将上报的 NetScaler 构建版本与 CVE-2026-88771 进行比对检查
离线、单文件、无依赖,支持 JSON、CSV 和 HTML 报告
netscaler-cve-2026-88771-check 会将你提供的 NetScaler ADC 和 Gateway 构建版本号与经过验证的内嵌公告快照进行比对。它无需任何软件包、网络访问或配套运行时文件。JSON、CSV 和离线 HTML 报告共享同一套经过验证的证据记录。
工作原理:
potentially_affected、fixed_version_reported 或 unknown。[!IMPORTANT] 上报的构建版本并不等同于经过验证的补丁状态。 这是一项证据评估:所提供的构建版本和导出结果并不能证明实际部署的内容。可达性、本地利用(
exploitability始终为not_tested)以及先前是否已被入侵均未测试。厂商声明此漏洞不需要任何可选配置功能,因此 DTLS、Gateway 角色和 SAML 检测并非适用性门槛。在实施修复前,请查阅当前的厂商公告。
本仓库仅涵盖一个 CVE;相邻的 NetScaler 漏洞需要各自的检查工具。
netscaler_check.py。可单独复制;运行时无需任何配套文件。# Single appliance: edition is required for classification
python netscaler_check.py --product netscaler-adc --edition standard --version 14.1-73.36
python netscaler_check.py --product netscaler-adc --edition fips --version "13.1.37.279 FIPS"
# Synthetic sample inventory, JSON to stdout
python netscaler_check.py --inventory examples/inventory.csv --format json
# Offline HTML report with your own label and logo
python netscaler_check.py --inventory examples/inventory.csv --format html --output report.html --brand "Example organization" --logo assets/logo.png
examples/ 仅包含合成数据。请勿提交真实的资产清单或报告。
运行 python netscaler_check.py --help 可查看完整的 CLI。 参考文档 是输入、限制和输出的权威说明。
--version 和 --inventory 必须且只能指定其中一个。
| 选项 | 用途 |
|---|---|
--version BUILD | 评估一个确切报告的构建版本。需要配合 --product。 |
--inventory CSV | 评估 CSV 资产清单中的每台设备。以下按设备选项不能与其组合使用;请改用 CSV 列。 |
--product | netscaler-adc 或 netscaler-gateway。 |
--edition | unknown(默认)、standard、fips 或 ndcpp。 |
--deployment | self-hosted(默认)、vendor-managed 或 unknown。 |
--build-source | unknown(默认)、upstream、vendor 或 custom。 |
--asset-id | 不透明的报告标识符,默认 device-0001。请勿提供主机名或机密信息。 |
--format | json(默认)、csv 或 html。 |
--output FILE | 将报告写入文件而不是 stdout。 |
--force | 替换已存在的报告文件。绝不会替换输入文件。 |
--brand TEXT | HTML 报告的组织标签(默认 CompleteTech LLC)。 |
--logo FILE | HTML 报告的光栅徽标。仅在与 --format html 一起使用时有效。 |
--fail-on-finding | 当结果为 potentially_affected 时以 1 退出。 |
--fail-on-unknown | 当结果为 unknown 时以 1 退出。 |
上游构建具有精确的数字形式 14.1-73.36。匹配的 FIPS 或 NDcPP 后缀可与显式版本一起接受。对于 13.1 FIPS 和 NDcPP,13.1.37.279 和 13.1-37.279 表示同一构建。带点的标准版构建、不匹配的后缀、预发布或构建元数据、多个版本以及前导零均保持为 unknown。比较绝不会跨分支或版本进行。
资产清单为 UTF-8 CSV(接受可选的 BOM),包含一个表头,每行一台设备。product 和 version 必须出现在表头中;不接受未记录的列。空值会变为未知证据,缺失的版本绝不会默认为标准版。
| 列 | 值 |
|---|---|
asset_id | 可选的不透明标识符,由 1–64 个 ASCII 字母、数字、点、下划线或连字符组成,以字母或数字开头。默认为 device-0001、device-0002,依此类推。 |
product | netscaler-adc 或 netscaler-gateway。 |
version | 确切报告的构建版本。 |
edition | unknown(默认)、standard、fips、ndcpp。分类需要受支持的版本。 |
deployment | self-hosted(默认)、vendor-managed、unknown。托管和未知部署保持为 unknown。 |
build_source | unknown(默认)、upstream、vendor、custom。 |
重复的表头或资产 ID、多余或缺失的字段、不支持的列以及空资产清单均属于输入错误。限制为 4 MiB、1,000 台设备和每个字段 1,024 个字符。仅接受常规文件;符号链接、FIFO 和无效 UTF-8 会被拒绝。合成示例请参见 examples/inventory.csv。
未指定 --output 时,报告输出到 stdout。--output FILE 会原子性地写入现有目录,且不会覆盖已存在的文件;如需有意替换,请使用 --force。即使使用 --force,检查器脚本、资产清单、它们的别名以及任何提供的徽标仍受保护,输出符号链接会被拒绝。
该快照已于 2026-10-23 对照 NetScaler 公告 和 CNA/CISA-ADP 记录 进行验证。比较保持在所列的 产品、版本和发布分支范围内。
| 产品 | 版本 | 分支 | 修复构建 |
|---|---|---|---|
| ADC 或 Gateway | Standard | 14.1 | 14.1-73.37 |
| ADC 或 Gateway | Standard | 13.1 | 13.1-64.23 |
| ADC | FIPS | 14.1 | 14.1-73.37 FIPS |
| ADC | FIPS | 13.1 | 13.1.37.279 FIPS |
| ADC | NDcPP | 13.1 | 13.1.37.279 NDcPP |
这些分支中较早的构建为 potentially_affected。同一分支中的阈值构建及之后报告的构建为 fixed_version_reported,这并不证明补丁已安装。FIPS 和 NDcPP 阈值适用于 ADC,不适用于 Gateway。
厂商或自定义构建、厂商管理的部署、未覆盖的分支(包括已停止支持的版本,本快照对其没有经过验证的规则)、限定符和模糊版本仍为 unknown。语法上有效的版本号并不能证明该构建存在或已部署。修复前请查阅当前厂商公告;该工具从不自动更新其快照。
| 状态 | 在此检查器中的含义 |
|---|---|
potentially_affected | 报告的版本低于已验证的修复版本。 |
fixed_version_reported | 报告的构建在其确切分支和版本内达到已验证的修复版本。并非补丁证明。 |
unknown | 所提供的产品、版本或来源无法分类。 |
fixed_version_reported,该状态仅声明报告的阈值,绝不构成补丁证明。厂商和自定义构建无法通过上游版本号被排除;它们需要自身的补丁证据。likely_exposed 或不支持的版本(unsupported_runtime)声明。unknown 结果表示证据缺失或未解决,绝不是干净的结果。--format html 生成单个离线文件,包含您的徽标、摘要和每一条结果。它遵循读者的浅色或深色主题,打印效果清晰,且不包含脚本或远程资源。
合成示例数据。查看 HTML。
使用 --logo path/to/logo.png 和 --brand "Your Company" 为您自己的组织添加品牌标识。徽标可以是 PNG、JPEG、GIF 或 WebP,最大 1 MiB。可选的品牌标识并不授予商标许可;请参阅品牌条款。
每种格式的内容
operator_reported。这些是清单断言,而非经过验证的设备状态。无法识别的值会被脱敏为 unknown,并保持评估结果不确定。generated_at)、可执行文件的 SHA-256 以及确切的规则快照标识。这些内容出现在 JSON、CSV 和 HTML 中,包括空的和中断的 CSV 摘要。隐私。 无法识别或格式错误的产品和版本文本不会被回显。资产标签和确切的有效构建号是操作员提供的事实;分享报告前请先审阅。任何格式均不声称本地设备已被利用。
CSV。 结构化维度为 JSON 单元格,电子表格公式前缀已被中和,complete 为 True 或 False。record_type=summary 行表示一份被中断且没有已完成资产的报告;它不是资产发现结果。