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脆弱性データベース — から構築されています。レポートは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データセットに基づくサイジング) |
実行方法は3つあり、ネットワークへの関与度に応じて分類されています。対象環境が何を許容するかに応じて選択してください。送信の可否は安全性に関わる重要な区別です。
| モード | 送信するか? | 使用する場面 | コマンド |
|---|---|---|---|
| パッシブ | いいえ — RXのみ、パケット送信ゼロ (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に記載されています。要点は、3つの実行方法があり、いずれも同じエンジンを駆動するという点です。
# 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)をコピーしてください — テンプレートから直接スキャンしないでください。所有している、またはテストについて明示的な書面による許可を得ているデバイスのみをリストしてください。 各ターゲットは正確に1つの host: — IP または FQDN であり、CIDR 範囲は決して指定しません。これは意図的なスコープの決定(小規模で既知の資産リストを対象とし、ネットワークスイープツールではない)であり、機能の欠落ではありません — 04-USAGE-GUIDE.md を参照してください。
実際に何かを行うすべてのチェック(実際のログイン試行など)は destructive: true です。セーフモードがデフォルトです — 破壊的チェックはフィンガープリントのみを報告し、--include-destructive を渡す(またはポリシーファイルで include_destructive: true を設定する)までは決して実行されません。さらにその場合でも、icsscanner.py は実際の処理が行われる前に、対話型の確認プロンプトで明示的な y を要求します(または --yes/-y でスキップ)。Web UI はターミナルプロンプトの代わりに、明示的な2回目の「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 を指定すると)チェックコーパス自体のシグネチャをトラフィックと照合して Observed-Activity セクションを生成します。これは 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 subscribe を行います。注意: ARP 側は何も送信しませんが、
Sparkplug 経路は MQTT subscribe を開きます — これはブローカーへ SUBSCRIBE を送信するため、discover sniff のように
文字通りゼロパケットではありません。ゼロ送信を前提として稼働中の OT ブローカーに向けないでください。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 は、既存の Malcolm / Hedgehog / ICSNPP パッシブスタックの上に位置する CVE 相関 + 検出レイヤーです
— スタックを構築、バンドル、立ち上げるものではありません。すでに Malcolm を運用している場合、
Malcolm 自身の mapi REST API を通じて、双方向に、あなた自身のホストに対して通信します。