针对 CVE-2026-56850 — Node.js:HTTPS Agent PFX 客户端身份冲突 的离线证据检查工具。它将操作员报告的 Node.js 运行时版本与 Node.js 安全公告中列出的修复版本进行比对,并将结果输出为 CSV、JSON 或无脚本 HTML。
该检查工具是一个仅使用标准库的单一 Python 3.10+ 文件,因此可执行文件可以单独复制并运行。
该检查工具仅对版本证据进行初步筛查。它不评估已部署的系统。
unknown。exploitability: not_tested。任何结果都不能证明该缺陷可被触达或已被利用。仅在你获得授权评估的资产清单上使用它。
CI 在 Ubuntu 和 Windows 上的 Python 3.10 和 3.14 中运行单元测试和 --help。
# Assess one runtime version and print JSON
python node_cve_2026_56850_check.py --version 22.23.2 --format json
# Assess the synthetic example inventory and save an HTML report
python node_cve_2026_56850_check.py --inventory examples/inventory.example.json --format html --output report.html
# Assess a CSV list and exit 1 if any result is a finding
python node_cve_2026_56850_check.py --csv-list inventory.csv --fail-on-finding
运行 python node_cve_2026_56850_check.py --help 查看选项列表,或运行 python -m unittest -v 执行本地测试套件。
打开合成示例报告。仅为示例数据;这不是实时评估。
不会自动扫描当前机器。请提供从已部署进程中获取的精确版本,然后选择输入源和输出格式。
你可以在一次运行中组合使用以下任意输入源;所有结果都会写入同一份报告。
| 选项 | 输入 |
|---|---|
--version VERSION(别名 --node-version) | 一个 Node.js 版本,例如 22.23.2;接受带前导 v 的写法。可重复使用;每个值描述一个独立的运行时。 |
--inventory FILE | JSON 对象或条目数组。可重复使用。参见 JSON 清单。 |
--csv-list FILE | 包含 node_version 列的 CSV。可重复使用。参见 CSV 列表。 |
至少需要一个输入源。JSON、CSV 和 HTML 报告均基于相同的证据构建。
| 选项 | 含义 |
|---|---|
--build-source SOURCE | --version 构建的来源,最多 512 个字符。unknown(默认值)、upstream、official 和 official_upstream 会按上游构建进行比较;任何其他值(例如供应商名称)会产生 vendor_build_unverified,状态为 unknown。 |
--shared-https-agent {true,false} | 应用于 --version 输入的操作员观察结果。 |
--pfx-object-arrays {true,false} | 应用于 --version 输入的操作员观察结果。 |
--different-client-certificates {true,false} | 应用于 --version 输入的操作员观察结果。 |
--format {csv,json,html} | 报告格式。默认为 csv。 |
--output FILE | 将报告保存到新文件。默认为 stdout。父目录必须已存在。 |
--force | 替换已存在的输出文件。未指定时,已存在的输出路径会报错。 |
--brand NAME | HTML 报告中显示的组织名称,最多 512 个字符。默认为 CompleteTech LLC。 |
--fail-on-finding | 当任何结果为 potentially_affected 或 unsupported_runtime 时以退出码 1 退出。参见 退出码与中断。 |
--tool-version | 打印检查器名称和版本,然后退出。(--version 是 Node.js 版本,不是检查器的版本。) |
三个观察选项仅适用于 --version 输入;清单和 CSV 条目自带观察结果。例如:
python node_cve_2026_56850_check.py --version 24.18.0 --build-source upstream --shared-https-agent true --format json
--force,否则永远不会替换已存在的输出文件。--output 必须与每个输入文件不同,即使指定了 --force 也是如此。输出必须是常规文件路径;目录和悬空符号链接会被拒绝。--force 时,发布使用硬链接,因此无法覆盖文件;在不支持硬链接的文件系统上,运行会失败,并提示选择其他文件系统或使用 --force。已于 2026-10-24 对照官方发布公告及关联的修复版本进行审查。公告特有的注意事项保留如下。
| Node.js 主版本 | 修复版本 |
|---|---|
| 22.x | 22.23.2 |
| 24.x | 24.18.1 |
| 26.x | 26.5.1 |
厂商未在发布公告中指明引入版本。因此,规则将每个所列主版本的更早普通版本视为 potentially_affected,并将所列修复版本及同一主版本上更晚的普通版本视为 fixed_version_reported。
对于每个所列主版本,低于其修复版本的版本需要修复。未列出的、自定义/向后移植的以及预发布构建需要明确证据;不要将未知构建标记为安全。
其他输入的分类方式:
unknown(release_line_not_in_rules);不会假定更新或未列出的主版本已修补。unsupported_runtime 作为升级指导。这并不表示该特定缺陷存在于每个历史构建中。unknown,因为上游版本无法显示该构建包含哪些补丁。unknown(qualified_version_unverified)。每个输入产生一个结果,包含 status 和更具体的 version_status。两者描述的都是所报告的版本证据,而非已部署系统。
status | 含义 |
|---|---|
potentially_affected | 所报告的版本低于其所属所列主版本的修复版本,需要修复审查。 |
fixed_version_reported | 所报告的版本等于或高于修复版本。这不是已部署补丁的证明;请确认正在运行的进程或容器实际使用了该发布版本。 |
unsupported_runtime | 该主版本已生命周期终止。这是升级指导,不是缺陷存在的证据。 |
unknown | 证据缺失或无法分类。请调查;不要将其视为安全。 |
每个结果还包含 exploitability: not_tested、evidence_type: operator_reported_version,以及 low 的 evidence_confidence(当状态为 unknown 时为 insufficient)。
version_status 取值:
version_status | 状态 | 原因 |
|---|---|---|
below_fixed_version | potentially_affected | 低于所列主版本的修复发布版本。 |
at_or_above_fixed_version | fixed_version_reported | 等于或高于所列主版本的修复发布版本。 |
unsupported_release_line | unsupported_runtime | 生命周期终止的主版本。 |
release_line_not_in_rules | unknown | 此带日期的规则快照未覆盖的主版本。 |
vendor_build_unverified | unknown | 报告了厂商、发行版、自定义或无法识别的 build_source。此检查先于生命周期终止检查,因此此类构建永远不会被报告为 unsupported_runtime。 |
qualified_version_unverified | unknown | 预发布、nightly/rc、带包后缀或其他限定版本。 |
unrecognized_or_partial_version | unknown | 不是普通的 MAJOR.MINOR.PATCH 版本。 |
version_not_disclosed | unknown | 未报告版本。元数据缺失并不表明运行时不受影响。 |
该公告涉及被授予 PFX 客户端身份的共享 HTTPS 代理。每个输入最多可记录三项操作员观察结果。每项观察结果报告为 reported_true、reported_false 或 not_reported。
| 观察项 | 含义 |
|---|---|
shared_https_agent | 共享 https 代理 |
pfx_object_arrays | pfx 对象数组 |
different_client_certificates | 不同的客户端证书 |
这些观察结果由操作员提供且未经核实。它们绝不会改变版本判定结果,也不构成可达性证明。
输入内容不可信。任何无效条目都会导致整个运行失败,退出码为 2,且不会生成报告。
一个对象或对象数组。每条记录要求整数 schema_version: 1 和字符串 node_version。可选字段为 runtime: "node"、label、build_source,以及上述三个观察项键,每个均为布尔值或 null。未知键、重复键、非有限数值和无效类型都会被拒绝。文本字段最多 512 个字符。没有 label 的条目在报告中命名为 <file name without extension>:<position>;--version 输入命名为 Node.js <version>。
[
{
"schema_version": 1,
"label": "example-service",
"runtime": "node",
"node_version": "22.23.2",
"build_source": "unknown",
"shared_https_agent": null,
"pfx_object_arrays": null,
"different_client_certificates": null
}
]
这是 examples/inventory.example.json(合成数据)。