用于 CVE-2026-58043:Node.js 权限模型路径前缀过度授权 的离线证据检查工具。它将操作人员报告的 Node.js 运行时版本与厂商公告中的修复版本进行比对,并输出 CSV、JSON 或 HTML 分类报告。
exploitability: not_tested。报告为已修复的版本并不代表已部署的进程已打补丁。unknown。公开 URL 并不等同于资产清单。node_cve_2026_58043_check.py 可单独复制使用。--version、--inventory 或 --csv-list 提供。CI 在 Ubuntu 和 Windows 上,于 Python 3.10 和 3.14 中运行仅本地测试和 --help。
# Assess one reported version and print a JSON report
python node_cve_2026_58043_check.py --version 22.23.2 --format json
# Assess a JSON inventory and save an HTML report
python node_cve_2026_58043_check.py --inventory examples/inventory.example.json --format html --output report.html
# Assess a CSV list; exit 1 if any result is a finding
python node_cve_2026_58043_check.py --csv-list inventory.csv --fail-on-finding
# Show all options, then run the local tests
python node_cve_2026_58043_check.py --help
python -m unittest -v
提供一个取自已部署进程的准确版本;不要从 lockfile 或工作站上猜测。默认输出格式为 csv,除非指定 --output,否则写入 stdout。
打开合成示例报告。仅为示例数据;这不是实时评估。
至少需要提供 --version、--inventory 或 --csv-list 之一。它们可以在一次运行中组合使用,并且所有格式都使用相同的证据。
| 选项 | 用途 |
|---|---|
--version VERSION(别名 --node-version) | 评估显式提供的 Node.js 版本。可重复;每个值描述一个独立的运行时。接受单个前导 v。 |
--build-source SOURCE | --version 构建的来源,最多 512 个字符。unknown(默认)、upstream、official 和 official_upstream 按上游构建进行比较;任何其他值(例如供应商名称)被视为供应商或自定义构建。 |
--permission-model-enabled、--filesystem-allowlist、--untrusted-inprocess-code | 每个都接受 true 或 false。操作员报告的观察结果应用于所有 --version 输入。 |
--inventory FILE | JSON 对象或条目数组。可重复。参见清单格式。 |
--csv-list FILE | 包含 node_version 列的 CSV。可重复。参见清单格式。 |
| 选项 | 用途 |
|---|---|
--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 | 打印工具名称和版本。 |
除非显式指定 --force,否则现有报告会受到保护,并且输入文件永远不能被覆盖,即使使用 --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;不假定它们已修补。unsupported_runtime。这是升级指导,并非声称此特定缺陷存在于每个历史构建中。计划来源(参见来源)已于 2026-10-24 审查;0.x 系列是推断的,因为计划仅列出 0.8、0.10 和 0.12。unknown。不要将未知构建标记为安全。unknown。缺少元数据并不能证明运行时不受影响。版本元数据不是补丁或构建签名。
status | 含义 |
|---|---|
potentially_affected | 所报告的版本低于其主版本的修复版本。需要进行修复审查;未测试可利用性。 |
fixed_version_reported | 所报告的版本等于或高于修复版本。这并非已部署补丁的证明:请确认正在运行的进程或容器实际使用的是该版本。 |
unsupported_runtime | 所报告的主版本已过生命周期终止。请迁移到受支持的修复版本。 |
unknown | 证据缺失或无法分类。请收集确切的上游版本和构建来源,然后再次运行检查器。 |
每个结果还有一个更具体的 version_status:
version_status | 适用情形 |
|---|---|
below_fixed_version | 版本低于所列主版本的修复版本。 |
at_or_above_fixed_version | 版本等于或高于所列主版本的修复版本。 |
unsupported_release_line | 根据发布计划,该主版本已生命周期终止。 |
release_line_not_in_rules | 该主版本不在此规则快照的覆盖范围内。 |
vendor_build_unverified | 报告了供应商、发行版、自定义或无法识别的构建来源;上游版本无法验证该构建包含哪些补丁。 |
qualified_version_unverified | 版本带有预发布或其他后缀。 |
unrecognized_or_partial_version | 版本无法解析为纯 MAJOR.MINOR.PATCH 格式,或不是文本。 |
conflicting_versions | 为一个运行时报告了多个不同的版本。 |
version_not_disclosed | 未报告版本。 |
每个结果都有 exploitability: not_tested、evidence_type: operator_reported_version,以及 low 的 evidence_confidence,对于 unknown 结果则为 insufficient。
你可以记录是否观察到公告中的前置条件。这些由操作员提供且未经核实。它们绝不会改变版本结果或确立可达性。
| 观察项 | 含义 |
|---|---|
permission_model_enabled | 权限模型已启用 |
filesystem_allowlist | 文件系统允许列表 |
untrusted_inprocess_code | 不可信的进程内代码 |
在报告中,每个观察项显示为 reported_true、reported_false 或 not_reported。
输入文件必须是常规 UTF-8 文件。请使用稳定的本地副本。
JSON(--inventory):一个对象或一个数组。每条记录需要整数 schema_version: 1 和字符串 node_version。可选字段为 runtime(仅限 "node")、label、build_source,以及上述三个观察项键,每个为布尔值或 null。未知键、重复键、非有限数字和无效类型将被拒绝。合成示例位于 examples/inventory.example.json:
[
{
"schema_version": 1,
"label": "example-service",
"runtime": "node",
"node_version": "22.23.2",
"build_source": "unknown",
"permission_model_enabled": null,
"filesystem_allowlist": null,
"untrusted_inprocess_code": null
}
]
CSV(--csv-list):必须包含表头行,且表头中必须包含 node_version。可选列为 label、build_source 以及观测列,观测列的单元格取值为 true、false 或留空。未记录或重复的列、字段数量不一致的行、未加引号单元格内的裸引号、闭合引号之后的文本、未闭合的引号以及 NUL 字符都会被拒绝。
未提供标签时,会根据文件名和条目编号生成一个标签。
所有格式都携带相同的评估结果,并保留规范的 tool、tool_version 和 UTC 时间 generated_at。该时间戳在每次 CLI 运行时只采集一次,并在中断恢复时复用;它描述的是检查器生成的时间,而不是操作员观测运行时的时间。规则审查日期(rules_as_of)保持独立。
tool、tool_version、report_schema_version(1.0)、cve、rules_as_of、sources、complete、generated_at 和 results。record_type=result 标记已完成的评估。当不存在结果时,单行 record_type=summary 会保留 report_complete 和规则元数据,但不包含资产或判定。tool、tool_version 和 generated_at 会追加在现有列之后,摘要行也不例外。notes 和 sources 等列表值以 | 连接。--version 值),每个文本字段最多 512 个字符。