validate_core.py
构建时实测参考实现:一个 3,535 行的 Python 文件,唯一的依赖是 jsonschema。它包含规范化、两种摘要、裁剪法则、Ed25519 和 DSSE 验证、捆绑包组合、风险覆盖以及一个 I-Regexp 引擎。
依据
本项目遵循三条规则。每项主张都标明为实测、已设计或假设。没有已发布目录的需要,任何机制都不会进入规范。每一项禁止性规定都写明它所防止的、经过统计的失败。本页把第一条规则应用于本项目自身。
01 一致性
一个工具是否一致,由测试语料库说了算。2026-11-15,在提交 967e9f3 上,参考校验器通过了分属 18 个族的 822 个测试向量中的全部 822 个,并重新验证了本站提供的 5 个捆绑包中 4,483 个对象的两个摘要。
jcs22modality21parameter22tailoring19attestation32facet29reference56lifecycle58tier10dsse27composition11conditional8risk73kernel97scale18check205advice74author40已发布的 1.0.0 包含十二个族共 157 个测试向量。risk、kernel 和 scale 随 2.0.0-rc.1 加入,205 个 check 测试向量随 2.0.0-rc.2 加入,74 个 advice 测试向量随 2.0.0-rc.3 加入。
参考实现:一个 3,535 行的 Python 文件,唯一的依赖是 jsonschema。它包含规范化、两种摘要、裁剪法则、Ed25519 和 DSSE 验证、捆绑包组合、风险覆盖以及一个 I-Regexp 引擎。
孪生实现:4,836 行 Windows PowerShell 5.1 代码,没有任何依赖,面向审计人员手头已有的机器。在一个托管的 Windows 运行器上,它对全部 822 个测试向量、五个捆绑包、完整示例包和示例文件夹返回与 Python 参考实现相同的计数。一个工作流会在每次变更时重复这次运行。
应用的校验页面运行内核规则的 JavaScript 移植版本,覆盖全部 18 个测试向量族。应用的 readme 列出了它留给 Python 校验器处理的内容。
行数采用关口 4 报告的计数方法:统计非空且不以 # 开头的行。
02 语料库
每个转换器都会生成一份覆盖报告,列出每条规则及其计数,并报告源数据中的缺陷而不加修复。根据发布者的条款,有五个捆绑包允许再分发,本站提供这些捆绑包。您可以在应用中打开其中任何一个。
| 语料库 | 对象数 | 类型 | 内容许可证 | |
|---|---|---|---|---|
| AU.ISMInformation Security ManualAustralian Signals Directorate | 1,731 | 1,150 Requirement · 581 RequirementSet1,150 项控制措施;按密级划分的基线和 Essential Eight 基线以 Set 表示 | CC BY 4.0 | 在应用中打开 |
| DE.BSIGrundschutz++ AnwenderkatalogBSI(德国) | 1,289 | 1,000 Requirement · 289 RequirementSet德语正文、陈述语法和保护目标以分面表示 | CC BY-SA 4.0 | 在应用中打开 |
| US.CSFCybersecurity Framework 2.0NIST | 226 | 185 Requirement · 41 RequirementSet功能、类别和子类别以嵌套的 Set 表示 | CC0 1.0 | 在应用中打开 |
| US.IFA-GoodReadOSCAL 示例系统(SSP、计划、结果、POA&M)NIST(虚构内容) | 16 | 6 Component · 3 Implementation · 2 Finding · 2 Requirement · 2 Risk · 1 Assessment生命周期类型:从 Component 到 Attestation,含两个 Risk | CC0 1.0 | 在应用中打开 |
| US.SP800-53SP 800-53 Rev 5.2.0(含 800-53B 基线)NIST | 1,221 | 1,196 Requirement · 25 RequirementSet作用范围限定在陈述上的参数;四个基线以成员关系 Set 表示 | CC0 1.0 | 在应用中打开 |
对象数量在构建时实测。这些转换均非由发布者制作、审阅或认可。本项目的 Apache 许可证不适用于这些捆绑包;适用的是每个捆绑包旁附的许可说明。
另有六个语料库为 1.0.0 进行了转换和实测。在审查了发布者的条款之后,它们的捆绑包于 2026年11月10日从仓库中移除。转换器和覆盖报告仍然保留,因此任何有权获取源文件的人都可以重新生成这些捆绑包。
03 关口
在绘制架构之前,对 ISM(1,150 项控制措施,8,958 个 prop)、Grundschutz++(13,315 个 prop)和 FedRAMP CR26(246 条规则,没有 prop)进行了清点。内核就是经测量这三者都需要的内容。
具有封闭且互斥结构的规范性 JSON Schema、七个标准库分面描述符、一致性测试语料库和参考校验器。
SP 800-53 Rev 5.2.0 及四个 800-53B 基线、CSF 2.0,以及由 SSP、评估计划、评估结果和 POA&M 组成的完整生命周期文档集。内核 Schema 无需任何改动。该语料库暴露了参考校验器中的两个缺陷,均已修复。
基于无依赖 Ed25519 实现的 DSSE 签名验证、捆绑包组合、条件规则、PowerShell 孪生实现以及双向 OSCAL 导出。规范经历了仓库内的对抗性评审和一轮外部审阅;每个发现项都有记录在案的裁定。其中一项修复找回了 239 个被某个转换器悄无声息地合并掉的 ISM 分类体系集合。
1.0.0 语料库的全部 6,914 个对象无需修改即可通过新 Schema 的校验。普查所涵盖的权威机构都不发布风险记录,因为风险登记册是使用方自己的数据。有三项标准要求具备这种记录:ISO/IEC 27001、BSI Standard 200-3 和 NIST SP 800-30。
11月11日提出,附带 Schema、校验器、156 个测试向量,以及对两个开放检查语料库的普查:ComplianceAsCode 中 CIS Ubuntu 24.04 配置文件的 510 条规则里有 481 条适配,且两个语料库中没有任何比较需要 I-Regexp 之外的正则表达式。次日连同六项决定被接受。晋升规则新增了一项条款,适用于目录权威机构不发布的类型;Risk 和 Check 都依据这一条款进入。目前共有 205 个测试向量。
厂商建议以单个发布文件的形式提供,连同八项记录在案的决定被接受:没有新增类型,包含十一条规则、74 个测试向量,以及一个带签名证明的完整示例包。在随附的捆绑包上运行时,关于 capability-ref 的规则在转换后的 NIST 示例中发现了一条边,它引用了其所属组件并未声明的能力。同一天,作者关闭了打标签前剩下的四个问题。1.0.0 中作为自由文本的两个字段现已类型化:偏离的登记日期和措施的截止日期。
与五个同类格式的比较发现了两处其中某个格式领先的地方,作者在同一天对两者作出了决定。由谁决定、何时决定,现在只有一种写法,即 provenance,在裁剪及其每个条目、风险及其评级、实施和发现项上均为可选。偏离可以写明何时作出决定以及何时应当复审。校验器会报告缺失的内容,每个对象和规则一行,并对照运行日期报告已过的复审日期。缺失的作者只有在调用方要求时才会使捆绑包校验失败;已过的复审日期永远不会。没有新增类型,也没有新增原语:有 40 个测试向量用于这两类报告,在参考实现中故意制造的十九处缺陷,每一处都会让一个向量变红。三个原先接受任意字符串的时间已类型化。
04 局限
以下是截至 2026-11-15 的未决问题。每一项同时也是外部贡献比维护者本人的工作更有分量的地方。
2026年11月10日的一次搜索显示,除其自身仓库外,没有任何地方提到 JASCON。没有权威机构用它发布内容,也没有厂商读取它。已实测的转换结果以及在已发布目录中发现的缺陷,无需采用该格式即可使用。
Python 参考实现和 PowerShell 孪生实现均由项目作者在 AI 辅助下依据同一批资料编写。二者的独立性仅限于编程语言和运行时。该关口衡量的是规范能否确定一个实现,而不是衡量一个陌生人用一个周末能做出什么。
覆盖报告统计的是具有已声明目标位置的源路径。每个值是否到达,目前在 6 个语料库上用台账逐值追踪,该台账跟踪每个源值在转换器中的去向:214,455 个叶值中,122,891 个被携带(71,259 个原样复制,51,632 个经由具名规则转换),91,564 个按台账检查的规则不属于内容(仅用于选择字段的名称、命名空间、可精确重建的标识符、无任何引用指向的资源),0 个被舍弃,0 个去向不明。只要有一个值去向不明,转换器的运行就会失败。这些语料库的路径映射此前全部显示 100 %,而最初的台账仍然发现了丢失的值;这些值现在已被携带。台账核对的是规则与其写入内容是否一致,而不是规则本身是否正确;台账也不会反向追溯转换器自行写入的内容。工作流会在每次变更时,用固定版本的源文件重现这些转换。其余 5 个语料库尚未测量。
| 语料库 | 源值 | 原样复制 | 经由具名规则 | 按经检查的规则不属于内容 | 舍弃 | 去向不明 |
|---|---|---|---|---|---|---|
| AU.ISM | 36,161 | 5,896 | 15,665 | 14,600 | 0 | 0 |
| DE.BSI | 49,521 | 22,679 | 11,822 | 15,020 | 0 | 0 |
| FedRAMP-CR26 | 7,532 | 5,545 | 1,987 | 0 | 0 | 0 |
| US.CSF | 4,726 | 1,936 | 905 | 1,885 | 0 | 0 |
| US.IFA-GoodRead | 835 | 762 | 62 | 11 | 0 | 0 |
| US.SP800-53 | 115,680 | 34,441 | 21,191 | 60,048 | 0 | 0 |
OSCAL 的风险数据没有责任人、没有单一等级,也没有接受日期。从中转换得到的风险无法离开 identified 状态,因此在真实的转换数据上,风险覆盖会把每条要求都显示为未覆盖。带有已处置风险的覆盖情况仅在示例捆绑包上展示。
Check 类型的适配度只在 Linux 主机和 Kubernetes 上统计过。没有统计过任何针对云 API 的检查,仓库中没有任何东西运行采集器,完整示例是针对一个桩(stub)运行的。在统计的 510 条规则中,有 29 条不适合声明式形式,仍需人工处理。查看完整现状。
已没有待决定的事项,两个校验器在候选版本的全部 822 个测试向量上均为绿色。作者于2026年11月13日接受的两项变更已作为 rc.4 纳入其中;写入新字段的工具尚待跟进。打标签是作者要走的一步,这一步尚未迈出。在此之前,已发布的版本是 1.0.0,2.0.0 的结构仍可能变化。
在 rc.2 之前,2.0.0 Schema 接受 1.0.0 所接受的一切。从 rc.3 起,偏离的登记日期必须是一个日期,措施的截止日期必须是类型化的时间点或时长。在这两个字段中任一使用自由文本的 1.0.0 捆绑包都必须进行转换。从 rc.4 起,映射出处中的日期、评估的时间和证明的时间戳也是如此。随附的五个捆绑包和示例文件夹全部符合要求。含 Unicode 类别的模式遵循其运行机器上的 Unicode 数据库,因此一个较晚才分配的码位可能在两台机器上得出两种判定;需要唯一判定的作者应写出字符范围。
没有任何目录权威机构发布厂商建议。对于此类数据,晋升规则要求:要么有一项标准规定必须具备此记录,要么有两个内容经过统计的开放实现。建议包两者都没有。能力上的条款级字段仅以 NIST 示例中的一个虚构组件定义为依据,其中有三条建议、两个条款级条目和两个建议参数值;产品版本字段则没有任何经过统计的依据。两者均由作者在违背该规则的情况下决定纳入内核,规范也如实记录了这一点。尚无厂商发布过建议包;建议包构建器可以导入 OSCAL 组件定义,NIST 自己的示例在导入时不会丢失建议包能够容纳的任何内容,但还没有任何由厂商发布的组件定义经过它的处理。这项普查仍有待完成。
2026年11月13日的比较发现了两处同类格式领先的地方:Deviation 当时没有到期时间,而 CISO Assistant 中的安全例外有到期日期,OSCAL 中的风险有期限;裁剪操作当时也不记录其自身的作者,而 CISO Assistant 会记录每一项变更。两者均已在 rc.4 中。这些字段是可选的:校验器会报告缺失的作者和已过的复审日期,前者只有在调用方要求时才会使捆绑包校验失败,后者永远不会。已过复审日期的 Deviation 在有人采取行动之前仍然有效。一个版本的作者并不是每项变更的日志。自2026年11月14日起,工具会写入这些字段。应用的各个页面写入其用户设置的作者,转换器和导入则根据来源预先填入作者和日期,导入者可以覆盖二者。来源能提供的很少:OSCAL 写明谁对一份文档负责,而不是谁写了其中的某条陈述,因此在转换后的 NIST 示例中,七条记录里有一条获得作者,仍有七行这样的报告。
手册描述了一个联邦式注册中心和一位标准库管理人。两者都还不存在。目前只有一位以个人身份工作的维护者、一份公开的决策登记册,以及一致性测试语料库。
05 现有技术
分两轮完成。前五行于 2026年11月13日对照指定版本的 Schema 或代码进行了核查:OSCAL 1.2.3、Gemara 1.6.0、CycloneDX 1.7.2、CISO Assistant,以及 XCCDF 1.2 与 SCAP 1.4。其下各行来自 11月10日的调研,资料取自公开仓库;无法访问一手站点时,则取自二手来源。没有转换任何同类格式的数据,因此表中每一格说明的是格式本身提供了什么,而不是某个部署用它做了什么。
| 格式 | 涵盖内容 | 缺少内容 |
|---|---|---|
| OSCAL (NIST) | 目录(catalog)、profile、组件定义、系统安全计划、评估计划与评估结果、POA&M,以及自 1.2.0 起的控制措施映射。从控制措施到带哈希的证据文件的完整链条;风险上的期限;一个无法修改目录的厂商模型 | 风险只存在于评估结果和 POA&M 中,从不与它本可作为依据的选择并列。profile 变更不记录作者。没有任何结构能承载第二种语言。没有原生签名:上游拒绝了内联签名(issue 245),只剩下字节哈希。扩展 prop 带有一个无人校验的命名空间字符串,而为 SP 800-53 编写的核心约束也会约束其他框架(#2118、#2112) |
| Gemara (OpenSSF) | 分层目录,涵盖指南、控制措施、威胁、风险和能力;带有类型化关系、强度和置信度的映射文档;证据带摘要的评估日志;以 CUE 编写的 Schema。被 FINOS Common Cloud Controls 和 OpenSSF OSPS Baseline 采用 | 没有第二种语言的正文。发现项或豁免没有截止日期或到期时间。没有实施记录:模型为其指定了一个层级,却没有提供 Schema。接受风险时没有批准人或日期。签名覆盖的是已发布捆绑包的字节,由工具在 Schema 之外完成。Schema 是封闭的:CUE profile 可以收窄它们,但不能新增字段。策略和风险 Schema 被标记为实验性 |
| CycloneDX Attestations (OWASP, ECMA-424) | 以数据表示的标准;映射到主张与反主张的要求、带作者和到期时间的证据、带签署人的确认声明(affirmation)。基于规范化 JSON 的逐对象签名,重新缩进后依然有效 | 没有风险对象,没有裁剪记录,没有语言映射表。证据附件不带哈希。签名只存在于 JSON 形式中:XML Schema 和 protobuf 定义中都没有它的位置。签署人和确认声明都不带日期。扩展是名称/值字符串,其注册表是可选的 |
| CISO Assistant (intuitem) | 在工具中:与控制措施关联的风险场景、适用性声明导出、带批准人、日期和到期时间的风险接受、带到期日期的安全例外、审计日志。在库格式中:200 多个框架、参考控制措施、风险矩阵、基于集合论的映射、每个对象的 translations 映射表 | 风险接受、例外和适用性声明都留在应用程序内;它们通过备份导出离开应用程序,而不是通过库格式。没有签名:字节哈希只用于去重。库更新可能改写已有的评估。要求上没有附加检查逻辑。导入器会忽略它不认识的库键 |
| SCAP、XCCDF、OVAL | 以 XML 表示的检查单和检查语言。Tailoring 文件可在不编辑厂商基准的情况下修改它;override 记录授权方、时间和理由;标题和描述按语言重复;数据流可以签名和会签 | 没有风险记录。没有截止日期、到期时间或豁免类型。采集项不带哈希。单项裁剪变更没有作者,而且可以在不给出理由的情况下降低严重程度。重新缩进已签名的数据流会破坏签名。符合一致性要求的检查只有 OVAL 和 OCIL;任意语言的脚本只能通过 OpenSCAP 扩展运行。外部命名空间中的元素只有在恰好有 Schema 可用时才会被校验 |
| 监管机构格式 | FedRAMP 的合并规则以 JSON 及 JSON Schema 提供;BSI C5:2026 以 YAML 提供;Grundschutz++ 和 ISM 以 OSCAL 目录和 profile 提供 | 每个发布者一种方言,各自以自己的方式组织情态、期限和适用性。C5 以单独的文件分别提供德文和英文;Grundschutz++ 把它的词汇保存在没有任何校验器读取的 prop 中 |
| 映射语义 | NIST IR 8477 的关系样式;Secure Controls Framework 的 STRM;OWASP OpenCRE | IR 8477 定义的是关系,而不是文件格式。SCF 以电子表格和 PDF 发布其映射,只把它的目录导出为 OSCAL。OpenCRE 是一种中心辐射式的要求图,而不是目录格式 |
| in-toto 与 SCITT | 带有经审核谓词(predicate)的签名证明,用于来源出处、验证汇总、测试结果和 SBOM;基于已签名声明的 IETF 透明性服务 | 没有任何 in-toto 谓词用于证明控制措施或要求。SCITT 是一种透明性架构,而不是合规模型 |
| Heimdall Data Format、OCSF、SARIF | 检查和扫描的结果 | 它们承载的是检查发现了什么,而不是标准要求什么 |
| NIST IR 8286 | 风险登记册和风险详细记录的 Schema | 没有从风险到控制措施选择的边 |
| OpenControl、Compliance Masonry | YAML 格式的标准和组件叙述 | 自 2023 年以来没有实质性活动 |
| ISO/IEC 27001 与 27002、IEC 62443、PCI DSS | 标准本身 | 没有官方的机器可读版本;SCF 和 CISO Assistant 中有第三方的转写版本 |
JASCON 的大部分内容并不新。下面每项特性都能在某个同类格式中找到先例。
| JASCON 特性 | 最接近的现有技术 |
|---|---|
| 每个陈述的结构化情态 | Grundschutz++ 的情态动词词汇;FedRAMP 规则的关键词;OpenSSF OSPS Baseline |
| 以语言映射表表示的正文 | CISO Assistant 库格式的 translations 映射表;XCCDF 中重复的标题和描述上的 xml:lang |
| 以成员关系表示的基线 | OSCAL profile;XCCDF profile |
| 以封闭操作列表表示的裁剪 | OSCAL profile 的 alter 和 set-parameter;XCCDF 的 refine-value |
| 类型化的跨框架映射 | NIST IR 8477;Secure Controls Framework 的 STRM;OSCAL 1.2 映射模型;Gemara 映射文档 |
| 类型化、受 Schema 约束的扩展 | CISO Assistant 内的类型化自定义字段;收窄 Gemara 封闭 Schema 的 CUE profile,OSPS Baseline 即是如此;带命名空间但无类型的 OSCAL prop;外部命名空间中仅作宽松校验的 XCCDF 元素 |
| 从组件到发现项的链条 | OSCAL 生命周期模型;CycloneDX 声明(declarations) |
| 针对要求的签名证明 | CycloneDX 的确认声明及基于规范化 JSON 的签名(ECMA-424);已签名和会签的 SCAP 数据流;in-toto 的 DSSE 信封 |
| 风险记录 | OSCAL 的 risk 组件(assembly),属事后记录;Gemara 风险目录;CISO Assistant 内的风险场景和风险接受;NIST IR 8286 |
| 厂商建议与控制措施相互隔离 | OSCAL 组件定义;XCCDF Tailoring 文件,它不改动厂商的基准 |
| 有批准人的例外记录 | XCCDF 的 override,含授权方、时间和理由;CISO Assistant 中的安全例外;OSCAL 上的 FedRAMP 偏离 prop |
这四项各自都有部分先例。该主张针对的是它们的组合,其可靠程度取决于调研的充分程度。Gemara 和 CycloneDX Attestations 是最接近的同类格式,来自这两个社区的读者都会问,JASCON 为什么不去扩展他们的格式;手册在附录 F.10 中作了回答。证明方面的差距很小:in-toto 没有用于证明要求的谓词,而若将 JASCON 证明表达为这样一个谓词,便可接入现有的验证器生态。对用户和审计人员重要的十项特性,在首页上进行了比较。
PRIOR-ART.md,含来源