Skip to content

KSI catalog: FedRAMP's current KSI-to-control mappings (W3, 2/4) - #502

Closed
sam-aydlette wants to merge 1 commit into
feat/frr-recordsfrom
feat/ksi-catalog-corpus
Closed

sam-aydlette wants to merge 1 commit into
feat/frr-recordsfrom
feat/ksi-catalog-corpus

Conversation

@sam-aydlette

@sam-aydlette sam-aydlette commented Nov 5, 2026 •

Copy link
Copy Markdown
Owner

SCN-Type: not-significant
SCN-Rationale: reference data aligned to FedRAMP's published KSI mappings; no change to the system, its boundary or its controls' implementation.

Changed

  • scripts/sync-ksi-catalog.py (new) derives the KSI block of infrastructure/schemas/ksi-catalog.json from the pinned, hash-checked Consolidated Rules: IDs, names, the Class C statement where a KSI varies by class, and the KSI→control mappings, with titles from the vendored NIST SP 800-53 Rev5 catalog. Per-KSI impact flags (not in the corpus) are kept; a new KSI fails until its flags are set. --check exits 1 on any difference.
  • infrastructure/schemas/ksi-catalog.json regenerated by it. The committed catalog predated FedRAMP's 2026-10-13 mapping revision ("Updated control mappings: added …" in the corpus's own change log), so 40 of 46 KSIs differed, almost all by mapping fewer controls.
  • infrastructure/policy/s3.rego: the versioning rule's annotation drops si-12, which no KSI maps any more (the annotation check requires a rule's controls to be carried by its KSIs).
  • Tests:
    • tests/test_ksi_catalog_corpus.py (new): the catalog equals the pinned rules; known-bad: the pre-revision catalog, a dropped control, a control outside NIST, a new KSI without impact flags.
    • tests/test_controls.py: the SSP parity test runs on a frozen copy of the catalog as it stood when the SSP was retired (tests/fixtures/migration/ksi-catalog-2026-11-05.json), so the projection code stays pinned.
    • tests/test_inject_figures.py: expected figures updated (below).

Effect

  • Control projection, Moderate baseline (323): no implementation status changes.
    • SC-45 and SC-45.1 move from inherited to shared, because KSI-SVC-ACM now claims them.
    • 66 control statements and 62 control links now name the KSIs FedRAMP maps to each control.
  • Beyond Moderate: the projection now covers 59 controls that FedRAMP's KSIs map outside the Moderate baseline (was 10): 52 implemented, 7 not applicable. The trust-center figures change from 333 total / 10 beyond to 382 / 59; coverage stays 323/323.
  • KSI signal and SDR: statements change for six KSIs, and the per-KSI control lists change for 40, on the next deploy.
  • Policy: S3 versioning violations stop citing si-12. Decisions are unchanged.

Verified

  • make check: PASS. Full suite: 975 passed, 1 skipped.
  • Regal, check-policy-annotations, check-exceptions and check-wasm-safe pass locally.
  • The new test module fails on the base (no sync script) and passes on the branch.
  • The projection was run on the clean fixture inventory with the old and new catalogs and diffed control by control (figures above).

Residual

  • The 52 beyond-baseline controls marked implemented get their status from the projection's family defaults, as the 10 did before; the per-control evidence trace arrives with the SDR's securityControls in the next PR.

