ZF/blog/oscal-getting-started
Practitioner6 min readMay 8, 2025

Getting Started with OSCAL

OSCAL is NIST's machine-readable format for security controls and assessments. Here is what it is, why FedRAMP is moving to it, and how to start working with OSCAL.


What OSCAL Is

OSCAL (Open Security Controls Assessment Language) is a machine-readable format developed by NIST for security controls, assessments, and continuous monitoring. It standardizes the exchange of compliance information between organizations, tools, and authorities.

OSCAL has six layers of models:

  1. Catalog: Control catalogs (NIST 800-53, NIST 800-171)
  2. Profile: Tailored baselines (FedRAMP Moderate, FedRAMP High)
  3. Component: System components (a database, a service, a piece of infrastructure)
  4. System Security Plan: SSP in machine-readable format
  5. Assessment Plan: Test plan for an assessment
  6. Assessment Results: Findings, observations, and risk information

OSCAL is XML and JSON-based. NIST publishes the schemas and reference implementations. The goal is to move compliance documentation from prose-only to structured data that tools can ingest, transform, and validate.

Reference the documentation module for OSCAL practical use cases.

Why OSCAL Matters

FedRAMP is the primary driver of OSCAL adoption. The FedRAMP PMO has stated the long-term goal of accepting authorization packages in OSCAL format, which would enable:

  • Automated package validation: Tools verify SSP completeness, control coverage, and structural correctness automatically
  • Faster review cycles: Agencies process structured data faster than 1500-page Word documents
  • Cross-package analysis: Identifying common gaps, control implementation patterns, and trends across CSPs
  • Continuous reauthorization: ConMon updates flow into OSCAL data structures, supporting near-real-time compliance posture

For CSPs, OSCAL adoption means tooling investment but operational benefits: machine-checkable SSPs, automated control mapping across frameworks, and reduced manual editing of large documents.

OSCAL is also being adopted beyond FedRAMP. Some private sector organizations use OSCAL for internal compliance management. As more tools support OSCAL, adoption will accelerate.

Where to Start

For organizations new to OSCAL, the on-ramp:

  1. Read the NIST OSCAL documentation: pages.nist.gov/OSCAL/ explains the models and use cases
  2. Examine reference examples: NIST provides examples of catalogs, profiles, SSPs, and other models in their GitHub repository
  3. Try OSCAL tooling: Tools like the OSCAL Editor, OSCAL CLI, and various validators help you work with OSCAL files
  4. Convert one component to OSCAL: Take a single system component and document it in OSCAL component format. This builds familiarity.
  5. Pilot a small SSP section: Convert a control family from your existing SSP to OSCAL SSP format

Do not try to convert your entire SSP to OSCAL on day one. The learning curve is significant. Start small, build expertise, then expand coverage.

Tooling Landscape

The OSCAL tooling ecosystem is growing:

  • Reference tooling from NIST: OSCAL CLI, validators, and example utilities published by NIST. Open source.
  • Commercial OSCAL tooling: Vendors like Telos, Knowledge Decisions, and others offer OSCAL-aware compliance platforms
  • Cloud provider OSCAL support: AWS, Azure, and Google Cloud have OSCAL components for their services that customers can incorporate
  • Open source OSCAL libraries: Python, Go, and other libraries for working with OSCAL data programmatically

Tooling is uneven across the OSCAL model. Catalog and profile tools are mature. SSP, assessment plan, and assessment results tools are emerging. Choose tools that support the OSCAL models most relevant to your use case.

The FedRAMP PMO and other agencies are publishing official OSCAL profiles for FedRAMP Low, Moderate, and High baselines. Use these as starting points for your tailored profiles.

Common OSCAL Pitfalls

Lessons from organizations adopting OSCAL:

  • Treating OSCAL as a one-time export: OSCAL works when it is the source of truth, not a derived format. Aim to author in OSCAL or maintain bi-directional sync.
  • Assuming current tools support OSCAL: Many GRC platforms claim OSCAL support but implementation depth varies. Test before relying on the support.
  • Skipping the prose: OSCAL still allows prose narratives within structured fields. The structure does not eliminate the need for clear writing.
  • Not validating against schema: OSCAL files must conform to NIST schemas. Validation tools catch errors that would otherwise propagate downstream.
  • Treating it as immediate ROI: OSCAL pays back at scale and over time. First-year ROI may be negative. Plan for multi-year adoption.

OSCAL is a strategic investment. Organizations that move early will benefit as the ecosystem matures and more tools, frameworks, and authorities adopt it.

Frequently Asked Questions

OSCALFedRAMPAutomationNIST

Related Articles