New Adoption
If you are approaching OSCAL to intially create your system security plan and do not have legacy documentaiton to convert, follow this path.
If you need to convert legacy documentation to OSCAL, follow the Retrofit Adoption path.
Organizations seeking to create a new authorization package should begin their OSCAL adoption journey with OSCAL components and iterate with additional detail over time.
SSP New Adoption Overview
The OSCAL Foundation recommends the following addoption path for FedRAMP SSP creation.
CORE
-
Minimum Front-Matter and OSCAL-required Content.
metadataincludes:title,published,last-modified,version,oscal-versionroles: CSP, ISSO, others as cited in controlsparties: the CSPresponsible-party: exactly one, linking the CSP party to the CSP role
system-characteristicsincludes:system-id,system-name,system-name-short,description- cloud-service-model
propand cloud-deployment-modelprop security-sensitivity-level(fips-199-high,fips-199-moderate,fips-199-low)system-information: exactly one entry with Appendix K pasted into thedescriptionstatus: Required field. Use as-isauthorization-boundary:descriptionandlinksentry identifying the external attachment.network-architecture:descriptionandlinksentry identifying the external attachment.data-flow:descriptionandlinksentry identifying the external attachment.
system-implementationincludes:users: Required by OSCAL, but no longer required by FedRAMP.Singleauthorized-privilegesentry with emptytitleandfunction-performed` set to "none"
-
**
-
Components
- this-system (Core OSCAL Mandatory)
- technical components. Appropriate level of granularity for:
- SSP control responses: If you need to reference an element of the system in a control response, there should be a defined OSCAL component.
- normalizing inventory reporting: for any item appearing in the inventory, details about its vendor, product/service name, version or other details should be a defined component.
- Document Components for Policies, Procedures, Plans, RoB, User Guides
DETAILS
- Required SSP Roles
- Information Types / FIPS-199 Categorization
- Leveraged Authorizations and External Services (needed for Controls below.)
- Cryptographic Module representation
CONTROLS
- Assign Components
- Responses at the Component Level
- Derived from included components:
- Roles
- Implementaiton Status
- Add roles where they are not inherited from cited components
- Override implementation status only where necessary. Examples:
- Cited components don't represent all components.
- Planned upgrades or replacement of components
TARGET
Advanced topics.
-
Convert controls without modification, with all response statements in the "this-system" component.
control-implementationimplemented-requirement(AC-1, AC-2, etc.)set-parameters: set parameters as neededstatement(part a, part b, etc.by-component("this system")description: Content directly from legacy Word SSP (part a, part b, etc.)implementation-statusresponsible-roles: One entry per role. Userole-id. Must matchmetadata/roles/id.
-
Flat Inventory, converted directly from spreadsheet. No corrisponding components.
system-implementation:inventory-items: All inventory converted from Excel spreadsheet
Intermediate
-
Required attachments
- Add direct
linksfrom the appropriate controls to identify relevant attachments
- Add direct
-
Required SSP roles
metadata/rolesThe roles required by SSP (System owner, ISSO, AO, etc.)metada/parties: the people, teams and organizations responsible for the above rolesmetadata/responsible-parties: links the aboverolesandparties
-
Information types
system-characteristics/system-information/information-types- a single entry for each row in appendix K.
-
leveraged authorizations
system-implementation/leveraged-authorizations:- one entry for leveraged authorization
- corrisponding
metadata/partiesentry for each - corrisponding
system-implementation/componentsfor each.
-
Separation of Duties Matrix
system-implementation/users- one entry per row in Table 11.1
./authorized-privilege/functions-performed: SSP Table 11.1 Duty Description (just one entry in the array)./authorized-privilege/title: Required by OSCAL, not by FedRAMP. Recommend duplicating thefunctions-performedcontent.role-ids: linksmetadata/rolestofunctions-performed
-
Customer Responsibility and Inheritance:
- Move customer responsibility statements to
//by-components/export/responsibilities
- Move customer responsibility statements to
Advanced
-
Normalize Inventory: Transition flat inventory to component-based inventory.
- Use
componentsto the greatest degree practical inventory-itemsbecome implemented instances of components
- Use
-
external systems and services
system-implementation/componentsentries for each
-
Transition to
resources- Where practical,
linksentries use URI fragments to reference resources instead of direct links.
- Where practical,
-
Components for Required Documents
- policy
componentsentries for each required policy - process-procedure
componentsentries for each required process - plan
componentsentries for each required plan - _useradd components for policies, processes, plans and other documents
- policy
Ideal
-
Services, Ports and Protocols
-
Cryptographic Modules (App Q table)
-
Migrateto component-based control responses
- Add
by-componentsentries toimplemented-requirementsfor each relevant component - Add/move component-specific control responses to their associated
by-componentsresponse. - Migrate slowly over time.
- Add