FedRAMP 20x: Make Public JSON Work in Agency Web Tools
FRC-CSO-JSN addresses schema-valid JSON when a corresponding schema is provided, unless otherwise specified, and public delivery compatible with modern web frameworks. Its guidance covers cross-origin access, application/json and nosniff headers, and browser use without security bypasses. Test public JSON from an application on another domain, then verify CDS-PUB’s directly displayable logo link. Preserve access limits for restricted materials and the separate FRC/CDS adoption dates.
In this article
Main question
How should 20x teams check that public certification JSON works in agency web tools?
FedRAMP 20x: Make Public JSON Work in Agency Web Tools
Your public certification JSON downloads, and its contents pass a schema check. Before calling delivery ready, check the experience described by FedRAMP: a web application on another domain can retrieve and use the public data with normal browser protections in place.
For 20x Class B and C teams, this is a coordination task for application engineering and the owner of public certification information. The October 5 clarification addressed public JSON compatibility and the public product-logo link. It did not make every certification document public or establish a new blanket adoption deadline.
Check structure and web delivery separately
FRC-CSO-JSN says providers MUST supply machine-readable information in JSON documents valid against the corresponding FedRAMP schema when a rule provides one, unless that rule specifies otherwise. It also says public JSON MUST be delivered compatibly with modern web frameworks.
The rule’s accompanying guidance identifies these delivery expectations:
| Area | What the rule says to support |
|---|---|
| Cross-Origin Resource Sharing (CORS) | Web applications running on another domain can directly access the public JSON |
| Content type | Supply Content-Type: application/json |
| Content-type protection | Supply X-Content-Type-Options: nosniff |
| Browser use | Standard web-application parsing without configuring the browser to bypass security defaults |
JSN also notes that FedRAMP’s Schema Validator will not work properly when CORS is incorrectly configured. Treat a schema result and a browser-delivery result as different evidence. A saved document’s structure does not demonstrate the deployed endpoint’s complete delivery behavior.
Exercise the public endpoint from a browser application
The following is an editorial engineering check, not an extra FedRAMP test form or prescribed monitoring schedule:
- Identify the public data. Confirm the endpoint serves the intended public certification information and record the exact URL and version under test.
- Check the applicable schema. Validate the JSON against the corresponding schema, preserving JSN’s exception when the underlying rule specifies otherwise.
- Use an application on another domain. Have a small browser-based test application retrieve and parse the public JSON with normal security settings. Merely opening the JSON URL is not this proposed cross-origin application test.
- Inspect the delivered response. Check the listed content headers and whether the test application can read the intended public fields. If it cannot, retain the observed failure and investigate the delivery configuration.
- Retest the deployed result. After a correction, repeat the same application retrieval and record what changed.
For a handoff, retain the schema result, endpoint, test application’s origin, response-header observations, browser result and release owner. These are suggested engineering records. They help the next operator reproduce the check without turning a local success into a claim of certification.
Include the logo in the delivery check
CDS-CSO-PUB calls for up-to-date public offering information in human-readable and JSON formats, including its listed information that is available and applicable. Among those items is a product-logo link.
The logo link is to be a valid, properly named image link that displays in a browser without processing. Transparent PNG is preferred, not mandatory. As a practical check, open the exact logo URL carried in the public data and confirm the image displays; a page that contains a logo is not the same deliverable as the specified image link.
Preserve the public and restricted access boundary
Apply these public-delivery checks to public information. They do not justify opening restricted package materials or prescribing a wildcard CORS policy for private endpoints. CDS separately addresses access to certification materials and conditional responsible public package sharing. Keep those decisions with the people responsible for the material and its access policy.
For both FRC and CDS, the 20x optional-adoption and initial-certification dates are July 4, 2026. Ongoing certification uses January 1, 2027; grace ends at the first FedRAMP independent assessment started after that date. October 5 is the clarification date.
Common release questions
Does valid JSON establish browser compatibility?
JSN addresses both schema validity and public web-framework compatibility. Check both; a structural result alone does not demonstrate the delivery expectations.
Does the public logo have to be a transparent PNG?
No. CDS-PUB prefers transparent PNG, while specifying a valid, properly named image link that displays in a browser without processing.
For adjacent work, see JSON schema validation and testing trust-center programmatic access.
Frequently asked questions
Does valid JSON establish browser compatibility?
JSN addresses both schema validity and public web-framework compatibility. Check both; a structural result alone does not demonstrate the delivery expectations.
Does the public logo have to be a transparent PNG?
No. CDS-PUB prefers transparent PNG, while specifying a valid, properly named image link that displays in a browser without processing.
Does public JSON compatibility make the entire certification package public?
No. CDS-PUB identifies available and applicable public offering information, while CDS separately governs access to certification materials and conditional responsible public package sharing. Apply the browser checks to the public endpoint without opening restricted materials.
Next step
If you want to turn this guidance into an execution plan, the product side handles control mapping, SSP drafting, and evidence collection.
Related articles
FedRAMP 20x: Keep Significant Change Notification History Retrievable
Keep significant change notices retrievable in both formats, preserve their relationship to evaluation evidence and maintain the routine-change exemption.
FedRAMP 20x OSCAL Evidence Automation: A Practical Workflow
FedRAMP's 20x certification rules say providers must supply machine-readable information in JSON documents whenever a rule includes a FedRAMP JSON schema.
Moving to FedRAMP 20x: Which Rev5 Certifications Can Coexist?
Distinguish Rev5 Program from Rev5 Agency Certification before planning coexistence with 20x, and preserve the warning about complexity and confusion.