针对 CVE-2026-58040 — Node.js:HTTPS Agent TLS 会话身份策略绕过 的离线证据检查工具。它将操作人员报告的 Node.js 运行时版本与厂商公告中列出的修复版本进行比对,并生成 CSV、JSON 或不含脚本的 HTML 分诊报告。要求 Python 3.10+,仅使用标准库;可执行文件可单独复制使用。
概述 · 快速开始 · 报告预览 · 用法 · 输入文件 · 结果解读 · 输出格式 · 限制与退出码 · 局限性 · 来源 · 文档 · 贡献与许可证
本仓库仅涉及 CVE-2026-58040。该检查工具评估你提供的版本证据;它属于分诊,而非漏洞扫描。
unknown。exploitability: not_tested。potentially_affected 并非已确认的可利用性,fixed_version_reported 也不能证明已部署的运行时已打补丁。本文档中的任何内容均不声称已实现利用或生产环境验证。要求:Python 3.10 或更高版本。无需安装任何内容;CI 在 Ubuntu 和 Windows 上使用 Python 3.10 和 3.14 运行测试。
# One exact runtime version, JSON report on stdout
python node_cve_2026_58040_check.py --version 22.23.2 --format json
# A JSON inventory, saved as an HTML report
python node_cve_2026_58040_check.py --inventory examples/inventory.example.json --format html --output report.html
# Your own CSV list (see Input files), exiting 1 if any result is potentially_affected or unsupported_runtime
python node_cve_2026_58040_check.py --csv-list inventory.csv --fail-on-finding
# Full option list, and the local-only test suite
python node_cve_2026_58040_check.py --help
python -m unittest -v
默认输出格式为 stdout 上的 CSV。在依据报告采取行动之前,请先阅读解读结果。
打开合成示例报告。仅为示例数据;这不是实时评估。
至少提供 --version、--inventory 或 --csv-list 中的一项;它们可以在一次运行中组合使用,并且所有输入都会使用相同的规则进行评估。不接受选项缩写。
| 选项 | 用途 |
|---|---|
--version VERSION(别名 --node-version) | 离线评估一个明确的 Node.js 版本。接受单个前导 v。可重复使用;每个值描述一个独立的运行时。 |
--build-source SOURCE | --version 构建的来源(最多 512 个字符)。默认值 unknown、upstream、official 和 official_upstream 会作为上游构建进行比较;任何其他值都会被视为供应商、发行版或自定义构建,结果保持为 unknown。 |
--https-agent-session-reuse {true,false}--different-identity-policies {true,false} | 操作员报告的前置条件观察结果,应用于每个 --version 输入。省略表示未报告。参见操作员报告的前置条件。 |
--inventory FILE | JSON 对象或条目数组。可重复使用。参见输入文件。 |
--csv-list FILE | 包含 node_version 列的 CSV 列表。可重复使用。参见输入文件。 |
--format {csv,json,html} | 报告格式。默认:csv。所有格式都携带相同的证据。 |
--output FILE | 将报告写入新文件而不是 stdout。 |
--force | 替换现有的 --output 文件。没有它,现有报告会受到保护。输入文件永远不会被覆盖,即使使用 --force 也是如此。 |
--brand NAME | HTML 报告中显示的组织名称(最多 512 个字符)。默认:CompleteTech LLC。 |
--fail-on-finding | 当任何结果为 potentially_affected 或 unsupported_runtime 时退出码为 1。操作错误仍以退出码 2 退出。 |
--tool-version、--help | 打印检查器名称和版本,或完整帮助。 |
前置条件标志和 --build-source 仅适用于 --version 值。对于文件,请在每条记录中设置 build_source 和观察结果。
提供稳定的本地常规 UTF-8 文件。将真实清单、目标、报告和机密保留在版本控制之外;合成示例位于 examples/ 和 docs/example-report.html 中。
JSON 清单是一个对象或由 1 到 10,000 个对象组成的数组。每条记录需要整数 schema_version: 1 和字符串 node_version。可选字段为 runtime(仅限 "node")、label、build_source,以及操作员报告的前置条件下列出的两个观察键,每个均为布尔值或 null。未知键、重复键、非有限数字和无效类型都会被拒绝。
[
{
"schema_version": 1,
"label": "example-service",
"runtime": "node",
"node_version": "22.23.2",
"build_source": "unknown",
"https_agent_session_reuse": null,
"different_identity_policies": null
}
]
CSV 列表需要包含一个带有 node_version 列的表头行。可选列为 label、build_source、https_agent_session_reuse 和 different_identity_policies;观测单元格必须恰好为 true、false 或空白。不存在 schema_version 或 runtime 列。未记录或重复的列、字段数与表头不同的行、未加引号单元格内的引号、闭合引号之后的文本、未终止的引号、NUL 字符以及空列表均会被拒绝。
label,node_version,build_source,https_agent_session_reuse,different_identity_policies
example-service,22.23.2,unknown,,
每个输入产生一个结果。结果是对上报的版本证据与带日期的规则快照进行比对评估;它从不测试可利用性。
已于 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。已停止维护(EOL)的旧主版本会产生 unsupported_runtime,作为升级指引,而非声称此特定缺陷存在于每个历史构建中。厂商构建、向后移植构建和自定义构建需要厂商证据,并保持 unknown。
公告注意事项,保留在每个结果中:对于每个所列主版本,低于其修复版本的版本需要修复。未列出、自定义/向后移植和预发布构建需要明确证据;不要将未知构建标记为安全。厂商在发布公告中未指定引入版本。
仅比较普通稳定版 MAJOR.MINOR.PATCH 版本。忽略周围的 ASCII 空白和一个前导 v。
status | version_status | 含义 |
|---|---|---|
potentially_affected | below_fixed_version | 上报版本低于其所属所列主版本的修复版本,需要修复审查。 |
fixed_version_reported | at_or_above_fixed_version | 上报版本等于或高于其所属所列主版本的修复版本。这是上报版本,而非已部署补丁的证明。 |
unsupported_runtime | unsupported_release_line | 该主版本在 Node.js 发布计划中已停止维护(截至 2026-10-24 审查,主版本 0、4–21、23 和 25;主版本 0 为推断)。仅为升级指引。 |
unknown | version_not_disclosed | 未上报版本。 |
unknown | unrecognized_or_partial_version | 该值不是普通 MAJOR.MINOR.PATCH 版本,例如 22.23。 |
unknown | qualified_version_unverified | 版本后跟有预发布、nightly/rc 构建、包后缀或自定义限定符。 |
unknown | vendor_build_unverified | 上报了非上游的 build_source。这优先于版本比较;上游版本无法显示该构建包含哪些补丁或向后移植。 |
unknown | release_line_not_in_rules | 该主版本既未列于上方,也非 EOL。较新或未列出的主版本不被假定为已修补。 |
unknown 表示证据缺失或无法分类,需要调查。它不表示不受影响。结果带有 evidence_type: operator_reported_version,其中 unknown 的 evidence_confidence 为 insufficient,其他情况为 low,并附带建议的下一步。
输入可附带两个可选观察项。它们由操作员提供且未经核实,在报告中显示为 reported_true、reported_false 或 not_reported,并且从不改变版本结果或确立可达性。
| 观察项 | 含义 |
|---|---|
https_agent_session_reuse | https agent 会话复用 |
different_identity_policies | 不同的身份策略 |
CSV、JSON 和 HTML 报告由同一证据生成。报告在写入任何内容之前完全在内存中渲染,因此编码错误不会留下半写入的文件。
=、+、-、@)。已完成的评估使用 record_type=result。当不存在结果时,单行 record_type=summary 会保留 report_complete 和规则元数据,而不包含资产或判定。包含 NUL 字符的值会在写入报告之前被拒绝。tool、tool_version、report_schema_version、cve、rules_as_of、sources、complete、generated_at 以及一个 results 数组。CSV 报告 schema v1 在现有列之后追加 tool、tool_version 和 generated_at。每个结果和空摘要都携带规范检查器身份和一个 UTC ISO-8601 运行时间戳,与 JSON、HTML 和中断恢复共享。此生成时间与 rules_as_of 不同,并且不证明证据是何时获取的或部署是何时修补的。
| 限制 | 值 |
|---|---|
| 文件大小 | 每个文件 4 MiB |
| 输入文件 | 每次运行 100 个(--inventory 和 --csv-list 合计) |
| 条目 | 每次运行 10,000 个(包括 --version 值) |
| 文本字段 | 512 个字符 |