Needs human

  • Review the mapping changes below (they are FedRAMP's, carried verbatim), SC-45/SC-45.1 becoming shared, and dropping si-12 from the S3 versioning rule.

Couldn't verify

  • Whether FedRAMP intends KSIs to map controls outside the Moderate baseline for a Moderate-equivalent Class C offering; the corpus maps them, and they are shown separately from the 323.
KSI mapping and statement changes (FedRAMP's)
KSI Controls added Controls removed Statement
KSI-CED-RAT cm-11, cp-3.1, ir-2.1, ir-2.2, ir-9.2, ir-9.4, pl-4, pl-4.1 —
KSI-CMT-LMC ca-7.4, cm-3.1, cm-3.6 ma-2
KSI-CMT-VTD cm-6.2, ir-9.4 —
KSI-CNA-DFP cm-8.4, cp-10.4, ir-9.4 —
KSI-CNA-EIS cm-11, cm-6.2, cp-10.4, ir-9.4, sc-24, sc-7.18, si-4.22, si-7, si-7.1, si-7.5, si-7.7 ca-7.1
KSI-CNA-IBP sc-7.18 —
KSI-CNA-MAT sc-7.18 —
KSI-CNA-OFA cp-2.5, sc-12.1 —
KSI-CNA-RNT sc-7.10, sc-7.18, sc-7.20, sc-7.21, si-10, si-4.11, si-4.18, si-4.4 —
KSI-CNA-RVP ir-4.2, sc-7.18 —
KSI-CNA-ULN ac-4.21, cm-11, sc-7.20, sc-7.21 —
KSI-IAM-AAM ia-8.4 —
KSI-IAM-APM ia-2.6, ia-5.8, ia-8.2, ia-8.4 —
KSI-IAM-ELP ac-18.4, ac-2.11, ac-2.7, ac-2.9, ac-21, ac-6.3, ac-6.8, au-12.3, au-6.7, cm-5.1, cm-5.5, cm-7.2, ir-4.6, ir-9.4, ra-5.5, sc-2, sc-3, si-4.19 —
KSI-IAM-JIT ac-17.4, ac-2.11, ac-2.7, ac-21, ac-6.3, ac-6.8, au-10, au-12.3, ca-3.6, cm-5.1, cm-5.5, ir-4.6, sc-3 —
KSI-IAM-SNU ac-2.9, au-10, ia-2.5 —
KSI-IAM-SUS ac-2.11, ac-2.12, au-6.5, cm-5.1, cm-6.2, ir-4.2, ir-4.6, si-4, si-4.1, si-4.19, si-4.20, si-4.22, si-4.4 —
KSI-INR-AAR ir-5.1, ir-9.3 —
KSI-INR-RIR ir-4.11, ir-9.3 —
KSI-INR-RPI ir-4.11, ir-4.4, ir-5.1, ra-5.8 —
KSI-MLA-ALA au-12.3, au-6.7 —
KSI-MLA-EVC ac-19, cm-6.1, ra-3 —
KSI-MLA-LET au-10, au-7, cm-5.1, ir-9.4, si-4.19, si-4.20 —
KSI-MLA-OSM au-12.1, au-5.1, au-6.4, au-6.5, si-4.16 si-7.7
KSI-MLA-RVL au-7, ra-5.8, si-4.19 —
KSI-PIY-GIV cm-8.2, cm-8.4 —
KSI-PIY-RIS ca-2.2, ir-4.11 —
KSI-PIY-RSD ia-5.7, ra-9 —
KSI-RPL-ABO — si-12
KSI-RPL-TRC ir-9.3, sc-12.1 —
KSI-SCR-MIT ac-19, ra-3, sa-11.1, sa-11.2, sa-15, sa-16, sa-17, sa-21, sa-4, sa-4.1, sa-4.2, sa-4.5, sa-4.9, sa-9.1, sa-9.2, sa-9.5, si-7.15, sr-2, sr-3 — changed
KSI-SCR-MON ac-19, ca-2.3, ra-3, sr-3 —
KSI-SVC-ACM ac-6.8, sc-45, sc-45.1, sc-7.18 —
KSI-SVC-ASM sc-12.1 —
KSI-SVC-EIS ca-7.4, cm-5.5, ir-9.4, ra-3 ma-2
KSI-SVC-PRR ac-19, ir-9.4, sc-12.1, sc-7.18 —
KSI-SVC-RUD ir-9, si-8, si-8.2 —
KSI-SVC-SIN ac-11, ac-11.1, ac-19.5, ac-21, ir-9.4, sc-4, sc-7.18, si-4.18 ac-1
KSI-SVC-VCM ac-10, ac-17.4, ac-18, ac-19, si-4.22 —
KSI-SVC-VRI ac-17.4, ac-18, ac-19, au-9.3, cm-14, si-7.15, sr-11 —

40 KSIs changed.

🤖 Generated with Claude Code

…ed rules

The vendored ksi-catalog.json predated FedRAMP's 2026-10-13 mapping revision:
40 of 46 KSIs mapped fewer (or different) controls than the pinned
Consolidated Rules. scripts/sync-ksi-catalog.py now derives the KSI block
from the pinned rules (Class C statements where a KSI varies by class,
titles from the NIST Rev5 catalog), and a test fails while they differ.

Within the Moderate baseline no implementation status changes; SC-45 and
SC-45.1 become shared. The projection reaches 59 controls beyond Moderate
(was 10). s3.rego drops si-12, which no KSI maps any more. The SSP parity
test runs on the catalog as it stood at the SSP's retirement.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@sam-aydlette
sam-aydlette force-pushed the feat/ksi-catalog-corpus branch from 7a2dc49 to 0f5e4fb Compare November 5, 2026 21:31
@sam-aydlette

Copy link
Copy Markdown
Owner Author

Folded into #503.

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