裁剪后的参数会重新调校检查
在 Tailoring 中把 max-auth-tries 从 6 收紧到 4,昨天观测到的 5 就会从“满足”变为“不满足”。没有任何一行代码改变,实施方也无法自行设定及格线。
检查 · 内核 2.0.0,发布候选版
一个只以 0 或 1 退出的扫描器,会隐藏自己的阈值、忽略裁剪,也不留下任何可供复查的东西。Check 公开采集器必须报告的事实,以及作出判定的比较。运行记录携带了观测到的内容,因此任何人都能根据记录重新计算判定。
01 缺口
JASCON 1.0.0 能够表达某个要求已被评估,以及评估者得出了什么结论,却无法表达机器如何作出判定。
这些规则无一例外地以 audit 字符串的形式进入转换后的捆绑包,shell 片段夹杂在正文中。通过条件是诸如“verify the output is”这样的句子,必须由人来阅读。
ISM、Grundschutz++ 和 SP 800-53 列出了方法(审查、访谈、测试)和所需文档。FedRAMP CR26 以正文形式给出关键测试。它们都没有规定一个可由程序求值的检查。
统计数字:CP-CHECK-1 第 2.1 节,来自已转换语料库的覆盖率报告。
02 设计
界线划在工具之间必须达成一致的地方。两个符合规范的工具,给定同一个 Check 和同一个观测值,会返回相同的判定。凡是可以在诚实的工具之间有所不同、而又不改变判定的东西,都留在内核之外。
一个 shell 脚本、一个 Ansible 任务或一次 API 调用,随 Check 一起携带,使该检查的摘要覆盖确切的代码。它输出一个观测值,不作任何判定。
具名、有类型的事实,例如 sshd.maxauthtries:整数。采集器报告的是生效值,并已解析默认值。缺失的键表示“查找过,但未找到”。
一个扁平的合取式,例如 at-most {param}。期望值是一个字面量或该要求的一个参数,因此由绑定该参数的 Tailoring 设定及格线。
满足、不满足、无定论或不适用:它是 Check、观测值和已绑定参数的纯函数。校验器会重新计算每一个已记录的判定。
在 Tailoring 中把 max-auth-tries 从 6 收紧到 4,昨天观测到的 5 就会从“满足”变为“不满足”。没有任何一行代码改变,实施方也无法自行设定及格线。
Assessment 的记录行中保存着观测值本身。第二方据此对判定条件求值并加以比较。已记录的结果若与计算结果不同,即为校验错误。
一条未通过的记录行写着 sshd.ciphers matches-not ".*-cbc",观测到的是一个包含 aes128-cbc 的列表。换作退出码,就只有一个 1。
03 动手试试
仓库中的完整示例:一个包含两个条款的要求、一个面向生产主机的 Tailoring、两个 Check,以及一台堡垒机的两次已记录的每日运行。您可以修改采集器看到的内容,或 Tailoring 绑定的值。
s1 SSH 守护进程每个连接最多允许 4 次认证尝试。
s2 SSH 守护进程不提供任何 CBC 模式的加密算法。
由应用移植的 check-verdict 在您的浏览器中计算,正是这段代码通过了 205 个检查测试向量。此处不运行任何采集器;观测值就是您所设定的值。
{
"id": "https://cso.example/check/LNX-SSH-1-maxauthtries",
"requirement-ref": "https://cso.example/req/LNX-SSH-1",
"statement-ids": ["s1"],
"platform": "https://cso.example/platform/linux-host",
"observes": [
{ "name": "sshd.maxauthtries", "type": "integer" }
],
"criteria": [
{ "fact": "sshd.maxauthtries", "op": "at-most",
"expected": { "param": "max-auth-tries" } }
],
"validity": { "num": 24, "unit": "hours" },
"confidence": "reviewed",
"facets": {
"https://ns.jascon.net/stdlib/facet/collector@1": {
"collectors": [
{ "id": "bash", "runtime": "bash", "privileges": "root",
"source": "#!/bin/bash\nv=$(sshd -T | awk '$1==\"maxauthtries\"{print $2}') ..." }
]
}
}
}
{
"check-ref": "https://cso.example/check/LNX-SSH-1-ciphers",
"check-digest": "sha256:b5ec275f0904a0a882d27e1434efb28e0595a74c6c0814297b2537fa49833f56",
"collector-id": "bash",
"outcome": "not-satisfied",
"time": "2026-11-03T06:00:04Z",
"observation": {
"facts": {
"sshd.ciphers": ["chacha20-poly1305@openssh.com",
"aes256-gcm@openssh.com", "aes256-ctr", "aes128-cbc"]
}
},
"evidence-record": {
"ref": "evidence/sha256/61c0ab97f7c9033b00b61a1eb09b5aa40d648114422ffa040aa779b09a9118fc",
"digest": "sha256:61c0ab97f7c9033b00b61a1eb09b5aa40d648114422ffa040aa779b09a9118fc"
}
}
{
"id": "https://cso.example/finding/bastion-01-ssh-cbc",
"assessment-ref": "https://cso.example/assessment/bastion-01-2026-11-03",
"requirement-ref": "https://cso.example/req/LNX-SSH-1",
"statement-ref": "s2",
"check-ref": "https://cso.example/check/LNX-SSH-1-ciphers",
"state": "closed",
"actions": [
{ "description": { "en": "Remove aes128-cbc from the Ciphers line of sshd_config; the next daily run verifies." },
"status": "done" }
]
}
aes128-cbc,不满足。该 Assessment 的结果是其各记录行的汇总。该示例并未评估任何真实主机。每次运行都原样执行了 Check 中的 bash 采集器,执行对象是一个输出固定配置的 sshd 桩程序,每条证据记录都如实注明了这一点。
04 比较算子
这个集合是有意保持精简的。不符合的检查仍为人工检查,并计入统计。
one-of 表示,否定则体现在成对的算子中。at-most 绝不绑定向上收紧的参数,这样收紧参数就不可能放宽检查。| 算子 | 作用对象 | 成立条件 |
|---|---|---|
equals | 单个值 | 该值等于期望值;小数按数值比较 |
not-equals | 单个值 | 该值不同于期望值;事实缺失时为无定论 |
one-of | 单个值 | 该值在列表中 |
at-least at-most | 整数、小数 | 大小比较;小数绝不按浮点数处理 |
present absent | 任意事实 | 该键在观测值中存在,或不存在 |
includes-all | 列表 | 所列的每个值都出现 |
excludes-all | 列表 | 所列的值均未出现 |
subset-of | 列表 | 观测到的每个值都在所列范围内 |
matches matches-not | 字符串、代码 | 整个值与某个 I-Regexp 模式匹配,或者没有任何模式匹配 |
手册拒绝使用表达式语言,因为那样一来,两个符合规范的工具可能返回两个不同的判定。Python、.NET 和 JavaScript 恰恰在人们最常用的构造上存在分歧:\d、\w、锚点、标志、环视。因此选用的方言是 I-Regexp(RFC 9485),它由 IETF 为互操作性而制定,并被 JSONPath 采用。
^ 和 $ 是普通字符。\p{..} 从宿主的数据库中读取(待办事项 59)。05 证据
证据是内容清单旁边的一个目录。每个文件都以其字节的 SHA-256 命名。脱敏在计算哈希之前进行,原始输出是单独的文件,因此按保留期限删除文件后,记录依然可以验证:校验器会将该文件报告为“不予提供”。
绑定 Assessment 的语义摘要。
以内联方式保存观测值,因此该摘要也覆盖了观测值。它同时通过引用和摘要指明所用的 Check:检查一旦改变,就是另一个检查。
写明检查、采集器、被检对象、开始与结束时间以及退出状态,并携带同一观测值的摘要。
stdout 或 API 响应,各以摘要标识,并附媒体类型、大小和脱敏标志。
06 实测适配度
比较算子集合是先起草、后测量的,测量对象是两个公开的检查语料库:ComplianceAsCode 中面向 Ubuntu 24.04 的四个 CIS profile(510 条规则),以及 kube-bench 的 CIS 1.12 检查(103 项自动化、28 项人工)。
| 类别 | 规则数(共 510 条) |
|---|---|
| 符合其中 23 条仅在采集器解析生效值、并以标志集合报告模式位时才符合 | 481 |
| 需要算术运算计数、唯一性、与当前时间比较 | 12 |
| 需要在两个事实之间比较 | 9 |
| 需要跨事实的 OR | 6 |
| 需要版本排序 | 2 |
| 需要 I-Regexp 之外的正则表达式 | 0 |
起草时的集合中没有“不等于”。普查在 OVAL 的 state 中发现了 2 处,在 kube-bench 的所有目录中共发现 85 处;而对于数值,没有其他算子能表达这一点。它于 11月12日作为第十二种比较算子加入。不符合的 29 条规则仍为人工检查。
07 状态
2026年11月12日,作者对该提案的未决问题作出了决定。自 2.0.0-rc.2 起,Check 已成为发布候选版的一部分,并将随 2.0.0 正式生效。该候选版目前为 rc.4,尚未打标签。
collector@1;CHECK-1 至 CHECK-15 以及原语 check-verdict,每一项都带有在失败时输出的理由。| 向作者提出的问题 | 2026年11月12日的决定 |
|---|---|
| 晋升规则要求普查所涵盖的三个权威机构中有两个对某种类型进行了编码。而没有任何一个编码了检查。 | 该规则针对目录权威机构不发布的类型新增了一个条款:要么有公认标准要求该记录,要么它是经两个已统计的开放实现证实的既定做法;另外两项检验仍须满足;它须随主版本引入。Risk 依据第一个分支纳入,Check 依据第二个分支纳入。 |
| 运行记录行:内核字段还是分面? | 内核字段。判定是计算,而分面从不定义计算。 |
| Check 能否不附带其所引用的要求而单独发布? | 可以。针对不得再分发的目录的检查包,可以独立通过校验。 |
| 现在落地,还是等待云 API 普查? | Check 随 2.0.0 正式生效。 |
| 除“每个资源”之外,是否还要另一个量词? | 不需要。每个资源都被求值并记录,报告失败占比,且检查判为不通过。 |
是否增加第十二种比较算子 not-equals? | 已增加。 |
提案及其普查、未被采纳的备选方案(判定条件放在分面中,日后再晋升)以及决定记录:drafts/CP-CHECK-1.md。规范性文本:规范 2.0.0-rc.4,D24。
每一种内核类型,都要由所有校验器永久地为之付出代价;打标签之后再修正,则要付出一个主版本的代价。候选版需要以运行扫描器为职业的读者来审阅:事实契约对您的平台是否成立?您的哪些检查落在十二种比较算子之外?