Skip to content
master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
src
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

FedRAMP

Federal Risk and Authorization Management Program (FedRAMP) Automation

OSCAL Guides and Templates

The FedRAMP Program Management Office (PMO) has drafted FedRAMP-specific extensions and guidance to ensure our stakeholders can fully express a FedRAMP Security Authorization Package using NIST's OSCAL SSP syntax.

To accompany these guides, the FedRAMP PMO has also drafted OSCAL files in XML and JSON formats to serve as an example and template for each major deliverable.

Support and OSCAL Deprecation Strategy

The FedRAMP PMO has a release strategy and versioning procedures. FedRAMP has a minimally supported version of OSCAL, unless explicitly noted otherwise in specific documents or source code in this repository. Baselines, guides, templates, and associated tools in this repository will only support OSCAL data with a version number no lower than specified by FedRAMP version tags. A version tag that ends in -oscal1.0.0 will only support data with oscal-version equal to 1.0.0 or newer, it will not support 1.0.0-milestone3, 1.0.0-rc1, or 1.0.0-rc2. A future version tag ending in -oscal1.1.0 indicates FedRAMP source code and guides will support data with oscal-version equal to 1.1.0 or newer, but not 1.0.0.

Changes to the minimally supported version and deprecation notices will be made in advance of a release.

This repository is for the development and enhancement of OSCAL artifacts only. For issues with the Word and Excel-based templates and artifacts on the fedramp.gov site, please send requests to info@fedramp.gov.

We Want Your Feedback!

The FedRAMP PMO is releasing the following files for public review and comment:

  • FedRAMP Baselines: The FedRAMP baselines for High, Moderate, Low, and Tailored for Low Impact-Software as a Service (LI-SaaS) in OSCAL (XML and JSON formats) are available here.

  • FedRAMP OSCAL Templates: The template files are pre-populated with FedRAMP extensions, defined-identifiers, and conformity tags where practical. They also include sample data, and are the basis for their respective guidance documents above. The drafts for public comment are available in both XML and JSON formats here.

  • FedRAMP OSCAL Registry This registry is the authoritative source for all FedRAMP extensions to the OSCAL syntax, FedRAMP-defined identifiers, and accepted values. The draft for public comment is available here.

  • Implementation Guides: These documents enables tool developers to generate OSCAL-based FedRAMP deliverabes that are fully compliant with FedRAMP’s extensions, defined identifiers, conformity tags, and acceptable values. The drafts for public comment are available here.

Please ask questions or provide feedback on the items above above either via email to oscal@fedramp.gov, as a comment to an existing issue, or as a new issue.

Dependencies

FedRAMP's work is based on NIST's OSCAL 1.0.0, and requires an understanding of the core OSCAL syntax, as well as NIST-provided resources to function correctly.

IMPORTANT: NIST has made minor syntax updates since releasing 1.0.0-rc2, which are also reflected in these guides. Please review the NIST OSCAL release notes in addition to guides here for more information about these changes.

The following NIST resources are available:

NIST offers a complete package containing the NIST OSCAL converters, syntax validation tools, 800-53 and FedRAMP baselines content is available for download in both ZIP and BZ2 format. Visit the NIST OSCAL Github releases page for more information.

Please ask questions or provide feedback on the above NIST dependencies either via email to oscal@nist.gov, as a comment to an existing issue, or as a new issue via the NIST OSCAL GitHub site.

FedRAMP looks forward to receiving your comments and sharing additional progress.

Developer notes

Build / test

A top-level Makefile is provided to simplify builds.

Build requirements are:

  • gnu make
  • node.js (as versioned in ./nvmrc)
  • Java 8+

For usage information, use the default target:

make

Implementation details

FedRAMP automation is composed of the following implementation details:

  • Validation rules are implemented in Schematron with xspec test coverage.
  • Web-based frontend provides a browser of implemented validation rules and may be used to validate a System Security Plan in-browser.
  • Example code is provided to demonstrate how to apply the validation rules using the compiled-XSLT artifact in selected languages.

Creating a release

ADR 0002 (git release version strategy) outlines the release and versioning system.

Releases must be tagged from the master branch of GSA/fedramp-automation. If your work resides elsewhere, first merge to master via a pull-request.

To produce a release: