From 0f5e4fb5ce5db991113a78fa0aa564725e467c6e Mon Sep 17 00:00:00 2001 From: sam-aydlette Date: Thu, 5 Nov 2026 14:17:10 -0500 Subject: [PATCH] KSI catalog: FedRAMP's current KSI-to-control mappings, from the pinned 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 --- .venv | 1 + infrastructure/policy/s3.rego | 2 +- infrastructure/schemas/ksi-catalog.json | 1065 ++++++-- scripts/sync-ksi-catalog.py | 95 + .../migration/ksi-catalog-2026-11-05.json | 2206 +++++++++++++++++ tests/test_controls.py | 7 +- tests/test_inject_figures.py | 7 +- tests/test_ksi_catalog_corpus.py | 57 + 8 files changed, 3273 insertions(+), 167 deletions(-) create mode 120000 .venv create mode 100644 scripts/sync-ksi-catalog.py create mode 100644 tests/fixtures/migration/ksi-catalog-2026-11-05.json create mode 100644 tests/test_ksi_catalog_corpus.py diff --git a/.venv b/.venv new file mode 120000 index 00000000..7e6cd3e1 --- /dev/null +++ b/.venv @@ -0,0 +1 @@ +../wt-w3-frr/.venv \ No newline at end of file diff --git a/infrastructure/policy/s3.rego b/infrastructure/policy/s3.rego index 7808baef..0243ac65 100644 --- a/infrastructure/policy/s3.rego +++ b/infrastructure/policy/s3.rego @@ -25,7 +25,7 @@ import data.policy.gate # id: versioning_disabled # category: infrastructure # severity: MEDIUM -# nist_controls: [cp-9, cp-10, si-12] +# nist_controls: [cp-9, cp-10] # ksi_ids: [KSI-RPL-ABO] violations contains violation if { some r in gate.resources diff --git a/infrastructure/schemas/ksi-catalog.json b/infrastructure/schemas/ksi-catalog.json index 7353e477..4b8dc8a7 100644 --- a/infrastructure/schemas/ksi-catalog.json +++ b/infrastructure/schemas/ksi-catalog.json @@ -121,7 +121,7 @@ { "reference": "NIST SP 800-53B", "reference_url": "https://csrc.nist.gov/pubs/sp/800/53/b/upd1/final", - "description": "Section 2.5 states \"As the number of controls in [SP 800-53] grows in response to an increasingly sophisticated threat space, it is important for organizations to have the ability to describe key capabilities needed to protect organizational missions and business functions, and to subsequently select controls that\u2014if properly designed, developed, and implemented\u2014produce such capabilities. The use of capabilities simplifies how the protection problem is viewed conceptually. Using the construct of a capability provides a method of grouping controls that are employed for a common purpose or to achieve a common objective.\" This section later states \"Ultimately, authorization decisions (i.e., risk acceptance decisions) are made based on the degree to which the desired capabilities have been effectively achieved.\"" + "description": "Section 2.5 states \"As the number of controls in [SP 800-53] grows in response to an increasingly sophisticated threat space, it is important for organizations to have the ability to describe key capabilities needed to protect organizational missions and business functions, and to subsequently select controls that—if properly designed, developed, and implemented—produce such capabilities. The use of capabilities simplifies how the protection problem is viewed conceptually. Using the construct of a capability provides a method of grouping controls that are employed for a common purpose or to achieve a common objective.\" This section later states \"Ultimately, authorization decisions (i.e., risk acceptance decisions) are made based on the degree to which the desired capabilities have been effectively achieved.\"" }, { "reference": "NIST SP 800-53A", @@ -129,9 +129,9 @@ "description": "Section 3.5 states \"When organizations employ the concept of capabilities, automated and manual assessments account for all security and privacy controls that comprise the security and privacy capabilities. Assessors are aware of how the controls work together to provide such capabilities.\"" }, { - "reference": "FedRAMP Authorization Act (44 USC \u00a7 3609 (a) (1))", + "reference": "FedRAMP Authorization Act (44 USC § 3609 (a) (1))", "reference_url": "https://fedramp.gov/docs/authority/law/#a-roles-and-responsibilities", - "description": "requires that the Administrator of the General Services Administration shall \"in consultation with the [DHS] Secretary, develop, coordinate, and implement a process to support agency review, reuse, and standardization, where appropriate, of security assessments of cloud computing products and services...\" 44 USC \u00a7 3609 (c) (2) further states that \"the [GSA] Administrator shall establish a means for the automation of security assessments and reviews.\"", + "description": "requires that the Administrator of the General Services Administration shall \"in consultation with the [DHS] Secretary, develop, coordinate, and implement a process to support agency review, reuse, and standardization, where appropriate, of security assessments of cloud computing products and services...\" 44 USC § 3609 (c) (2) further states that \"the [GSA] Administrator shall establish a means for the automation of security assessments and reviews.\"", "delegation": "These responsibilities are delegated to the FedRAMP Director", "delegation_url": "https://www.gsa.gov/directives-library/gsa-delegations-of-authority-fedramp" } @@ -159,18 +159,6 @@ "moderate": true }, "controls": [ - { - "control_id": "cp-3", - "title": "Contingency Training" - }, - { - "control_id": "ir-2", - "title": "Incident Response Training" - }, - { - "control_id": "ps-6", - "title": "Access Agreements" - }, { "control_id": "at-2", "title": "Literacy Training and Awareness" @@ -183,6 +171,10 @@ "control_id": "at-2.3", "title": "Social Engineering and Mining" }, + { + "control_id": "at-3", + "title": "Role-based Training" + }, { "control_id": "at-3.5", "title": "Processing Personally Identifiable Information" @@ -191,13 +183,53 @@ "control_id": "at-4", "title": "Training Records" }, + { + "control_id": "cm-11", + "title": "User-installed Software" + }, + { + "control_id": "cp-3", + "title": "Contingency Training" + }, + { + "control_id": "cp-3.1", + "title": "Simulated Events" + }, + { + "control_id": "ir-2", + "title": "Incident Response Training" + }, + { + "control_id": "ir-2.1", + "title": "Simulated Events" + }, + { + "control_id": "ir-2.2", + "title": "Automated Training Environments" + }, { "control_id": "ir-2.3", "title": "Breach" }, { - "control_id": "at-3", - "title": "Role-based Training" + "control_id": "ir-9.2", + "title": "Training" + }, + { + "control_id": "ir-9.4", + "title": "Exposure to Unauthorized Personnel" + }, + { + "control_id": "pl-4", + "title": "Rules of Behavior" + }, + { + "control_id": "pl-4.1", + "title": "Social Media and External Site/Application Usage Restrictions" + }, + { + "control_id": "ps-6", + "title": "Access Agreements" }, { "control_id": "sr-11.1", @@ -224,14 +256,26 @@ "control_id": "au-2", "title": "Event Logging" }, + { + "control_id": "ca-7.4", + "title": "Risk Monitoring" + }, { "control_id": "cm-3", "title": "Configuration Change Control" }, + { + "control_id": "cm-3.1", + "title": "Automated Documentation, Notification, and Prohibition of Changes" + }, { "control_id": "cm-3.2", "title": "Testing, Validation, and Documentation of Changes" }, + { + "control_id": "cm-3.6", + "title": "Cryptography Management" + }, { "control_id": "cm-4.2", "title": "Verification of Controls" @@ -243,10 +287,6 @@ { "control_id": "cm-8.3", "title": "Automated Unauthorized Component Detection" - }, - { - "control_id": "ma-2", - "title": "Controlled Maintenance" } ] }, @@ -345,6 +385,14 @@ "control_id": "cm-4.2", "title": "Verification of Controls" }, + { + "control_id": "cm-6.2", + "title": "Respond to Unauthorized Changes" + }, + { + "control_id": "ir-9.4", + "title": "Exposure to Unauthorized Personnel" + }, { "control_id": "si-2", "title": "Flaw Remediation" @@ -370,6 +418,18 @@ "control_id": "cm-2", "title": "Baseline Configuration" }, + { + "control_id": "cm-8.4", + "title": "Accountability Information" + }, + { + "control_id": "cp-10.4", + "title": "Restore Within Time Period" + }, + { + "control_id": "ir-9.4", + "title": "Exposure to Unauthorized Personnel" + }, { "control_id": "si-3", "title": "Malicious Code Protection" @@ -390,8 +450,48 @@ "title": "Independent Assessors" }, { - "control_id": "ca-7.1", - "title": "Independent Assessment" + "control_id": "cm-11", + "title": "User-installed Software" + }, + { + "control_id": "cm-6.2", + "title": "Respond to Unauthorized Changes" + }, + { + "control_id": "cp-10.4", + "title": "Restore Within Time Period" + }, + { + "control_id": "ir-9.4", + "title": "Exposure to Unauthorized Personnel" + }, + { + "control_id": "sc-24", + "title": "Fail in Known State" + }, + { + "control_id": "sc-7.18", + "title": "Fail Secure" + }, + { + "control_id": "si-4.22", + "title": "Unauthorized Network Services" + }, + { + "control_id": "si-7", + "title": "Software, Firmware, and Information Integrity" + }, + { + "control_id": "si-7.1", + "title": "Integrity Checks" + }, + { + "control_id": "si-7.5", + "title": "Automated Response to Integrity Violations" + }, + { + "control_id": "si-7.7", + "title": "Integration of Detection and Response" } ] }, @@ -415,6 +515,10 @@ { "control_id": "pl-10", "title": "Baseline Selection" + }, + { + "control_id": "sc-7.18", + "title": "Fail Secure" } ] }, @@ -447,6 +551,14 @@ "control_id": "ca-9", "title": "Internal System Connections" }, + { + "control_id": "sc-10", + "title": "Network Disconnect" + }, + { + "control_id": "sc-7.18", + "title": "Fail Secure" + }, { "control_id": "sc-7.3", "title": "Access Points" @@ -457,7 +569,7 @@ }, { "control_id": "sc-7.5", - "title": "Deny by Default \u2014 Allow by Exception" + "title": "Deny by Default — Allow by Exception" }, { "control_id": "sc-7.8", @@ -467,10 +579,6 @@ "control_id": "sc-8", "title": "Transmission Confidentiality and Integrity" }, - { - "control_id": "sc-10", - "title": "Network Disconnect" - }, { "control_id": "si-10", "title": "Information Input Validation" @@ -493,7 +601,16 @@ "low": true, "moderate": true }, - "controls": [] + "controls": [ + { + "control_id": "cp-2.5", + "title": "Continue Mission and Business Functions" + }, + { + "control_id": "sc-12.1", + "title": "Availability" + } + ] }, { "id": "KSI-CNA-RNT", @@ -516,9 +633,41 @@ "control_id": "cm-7.1", "title": "Periodic Review" }, + { + "control_id": "sc-7.10", + "title": "Prevent Exfiltration" + }, + { + "control_id": "sc-7.18", + "title": "Fail Secure" + }, + { + "control_id": "sc-7.20", + "title": "Dynamic Isolation and Segregation" + }, + { + "control_id": "sc-7.21", + "title": "Isolation of System Components" + }, { "control_id": "sc-7.5", - "title": "Deny by Default \u2014 Allow by Exception" + "title": "Deny by Default — Allow by Exception" + }, + { + "control_id": "si-10", + "title": "Information Input Validation" + }, + { + "control_id": "si-4.11", + "title": "Analyze Communications Traffic Anomalies" + }, + { + "control_id": "si-4.18", + "title": "Analyze Traffic and Covert Exfiltration" + }, + { + "control_id": "si-4.4", + "title": "Inbound and Outbound Communications Traffic" }, { "control_id": "si-8", @@ -535,10 +684,18 @@ "moderate": true }, "controls": [ + { + "control_id": "ir-4.2", + "title": "Dynamic Reconfiguration" + }, { "control_id": "sc-5", "title": "Denial-of-service Protection" }, + { + "control_id": "sc-7.18", + "title": "Fail Secure" + }, { "control_id": "si-8", "title": "Spam Protection" @@ -566,10 +723,22 @@ "control_id": "ac-17.3", "title": "Managed Access Control Points" }, + { + "control_id": "ac-4.21", + "title": "Physical or Logical Separation of Information Flows" + }, { "control_id": "ca-9", "title": "Internal System Connections" }, + { + "control_id": "cm-11", + "title": "User-installed Software" + }, + { + "control_id": "sc-10", + "title": "Network Disconnect" + }, { "control_id": "sc-4", "title": "Information in Shared System Resources" @@ -578,6 +747,14 @@ "control_id": "sc-7", "title": "Boundary Protection" }, + { + "control_id": "sc-7.20", + "title": "Dynamic Isolation and Segregation" + }, + { + "control_id": "sc-7.21", + "title": "Isolation of System Components" + }, { "control_id": "sc-7.7", "title": "Split Tunneling for Remote Devices" @@ -585,10 +762,6 @@ { "control_id": "sc-8", "title": "Transmission Confidentiality and Integrity" - }, - { - "control_id": "sc-10", - "title": "Network Disconnect" } ] } @@ -607,6 +780,10 @@ "moderate": true }, "controls": [ + { + "control_id": "ac-2.13", + "title": "Disable Accounts for High-risk Individuals" + }, { "control_id": "ac-2.2", "title": "Automated Temporary and Emergency Account Management" @@ -615,18 +792,10 @@ "control_id": "ac-2.3", "title": "Disable Accounts" }, - { - "control_id": "ac-2.13", - "title": "Disable Accounts for High-risk Individuals" - }, { "control_id": "ac-6.7", "title": "Review of User Privileges" }, - { - "control_id": "ia-4.4", - "title": "Identify User Status" - }, { "control_id": "ia-12", "title": "Identity Proofing" @@ -642,6 +811,14 @@ { "control_id": "ia-12.5", "title": "Address Confirmation" + }, + { + "control_id": "ia-4.4", + "title": "Identify User Status" + }, + { + "control_id": "ia-8.4", + "title": "Use of Defined Profiles" } ] }, @@ -654,54 +831,70 @@ "moderate": true }, "controls": [ + { + "control_id": "ac-2", + "title": "Account Management" + }, { "control_id": "ac-3", "title": "Access Enforcement" }, { - "control_id": "ia-5.1", - "title": "Password-based Authentication" + "control_id": "ia-2", + "title": "Identification and Authentication (Organizational Users)" }, { - "control_id": "ia-5.2", - "title": "Public Key-based Authentication" + "control_id": "ia-2.1", + "title": "Multi-factor Authentication to Privileged Accounts" }, { - "control_id": "ia-5.6", - "title": "Protection of Authenticators" + "control_id": "ia-2.2", + "title": "Multi-factor Authentication to Non-privileged Accounts" }, { - "control_id": "ia-6", - "title": "Authentication Feedback" + "control_id": "ia-2.6", + "title": "Access to Accounts —separate Device" }, { - "control_id": "ac-2", - "title": "Account Management" + "control_id": "ia-2.8", + "title": "Access to Accounts — Replay Resistant" }, { - "control_id": "ia-2", - "title": "Identification and Authentication (Organizational Users)" + "control_id": "ia-5", + "title": "Authenticator Management" }, { - "control_id": "ia-2.1", - "title": "Multi-factor Authentication to Privileged Accounts" + "control_id": "ia-5.1", + "title": "Password-based Authentication" }, { - "control_id": "ia-2.2", - "title": "Multi-factor Authentication to Non-privileged Accounts" + "control_id": "ia-5.2", + "title": "Public Key-based Authentication" }, { - "control_id": "ia-2.8", - "title": "Access to Accounts \u2014 Replay Resistant" + "control_id": "ia-5.6", + "title": "Protection of Authenticators" }, { - "control_id": "ia-5", - "title": "Authenticator Management" + "control_id": "ia-5.8", + "title": "Multiple System Accounts" + }, + { + "control_id": "ia-6", + "title": "Authentication Feedback" }, { "control_id": "ia-8", "title": "Identification and Authentication (Non-organizational Users)" }, + { + "control_id": "ia-8.2", + "title": "Acceptance of External Authenticators" + }, + { + "control_id": "ia-8.4", + "title": "Use of Defined Profiles" + }, { "control_id": "sc-23", "title": "Session Authenticity" @@ -717,26 +910,6 @@ "moderate": true }, "controls": [ - { - "control_id": "ac-2.5", - "title": "Inactivity Logout" - }, - { - "control_id": "ac-2.6", - "title": "Dynamic Privilege Management" - }, - { - "control_id": "ac-3", - "title": "Access Enforcement" - }, - { - "control_id": "ac-4", - "title": "Information Flow Enforcement" - }, - { - "control_id": "ac-6", - "title": "Least Privilege" - }, { "control_id": "ac-12", "title": "Session Termination" @@ -761,6 +934,30 @@ "control_id": "ac-17.3", "title": "Managed Access Control Points" }, + { + "control_id": "ac-18.4", + "title": "Restrict Configurations by Users" + }, + { + "control_id": "ac-2.11", + "title": "Usage Conditions" + }, + { + "control_id": "ac-2.5", + "title": "Inactivity Logout" + }, + { + "control_id": "ac-2.6", + "title": "Dynamic Privilege Management" + }, + { + "control_id": "ac-2.7", + "title": "Privileged User Accounts" + }, + { + "control_id": "ac-2.9", + "title": "Restrictions on Use of Shared and Group Accounts" + }, { "control_id": "ac-20", "title": "Use of External Systems" @@ -769,14 +966,62 @@ "control_id": "ac-20.1", "title": "Limits on Authorized Use" }, + { + "control_id": "ac-21", + "title": "Information Sharing" + }, + { + "control_id": "ac-3", + "title": "Access Enforcement" + }, + { + "control_id": "ac-4", + "title": "Information Flow Enforcement" + }, + { + "control_id": "ac-6", + "title": "Least Privilege" + }, + { + "control_id": "ac-6.3", + "title": "Network Access to Privileged Commands" + }, + { + "control_id": "ac-6.8", + "title": "Privilege Levels for Code Execution" + }, + { + "control_id": "au-12.3", + "title": "Changes by Authorized Individuals" + }, + { + "control_id": "au-6.7", + "title": "Permitted Actions" + }, { "control_id": "cm-2.7", "title": "Configure Systems and Components for High-risk Areas" }, + { + "control_id": "cm-5.1", + "title": "Automated Access Enforcement and Audit Records" + }, + { + "control_id": "cm-5.5", + "title": "Privilege Limitation for Production and Operation" + }, + { + "control_id": "cm-7.2", + "title": "Prevent Program Execution" + }, { "control_id": "cm-9", "title": "Configuration Management Plan" }, + { + "control_id": "ia-11", + "title": "Re-authentication" + }, { "control_id": "ia-2", "title": "Identification and Authentication (Organizational Users)" @@ -802,8 +1047,12 @@ "title": "Protection of Authenticators" }, { - "control_id": "ia-11", - "title": "Re-authentication" + "control_id": "ir-4.6", + "title": "Insider Threats" + }, + { + "control_id": "ir-9.4", + "title": "Exposure to Unauthorized Personnel" }, { "control_id": "ps-2", @@ -826,8 +1075,12 @@ "title": "Access Agreements" }, { - "control_id": "sc-4", - "title": "Information in Shared System Resources" + "control_id": "ra-5.5", + "title": "Privileged Access" + }, + { + "control_id": "sc-2", + "title": "Separation of System and User Functionality" }, { "control_id": "sc-20", @@ -845,13 +1098,25 @@ "control_id": "sc-23", "title": "Session Authenticity" }, + { + "control_id": "sc-3", + "title": "Security Function Isolation" + }, { "control_id": "sc-39", "title": "Process Isolation" }, + { + "control_id": "sc-4", + "title": "Information in Shared System Resources" + }, { "control_id": "si-3", "title": "Malicious Code Protection" + }, + { + "control_id": "si-4.19", + "title": "Risk for Individuals" } ] }, @@ -864,6 +1129,14 @@ "moderate": true }, "controls": [ + { + "control_id": "ac-17", + "title": "Remote Access" + }, + { + "control_id": "ac-17.4", + "title": "Privileged Commands and Access" + }, { "control_id": "ac-2", "title": "Account Management" @@ -872,6 +1145,10 @@ "control_id": "ac-2.1", "title": "Automated System Account Management" }, + { + "control_id": "ac-2.11", + "title": "Usage Conditions" + }, { "control_id": "ac-2.2", "title": "Automated Temporary and Emergency Account Management" @@ -888,6 +1165,18 @@ "control_id": "ac-2.6", "title": "Dynamic Privilege Management" }, + { + "control_id": "ac-2.7", + "title": "Privileged User Accounts" + }, + { + "control_id": "ac-20.1", + "title": "Limits on Authorized Use" + }, + { + "control_id": "ac-21", + "title": "Information Sharing" + }, { "control_id": "ac-3", "title": "Access Enforcement" @@ -908,10 +1197,18 @@ "control_id": "ac-6.1", "title": "Authorize Access to Security Functions" }, + { + "control_id": "ac-6.10", + "title": "Prohibit Non-privileged Users from Executing Privileged Functions" + }, { "control_id": "ac-6.2", "title": "Non-privileged Access for Nonsecurity Functions" }, + { + "control_id": "ac-6.3", + "title": "Network Access to Privileged Commands" + }, { "control_id": "ac-6.5", "title": "Privileged Accounts" @@ -921,33 +1218,45 @@ "title": "Review of User Privileges" }, { - "control_id": "ac-6.9", - "title": "Log Use of Privileged Functions" + "control_id": "ac-6.8", + "title": "Privilege Levels for Code Execution" }, { - "control_id": "ac-6.10", - "title": "Prohibit Non-privileged Users from Executing Privileged Functions" + "control_id": "ac-6.9", + "title": "Log Use of Privileged Functions" }, { "control_id": "ac-7", "title": "Unsuccessful Logon Attempts" }, { - "control_id": "ac-20.1", - "title": "Limits on Authorized Use" + "control_id": "au-10", + "title": "Non-repudiation" }, { - "control_id": "ac-17", - "title": "Remote Access" + "control_id": "au-12.3", + "title": "Changes by Authorized Individuals" }, { "control_id": "au-9.4", "title": "Access by Subset of Privileged Users" }, + { + "control_id": "ca-3.6", + "title": "Transfer Authorizations" + }, { "control_id": "cm-5", "title": "Access Restrictions for Change" }, + { + "control_id": "cm-5.1", + "title": "Automated Access Enforcement and Audit Records" + }, + { + "control_id": "cm-5.5", + "title": "Privilege Limitation for Production and Operation" + }, { "control_id": "cm-7", "title": "Least Functionality" @@ -958,7 +1267,7 @@ }, { "control_id": "cm-7.5", - "title": "Authorized Software \u2014 Allow-by-exception" + "title": "Authorized Software — Allow-by-exception" }, { "control_id": "cm-9", @@ -976,6 +1285,10 @@ "control_id": "ia-7", "title": "Cryptographic Module Authentication" }, + { + "control_id": "ir-4.6", + "title": "Insider Threats" + }, { "control_id": "ps-2", "title": "Position Risk Designation" @@ -1012,6 +1325,10 @@ "control_id": "sc-23", "title": "Session Authenticity" }, + { + "control_id": "sc-3", + "title": "Security Function Isolation" + }, { "control_id": "sc-39", "title": "Process Isolation" @@ -1035,6 +1352,10 @@ "control_id": "ac-2.2", "title": "Automated Temporary and Emergency Account Management" }, + { + "control_id": "ac-2.9", + "title": "Restrictions on Use of Shared and Group Accounts" + }, { "control_id": "ac-4", "title": "Information Flow Enforcement" @@ -1043,6 +1364,14 @@ "control_id": "ac-6.5", "title": "Privileged Accounts" }, + { + "control_id": "au-10", + "title": "Non-repudiation" + }, + { + "control_id": "ia-2.5", + "title": "Individual Authentication with Group Authentication" + }, { "control_id": "ia-3", "title": "Device Identification and Authentication" @@ -1075,17 +1404,45 @@ "title": "Automated System Account Management" }, { - "control_id": "ac-2.3", - "title": "Disable Accounts" + "control_id": "ac-2.11", + "title": "Usage Conditions" + }, + { + "control_id": "ac-2.12", + "title": "Account Monitoring for Atypical Usage" }, { "control_id": "ac-2.13", "title": "Disable Accounts for High-risk Individuals" }, + { + "control_id": "ac-2.3", + "title": "Disable Accounts" + }, { "control_id": "ac-7", "title": "Unsuccessful Logon Attempts" }, + { + "control_id": "au-6.5", + "title": "Integrated Analysis of Audit Records" + }, + { + "control_id": "cm-5.1", + "title": "Automated Access Enforcement and Audit Records" + }, + { + "control_id": "cm-6.2", + "title": "Respond to Unauthorized Changes" + }, + { + "control_id": "ir-4.2", + "title": "Dynamic Reconfiguration" + }, + { + "control_id": "ir-4.6", + "title": "Insider Threats" + }, { "control_id": "ps-4", "title": "Personnel Termination" @@ -1093,6 +1450,30 @@ { "control_id": "ps-8", "title": "Personnel Sanctions" + }, + { + "control_id": "si-4", + "title": "System Monitoring" + }, + { + "control_id": "si-4.1", + "title": "System-wide Intrusion Detection System" + }, + { + "control_id": "si-4.19", + "title": "Risk for Individuals" + }, + { + "control_id": "si-4.20", + "title": "Privileged Users" + }, + { + "control_id": "si-4.22", + "title": "Unauthorized Network Services" + }, + { + "control_id": "si-4.4", + "title": "Inbound and Outbound Communications Traffic" } ] } @@ -1123,9 +1504,17 @@ "control_id": "ir-4.1", "title": "Automated Incident Handling Processes" }, + { + "control_id": "ir-5.1", + "title": "Automated Tracking, Data Collection, and Analysis" + }, { "control_id": "ir-8", "title": "Incident Response Plan" + }, + { + "control_id": "ir-9.3", + "title": "Post-spill Operations" } ] }, @@ -1146,6 +1535,10 @@ "control_id": "ir-4.1", "title": "Automated Incident Handling Processes" }, + { + "control_id": "ir-4.11", + "title": "Integrated Incident Response Team" + }, { "control_id": "ir-6", "title": "Incident Reporting" @@ -1174,6 +1567,10 @@ "control_id": "ir-8.1", "title": "Breaches" }, + { + "control_id": "ir-9.3", + "title": "Post-spill Operations" + }, { "control_id": "si-4.5", "title": "System-generated Alerts" @@ -1201,13 +1598,29 @@ "control_id": "ir-4.1", "title": "Automated Incident Handling Processes" }, + { + "control_id": "ir-4.11", + "title": "Integrated Incident Response Team" + }, + { + "control_id": "ir-4.4", + "title": "Information Correlation" + }, { "control_id": "ir-5", "title": "Incident Monitoring" }, + { + "control_id": "ir-5.1", + "title": "Automated Tracking, Data Collection, and Analysis" + }, { "control_id": "ir-8", "title": "Incident Response Plan" + }, + { + "control_id": "ra-5.8", + "title": "Review Historic Audit Logs" } ] } @@ -1226,6 +1639,14 @@ "moderate": true }, "controls": [ + { + "control_id": "au-12.3", + "title": "Changes by Authorized Individuals" + }, + { + "control_id": "au-6.7", + "title": "Permitted Actions" + }, { "control_id": "si-11", "title": "Error Handling" @@ -1241,6 +1662,10 @@ "moderate": true }, "controls": [ + { + "control_id": "ac-19", + "title": "Access Control for Mobile Devices" + }, { "control_id": "ca-7", "title": "Continuous Monitoring" @@ -1253,6 +1678,14 @@ "control_id": "cm-6", "title": "Configuration Settings" }, + { + "control_id": "cm-6.1", + "title": "Automated Management, Application, and Verification" + }, + { + "control_id": "ra-3", + "title": "Risk Assessment" + }, { "control_id": "si-7.7", "title": "Integration of Detection and Response" @@ -1268,33 +1701,57 @@ "moderate": true }, "controls": [ + { + "control_id": "ac-17.1", + "title": "Monitoring and Control" + }, { "control_id": "ac-2.4", "title": "Automated Audit Actions" }, + { + "control_id": "ac-20.1", + "title": "Limits on Authorized Use" + }, { "control_id": "ac-6.9", "title": "Log Use of Privileged Functions" }, { - "control_id": "ac-17.1", - "title": "Monitoring and Control" + "control_id": "au-10", + "title": "Non-repudiation" + }, + { + "control_id": "au-12", + "title": "Audit Record Generation" + }, + { + "control_id": "au-2", + "title": "Event Logging" + }, + { + "control_id": "au-7", + "title": "Audit Record Reduction and Report Generation" + }, + { + "control_id": "au-7.1", + "title": "Automatic Processing" }, { - "control_id": "ac-20.1", - "title": "Limits on Authorized Use" + "control_id": "cm-5.1", + "title": "Automated Access Enforcement and Audit Records" }, { - "control_id": "au-2", - "title": "Event Logging" + "control_id": "ir-9.4", + "title": "Exposure to Unauthorized Personnel" }, { - "control_id": "au-7.1", - "title": "Automatic Processing" + "control_id": "si-4.19", + "title": "Risk for Individuals" }, { - "control_id": "au-12", - "title": "Audit Record Generation" + "control_id": "si-4.20", + "title": "Privileged Users" }, { "control_id": "si-4.4", @@ -1327,6 +1784,14 @@ "control_id": "ac-20.1", "title": "Limits on Authorized Use" }, + { + "control_id": "au-11", + "title": "Audit Record Retention" + }, + { + "control_id": "au-12.1", + "title": "System-wide and Time-correlated Audit Trail" + }, { "control_id": "au-2", "title": "Event Logging" @@ -1347,6 +1812,10 @@ "control_id": "au-5", "title": "Response to Audit Logging Process Failures" }, + { + "control_id": "au-5.1", + "title": "Storage Capacity Warning" + }, { "control_id": "au-6.1", "title": "Automated Process Integration" @@ -1355,6 +1824,14 @@ "control_id": "au-6.3", "title": "Correlate Audit Record Repositories" }, + { + "control_id": "au-6.4", + "title": "Central Review and Analysis" + }, + { + "control_id": "au-6.5", + "title": "Integrated Analysis of Audit Records" + }, { "control_id": "au-7", "title": "Audit Record Reduction and Report Generation" @@ -1371,14 +1848,14 @@ "control_id": "au-9", "title": "Protection of Audit Information" }, - { - "control_id": "au-11", - "title": "Audit Record Retention" - }, { "control_id": "ir-4.1", "title": "Automated Incident Handling Processes" }, + { + "control_id": "si-4.16", + "title": "Correlate Monitoring Information" + }, { "control_id": "si-4.2", "title": "Automated Tools and Mechanisms for Real-time Analysis" @@ -1386,10 +1863,6 @@ { "control_id": "si-4.4", "title": "Inbound and Outbound Communications Traffic" - }, - { - "control_id": "si-7.7", - "title": "Integration of Detection and Response" } ] }, @@ -1422,10 +1895,22 @@ "control_id": "au-6.1", "title": "Automated Process Integration" }, + { + "control_id": "au-7", + "title": "Audit Record Reduction and Report Generation" + }, + { + "control_id": "ra-5.8", + "title": "Review Historic Audit Logs" + }, { "control_id": "si-4", "title": "System Monitoring" }, + { + "control_id": "si-4.19", + "title": "Risk for Individuals" + }, { "control_id": "si-4.4", "title": "Inbound and Outbound Communications Traffic" @@ -1447,13 +1932,21 @@ "moderate": true }, "controls": [ + { + "control_id": "cm-12", + "title": "Information Location" + }, + { + "control_id": "cm-12.1", + "title": "Automated Tools to Support Information Location" + }, { "control_id": "cm-2.2", "title": "Automation Support for Accuracy and Currency" }, { "control_id": "cm-7.5", - "title": "Authorized Software \u2014 Allow-by-exception" + "title": "Authorized Software — Allow-by-exception" }, { "control_id": "cm-8", @@ -1464,12 +1957,12 @@ "title": "Updates During Installation and Removal" }, { - "control_id": "cm-12", - "title": "Information Location" + "control_id": "cm-8.2", + "title": "Automated Maintenance" }, { - "control_id": "cm-12.1", - "title": "Automated Tools to Support Information Location" + "control_id": "cm-8.4", + "title": "Accountability Information" }, { "control_id": "cp-2.8", @@ -1504,6 +1997,10 @@ "control_id": "ca-2", "title": "Control Assessments" }, + { + "control_id": "ca-2.2", + "title": "Specialized Assessments" + }, { "control_id": "cp-2.1", "title": "Coordinate with Related Plans" @@ -1516,6 +2013,10 @@ "control_id": "ir-3.2", "title": "Coordination with Related Plans" }, + { + "control_id": "ir-4.11", + "title": "Integrated Incident Response Team" + }, { "control_id": "pm-3", "title": "Information Security and Privacy Resources" @@ -1555,6 +2056,10 @@ "control_id": "cm-3.4", "title": "Security and Privacy Representatives" }, + { + "control_id": "ia-5.7", + "title": "No Embedded Unencrypted Static Authenticators" + }, { "control_id": "pl-8", "title": "Security and Privacy Architectures" @@ -1563,6 +2068,10 @@ "control_id": "pm-7", "title": "Enterprise Architecture" }, + { + "control_id": "ra-9", + "title": "Criticality Analysis" + }, { "control_id": "sa-3", "title": "System Development Life Cycle" @@ -1571,14 +2080,14 @@ "control_id": "sa-8", "title": "Security and Privacy Engineering Principles" }, - { - "control_id": "sc-4", - "title": "Information in Shared System Resources" - }, { "control_id": "sc-18", "title": "Mobile Code" }, + { + "control_id": "sc-4", + "title": "Information in Shared System Resources" + }, { "control_id": "si-10", "title": "Information Input Validation" @@ -1642,10 +2151,6 @@ { "control_id": "cp-10.2", "title": "Transaction Recovery" - }, - { - "control_id": "si-12", - "title": "Information Management and Retention" } ] }, @@ -1752,6 +2257,10 @@ "moderate": true }, "controls": [ + { + "control_id": "cp-10", + "title": "System Recovery and Reconstitution" + }, { "control_id": "cp-2.1", "title": "Coordinate with Related Plans" @@ -1780,10 +2289,6 @@ "control_id": "cp-9.1", "title": "Testing for Reliability and Integrity" }, - { - "control_id": "cp-10", - "title": "System Recovery and Reconstitution" - }, { "control_id": "ir-3", "title": "Incident Response Testing" @@ -1791,6 +2296,14 @@ { "control_id": "ir-3.2", "title": "Coordination with Related Plans" + }, + { + "control_id": "ir-9.3", + "title": "Post-spill Operations" + }, + { + "control_id": "sc-12.1", + "title": "Availability" } ] } @@ -1803,23 +2316,31 @@ { "id": "KSI-SCR-MIT", "name": "Mitigating Supply Chain Risk", - "statement": "Persistently identify, review, and mitigate potential supply chain risks.", + "statement": "Potential supply chain risks are persistently identified, reviewed, and mitigated.", "impact": { "low": true, "moderate": true }, "controls": [ + { + "control_id": "ac-19", + "title": "Access Control for Mobile Devices" + }, { "control_id": "ac-20", "title": "Use of External Systems" }, { - "control_id": "ra-3.1", - "title": "Supply Chain Risk Assessment" + "control_id": "ca-7.4", + "title": "Risk Monitoring" }, { - "control_id": "sa-9", - "title": "External System Services" + "control_id": "ra-3", + "title": "Risk Assessment" + }, + { + "control_id": "ra-3.1", + "title": "Supply Chain Risk Assessment" }, { "control_id": "sa-10", @@ -1829,33 +2350,101 @@ "control_id": "sa-11", "title": "Developer Testing and Evaluation" }, + { + "control_id": "sa-11.1", + "title": "Static Code Analysis" + }, + { + "control_id": "sa-11.2", + "title": "Threat Modeling and Vulnerability Analyses" + }, + { + "control_id": "sa-15", + "title": "Development Process, Standards, and Tools" + }, { "control_id": "sa-15.3", "title": "Criticality Analysis" }, + { + "control_id": "sa-16", + "title": "Developer-provided Training" + }, + { + "control_id": "sa-17", + "title": "Developer Security and Privacy Architecture and Design" + }, + { + "control_id": "sa-21", + "title": "Developer Screening" + }, { "control_id": "sa-22", "title": "Unsupported System Components" }, { - "control_id": "si-7.1", - "title": "Integrity Checks" + "control_id": "sa-4", + "title": "Acquisition Process" }, { - "control_id": "sr-5", - "title": "Acquisition Strategies, Tools, and Methods" + "control_id": "sa-4.1", + "title": "Functional Properties of Controls" }, { - "control_id": "sr-6", - "title": "Supplier Assessments and Reviews" + "control_id": "sa-4.2", + "title": "Design and Implementation Information for Controls" }, { - "control_id": "ca-7.4", - "title": "Risk Monitoring" + "control_id": "sa-4.5", + "title": "System, Component, and Service Configurations" + }, + { + "control_id": "sa-4.9", + "title": "Functions, Ports, Protocols, and Services in Use" + }, + { + "control_id": "sa-9", + "title": "External System Services" + }, + { + "control_id": "sa-9.1", + "title": "Risk Assessments and Organizational Approvals" + }, + { + "control_id": "sa-9.2", + "title": "Identification of Functions, Ports, Protocols, and Services" + }, + { + "control_id": "sa-9.5", + "title": "Processing, Storage, and Service Location" }, { "control_id": "sc-18", "title": "Mobile Code" + }, + { + "control_id": "si-7.1", + "title": "Integrity Checks" + }, + { + "control_id": "si-7.15", + "title": "Code Authentication" + }, + { + "control_id": "sr-2", + "title": "Supply Chain Risk Management Plan" + }, + { + "control_id": "sr-3", + "title": "Supply Chain Controls and Processes" + }, + { + "control_id": "sr-5", + "title": "Acquisition Strategies, Tools, and Methods" + }, + { + "control_id": "sr-6", + "title": "Supplier Assessments and Reviews" } ] }, @@ -1868,10 +2457,18 @@ "moderate": true }, "controls": [ + { + "control_id": "ac-19", + "title": "Access Control for Mobile Devices" + }, { "control_id": "ac-20", "title": "Use of External Systems" }, + { + "control_id": "ca-2.3", + "title": "Leveraging Results from External Organizations" + }, { "control_id": "ca-3", "title": "Information Exchange" @@ -1884,6 +2481,10 @@ "control_id": "ps-7", "title": "External Personnel Security" }, + { + "control_id": "ra-3", + "title": "Risk Assessment" + }, { "control_id": "ra-5", "title": "Vulnerability Monitoring and Scanning" @@ -1896,6 +2497,10 @@ "control_id": "si-5", "title": "Security Alerts, Advisories, and Directives" }, + { + "control_id": "sr-3", + "title": "Supply Chain Controls and Processes" + }, { "control_id": "sr-5", "title": "Acquisition Strategies, Tools, and Methods" @@ -1929,6 +2534,10 @@ "control_id": "ac-2.4", "title": "Automated Audit Actions" }, + { + "control_id": "ac-6.8", + "title": "Privilege Levels for Code Execution" + }, { "control_id": "cm-2", "title": "Baseline Configuration" @@ -1949,18 +2558,30 @@ "control_id": "cm-7.1", "title": "Periodic Review" }, - { - "control_id": "pl-9", - "title": "Central Management" - }, { "control_id": "pl-10", "title": "Baseline Selection" }, + { + "control_id": "pl-9", + "title": "Central Management" + }, { "control_id": "sa-5", "title": "System Documentation" }, + { + "control_id": "sc-45", + "title": "System Time Synchronization" + }, + { + "control_id": "sc-45.1", + "title": "Synchronization with Authoritative Time Source" + }, + { + "control_id": "sc-7.18", + "title": "Fail Secure" + }, { "control_id": "si-5", "title": "Security Alerts, Advisories, and Directives" @@ -1996,6 +2617,10 @@ "control_id": "sc-12", "title": "Cryptographic Key Establishment and Management" }, + { + "control_id": "sc-12.1", + "title": "Availability" + }, { "control_id": "sc-17", "title": "Public Key Infrastructure Certificates" @@ -2012,29 +2637,41 @@ }, "controls": [ { - "control_id": "cm-7.1", - "title": "Periodic Review" + "control_id": "ca-7.4", + "title": "Risk Monitoring" }, { "control_id": "cm-12.1", "title": "Automated Tools to Support Information Location" }, { - "control_id": "ma-2", - "title": "Controlled Maintenance" + "control_id": "cm-5.5", + "title": "Privilege Limitation for Production and Operation" + }, + { + "control_id": "cm-7.1", + "title": "Periodic Review" + }, + { + "control_id": "ir-9.4", + "title": "Exposure to Unauthorized Personnel" }, { "control_id": "pl-8", "title": "Security and Privacy Architectures" }, { - "control_id": "sc-7", - "title": "Boundary Protection" + "control_id": "ra-3", + "title": "Risk Assessment" }, { "control_id": "sc-39", "title": "Process Isolation" }, + { + "control_id": "sc-7", + "title": "Boundary Protection" + }, { "control_id": "si-2.2", "title": "Automated Flaw Remediation Status" @@ -2058,9 +2695,25 @@ "moderate": true }, "controls": [ + { + "control_id": "ac-19", + "title": "Access Control for Mobile Devices" + }, + { + "control_id": "ir-9.4", + "title": "Exposure to Unauthorized Personnel" + }, + { + "control_id": "sc-12.1", + "title": "Availability" + }, { "control_id": "sc-4", "title": "Information in Shared System Resources" + }, + { + "control_id": "sc-7.18", + "title": "Fail Secure" } ] }, @@ -2073,6 +2726,10 @@ "moderate": true }, "controls": [ + { + "control_id": "ir-9", + "title": "Information Spillage Response" + }, { "control_id": "si-12.3", "title": "Information Disposal" @@ -2080,6 +2737,14 @@ { "control_id": "si-18.4", "title": "Individual Requests" + }, + { + "control_id": "si-8", + "title": "Spam Protection" + }, + { + "control_id": "si-8.2", + "title": "Automatic Updates" } ] }, @@ -2093,25 +2758,33 @@ }, "controls": [ { - "control_id": "ac-1", - "title": "Policy and Procedures" + "control_id": "ac-11", + "title": "Device Lock" + }, + { + "control_id": "ac-11.1", + "title": "Pattern-hiding Displays" }, { "control_id": "ac-17.2", "title": "Protection of Confidentiality and Integrity Using Encryption" }, { - "control_id": "cp-9.8", - "title": "Cryptographic Protection" + "control_id": "ac-19.5", + "title": "Full Device or Container-based Encryption" }, { - "control_id": "sc-8", - "title": "Transmission Confidentiality and Integrity" + "control_id": "ac-21", + "title": "Information Sharing" }, { - "control_id": "sc-8.1", + "control_id": "cp-9.8", "title": "Cryptographic Protection" }, + { + "control_id": "ir-9.4", + "title": "Exposure to Unauthorized Personnel" + }, { "control_id": "sc-13", "title": "Cryptographic Protection" @@ -2139,6 +2812,26 @@ { "control_id": "sc-28.1", "title": "Cryptographic Protection" + }, + { + "control_id": "sc-4", + "title": "Information in Shared System Resources" + }, + { + "control_id": "sc-7.18", + "title": "Fail Secure" + }, + { + "control_id": "sc-8", + "title": "Transmission Confidentiality and Integrity" + }, + { + "control_id": "sc-8.1", + "title": "Cryptographic Protection" + }, + { + "control_id": "si-4.18", + "title": "Analyze Traffic and Covert Exfiltration" } ] }, @@ -2151,10 +2844,30 @@ "moderate": true }, "controls": [ + { + "control_id": "ac-10", + "title": "Concurrent Session Control" + }, + { + "control_id": "ac-17.4", + "title": "Privileged Commands and Access" + }, + { + "control_id": "ac-18", + "title": "Wireless Access" + }, + { + "control_id": "ac-19", + "title": "Access Control for Mobile Devices" + }, { "control_id": "sc-23", "title": "Session Authenticity" }, + { + "control_id": "si-4.22", + "title": "Unauthorized Network Services" + }, { "control_id": "si-7.1", "title": "Integrity Checks" @@ -2170,6 +2883,26 @@ "moderate": true }, "controls": [ + { + "control_id": "ac-17.4", + "title": "Privileged Commands and Access" + }, + { + "control_id": "ac-18", + "title": "Wireless Access" + }, + { + "control_id": "ac-19", + "title": "Access Control for Mobile Devices" + }, + { + "control_id": "au-9.3", + "title": "Cryptographic Protection" + }, + { + "control_id": "cm-14", + "title": "Signed Components" + }, { "control_id": "cm-2.2", "title": "Automation Support for Accuracy and Currency" @@ -2194,9 +2927,17 @@ "control_id": "si-7.1", "title": "Integrity Checks" }, + { + "control_id": "si-7.15", + "title": "Code Authentication" + }, { "control_id": "sr-10", "title": "Inspection of Systems or Components" + }, + { + "control_id": "sr-11", + "title": "Component Authenticity" } ] } diff --git a/scripts/sync-ksi-catalog.py b/scripts/sync-ksi-catalog.py new file mode 100644 index 00000000..199c3a8d --- /dev/null +++ b/scripts/sync-ksi-catalog.py @@ -0,0 +1,95 @@ +#!/usr/bin/env python3 +"""Keep infrastructure/schemas/ksi-catalog.json equal to the pinned FedRAMP rules. + +The catalog's KSI block (IDs, names, statements and KSI->control mappings) is +FedRAMP's, so it is derived from the vendored, hash-checked Consolidated Rules +(scripts/_rules.py), never edited by hand. FedRAMP revises mappings between +releases (for example on 2026-10-13); re-pinning the rules and re-running this +script carries the change, and tests/test_ksi_catalog_corpus.py fails while +the two disagree. + +Control titles come from the vendored NIST SP 800-53 Rev5 catalog. The per-KSI impact flags are the catalog's +own (the corpus does not carry them) and are kept. + + sync-ksi-catalog.py rewrite the catalog + sync-ksi-catalog.py --check exit 1 if it differs from the corpus +""" + +import argparse +import json +import sys +from pathlib import Path + +sys.path.insert(0, str(Path(__file__).resolve().parent)) +import _rules # noqa: E402 + +REPO = Path(__file__).resolve().parent.parent +CATALOG = REPO / "infrastructure" / "schemas" / "ksi-catalog.json" +NIST = REPO / "data" / "catalogs" / "NIST_SP-800-53_rev5_catalog.json" + + +def _fail(msg): + raise SystemExit(f"::error::KSI catalog: {msg} (fail-closed)") + + +def _titles(): + out = {} + + def walk(group): + for c in group.get("controls", []) or []: + out[c["id"]] = c["title"] + walk(c) + for g in group.get("groups", []) or []: + walk(g) + walk(json.loads(NIST.read_text())["catalog"]) + return out + + +def derive(catalog, rules_dir=_rules.RULES_DIR): + """The catalog with its KSI block rebuilt from the pinned corpus.""" + rules, _ = _rules.load_rules(rules_dir) + titles = _titles() + old_impact = {i["id"]: i.get("impact") for f in catalog.get("KSI", {}).values() + for i in f.get("indicators", [])} + ksi = {} + for fam_id, fam in rules["KSI"].items(): + indicators = [] + for kid, k in fam["indicators"].items(): + controls = [] + for c in k.get("controls", []) or []: + cid = str(c).lower() + if cid not in titles: + _fail(f"{kid} maps {cid}, which is not in the NIST SP 800-53 Rev5 catalog") + controls.append({"control_id": cid, "title": titles[cid]}) + if kid not in old_impact: + _fail(f"{kid} is new in the corpus; set its impact flags in the catalog first") + # Class C's statement where the KSI varies by class (five do). + statement = ((k.get("varies_by_class") or {}).get(_rules.CERT_CLASS) or k).get("statement") + if not isinstance(statement, str): + _fail(f"{kid} has no Class {_rules.CERT_CLASS.upper()} statement") + indicators.append({"id": kid, "name": k["name"], "statement": statement, + "impact": old_impact[kid], "controls": controls}) + ksi[fam_id] = {"id": fam["id"], "name": fam["name"], "indicators": indicators} + out = dict(catalog) + out["KSI"] = ksi + return out + + +def main(argv=None): + ap = argparse.ArgumentParser() + ap.add_argument("--check", action="store_true") + a = ap.parse_args(argv) + current = json.loads(CATALOG.read_text()) + want = derive(current) + if a.check: + if want != current: + print("::error::infrastructure/schemas/ksi-catalog.json differs from the pinned FedRAMP rules; " + "run scripts/sync-ksi-catalog.py and review the diff") + return 1 + return 0 + CATALOG.write_text(json.dumps(want, indent=2, ensure_ascii=False) + "\n") + return 0 + + +if __name__ == "__main__": + raise SystemExit(main()) diff --git a/tests/fixtures/migration/ksi-catalog-2026-11-05.json b/tests/fixtures/migration/ksi-catalog-2026-11-05.json new file mode 100644 index 00000000..7353e477 --- /dev/null +++ b/tests/fixtures/migration/ksi-catalog-2026-11-05.json @@ -0,0 +1,2206 @@ +{ + "$schema": "https://json-schema.org/draft/2020-12/schema", + "$id": "FedRAMP.schema.json", + "info": { + "name": "Key Security Indicators", + "short_name": "KSI", + "effective": { + "rev5": { + "is": "no" + }, + "20x": { + "is": "required", + "signup_url": "https://www.fedramp.gov/20x/phase-two/participate/", + "current_status": "Phase 2 Pilot", + "start_date": "2025-11-18", + "end_date": "2026-03-31", + "comments": [ + "Phase 1 pilot authorizations have one year from authorization to fully address this process but must demonstrate continuous quarterly progress.", + "Phase 2 Pilot participants must demonstrate significant progress towards addressing this process prior to submission for authorization review." + ] + } + }, + "releases": [ + { + "id": "26.06", + "published_date": "2026-06-24", + "description": "Consolidated Rules for 2026 (official launch). Key Security Indicators renumbered to mnemonic IDs; the AFR (Authorization by FedRAMP) family was retired and TPR (Third-Party) was renamed SCR (Supply Chain Risk). Rebuilt from the published markdown corpus by scripts/staged/build-ksi-catalog.py." + }, + { + "id": "25.12A", + "published_date": "2025-12-29", + "description": "This release updates a significant number of KSIs to improve clarity and expectations; in general the measures required to meet each KSI remain unchanged but these updates should make it easier to address them. In additional, some KSIs have been retired.", + "public_comment": false + }, + { + "id": "25.11C", + "published_date": "2025-12-01", + "description": "No effective/material changes; adjusted some KSI-AFR indcators to reference \"process\" instead of \"standard\" and added a note to KSI-AFR-02 addressing the potential infinite loop.", + "public_comment": false, + "machine_readable_link": "https://raw.githubusercontent.com/FedRAMP/docs/ced2160b22455ed26a11bf697be8f0ae3e1e5dff/data/FRMR.KSI.key-security-indicators.json" + }, + { + "id": "25.11B", + "published_date": "2025-11-24", + "description": "No material changes to content; updated JSON structure with additional information about Rev5 application added.", + "public_comment": false, + "machine_readable_link": "https://raw.githubusercontent.com/FedRAMP/docs/a37618fccf49d6b3406d90edf2125dc6cfcba140/data/FRMR.KSI.key-security-indicators.json" + }, + { + "id": "25.11A", + "published_date": "2025-11-18", + "description": "Updates Key Security Indicators for the FedRAMP 20x Phase Two pilot, including underlying structural changes to machine-readable docs; Renamed KSI \"indicator\" property to \"theme\" and KSI \"requirements\" property to \"indicators\" to match current naming conventions..", + "public_comment": true, + "related_rfcs": [ + { + "start_date": "2025-09-10", + "end_date": "2025-11-17", + "id": "0015", + "url": "https://www.fedramp.gov/rfcs/0015/", + "discussion_url": "https://github.com/FedRAMP/community/discussions/84", + "short_name": "rfc-0015-recommended-secure-configuration", + "full_name": "FedRAMP RFC-0015: Recommended Secure Configuration Standard" + } + ], + "machine_readable_link": "https://raw.githubusercontent.com/FedRAMP/docs/3291fa1952f5b68eaf1a815a8ef1846ae8ca9e2f/data/FRMR.KSI.key-security-indicators.json" + }, + { + "id": "25.10A", + "published_date": "2025-10-17", + "description": "Minor updates to improve clarity; switch from federal information to federal customer data; add impact level metadata; no substantive changes.", + "public_comment": false, + "machine_readable_link": null + }, + { + "id": "25.05D", + "published_date": "2025-08-24", + "description": "Minor non-breaking updates to align term definitions and highlighted terms across updated materials (no changes to KSIs, definitions are now in FRD-ALL).", + "public_comment": false, + "machine_readable_link": null + }, + { + "id": "25.05C", + "published_date": "2025-06-28", + "description": "Key Security Indicators in this release are unchanged from previously releases. 25.05C adds references for each KSI to underlying SP 800-53 controls.", + "public_comment": false, + "machine_readable_link": null + }, + { + "id": "25.05B", + "published_date": "2025-06-18", + "description": "Initial release of Key Security Indicators from 25.05; the previous 25.05A release contained errors during conversion to JSON that are fixed in this release, the KSIs should now be identical to the original 25.05 paper release of the KSIs released on 2025-05-30. FRR-KSI-AY rules were converted to FRR-KSI rules, but otherwise unchanged.", + "public_comment": false, + "machine_readable_link": null + }, + { + "id": "25.05A", + "published_date": "2025-05-30", + "description": "Initial release of Key Security Indicators", + "public_comment": true, + "related_rfcs": [ + { + "start_date": "2025-04-24", + "end_date": "2025-05-24", + "id": "0006", + "url": "https://www.fedramp.gov/rfcs/0006/", + "discussion_url": "https://github.com/FedRAMP/community/discussions/3", + "short_name": "rfc-0006-key-security-indicators", + "full_name": "FedRAMP RFC-0006: 20x Phase One Key Security Indicators" + } + ], + "machine_readable_link": null + } + ], + "front_matter": { + "authority": [ + { + "reference": "OMB Circular A-130", + "reference_url": "https://whitehouse.gov/wp-content/uploads/legacy_drupal_files/omb/circulars/A130/a130revised.pdf", + "description": "Appendix I states \"Agencies may also develop overlays for specific types of information or communities of interest (e.g., all web-based applications, all health care-related systems) as part of the security control selection process. Overlays provide a specification of security or privacy controls, control enhancements, supplemental guidance, and other supporting information as part of the tailoring process, that is intended to complement (and further refine) security control baselines. The overlay may be more stringent or less stringent than the original security control baseline and can be applied to multiple information systems.\"" + }, + { + "reference": "NIST SP 800-53B", + "reference_url": "https://csrc.nist.gov/pubs/sp/800/53/b/upd1/final", + "description": "Section 2.5 states \"As the number of controls in [SP 800-53] grows in response to an increasingly sophisticated threat space, it is important for organizations to have the ability to describe key capabilities needed to protect organizational missions and business functions, and to subsequently select controls that\u2014if properly designed, developed, and implemented\u2014produce such capabilities. The use of capabilities simplifies how the protection problem is viewed conceptually. Using the construct of a capability provides a method of grouping controls that are employed for a common purpose or to achieve a common objective.\" This section later states \"Ultimately, authorization decisions (i.e., risk acceptance decisions) are made based on the degree to which the desired capabilities have been effectively achieved.\"" + }, + { + "reference": "NIST SP 800-53A", + "reference_url": "https://csrc.nist.gov/pubs/sp/800/53/a/r5/final", + "description": "Section 3.5 states \"When organizations employ the concept of capabilities, automated and manual assessments account for all security and privacy controls that comprise the security and privacy capabilities. Assessors are aware of how the controls work together to provide such capabilities.\"" + }, + { + "reference": "FedRAMP Authorization Act (44 USC \u00a7 3609 (a) (1))", + "reference_url": "https://fedramp.gov/docs/authority/law/#a-roles-and-responsibilities", + "description": "requires that the Administrator of the General Services Administration shall \"in consultation with the [DHS] Secretary, develop, coordinate, and implement a process to support agency review, reuse, and standardization, where appropriate, of security assessments of cloud computing products and services...\" 44 USC \u00a7 3609 (c) (2) further states that \"the [GSA] Administrator shall establish a means for the automation of security assessments and reviews.\"", + "delegation": "These responsibilities are delegated to the FedRAMP Director", + "delegation_url": "https://www.gsa.gov/directives-library/gsa-delegations-of-authority-fedramp" + } + ], + "purpose": "Modern cloud services use automated or code-driven configuration management and control planes to ensure predictable, repeatable, reliable, and secure outcomes during deployment and operation. The majority of a service security assessment can take place continuously via automated validation for simple cloud-native services if the need for a traditional control-by-control narrative approach is removed.", + "expected_outcomes": [ + "Cloud service providers following commercial security best practices will be able to meet and validate FedRAMP security requirements with the application of simple changes and automated capabilities", + "Third-party independent assessors will have a simpler framework to assess security and implementation decisions based on engineering decisions in context", + "Federal agencies will be able to easily, quickly, and effectively review and consume security information about the service to make informed risk-based authorization to operate decisions based on their planned use case" + ] + } + }, + "FRR.KSI": {}, + "KSI": { + "CED": { + "id": "KSI-CED", + "name": "Cybersecurity Education", + "indicators": [ + { + "id": "KSI-CED-RAT", + "name": "Reviewing All Training", + "statement": "The effectiveness of relevant cybersecurity education and training is persistently reviewed, including at least general training for all employees, role-specific training for employees in high risk roles, training for development and engineering staff on secure software delivery, and training for staff involved with incident response or disaster recovery.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [ + { + "control_id": "cp-3", + "title": "Contingency Training" + }, + { + "control_id": "ir-2", + "title": "Incident Response Training" + }, + { + "control_id": "ps-6", + "title": "Access Agreements" + }, + { + "control_id": "at-2", + "title": "Literacy Training and Awareness" + }, + { + "control_id": "at-2.2", + "title": "Insider Threat" + }, + { + "control_id": "at-2.3", + "title": "Social Engineering and Mining" + }, + { + "control_id": "at-3.5", + "title": "Processing Personally Identifiable Information" + }, + { + "control_id": "at-4", + "title": "Training Records" + }, + { + "control_id": "ir-2.3", + "title": "Breach" + }, + { + "control_id": "at-3", + "title": "Role-based Training" + }, + { + "control_id": "sr-11.1", + "title": "Anti-counterfeit Training" + } + ] + } + ] + }, + "CMT": { + "id": "KSI-CMT", + "name": "Change Management", + "indicators": [ + { + "id": "KSI-CMT-LMC", + "name": "Logging Changes", + "statement": "Modifications to the cloud service offering are logged and monitored.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [ + { + "control_id": "au-2", + "title": "Event Logging" + }, + { + "control_id": "cm-3", + "title": "Configuration Change Control" + }, + { + "control_id": "cm-3.2", + "title": "Testing, Validation, and Documentation of Changes" + }, + { + "control_id": "cm-4.2", + "title": "Verification of Controls" + }, + { + "control_id": "cm-6", + "title": "Configuration Settings" + }, + { + "control_id": "cm-8.3", + "title": "Automated Unauthorized Component Detection" + }, + { + "control_id": "ma-2", + "title": "Controlled Maintenance" + } + ] + }, + { + "id": "KSI-CMT-RMV", + "name": "Redeploying vs Modifying", + "statement": "Changes to machine-based information resources are executed through the redeployment of version controlled resources rather than direct modification wherever reasonable.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [ + { + "control_id": "cm-2", + "title": "Baseline Configuration" + }, + { + "control_id": "cm-3", + "title": "Configuration Change Control" + }, + { + "control_id": "cm-5", + "title": "Access Restrictions for Change" + }, + { + "control_id": "cm-6", + "title": "Configuration Settings" + }, + { + "control_id": "cm-7", + "title": "Least Functionality" + }, + { + "control_id": "cm-8.1", + "title": "Updates During Installation and Removal" + }, + { + "control_id": "si-3", + "title": "Malicious Code Protection" + } + ] + }, + { + "id": "KSI-CMT-RVP", + "name": "Reviewing Change Procedures", + "statement": "The effectiveness of documented change management procedures is persistently reviewed.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [ + { + "control_id": "cm-3", + "title": "Configuration Change Control" + }, + { + "control_id": "cm-3.2", + "title": "Testing, Validation, and Documentation of Changes" + }, + { + "control_id": "cm-3.4", + "title": "Security and Privacy Representatives" + }, + { + "control_id": "cm-5", + "title": "Access Restrictions for Change" + }, + { + "control_id": "cm-7.1", + "title": "Periodic Review" + }, + { + "control_id": "cm-9", + "title": "Configuration Management Plan" + } + ] + }, + { + "id": "KSI-CMT-VTD", + "name": "Validating Throughout Deployment", + "statement": "Persistent testing and validation of changes throughout deployment is automated.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [ + { + "control_id": "cm-3", + "title": "Configuration Change Control" + }, + { + "control_id": "cm-3.2", + "title": "Testing, Validation, and Documentation of Changes" + }, + { + "control_id": "cm-4.2", + "title": "Verification of Controls" + }, + { + "control_id": "si-2", + "title": "Flaw Remediation" + } + ] + } + ] + }, + "CNA": { + "id": "KSI-CNA", + "name": "Cloud Native Architecture", + "indicators": [ + { + "id": "KSI-CNA-DFP", + "name": "Defining Functionality and Privileges", + "statement": "The functionality and privileges for infrastructure and services are strictly defined.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [ + { + "control_id": "cm-2", + "title": "Baseline Configuration" + }, + { + "control_id": "si-3", + "title": "Malicious Code Protection" + } + ] + }, + { + "id": "KSI-CNA-EIS", + "name": "Enforcing Intended State", + "statement": "Automated services are used to persistently assess the security of all machine-based information resources and automatically enforce their intended operational state.", + "impact": { + "low": false, + "moderate": true + }, + "controls": [ + { + "control_id": "ca-2.1", + "title": "Independent Assessors" + }, + { + "control_id": "ca-7.1", + "title": "Independent Assessment" + } + ] + }, + { + "id": "KSI-CNA-IBP", + "name": "Implementing Best Practices", + "statement": "The use and configuration of third-party machine-based information resources is persistently compared against the original provider's best practices and guidance.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [ + { + "control_id": "ac-17.3", + "title": "Managed Access Control Points" + }, + { + "control_id": "cm-2", + "title": "Baseline Configuration" + }, + { + "control_id": "pl-10", + "title": "Baseline Selection" + } + ] + }, + { + "id": "KSI-CNA-MAT", + "name": "Minimizing Attack Surface", + "statement": "Machine-based information resources are persistently reviewed to ensure they have a minimal attack surface and that lateral movement is minimized if compromised.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [ + { + "control_id": "ac-17.3", + "title": "Managed Access Control Points" + }, + { + "control_id": "ac-18.1", + "title": "Authentication and Encryption" + }, + { + "control_id": "ac-18.3", + "title": "Disable Wireless Networking" + }, + { + "control_id": "ac-20.1", + "title": "Limits on Authorized Use" + }, + { + "control_id": "ca-9", + "title": "Internal System Connections" + }, + { + "control_id": "sc-7.3", + "title": "Access Points" + }, + { + "control_id": "sc-7.4", + "title": "External Telecommunications Services" + }, + { + "control_id": "sc-7.5", + "title": "Deny by Default \u2014 Allow by Exception" + }, + { + "control_id": "sc-7.8", + "title": "Route Traffic to Authenticated Proxy Servers" + }, + { + "control_id": "sc-8", + "title": "Transmission Confidentiality and Integrity" + }, + { + "control_id": "sc-10", + "title": "Network Disconnect" + }, + { + "control_id": "si-10", + "title": "Information Input Validation" + }, + { + "control_id": "si-11", + "title": "Error Handling" + }, + { + "control_id": "si-16", + "title": "Memory Protection" + } + ] + }, + { + "id": "KSI-CNA-OFA", + "name": "Optimizing for Availability", + "statement": "Machine-based information resources are persistently reviewed to ensure they are appropriately optimized for high availability and rapid recovery.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [] + }, + { + "id": "KSI-CNA-RNT", + "name": "Restricting Network Traffic", + "statement": "Machine-based information resources are persistently reviewed to ensure they are appropriately configured to limit inbound and outbound network traffic.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [ + { + "control_id": "ac-17.3", + "title": "Managed Access Control Points" + }, + { + "control_id": "ca-9", + "title": "Internal System Connections" + }, + { + "control_id": "cm-7.1", + "title": "Periodic Review" + }, + { + "control_id": "sc-7.5", + "title": "Deny by Default \u2014 Allow by Exception" + }, + { + "control_id": "si-8", + "title": "Spam Protection" + } + ] + }, + { + "id": "KSI-CNA-RVP", + "name": "Reviewing Protections", + "statement": "The effectiveness of protection against denial of service attacks and other unwanted activity for machine-based information resources is persistently reviewed.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [ + { + "control_id": "sc-5", + "title": "Denial-of-service Protection" + }, + { + "control_id": "si-8", + "title": "Spam Protection" + }, + { + "control_id": "si-8.2", + "title": "Automatic Updates" + } + ] + }, + { + "id": "KSI-CNA-ULN", + "name": "Using Logical Networking", + "statement": "Logical networking and related capabilities are used and persistently reviewed to enforce traffic flow controls.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [ + { + "control_id": "ac-12", + "title": "Session Termination" + }, + { + "control_id": "ac-17.3", + "title": "Managed Access Control Points" + }, + { + "control_id": "ca-9", + "title": "Internal System Connections" + }, + { + "control_id": "sc-4", + "title": "Information in Shared System Resources" + }, + { + "control_id": "sc-7", + "title": "Boundary Protection" + }, + { + "control_id": "sc-7.7", + "title": "Split Tunneling for Remote Devices" + }, + { + "control_id": "sc-8", + "title": "Transmission Confidentiality and Integrity" + }, + { + "control_id": "sc-10", + "title": "Network Disconnect" + } + ] + } + ] + }, + "IAM": { + "id": "KSI-IAM", + "name": "Identity and Access Management", + "indicators": [ + { + "id": "KSI-IAM-AAM", + "name": "Automating Account Management", + "statement": "The lifecycle and privileges of all accounts, roles, and groups are securely managed using automation.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [ + { + "control_id": "ac-2.2", + "title": "Automated Temporary and Emergency Account Management" + }, + { + "control_id": "ac-2.3", + "title": "Disable Accounts" + }, + { + "control_id": "ac-2.13", + "title": "Disable Accounts for High-risk Individuals" + }, + { + "control_id": "ac-6.7", + "title": "Review of User Privileges" + }, + { + "control_id": "ia-4.4", + "title": "Identify User Status" + }, + { + "control_id": "ia-12", + "title": "Identity Proofing" + }, + { + "control_id": "ia-12.2", + "title": "Identity Evidence" + }, + { + "control_id": "ia-12.3", + "title": "Identity Evidence Validation and Verification" + }, + { + "control_id": "ia-12.5", + "title": "Address Confirmation" + } + ] + }, + { + "id": "KSI-IAM-APM", + "name": "Adopting Passwordless Methods", + "statement": "Secure passwordless methods are used for user authentication and authorization when feasible, otherwise strong passwords with phishing-resistant MFA is used.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [ + { + "control_id": "ac-3", + "title": "Access Enforcement" + }, + { + "control_id": "ia-5.1", + "title": "Password-based Authentication" + }, + { + "control_id": "ia-5.2", + "title": "Public Key-based Authentication" + }, + { + "control_id": "ia-5.6", + "title": "Protection of Authenticators" + }, + { + "control_id": "ia-6", + "title": "Authentication Feedback" + }, + { + "control_id": "ac-2", + "title": "Account Management" + }, + { + "control_id": "ia-2", + "title": "Identification and Authentication (Organizational Users)" + }, + { + "control_id": "ia-2.1", + "title": "Multi-factor Authentication to Privileged Accounts" + }, + { + "control_id": "ia-2.2", + "title": "Multi-factor Authentication to Non-privileged Accounts" + }, + { + "control_id": "ia-2.8", + "title": "Access to Accounts \u2014 Replay Resistant" + }, + { + "control_id": "ia-5", + "title": "Authenticator Management" + }, + { + "control_id": "ia-8", + "title": "Identification and Authentication (Non-organizational Users)" + }, + { + "control_id": "sc-23", + "title": "Session Authenticity" + } + ] + }, + { + "id": "KSI-IAM-ELP", + "name": "Ensuring Least Privilege", + "statement": "Identity and access management measures are used and persistently reviewed to ensure each user or device can only access the resources they need.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [ + { + "control_id": "ac-2.5", + "title": "Inactivity Logout" + }, + { + "control_id": "ac-2.6", + "title": "Dynamic Privilege Management" + }, + { + "control_id": "ac-3", + "title": "Access Enforcement" + }, + { + "control_id": "ac-4", + "title": "Information Flow Enforcement" + }, + { + "control_id": "ac-6", + "title": "Least Privilege" + }, + { + "control_id": "ac-12", + "title": "Session Termination" + }, + { + "control_id": "ac-14", + "title": "Permitted Actions Without Identification or Authentication" + }, + { + "control_id": "ac-17", + "title": "Remote Access" + }, + { + "control_id": "ac-17.1", + "title": "Monitoring and Control" + }, + { + "control_id": "ac-17.2", + "title": "Protection of Confidentiality and Integrity Using Encryption" + }, + { + "control_id": "ac-17.3", + "title": "Managed Access Control Points" + }, + { + "control_id": "ac-20", + "title": "Use of External Systems" + }, + { + "control_id": "ac-20.1", + "title": "Limits on Authorized Use" + }, + { + "control_id": "cm-2.7", + "title": "Configure Systems and Components for High-risk Areas" + }, + { + "control_id": "cm-9", + "title": "Configuration Management Plan" + }, + { + "control_id": "ia-2", + "title": "Identification and Authentication (Organizational Users)" + }, + { + "control_id": "ia-3", + "title": "Device Identification and Authentication" + }, + { + "control_id": "ia-4", + "title": "Identifier Management" + }, + { + "control_id": "ia-4.4", + "title": "Identify User Status" + }, + { + "control_id": "ia-5.2", + "title": "Public Key-based Authentication" + }, + { + "control_id": "ia-5.6", + "title": "Protection of Authenticators" + }, + { + "control_id": "ia-11", + "title": "Re-authentication" + }, + { + "control_id": "ps-2", + "title": "Position Risk Designation" + }, + { + "control_id": "ps-3", + "title": "Personnel Screening" + }, + { + "control_id": "ps-4", + "title": "Personnel Termination" + }, + { + "control_id": "ps-5", + "title": "Personnel Transfer" + }, + { + "control_id": "ps-6", + "title": "Access Agreements" + }, + { + "control_id": "sc-4", + "title": "Information in Shared System Resources" + }, + { + "control_id": "sc-20", + "title": "Secure Name/Address Resolution Service (Authoritative Source)" + }, + { + "control_id": "sc-21", + "title": "Secure Name/Address Resolution Service (Recursive or Caching Resolver)" + }, + { + "control_id": "sc-22", + "title": "Architecture and Provisioning for Name/Address Resolution Service" + }, + { + "control_id": "sc-23", + "title": "Session Authenticity" + }, + { + "control_id": "sc-39", + "title": "Process Isolation" + }, + { + "control_id": "si-3", + "title": "Malicious Code Protection" + } + ] + }, + { + "id": "KSI-IAM-JIT", + "name": "Authorizing Just-in-Time", + "statement": "A least-privileged, role and attribute-based, and just-in-time security authorization model is used and persistently reviewed for all user and non-user accounts and services.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [ + { + "control_id": "ac-2", + "title": "Account Management" + }, + { + "control_id": "ac-2.1", + "title": "Automated System Account Management" + }, + { + "control_id": "ac-2.2", + "title": "Automated Temporary and Emergency Account Management" + }, + { + "control_id": "ac-2.3", + "title": "Disable Accounts" + }, + { + "control_id": "ac-2.4", + "title": "Automated Audit Actions" + }, + { + "control_id": "ac-2.6", + "title": "Dynamic Privilege Management" + }, + { + "control_id": "ac-3", + "title": "Access Enforcement" + }, + { + "control_id": "ac-4", + "title": "Information Flow Enforcement" + }, + { + "control_id": "ac-5", + "title": "Separation of Duties" + }, + { + "control_id": "ac-6", + "title": "Least Privilege" + }, + { + "control_id": "ac-6.1", + "title": "Authorize Access to Security Functions" + }, + { + "control_id": "ac-6.2", + "title": "Non-privileged Access for Nonsecurity Functions" + }, + { + "control_id": "ac-6.5", + "title": "Privileged Accounts" + }, + { + "control_id": "ac-6.7", + "title": "Review of User Privileges" + }, + { + "control_id": "ac-6.9", + "title": "Log Use of Privileged Functions" + }, + { + "control_id": "ac-6.10", + "title": "Prohibit Non-privileged Users from Executing Privileged Functions" + }, + { + "control_id": "ac-7", + "title": "Unsuccessful Logon Attempts" + }, + { + "control_id": "ac-20.1", + "title": "Limits on Authorized Use" + }, + { + "control_id": "ac-17", + "title": "Remote Access" + }, + { + "control_id": "au-9.4", + "title": "Access by Subset of Privileged Users" + }, + { + "control_id": "cm-5", + "title": "Access Restrictions for Change" + }, + { + "control_id": "cm-7", + "title": "Least Functionality" + }, + { + "control_id": "cm-7.2", + "title": "Prevent Program Execution" + }, + { + "control_id": "cm-7.5", + "title": "Authorized Software \u2014 Allow-by-exception" + }, + { + "control_id": "cm-9", + "title": "Configuration Management Plan" + }, + { + "control_id": "ia-4", + "title": "Identifier Management" + }, + { + "control_id": "ia-4.4", + "title": "Identify User Status" + }, + { + "control_id": "ia-7", + "title": "Cryptographic Module Authentication" + }, + { + "control_id": "ps-2", + "title": "Position Risk Designation" + }, + { + "control_id": "ps-3", + "title": "Personnel Screening" + }, + { + "control_id": "ps-4", + "title": "Personnel Termination" + }, + { + "control_id": "ps-5", + "title": "Personnel Transfer" + }, + { + "control_id": "ps-6", + "title": "Access Agreements" + }, + { + "control_id": "ps-9", + "title": "Position Descriptions" + }, + { + "control_id": "ra-5.5", + "title": "Privileged Access" + }, + { + "control_id": "sc-2", + "title": "Separation of System and User Functionality" + }, + { + "control_id": "sc-23", + "title": "Session Authenticity" + }, + { + "control_id": "sc-39", + "title": "Process Isolation" + } + ] + }, + { + "id": "KSI-IAM-SNU", + "name": "Securing Non-User Authentication", + "statement": "Appropriately secure authentication methods are used and persistently reviewed for non-user accounts and services.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [ + { + "control_id": "ac-2", + "title": "Account Management" + }, + { + "control_id": "ac-2.2", + "title": "Automated Temporary and Emergency Account Management" + }, + { + "control_id": "ac-4", + "title": "Information Flow Enforcement" + }, + { + "control_id": "ac-6.5", + "title": "Privileged Accounts" + }, + { + "control_id": "ia-3", + "title": "Device Identification and Authentication" + }, + { + "control_id": "ia-5.2", + "title": "Public Key-based Authentication" + }, + { + "control_id": "ra-5.5", + "title": "Privileged Access" + } + ] + }, + { + "id": "KSI-IAM-SUS", + "name": "Responding to Suspicious Activity", + "statement": "Accounts with privileged access are disabled or otherwise secured in response to suspicious activity.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [ + { + "control_id": "ac-2", + "title": "Account Management" + }, + { + "control_id": "ac-2.1", + "title": "Automated System Account Management" + }, + { + "control_id": "ac-2.3", + "title": "Disable Accounts" + }, + { + "control_id": "ac-2.13", + "title": "Disable Accounts for High-risk Individuals" + }, + { + "control_id": "ac-7", + "title": "Unsuccessful Logon Attempts" + }, + { + "control_id": "ps-4", + "title": "Personnel Termination" + }, + { + "control_id": "ps-8", + "title": "Personnel Sanctions" + } + ] + } + ] + }, + "INR": { + "id": "KSI-INR", + "name": "Incident Response", + "indicators": [ + { + "id": "KSI-INR-AAR", + "name": "Generating After Action Reports", + "statement": "Incident after action reports are generated and lessons learned are persistently incorporated.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [ + { + "control_id": "ir-3", + "title": "Incident Response Testing" + }, + { + "control_id": "ir-4", + "title": "Incident Handling" + }, + { + "control_id": "ir-4.1", + "title": "Automated Incident Handling Processes" + }, + { + "control_id": "ir-8", + "title": "Incident Response Plan" + } + ] + }, + { + "id": "KSI-INR-RIR", + "name": "Reviewing Incident Response Procedures", + "statement": "The effectiveness of documented incident response procedures is persistently reviewed.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [ + { + "control_id": "ir-4", + "title": "Incident Handling" + }, + { + "control_id": "ir-4.1", + "title": "Automated Incident Handling Processes" + }, + { + "control_id": "ir-6", + "title": "Incident Reporting" + }, + { + "control_id": "ir-6.1", + "title": "Automated Reporting" + }, + { + "control_id": "ir-6.3", + "title": "Supply Chain Coordination" + }, + { + "control_id": "ir-7", + "title": "Incident Response Assistance" + }, + { + "control_id": "ir-7.1", + "title": "Automation Support for Availability of Information and Support" + }, + { + "control_id": "ir-8", + "title": "Incident Response Plan" + }, + { + "control_id": "ir-8.1", + "title": "Breaches" + }, + { + "control_id": "si-4.5", + "title": "System-generated Alerts" + } + ] + }, + { + "id": "KSI-INR-RPI", + "name": "Reviewing Past Incidents", + "statement": "Past incidents are persistently reviewed for patterns or vulnerabilities that were not previously apparent or identified.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [ + { + "control_id": "ir-3", + "title": "Incident Response Testing" + }, + { + "control_id": "ir-4", + "title": "Incident Handling" + }, + { + "control_id": "ir-4.1", + "title": "Automated Incident Handling Processes" + }, + { + "control_id": "ir-5", + "title": "Incident Monitoring" + }, + { + "control_id": "ir-8", + "title": "Incident Response Plan" + } + ] + } + ] + }, + "MLA": { + "id": "KSI-MLA", + "name": "Monitoring, Logging, and Auditing", + "indicators": [ + { + "id": "KSI-MLA-ALA", + "name": "Authorizing Log Access", + "statement": "A least-privileged, role and attribute-based, and just-in-time access authorization model is used and persistently reviewed for access to log data based on organizationally defined data sensitivity.", + "impact": { + "low": false, + "moderate": true + }, + "controls": [ + { + "control_id": "si-11", + "title": "Error Handling" + } + ] + }, + { + "id": "KSI-MLA-EVC", + "name": "Evaluating Configurations", + "statement": "The configuration of machine-based information resources, especially infrastructure as code, is persistently evaluated and tested.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [ + { + "control_id": "ca-7", + "title": "Continuous Monitoring" + }, + { + "control_id": "cm-2", + "title": "Baseline Configuration" + }, + { + "control_id": "cm-6", + "title": "Configuration Settings" + }, + { + "control_id": "si-7.7", + "title": "Integration of Detection and Response" + } + ] + }, + { + "id": "KSI-MLA-LET", + "name": "Logging Event Types", + "statement": "A list of information resources and event types that will be logged, monitored, and audited is maintained and persistently reviewed to ensure these activities occur.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [ + { + "control_id": "ac-2.4", + "title": "Automated Audit Actions" + }, + { + "control_id": "ac-6.9", + "title": "Log Use of Privileged Functions" + }, + { + "control_id": "ac-17.1", + "title": "Monitoring and Control" + }, + { + "control_id": "ac-20.1", + "title": "Limits on Authorized Use" + }, + { + "control_id": "au-2", + "title": "Event Logging" + }, + { + "control_id": "au-7.1", + "title": "Automatic Processing" + }, + { + "control_id": "au-12", + "title": "Audit Record Generation" + }, + { + "control_id": "si-4.4", + "title": "Inbound and Outbound Communications Traffic" + }, + { + "control_id": "si-4.5", + "title": "System-generated Alerts" + }, + { + "control_id": "si-7.7", + "title": "Integration of Detection and Response" + } + ] + }, + { + "id": "KSI-MLA-OSM", + "name": "Operating SIEM Capability", + "statement": "A Security Information and Event Management (SIEM) or similar system(s) is used and persistently reviewed for centralized, tamper-resistant logging of events, activities, and changes.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [ + { + "control_id": "ac-17.1", + "title": "Monitoring and Control" + }, + { + "control_id": "ac-20.1", + "title": "Limits on Authorized Use" + }, + { + "control_id": "au-2", + "title": "Event Logging" + }, + { + "control_id": "au-3", + "title": "Content of Audit Records" + }, + { + "control_id": "au-3.1", + "title": "Additional Audit Information" + }, + { + "control_id": "au-4", + "title": "Audit Log Storage Capacity" + }, + { + "control_id": "au-5", + "title": "Response to Audit Logging Process Failures" + }, + { + "control_id": "au-6.1", + "title": "Automated Process Integration" + }, + { + "control_id": "au-6.3", + "title": "Correlate Audit Record Repositories" + }, + { + "control_id": "au-7", + "title": "Audit Record Reduction and Report Generation" + }, + { + "control_id": "au-7.1", + "title": "Automatic Processing" + }, + { + "control_id": "au-8", + "title": "Time Stamps" + }, + { + "control_id": "au-9", + "title": "Protection of Audit Information" + }, + { + "control_id": "au-11", + "title": "Audit Record Retention" + }, + { + "control_id": "ir-4.1", + "title": "Automated Incident Handling Processes" + }, + { + "control_id": "si-4.2", + "title": "Automated Tools and Mechanisms for Real-time Analysis" + }, + { + "control_id": "si-4.4", + "title": "Inbound and Outbound Communications Traffic" + }, + { + "control_id": "si-7.7", + "title": "Integration of Detection and Response" + } + ] + }, + { + "id": "KSI-MLA-RVL", + "name": "Reviewing Logs", + "statement": "Logs are persistently reviewed and audited.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [ + { + "control_id": "ac-2.4", + "title": "Automated Audit Actions" + }, + { + "control_id": "ac-6.9", + "title": "Log Use of Privileged Functions" + }, + { + "control_id": "au-2", + "title": "Event Logging" + }, + { + "control_id": "au-6", + "title": "Audit Record Review, Analysis, and Reporting" + }, + { + "control_id": "au-6.1", + "title": "Automated Process Integration" + }, + { + "control_id": "si-4", + "title": "System Monitoring" + }, + { + "control_id": "si-4.4", + "title": "Inbound and Outbound Communications Traffic" + } + ] + } + ] + }, + "PIY": { + "id": "KSI-PIY", + "name": "Policy and Inventory", + "indicators": [ + { + "id": "KSI-PIY-GIV", + "name": "Generating Inventories", + "statement": "Authoritative sources are used to automatically generate real-time inventories of all information resources when needed.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [ + { + "control_id": "cm-2.2", + "title": "Automation Support for Accuracy and Currency" + }, + { + "control_id": "cm-7.5", + "title": "Authorized Software \u2014 Allow-by-exception" + }, + { + "control_id": "cm-8", + "title": "System Component Inventory" + }, + { + "control_id": "cm-8.1", + "title": "Updates During Installation and Removal" + }, + { + "control_id": "cm-12", + "title": "Information Location" + }, + { + "control_id": "cm-12.1", + "title": "Automated Tools to Support Information Location" + }, + { + "control_id": "cp-2.8", + "title": "Identify Critical Assets" + } + ] + }, + { + "id": "KSI-PIY-RES", + "name": "Reviewing Executive Support", + "statement": "Executive support for achieving the provider's security goals is persistently reviewed and demonstrated.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [] + }, + { + "id": "KSI-PIY-RIS", + "name": "Reviewing Investments in Security", + "statement": "The effectiveness of the provider's investments in achieving security goals is persistently reviewed.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [ + { + "control_id": "ac-5", + "title": "Separation of Duties" + }, + { + "control_id": "ca-2", + "title": "Control Assessments" + }, + { + "control_id": "cp-2.1", + "title": "Coordinate with Related Plans" + }, + { + "control_id": "cp-4.1", + "title": "Coordinate with Related Plans" + }, + { + "control_id": "ir-3.2", + "title": "Coordination with Related Plans" + }, + { + "control_id": "pm-3", + "title": "Information Security and Privacy Resources" + }, + { + "control_id": "sa-2", + "title": "Allocation of Resources" + }, + { + "control_id": "sa-3", + "title": "System Development Life Cycle" + }, + { + "control_id": "sr-2.1", + "title": "Establish SCRM Team" + } + ] + }, + { + "id": "KSI-PIY-RSD", + "name": "Reviewing Security in the SDLC", + "statement": "The effectiveness of building security and privacy considerations into the Software Development Lifecycle and aligning with CISA Secure By Design principles is persistently reviewed.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [ + { + "control_id": "ac-5", + "title": "Separation of Duties" + }, + { + "control_id": "au-3.3", + "title": "Limit Personally Identifiable Information Elements" + }, + { + "control_id": "cm-3.4", + "title": "Security and Privacy Representatives" + }, + { + "control_id": "pl-8", + "title": "Security and Privacy Architectures" + }, + { + "control_id": "pm-7", + "title": "Enterprise Architecture" + }, + { + "control_id": "sa-3", + "title": "System Development Life Cycle" + }, + { + "control_id": "sa-8", + "title": "Security and Privacy Engineering Principles" + }, + { + "control_id": "sc-4", + "title": "Information in Shared System Resources" + }, + { + "control_id": "sc-18", + "title": "Mobile Code" + }, + { + "control_id": "si-10", + "title": "Information Input Validation" + }, + { + "control_id": "si-11", + "title": "Error Handling" + }, + { + "control_id": "si-16", + "title": "Memory Protection" + } + ] + }, + { + "id": "KSI-PIY-RVD", + "name": "Reviewing Vulnerability Disclosures", + "statement": "The effectiveness of the provider's vulnerability disclosure program is persistently reviewed.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [ + { + "control_id": "ra-5.11", + "title": "Public Disclosure Program" + } + ] + } + ] + }, + "RPL": { + "id": "KSI-RPL", + "name": "Recovery Planning", + "indicators": [ + { + "id": "KSI-RPL-ABO", + "name": "Aligning Backups with Objectives", + "statement": "The alignment of machine-based information resource backups with defined recovery objectives is persistently reviewed.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [ + { + "control_id": "cm-2.3", + "title": "Retention of Previous Configurations" + }, + { + "control_id": "cp-6", + "title": "Alternate Storage Site" + }, + { + "control_id": "cp-9", + "title": "System Backup" + }, + { + "control_id": "cp-10", + "title": "System Recovery and Reconstitution" + }, + { + "control_id": "cp-10.2", + "title": "Transaction Recovery" + }, + { + "control_id": "si-12", + "title": "Information Management and Retention" + } + ] + }, + { + "id": "KSI-RPL-ARP", + "name": "Aligning Recovery Plan", + "statement": "The alignment of recovery plans with defined recovery objectives is persistently reviewed.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [ + { + "control_id": "cp-2", + "title": "Contingency Plan" + }, + { + "control_id": "cp-2.1", + "title": "Coordinate with Related Plans" + }, + { + "control_id": "cp-2.3", + "title": "Resume Mission and Business Functions" + }, + { + "control_id": "cp-4.1", + "title": "Coordinate with Related Plans" + }, + { + "control_id": "cp-6", + "title": "Alternate Storage Site" + }, + { + "control_id": "cp-6.1", + "title": "Separation from Primary Site" + }, + { + "control_id": "cp-6.3", + "title": "Accessibility" + }, + { + "control_id": "cp-7", + "title": "Alternate Processing Site" + }, + { + "control_id": "cp-7.1", + "title": "Separation from Primary Site" + }, + { + "control_id": "cp-7.2", + "title": "Accessibility" + }, + { + "control_id": "cp-7.3", + "title": "Priority of Service" + }, + { + "control_id": "cp-8", + "title": "Telecommunications Services" + }, + { + "control_id": "cp-8.1", + "title": "Priority of Service Provisions" + }, + { + "control_id": "cp-8.2", + "title": "Single Points of Failure" + }, + { + "control_id": "cp-10", + "title": "System Recovery and Reconstitution" + }, + { + "control_id": "cp-10.2", + "title": "Transaction Recovery" + } + ] + }, + { + "id": "KSI-RPL-RRO", + "name": "Reviewing Recovery Objectives", + "statement": "The desired Recovery Time Objectives (RTO) and Recovery Point Objectives (RPO) are defined and persistently reviewed for alignment with the provider's business needs and capabilities.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [ + { + "control_id": "cp-2.3", + "title": "Resume Mission and Business Functions" + }, + { + "control_id": "cp-10", + "title": "System Recovery and Reconstitution" + } + ] + }, + { + "id": "KSI-RPL-TRC", + "name": "Testing Recovery Capabilities", + "statement": "The capability to recover from incidents and contingencies aligned with defined recovery objectives is persistently tested.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [ + { + "control_id": "cp-2.1", + "title": "Coordinate with Related Plans" + }, + { + "control_id": "cp-2.3", + "title": "Resume Mission and Business Functions" + }, + { + "control_id": "cp-4", + "title": "Contingency Plan Testing" + }, + { + "control_id": "cp-4.1", + "title": "Coordinate with Related Plans" + }, + { + "control_id": "cp-6", + "title": "Alternate Storage Site" + }, + { + "control_id": "cp-6.1", + "title": "Separation from Primary Site" + }, + { + "control_id": "cp-9.1", + "title": "Testing for Reliability and Integrity" + }, + { + "control_id": "cp-10", + "title": "System Recovery and Reconstitution" + }, + { + "control_id": "ir-3", + "title": "Incident Response Testing" + }, + { + "control_id": "ir-3.2", + "title": "Coordination with Related Plans" + } + ] + } + ] + }, + "SCR": { + "id": "KSI-SCR", + "name": "Supply Chain Risk", + "indicators": [ + { + "id": "KSI-SCR-MIT", + "name": "Mitigating Supply Chain Risk", + "statement": "Persistently identify, review, and mitigate potential supply chain risks.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [ + { + "control_id": "ac-20", + "title": "Use of External Systems" + }, + { + "control_id": "ra-3.1", + "title": "Supply Chain Risk Assessment" + }, + { + "control_id": "sa-9", + "title": "External System Services" + }, + { + "control_id": "sa-10", + "title": "Developer Configuration Management" + }, + { + "control_id": "sa-11", + "title": "Developer Testing and Evaluation" + }, + { + "control_id": "sa-15.3", + "title": "Criticality Analysis" + }, + { + "control_id": "sa-22", + "title": "Unsupported System Components" + }, + { + "control_id": "si-7.1", + "title": "Integrity Checks" + }, + { + "control_id": "sr-5", + "title": "Acquisition Strategies, Tools, and Methods" + }, + { + "control_id": "sr-6", + "title": "Supplier Assessments and Reviews" + }, + { + "control_id": "ca-7.4", + "title": "Risk Monitoring" + }, + { + "control_id": "sc-18", + "title": "Mobile Code" + } + ] + }, + { + "id": "KSI-SCR-MON", + "name": "Monitoring Supply Chain Risk", + "statement": "Third party software information resources are automatically monitored for upstream vulnerabilities using mechanisms that may include contractual notification requirements or active monitoring services.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [ + { + "control_id": "ac-20", + "title": "Use of External Systems" + }, + { + "control_id": "ca-3", + "title": "Information Exchange" + }, + { + "control_id": "ir-6.3", + "title": "Supply Chain Coordination" + }, + { + "control_id": "ps-7", + "title": "External Personnel Security" + }, + { + "control_id": "ra-5", + "title": "Vulnerability Monitoring and Scanning" + }, + { + "control_id": "sa-9", + "title": "External System Services" + }, + { + "control_id": "si-5", + "title": "Security Alerts, Advisories, and Directives" + }, + { + "control_id": "sr-5", + "title": "Acquisition Strategies, Tools, and Methods" + }, + { + "control_id": "sr-6", + "title": "Supplier Assessments and Reviews" + }, + { + "control_id": "sr-8", + "title": "Notification Agreements" + } + ] + } + ] + }, + "SVC": { + "id": "KSI-SVC", + "name": "Service Configuration", + "indicators": [ + { + "id": "KSI-SVC-ACM", + "name": "Automating Configuration Management", + "statement": "The configuration of machine-based information resources is managed using automation and persistently reviewed for drift.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [ + { + "control_id": "ac-2.4", + "title": "Automated Audit Actions" + }, + { + "control_id": "cm-2", + "title": "Baseline Configuration" + }, + { + "control_id": "cm-2.2", + "title": "Automation Support for Accuracy and Currency" + }, + { + "control_id": "cm-2.3", + "title": "Retention of Previous Configurations" + }, + { + "control_id": "cm-6", + "title": "Configuration Settings" + }, + { + "control_id": "cm-7.1", + "title": "Periodic Review" + }, + { + "control_id": "pl-9", + "title": "Central Management" + }, + { + "control_id": "pl-10", + "title": "Baseline Selection" + }, + { + "control_id": "sa-5", + "title": "System Documentation" + }, + { + "control_id": "si-5", + "title": "Security Alerts, Advisories, and Directives" + }, + { + "control_id": "sr-10", + "title": "Inspection of Systems or Components" + } + ] + }, + { + "id": "KSI-SVC-ASM", + "name": "Automating Secret Management", + "statement": "Management, protection, and regular rotation of digital keys, certificates, and other secrets is automated and persistently reviewed.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [ + { + "control_id": "ac-17.2", + "title": "Protection of Confidentiality and Integrity Using Encryption" + }, + { + "control_id": "ia-5.2", + "title": "Public Key-based Authentication" + }, + { + "control_id": "ia-5.6", + "title": "Protection of Authenticators" + }, + { + "control_id": "sc-12", + "title": "Cryptographic Key Establishment and Management" + }, + { + "control_id": "sc-17", + "title": "Public Key Infrastructure Certificates" + } + ] + }, + { + "id": "KSI-SVC-EIS", + "name": "Evaluating and Improving Security", + "statement": "Information resources are persistently evaluated for opportunities to improve security and those improvements are persistently made.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [ + { + "control_id": "cm-7.1", + "title": "Periodic Review" + }, + { + "control_id": "cm-12.1", + "title": "Automated Tools to Support Information Location" + }, + { + "control_id": "ma-2", + "title": "Controlled Maintenance" + }, + { + "control_id": "pl-8", + "title": "Security and Privacy Architectures" + }, + { + "control_id": "sc-7", + "title": "Boundary Protection" + }, + { + "control_id": "sc-39", + "title": "Process Isolation" + }, + { + "control_id": "si-2.2", + "title": "Automated Flaw Remediation Status" + }, + { + "control_id": "si-4", + "title": "System Monitoring" + }, + { + "control_id": "sr-10", + "title": "Inspection of Systems or Components" + } + ] + }, + { + "id": "KSI-SVC-PRR", + "name": "Preventing Residual Risk", + "statement": "Plans, procedures, and the state of information resources are persistently reviewed after making changes to limit and remove unwanted residual elements that would likely negatively affect the confidentiality, integrity, or availability of federal customer data.", + "impact": { + "low": false, + "moderate": true + }, + "controls": [ + { + "control_id": "sc-4", + "title": "Information in Shared System Resources" + } + ] + }, + { + "id": "KSI-SVC-RUD", + "name": "Removing Unwanted Data", + "statement": "Unwanted federal customer data is removed promptly when requested by an agency in alignment with customer agreements, including from backups if appropriate; this typically applies when a customer spills information or when a customer seeks to remove information from a service due to a change in usage.", + "impact": { + "low": false, + "moderate": true + }, + "controls": [ + { + "control_id": "si-12.3", + "title": "Information Disposal" + }, + { + "control_id": "si-18.4", + "title": "Individual Requests" + } + ] + }, + { + "id": "KSI-SVC-SIN", + "name": "Securing Information", + "statement": "Information is encrypted or otherwise secured from unwanted access or modification.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [ + { + "control_id": "ac-1", + "title": "Policy and Procedures" + }, + { + "control_id": "ac-17.2", + "title": "Protection of Confidentiality and Integrity Using Encryption" + }, + { + "control_id": "cp-9.8", + "title": "Cryptographic Protection" + }, + { + "control_id": "sc-8", + "title": "Transmission Confidentiality and Integrity" + }, + { + "control_id": "sc-8.1", + "title": "Cryptographic Protection" + }, + { + "control_id": "sc-13", + "title": "Cryptographic Protection" + }, + { + "control_id": "sc-20", + "title": "Secure Name/Address Resolution Service (Authoritative Source)" + }, + { + "control_id": "sc-21", + "title": "Secure Name/Address Resolution Service (Recursive or Caching Resolver)" + }, + { + "control_id": "sc-22", + "title": "Architecture and Provisioning for Name/Address Resolution Service" + }, + { + "control_id": "sc-23", + "title": "Session Authenticity" + }, + { + "control_id": "sc-28", + "title": "Protection of Information at Rest" + }, + { + "control_id": "sc-28.1", + "title": "Cryptographic Protection" + } + ] + }, + { + "id": "KSI-SVC-VCM", + "name": "Validating Communications", + "statement": "The authenticity and integrity of communications between machine-based information resources is persistently validated using automation.", + "impact": { + "low": false, + "moderate": true + }, + "controls": [ + { + "control_id": "sc-23", + "title": "Session Authenticity" + }, + { + "control_id": "si-7.1", + "title": "Integrity Checks" + } + ] + }, + { + "id": "KSI-SVC-VRI", + "name": "Validating Resource Integrity", + "statement": "Use cryptographic methods to validate the integrity of machine-based information resources.", + "impact": { + "low": true, + "moderate": true + }, + "controls": [ + { + "control_id": "cm-2.2", + "title": "Automation Support for Accuracy and Currency" + }, + { + "control_id": "cm-8.3", + "title": "Automated Unauthorized Component Detection" + }, + { + "control_id": "sc-13", + "title": "Cryptographic Protection" + }, + { + "control_id": "sc-23", + "title": "Session Authenticity" + }, + { + "control_id": "si-7", + "title": "Software, Firmware, and Information Integrity" + }, + { + "control_id": "si-7.1", + "title": "Integrity Checks" + }, + { + "control_id": "sr-10", + "title": "Inspection of Systems or Components" + } + ] + } + ] + } + } +} diff --git a/tests/test_controls.py b/tests/test_controls.py index fa0aae40..75e0e53a 100644 --- a/tests/test_controls.py +++ b/tests/test_controls.py @@ -26,6 +26,11 @@ REPO = Path(__file__).resolve().parent.parent FIX_SIGNAL = REPO / "tests" / "fixtures" / "clean" / "ksi-signal.json" CATALOG = REPO / "infrastructure" / "schemas" / "ksi-catalog.json" +# The KSI catalog as it stood when the SSP was retired (FedRAMP's mappings before +# its 2026-10-13 revision). The parity test runs the projection on it, so the +# projection's code stays pinned to the SSP it replaced; the current catalog is +# FedRAMP's current mapping (tests/test_ksi_catalog_corpus.py). +CATALOG_AT_RETIREMENT = REPO / "tests" / "fixtures" / "migration" / "ksi-catalog-2026-11-05.json" FROZEN = REPO / "tests" / "fixtures" / "migration" / "ssp-control-status-2026-11-05.json" sys.path.insert(0, str(REPO / "scripts")) @@ -48,7 +53,7 @@ def _projection(): def test_the_projection_matches_the_last_ssp_control_for_control(): frozen = json.loads(FROZEN.read_text()) - irs = _projection() + irs = _controls.load(FIX_SIGNAL, CATALOG_AT_RETIREMENT) assert len(irs) == frozen["implemented_requirements"] == 333 got = {cid: list(v) for cid, v in _controls.status_map(irs).items()} assert got == frozen["controls"] diff --git a/tests/test_inject_figures.py b/tests/test_inject_figures.py index 2973c66d..76861df0 100644 --- a/tests/test_inject_figures.py +++ b/tests/test_inject_figures.py @@ -47,13 +47,14 @@ def test_figures_reproduce_published_numbers(): # hub split: hand-written + family-default = total assert int(f["hub_handwritten"]) + int(f["hub_generated"]) == int(f["hub_total"]) assert f["hub_handwritten"] == "116" - assert f["hub_total"] == "333" + assert f["hub_total"] == "382" # FedRAMP Moderate stack sums to the total assert int(f["moderate_implemented"]) + int(f["moderate_inherited"]) + int(f["moderate_na"]) == int(f["hub_total"]) # coverage is measured against the published baseline, not the hub total assert f["moderate_baseline"] == "323" assert f["moderate_coverage"] == "323/323" - assert f["moderate_beyond"] == "10" + # controls FedRAMP's KSI mappings reach beyond Moderate (2026-10-13 revision) + assert f["moderate_beyond"] == "59" assert int(f["moderate_baseline"]) + int(f["moderate_beyond"]) == int(f["hub_total"]) # spokes assert f["govramp_coverage"] == "339/339" @@ -126,7 +127,7 @@ def test_altered_projection_count_flows_to_html(monkeypatch): # hand-written count is unchanged (component def untouched), so generated grows assert f["hub_generated"] == str(baseline + 1 - int(f["hub_handwritten"])) assert f["moderate_coverage"] == "323/323" - assert f["moderate_beyond"] == "11" + assert f["moderate_beyond"] == "60" # and that new value actually lands in the marked HTML marked = '331' diff --git a/tests/test_ksi_catalog_corpus.py b/tests/test_ksi_catalog_corpus.py new file mode 100644 index 00000000..6fa3d396 --- /dev/null +++ b/tests/test_ksi_catalog_corpus.py @@ -0,0 +1,57 @@ +"""The KSI catalog is FedRAMP's: IDs, names, Class C statements and KSI->control +mappings equal the pinned Consolidated Rules (scripts/sync-ksi-catalog.py).""" + +import copy +import importlib.util +import json +from pathlib import Path + +import pytest + +REPO = Path(__file__).resolve().parent.parent +spec = importlib.util.spec_from_file_location("sync_ksi", REPO / "scripts" / "sync-ksi-catalog.py") +sync = importlib.util.module_from_spec(spec) +spec.loader.exec_module(sync) +BEFORE = REPO / "tests" / "fixtures" / "migration" / "ksi-catalog-2026-11-05.json" + + +def _catalog(): + return json.loads(sync.CATALOG.read_text()) + + +def test_the_committed_catalog_equals_the_pinned_rules(): + assert sync.main(["--check"]) == 0 + + +def test_a_mapping_that_drifts_from_the_rules_fails(): + """Known-bad: the catalog as committed before FedRAMP's 2026-10-13 mapping + revision was carried (40 of 46 KSIs differ).""" + stale = json.loads(BEFORE.read_text()) + assert sync.derive(stale) != stale + + +def test_a_dropped_control_is_detected(): + cat = _catalog() + bad = copy.deepcopy(cat) + bad["KSI"]["CED"]["indicators"][0]["controls"].pop() + assert sync.derive(bad) != bad + + +def test_class_c_statements_are_used_where_a_ksi_varies_by_class(): + by_id = {i["id"]: i for f in _catalog()["KSI"].values() for i in f["indicators"]} + assert len(by_id) == 46 + assert not by_id["KSI-CNA-EIS"]["statement"].startswith("**Optional:**") + + +def test_a_control_outside_the_nist_catalog_fails_closed(monkeypatch): + monkeypatch.setattr(sync, "_titles", lambda: {}) + with pytest.raises(SystemExit, match="not in the NIST SP 800-53 Rev5 catalog"): + sync.derive(_catalog()) + + +def test_a_new_ksi_needs_its_impact_set_first(): + cat = _catalog() + for f in cat["KSI"].values(): + f["indicators"] = [i for i in f["indicators"] if i["id"] != "KSI-CED-RAT"] + with pytest.raises(SystemExit, match="KSI-CED-RAT is new in the corpus"): + sync.derive(cat)