Skip to content

Certification package, slice A: the CPO in FedRAMP's schema, with the CDS overview folded in (SCN-2026-008) - #573

Merged
sam-aydlette merged 1 commit into
mainfrom
feat/cpo-one-package
Nov 17, 2026
Merged

sam-aydlette merged 1 commit into
mainfrom
feat/cpo-one-package

Conversation

@sam-aydlette

Copy link
Copy Markdown
Owner

SCN-Type: adaptive
SCN-Rationale: Certification package, slice A: the Certification Package Overview is written in FedRAMP's schema and absorbs the separate certification-overview package, and two rules it now meets move to Implemented.
SCN-Record: SCN-2026-008

SIA:

  • compliance-engine: yes (the CPO generator is rewritten and validated against FedRAMP's schema; the CDS overview generator is removed; CPO-CSO-MTD and CDS-CSO-SVC move to Implemented)
  • pipeline: yes (the deploy stops building, signing and publishing certification-overview-package.json; the CPO step drops its --overview input)
  • security-controls: no (no gate is added, removed or weakened; the CPO now fails closed on a schema error, which is stricter)
  • external-service: no (no service, interconnection or third-party component changes)
  • data-handling: no (the same public offering data, reshaped; no new data)
  • privacy-data: no (the offering data names only the operator, as before; no PII or PHI is collected or generated)
  • crypto: no (one signature fewer because one file is retired; no module, key, algorithm or signing method changes)

Changed

  • scripts/build-cpo.py. Rewritten to write FedRAMP's Certification Package Overview schema (2026-06-24), validated by write_validated before it is written; a CPO that fails is never signed or published.
    • serviceIdentification: provider, service, acronym, description, certification type 20x, FedRAMP ID, website, logo.
    • serviceProperties: service and deployment model, business category, trust center, Secure Configuration Guidance, and the package's files as repositories.
    • contactInformation: Security and Sales; neither is an email address.
    • certifiedServices: each service with its security category and whether it is in the Minimum Assessment Scope (CDS-CSO-SVC). The build fails on an empty list, a missing scope answer, or a category that doesn't name the system's impact level.
    • metadata: the accountable official (name, title, contact), version (the commit), last update and its source (builder, commit, deploy run) (CPO-CSO-MTD). The build fails without them.
    • The fields the gates read stay where they are: ksi_signal_id, impact_level, metadata.last_updated.
  • scripts/build-cds-overview.py removed. Its fields now live in the CPO, so the public information has one file. Removed from the deploy (build and signing), the freshness config and .gitignore.
  • data/cds/offering.json.
    • Adds the provider name, service name and acronym.
    • The FedRAMP ID becomes FedRAMP's fallback (provider name and acronym) suffixed PROOF-OF-CONCEPT-NOT-A-REAL-FEDRAMP-ID (operator, 2026-11-17).
    • The business category uses three of the schema's values.
    • The UEI placeholder is removed: the schema says to leave it out when there is none.
    • The independent-assessment text that said "N/A" is removed; the CPO says Impractical (one-person, no-budget), as the rule record does.
  • data/frr-records.json. CPO-CSO-MTD and CDS-CSO-SVC: Not Demonstrated → Implemented, citing the deploy step, the published CPO and the new tests.
  • Tests.
    • New tests/test_cpo.py (14): the CPO validates; a failing one is never written; metadata; each missing accountable-official field and a missing commit fail the build; the service list, and each bad service input failing it; the gate fields; the FedRAMP ID suffix and no UEI; no email in contacts; the Markdown.
    • tests/test_published_set.py, tests/test_verify_published.py: the published counts drop by the overview's three objects (JSON, Markdown, signature) and one signature.

Effect

  • /.well-known/certification-package-overview.json is in FedRAMP's schema and carries the public information and service list. Its Markdown sibling shows the same.
  • The deploy no longer publishes certification-overview-package.json, .md or .bundle. The objects already on the site stay until they are deleted (below).
  • Freshness: 25 → 24 governed artifacts. Signed files verify-published checks: 24 → 23.
  • Rule statuses: Implemented 6 → 8, Not Demonstrated 99 → 97 (Impractical 36, Not Applicable 13 unchanged).
  • nextOngoingCertificationReportDate is not published yet. The old overview carried today + 91 days, a date that moved every deploy; the real calendar is slice D, and CCM-OCR-NRD stays Not Demonstrated until then.

Verified

  • make check: PASS (exit 0).
  • Built the CPO from this branch against the live inventory (ksi-signal.json): 2 services, 7 package files, 216 components. It validates with this repo's validator and with jsonschema (0 errors).
  • The logo URL serves image/png.
  • scripts/sia.py exits 0 on this body.
  • CodeGuard (rules checked against the diff by hand): the commit lookup runs git with an argument list and no shell; no secret, credential, account ID or email address is added; no permission or action changes. No findings.

Residual / needs human

  • After this deploys and the new CPO is live, delete the three retired objects from the site bucket: .well-known/certification-overview-package.json, .md and .bundle. aws s3 rm is blocked for the agent, so this is the operator's step; I'll give the exact commands after verifying the deploy.

Couldn't verify

  • The deploy's published CPO, until it runs.

Follow-ups noticed

  • The OCR also publishes a next report date of today + 91 days; slice D replaces both with the issue calendar.

🤖 Generated with Claude Code

… CDS overview folded in (SCN-2026-008)

The Certification Package Overview is written in FedRAMP's 2026-06-24 schema
and validated before it is written. It now carries the public information and
service list the separate certification-overview package published, which is
retired. CPO-CSO-MTD and CDS-CSO-SVC move to Implemented with tests.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@sam-aydlette
sam-aydlette merged commit 9788e92 into main Nov 17, 2026
9 checks passed
@sam-aydlette
sam-aydlette deleted the feat/cpo-one-package branch November 17, 2026 18:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant