Ein sicherheitsorientierter Schwachstellenscanner für ICS/OT-Protokolle.
Ein sicherheitsorientierter Schwachstellenscanner für ICS/OT-Protokolle. Er identifiziert Geräte und prüft sie gegen bekannte CVEs und unsichere Standardeinstellungen — aktiv (durch Abfragen einer expliziten, autorisierten Zielliste) oder passiv (durch Lesen eines SPAN/TAP oder pcap, ohne etwas zu übertragen) — korreliert Befunde mit CVEs und kann einsatzfähige Erkennungsinhalte für Zeek, Suricata, Sigma und Splunk ausgeben.
Verantwortungsvolle Nutzung. icsScanner kann aktive Probes und Authentifizierungsversuche an laufende industrielle Systeme senden, bei denen unerwarteter Datenverkehr physische Prozesse stören kann. Scannen Sie nur Geräte, die Ihnen gehören oder deren Test Sie ausdrücklich autorisiert sind. Aktive Prüfungen sind standardmäßig deaktiviert (der sichere Modus meldet nur Fingerprints); der passive Modus (
discover sniff) überträgt nichts und ist die richtige Wahl in laufenden OT-Netzen. Siehe SECURITY.md.
Der Prüfkorpus umfasst viele ICS/OT-Protokolle. Die meisten Prüfungen zielen auf werkseitige Standardanmeldedaten und unsichere
Standardeinstellungen ab; die Kandidaten für die CVE-Korrelation werden aus strukturierten Schwachstellen-Feeds erstellt — dem ICS Advisory
Project, Japans MyJVN, den CSAF-2.0-OT-Advisories von CISA und der EU Vulnerability Database von ENISA. Die Berichterstattung erfolgt als
JSONL + eine Textzusammenfassung, mit HTML-/CSV-/SVG-Export. Die vollständige Anleitung finden Sie in 04-USAGE-GUIDE.md oder
unter „Running a scan" weiter unten für die Kurzfassung.
Die Recherche zum Stand der Technik ergab echte Lücken in der Abdeckung von ICS/OT-Schwachstellenscans: Die SCADA-Plugin-Familie von Nessus ist ausgereift, aber geschlossen/kommerziell; die ICS-Inhalte von Nuclei und Metasploit sind dünn; nmap NSE deckt Fingerprinting gut ab, hat aber keine Prüfungen auf CVE-Ebene. Niemand hat eine offene, sicherheitsorientierte, aktiv erweiterbare Ebene für aktive CVE-Prüfungen für ICS. icsScanner schließt diese Lücke.
| Datei | Zweck |
|---|---|
00-PROJECT-CHARTER.md | Umfang, Entscheidungen, phasenweise Meilensteine (0–5), LOE |
01-METHODOLOGY-AND-CHECKLISTS.md | Methode zur sicheren Entwicklung aktiver Prüfungen + das Gate „Ist dies eine sichere Prüfung?" |
02-DISCLOSURE-PLAYBOOK.md | Der disclosure_status-Vertrag für die sichere Nutzung vorgelagerter Befunde |
03-STYLE-AND-DECISIONS.md | Identität, Benennung und die Entscheidung zur vorerst privaten Veröffentlichung |
04-USAGE-GUIDE.md | Vollständige Anleitung: CLI + Web-UI, Formate für Zielinventar/Scan-Richtlinie, Sicherheitsmodell, API-Referenz, Fehlerbehebung |
lab-notes/gap-survey-and-prior-art.md | Die Bestandsaufnahme zum Stand der Technik vom 2026-08-12 (Nessus, Nuclei, Metasploit, nmap NSE, geeknik/scada-scanner, ICS Advisory Project) |
lab-notes/check-inventory.md | Zuordnung eigener Befunde (beider Schwesterprojekte) zu geplanten Prüfungen, mit Offenlegungsstatus |
lab-notes/default-credentials-sweep.md | Phasenweises Protokoll des Sweeps über Standardanmeldedaten — die Entstehungsgeschichte der meisten der 98 Prüfungen |
core/ | Engine — Registry, Laden von Zielen/Richtlinien, Sicherheits-/Drosselungsschicht, Logging, Berichterstattung |
core/passive.py / core/detect_match.py / core/detections.py | Passiver Modus ohne Übertragung — Erfassung/Dissection/Inventarisierung, native Erkennungszuordnung, der Abschnitt „Observed Activity" im Bericht |
checks/ | Inhalt der Prüfungsregistry, nach Protokoll organisiert; checks/candidates/ enthält Stubs aus der Forschungsphase, niemals ausführbar |
detection-gen/ | Erzeugt einsatzfähige Erkennungen (Sigma / Splunk-ESCU / Suricata / Zeek-Signatur + ATT&CK-for-ICS-Richtlinie) aus denselben checks/-detection_hints |
icsscanner.py | CLI-Treiber — aktives scan und passives discover sniff; siehe oben |
icsscanner-web.py / web/ | Web-UI — ein lokales Control Panel über derselben Engine |
templates/ | Beispielhafte YAML-Dateien für Zielinventar und Scan-Richtlinie |
lab-notes/passive-mode.md | Architektur des passiven Modus + TSA-Systemanforderungen (Dimensionierung anhand des PNNL-OT-IDS-Datensatzes) |
Drei Möglichkeiten, es auszuführen, gruppiert danach, wie stark sie das Netzwerk berühren. Wähle danach, was die Zielumgebung erlaubt — die Übertragungshaltung ist die sicherheitskritische Unterscheidung:
| Modus | Überträgt? | Verwenden, wenn | Befehle |
|---|---|---|---|
| Passiv | Nein — nur RX, null Pakete (discover sniff) | Live-OT, wo aktives Probing nicht erlaubt ist (Sicherheit, fragile Legacy-Geräte, Change Control) | discover sniff (SPAN/TAP/pcap/Zeek-Logs); discover passive (ARP-Listen + Sparkplug — siehe den Hinweis unten) |
| Aktiver Scan | Ja — sendet Probes und optionale Logins | Assets, die dir gehören oder für die du eine ausdrückliche schriftliche Testgenehmigung hast | scan (Standard-CLI / Policy-Datei / Web-UI); discover active (ARP-Sweep, um zuerst Hosts zu finden) |
| Malcolm-Interop | Schreibgeschützte API-Aufrufe an deinen eigenen Malcolm | Du betreibst bereits einen passiven Malcolm-/Hedgehog-Stack | discover malcolm (Inventar lesen + korrelieren; --push sendet Findings zurück); discover sniff --push-malcolm (Findings eines passiven Laufs pushen) |
Jeder Modus wird unten im Detail beschrieben. scan und discover sniff sind die primären Befehle; discover active /
discover passive sind sekundäre Discovery-Helfer innerhalb der Modi Aktiv / Passiv. Der Safe-Modus
(nur Fingerprinting, keine destruktiven Prüfungen) ist der Standard in jedem Modus, der übertragen kann.
Vollständige Details in 04-USAGE-GUIDE.md. Kurzfassung — drei Einstiegspunkte, alle treiben dieselbe Engine an:
# 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
Kopieren Sie templates/target-inventory.example.yaml (und optional templates/scan-policy.example.yaml),
bevor Sie Änderungen vornehmen — scannen Sie nicht direkt aus der Vorlage. Listen Sie nur Geräte auf, die Ihnen gehören oder für die Sie
eine ausdrückliche schriftliche Genehmigung zum Testen haben. Jedes Ziel ist ein exakter host: — eine IP oder ein FQDN, niemals ein
CIDR-Bereich; dies ist eine bewusste Scope-Entscheidung (kleine bekannte Asset-Listen, kein Netzwerk-Sweep-
Tool), kein fehlendes Feature — siehe 04-USAGE-GUIDE.md.