一款面向 ICS/OT 协议的安全优先漏洞扫描器。
一款面向 ICS/OT 协议、以安全为先的漏洞扫描器。它可识别设备,并对照已知 CVE 和不安全默认配置进行检查——主动(探测一份明确、已获授权的目标列表)或被动(读取 SPAN/TAP 或 pcap,不发送任何数据)——将发现关联到 CVE,并可生成可部署的检测内容,用于 Zeek、Suricata、Sigma 和 Splunk。
负责任使用。 icsScanner 可向运行中的工业系统发送主动探测和认证尝试,而意外流量可能干扰物理过程。仅扫描你拥有或明确获授权测试的设备。 主动检查默认关闭(安全模式仅报告指纹识别结果);被动模式(
discover sniff)不发送任何数据,是在运行中的 OT 网络上应选用的方式。参见 SECURITY.md。
检查语料库覆盖多种 ICS/OT 协议。大多数检查针对出厂默认凭据和不安全默认配置;CVE 关联候选来自结构化漏洞源——ICS Advisory Project、日本的 MyJVN、CISA 的 CSAF 2.0 OT 公告,以及 ENISA 的 EU Vulnerability Database。报告为 JSONL + 文本摘要,并支持 HTML / CSV / SVG 导出。完整操作指南见 04-USAGE-GUIDE.md,或参见下文“运行扫描”的简要版本。
前期研究发现了真实的 ICS/OT 漏洞扫描覆盖缺口:Nessus 的 SCADA 插件系列成熟但闭源/商业;Nuclei 和 Metasploit 的 ICS 内容单薄;nmap NSE 在指纹识别方面覆盖良好,但没有 CVE 级别的检查。目前还没有一个开放、安全优先、可主动扩展的 ICS 主动 CVE 检查层。icsScanner 填补了这一空白。
| 文件 | 用途 |
|---|---|
00-PROJECT-CHARTER.md | 范围、决策、分阶段里程碑(0–5)、LOE |
01-METHODOLOGY-AND-CHECKLISTS.md | 安全的主动检查开发方法 + “这是否是安全检查?”门禁 |
02-DISCLOSURE-PLAYBOOK.md | 用于安全消费上游发现的 disclosure_status 契约 |
03-STYLE-AND-DECISIONS.md | 身份、命名,以及暂不公开的发布决定 |
04-USAGE-GUIDE.md | 完整操作指南:CLI + Web UI、目标清单/扫描策略格式、安全模型、API 参考、故障排查 |
lab-notes/gap-survey-and-prior-art.md | 2026-08-12 前期技术调研(Nessus、Nuclei、Metasploit、nmap NSE、geeknik/scada-scanner、ICS Advisory Project) |
lab-notes/check-inventory.md | 将自身发现(两个姊妹项目)映射到计划检查,并附披露状态 |
lab-notes/default-credentials-sweep.md | 默认凭据扫描的逐阶段日志——98 项检查的大部分起源故事 |
core/ | 引擎——注册表、目标/策略加载、安全/限流层、日志记录、报告 |
core/passive.py / core/detect_match.py / core/detections.py | 零发送被动模式——捕获/解析/清点、原生检测匹配、Observed-Activity 报告部分 |
checks/ | 检查注册表内容,按协议组织;checks/candidates/ 存放研究阶段存根,永不执行 |
detection-gen/ | 从同一 checks/ detection_hints 生成可部署检测(Sigma / Splunk-ESCU / Suricata / Zeek 签名 + ATT&CK-for-ICS 策略) |
icsscanner.py | CLI 驱动——主动 scan 和被动 discover sniff;见上文 |
icsscanner-web.py / web/ | Web UI——基于同一引擎的本地控制面板 |
templates/ | 示例目标清单和扫描策略 YAML 文件 |
lab-notes/passive-mode.md | 被动模式架构 + TSA 系统需求(基于 PNNL OT-IDS 数据集进行容量规划) |
运行方式有三种,按它们对网络的接触程度分组。根据目标环境允许的范围来选择——是否发送数据这一姿态是关乎安全的关键区别:
| 模式 | 是否发送数据? | 适用场景 | 命令 |
|---|---|---|---|
| 被动 | 否——仅接收,零数据包(discover sniff) | 不允许主动探测的实时 OT 环境(安全、脆弱的遗留设备、变更控制) | discover sniff(SPAN/TAP/pcap/Zeek 日志);discover passive(ARP 监听 + Sparkplug——见下方注意事项) |
| 主动扫描 | 是——发送探测包,以及可选的登录 | 你拥有或已获得明确书面许可进行测试的资产 | scan(默认 CLI / 策略文件 / Web UI);discover active(先进行 ARP 扫描以发现主机) |
| Malcolm 互操作 | 对你自己的 Malcolm 进行只读 API 调用 | 你已运行 Malcolm / Hedgehog 被动式技术栈 | discover malcolm(读取清单并关联;--push 将发现结果回传);discover sniff --push-malcolm(推送一次被动运行的发现结果) |
每种模式在下方详述。scan 和 discover sniff 是主要命令;discover active /
discover passive 是主动 / 被动模式中的辅助发现工具。安全模式
(仅指纹识别,无破坏性检查)是所有可能发送数据的模式中的默认设置。
完整细节见 04-USAGE-GUIDE.md。简而言之——三种入口,均驱动同一引擎:
# Ad hoc CLI: just point at a target inventory, optionally narrow by protocol/check-id.
python3 icsscanner.py --inventory templates/target-inventory.example.yaml --protocol http
# Policy-file CLI: bundles target inventory + check selection + rate profile + output dir into
# one reusable YAML (00-PROJECT-CHARTER.md § Scope — the decided invocation model). CLI flags
# below still override individual policy fields for a one-off tweak.
python3 icsscanner.py --policy templates/scan-policy.example.yaml
# Web UI: a form + run view at http://127.0.0.1:8807/ — same policy/inventory model, same
# safe-mode default, a two-step confirm click in place of the CLI's interactive prompt.
python3 icsscanner-web.py
编辑前先复制 templates/target-inventory.example.yaml(可选地复制 templates/scan-policy.example.yaml)——不要直接从模板进行扫描。只列出你拥有或已获得明确书面许可进行测试的设备。 每个目标都是一个精确的 host:——一个 IP 或 FQDN,绝不是 CIDR 范围;这是有意的范围决策(小型已知资产列表,而非网络扫描工具),并非缺失的功能——参见 04-USAGE-GUIDE.md。
每一个真正执行操作的检查(真实的登录尝试等)都是 destructive: true。安全模式是默认设置——破坏性检查仅报告指纹,除非你传入 --include-destructive(或在策略文件中设置 include_destructive: true),否则绝不会触发;即便如此,icsscanner.py 也会在交互式确认提示中要求显式输入 y(或使用 --yes/-y 跳过该提示),之后才会发生任何实际活动。Web UI 以显式的第二次“Confirm and Run”点击来执行同样的强制要求,而非终端提示——第一次提交只会显示将会运行的内容。Web UI 也没有身份验证,并且出于这一原因默认绑定 127.0.0.1(仅限 localhost)——在将其暴露到更广范围之前,请参阅 04-USAGE-GUIDE.md。
python3 icsscanner.py --help 列出了所有标志。结果会落在 --output 指定的目录中(默认为 ./output,已加入 gitignore),以带时间戳的 icsscanner-*.jsonl 形式保存,并打印文本摘要。
对于禁止主动探测的实时 OT 网络(出于安全、脆弱的遗留设备、变更控制等原因),discover sniff 会读取流量并且不发送任何内容——捕获套接字是只接收的。它将 ICS 身份帧解析为资产清单,关联 CVE,并且(配合 --detections)将检查语料库自身的签名与流量进行匹配,以生成“观测活动”部分。这是 TSA 为其受监管行业(管道、铁路、航空)所要求的。
# Offline: dissect a capture file (no network, no transmit)
python3 icsscanner.py discover sniff --pcap plant-span.pcap --cve --detections --html
# Live: read a SPAN/mirror port or TAP for 300s (RX-only, promiscuous, zero packets sent)
sudo python3 icsscanner.py discover sniff --span eth1 --window 300 --cve --detections --csv
# Hybrid: ingest an existing Zeek/ICSNPP sensor's identity logs + its notice.log
python3 icsscanner.py discover sniff --zeek-logs /opt/zeek/logs/current --notice-log notice.log
# Hand the passive inventory to the active scanner as pre-hinted targets (still zero transmit)
python3 icsscanner.py discover sniff --pcap plant-span.pcap --emit-targets targets.yaml
python3 icsscanner.py --inventory targets.yaml # then scan only what passive found
--detections 在进程内运行签名(无需外部工具)。--notice-log 则改为摄取 Zeek 传感器自身的检测结果(Malcolm/Hedgehog 路径);两者渲染相同的部分。检测结果是指匹配某项检查签名的流量,并非已确认的入侵——会标注为窄范围(侦察)与宽范围(利用类),且匹配结果会关联回已发现的资产清单。detection-gen/ 以可部署的 Zeek/Suricata/Sigma/Splunk-ESCU 规则形式提供。discover sniff 是零发送的旗舰功能。更轻量的 discover passive 子命令执行 ARP 仅监听,外加针对 Sparkplug B 的只读 MQTT 订阅。注意: ARP 侧不发送任何内容,但 Sparkplug 路径会打开一个 MQTT 订阅——这会向 broker 发送一个 SUBSCRIBE,因此它并非像 discover sniff 那样字面意义上的零数据包。不要以为它零发送就将其指向生产 OT broker。lab-notes/passive-mode.md。如果目标资产清单条目带有 credential: 引用(如 OPC-UA 等需要认证的检查),请先在密钥环中设置:python3 -c "import keyring; keyring.set_password('service', 'username', 'the-secret')"。在无头 Linux 上(没有 D-Bus Secret Service——本项目的 WSL2 开发环境正是如此),还需先设置 ICSSCANNER_KEYRING_PASSWORD——参见 feedback_keyring_wsl2.md。任何默认凭据检查都不需要这样做;它们是在测试弱/默认凭据,而不是用已知正确的凭据进行认证。
icsScanner 是 CVE 关联 + 检测层,它位于现有 Malcolm / Hedgehog / ICSNPP 被动式技术栈之上——它不会构建、捆绑或搭建该技术栈。如果你已经在运行 Malcolm,它会通过 Malcolm 自有的 mapi REST API 与其双向通信,针对你自己的主机。
# READ: pull the passive asset inventory from a running Malcolm and correlate CVEs (no scan, no file hand-off).
python3 icsscanner.py discover malcolm --url https://malcolm.example --cve
# READ with richer identity: use a NetBox-enriched vendor/model field for model-level CVE matching.
python3 icsscanner.py discover malcolm --url https://malcolm.example --vendor-from-detail --cve
# PUSH: send the correlated CVE findings back into Malcolm's dashboards as session records.
python3 icsscanner.py discover malcolm --url https://malcolm.example --cve --push
# PUSH from a passive run: a SPAN/TAP/pcap sniff that also pushes its findings into Malcolm.
python3 icsscanner.py discover sniff --pcap plant-span.pcap --cve --push-malcolm https://malcolm.example
POST /mapi/agg(对 Malcolm 实时索引进行聚合);推送使用 POST /mapi/event
(Malcolm 文档中记录的告警 webhook——可在其仪表板中查看的会话记录),绝不使用原始的
OpenSearch 写入。当 NETBOX_ENRICHMENT 开启时,read_identities() 会拉取经 NetBox 富化的 device.manufacturer / device_type,
用于模型级关联;否则回退到协议存在性判断。--token <bearer>;在实验主机上跳过 TLS 验证请使用 --insecure
(sniff 推送路径使用 --malcolm-token / --malcolm-insecure)。discover sniff --zeek-logs)。