针对 CVE-2026-88774(NetScaler HTTP URL 表达式策略绕过)的离线版本与配置排查工具。
一个独立的 Python 3.10+ 检查器,仅使用标准库,将操作人员报告的 NetScaler 构建版本和配置证据与厂商的修复版本进行比对。它完全离线运行:不具备设备访问、应用执行、漏洞利用载荷或网络模式,且仅覆盖这一个 CVE。
[!IMPORTANT] 报告的版本是操作人员的声明,而非经过验证的运行时状态。
potentially_affected并非已确认的可利用性,fixed_version_reported并非经过验证的补丁或安全保证,而unknown永远不代表安全。每个结果都带有exploitability: not_tested。
Python 3.10 或更高版本。无需安装任何内容,也没有依赖项;在没有 python 的情况下请使用 python3。运行 --help 可查看所有选项,运行 --tool-version 可查看检查器版本。
# One reported build
python netscaler_cve_2026_88774_check.py --version 14.1-73.36 --variant standard
# The synthetic example inventory as a self-contained HTML report
python netscaler_cve_2026_88774_check.py --inventory docs/example-inventory.json --format html --output report.html
# Your own CSV inventory as JSON, with a non-zero exit when firmware is potentially affected
python netscaler_cve_2026_88774_check.py --csv-list inventory.csv --format json --fail-on-finding
除非指定 --output,否则报告会以 JSON 格式输出到标准输出。如果报告文件已存在,除非传入 --force,否则会拒绝写入。
--version、--inventory 和 --csv-list 可以在一次运行中组合使用。至少需要提供其中一个。
| 选项 | 用途 |
|---|---|
--version BUILD | 指定一个待报告的构建版本。可重复使用。 |
--variant standard|fips|ndcpp | 应用于每个 --version 的变体。未明确说明的歧义变体保持为 unknown。 |
--build-source | 应用于每个 --version 的来源信息。只有空值、unknown、official 和 citrix 允许进行比较;任何其他值都会使结果保持为 unknown。 |
--inventory FILE | 严格 JSON 格式的清单文件。可重复使用。 |
--csv-list FILE | 严格 CSV 格式的清单文件,需包含 version 表头。可重复使用。 |
--http-url-policy-expression | 配置观察项:true、false 或 unknown(默认值)。参见配置观察项。 |
--format json|csv|html | 报告格式。默认为 json。 |
--output FILE | 新的报告文件。默认为标准输出。输出目录必须已存在。 |
--force | 显式替换已存在的报告文件。 |
--fail-on-finding | 当任何结果为 potentially_affected 时以 1 退出。参见退出码与中断。 |
--tool-version | 打印检查器名称和版本。 |
请注意,--version 接受的是 NetScaler 构建版本,而非检查器版本。
清单文件。 JSON 清单为 UTF-8 对象或非空数组;每个条目需要整数类型的 schema_version: 1 和字符串类型的 version(空值为 unknown),并可添加 label、variant、build_source、观察项字段以及最多 16 个 version_candidates。CSV 文件需要 version 列,并可添加 label、variant、build_source 和观察项列;schema_version 和 version_candidates 仅限 JSON 使用。未知字段、重复的键或表头、类型错误以及格式错误的行都会被视为错误。
限制。 每次运行最多 100 个输入文件和 10,000 个观察项,每个文件最大 4 MiB,每个字符串最大 512 个字符。输入必须是常规文件;归档文件和目录树永远不会被打开。参考文档包含完整的输入约定,docs/example-inventory.json 是一个合成清单,不描述任何真实系统。
仅当构建版本严格早于同一分支和变体的修复构建版本时,才被视为可能受影响。不会臆造任何下界或生命周期结论。
| 分支和变体 | 厂商修复构建版本 |
|---|---|
| 14.1 standard | 14.1-73.37 |
| 13.1 standard | 13.1-64.23 |
| 14.1 FIPS | 14.1-73.37 |
| 13.1 FIPS/NDcPP | 13.1-37.279 |
其他分支和 14.1 NDcPP 保持为 unknown。当 standard 和 FIPS/NDcPP 的比较结果不一致时,未明确说明的 13.1 变体保持为 unknown。
接受的构建文本。 14.1-73.37、14.1.73.37 和 NS14.1: Build 73.37.nc,可选在可选的 nc 标记之前标注 FIPS 或 NDcPP。仅提供构建文本,而非完整的 show version 行。格式错误、带限定符、非 ASCII、冲突、自定义构建以及未覆盖的证据均保持为 unknown。
以 true、false 或 unknown 的 CLI 标志、JSON 布尔值或 null,或文档中记录的 CSV 值形式提供显式观察项。观察项与版本状态保持独立,且不能证明可达性。不会收集任何本地配置或进程数据。
| CLI 观察项 | 含义 | 暴露条件期望值 |
|---|---|---|
--http-url-policy-expression | 某个策略使用了基于 HTTP URL 的表达式 | true |
| 字段 | 取值 | 含义 |
|---|---|---|
version_status | potentially_affected | 所报告的构建版本低于其分支和变体的修复构建版本。 |
fixed_version_reported | 所报告的构建版本等于或高于该修复构建版本。这是所报告的版本,而非经过验证的补丁。 | |
unknown | 证据缺失、格式错误、相互冲突、自定义构建或未被覆盖。切勿将其解读为安全。 | |
precondition_status | conditions_observed、condition_not_observed、unknown | 仅是对操作员配置观察结果的汇总。它绝不是经过验证的暴露情况,也不是干净的结果。 |
remediation_status | firmware_update_required、version_verification_required、version_requirement_reported | 版本结果所隐含的处置要求,与可利用性无关。 |
exploitability | not_tested | 始终如此。不运行任何漏洞利用,也不联系任何设备。 |
version_reason 说明分支、构建版本和变体的判定依据。其主要 unknown 原因包括:版本缺失或格式错误、版本或变体相互冲突、无法识别的变体、未覆盖的分支或变体、所需变体不明确,以及自定义构建来源。对于不明确的 13.1 构建版本,fixed_version 可以列出备选变体的阈值。
操作故障(退出码 2)不属于评估结果,输入或渲染错误不会发布任何报告。
支持 JSON、公式安全的 CSV 以及自包含、无脚本的 HTML。合成示例输入和生成的示例报告不描述任何真实系统。
来源信息。 每种格式都会保留检查器名称和版本、UTC 报告生成时间以及正在执行的独立文件的 SHA-256。该摘要标识的是本地检查器字节,而非设备的真实性或补丁状态。CSV 在结果行和空摘要中都包含这些字段;HTML 显示所报告的和规范化后的变体,并明确标注 unknown 值。一次 CLI 运行只保留一个时间戳,包括在未完成报告恢复期间也是如此。
构建证据。 每个结果都会保留其解析后的主要和候选构建证据,并附带输入字段和候选索引,包括冲突情况。无法解析的候选文本会连同原因一并省略,且不会将任何原始候选文本复制到报告中。冲突保持为 unknown,这些操作员声明不能证明已部署补丁。
带日期的 KEV 元数据。 结果还带有附加的 kev_* 字段,来自 CISA KEV 目录的一份带日期、固定版本的快照(已验证于 2026-10-25)。本公告为 not_listed。不会发起任何网络请求,这些字段绝不会改变本地分类,且“未列出”并不构成安全或未被利用的证据。参见 KEV 元数据。
输出保护。 输出不得解析或硬链接到任何输入,即使使用 --force 也不行。文件会先完整渲染,以仅所有者可访问的权限写入(POSIX 上为 0600;Windows 上为继承的 ACL),然后原子化发布。未使用 --force 时,发布失败而不会回退为覆盖式重命名。诊断信息不会回显私有路径或所提供的值。有关 JSON、CSV 和 HTML 模式以及 CSV 摘要行,请参见参考文档。
| 退出码 | 含义 |
|---|---|
0 | 已写入报告。unknown 结果不会改变退出码,也绝不代表一切正常。 |
1 | 已指定 --fail-on-finding,且某个结果为受影响的固件。(帮助文本还提到需要增强 ISN 变更;本 CVE 的规则未启用该变更。) |
2 | 用法、输入或输出错误。输入和渲染错误不会发布任何内容。 |
130 | 已中断。 |
中断的运行会尽可能保留已完成的观测结果,并附带明确的完整性元数据。在验证之前,不会写入任何内容。在发布之前,已完成的观测结果会尽可能以完整性为 false 的状态输出一次,其中包括一个空的 CSV 摘要。在文件发布之后,或者一旦单次缓冲的 stdout 写入开始,就不会进行任何重试。第二次中断会以退出码 130 放弃。如果发布过程被中断且无法验证其是否完成,检查器不会声称已发布报告,因此在再次运行之前请检查报告文件。stdout 的 I/O 错误可能会留下接收端已经接受的字节。参考文档中有完整的语义说明。
厂商公告和 CNA 记录已于 2026-10-24 审阅。厂商公告决定了分支、变体和修复构建版本的比较;此处保留了其中的差异。
主要来源: