Uno scanner di vulnerabilità orientato alla sicurezza per i protocolli ICS/OT.
Uno scanner di vulnerabilità safety-first per protocolli ICS/OT. Identifica i dispositivi e li verifica rispetto a CVE note e configurazioni predefinite non sicure — attivamente (sondando un elenco esplicito e autorizzato di target) o passivamente (leggendo una porta SPAN/TAP o un pcap senza trasmettere nulla) — correla i risultati alle CVE e può generare contenuti di rilevamento distribuibili per Zeek, Suricata, Sigma e Splunk.
Uso responsabile. icsScanner può inviare sonde attive e tentativi di autenticazione a sistemi industriali in produzione, dove traffico inatteso può compromettere processi fisici. Esegui la scansione solo su dispositivi di tua proprietà o per i quali sei esplicitamente autorizzato a eseguire test. I controlli attivi sono disattivati per impostazione predefinita (la modalità sicura riporta solo il fingerprinting); la modalità passiva (
discover sniff) non trasmette nulla ed è la scelta giusta sulle reti OT in produzione. Vedi SECURITY.md.
Il corpus di controlli copre molti protocolli ICS/OT. La maggior parte dei controlli è mirata a credenziali predefinite di fabbrica e a configurazioni
predefinite non sicure; i candidati alla correlazione CVE sono costruiti a partire da feed strutturati di vulnerabilità — l'ICS Advisory
Project, il MyJVN giapponese, gli avvisi OT CSAF 2.0 di CISA e l'EU Vulnerability Database di ENISA. Il reporting è
JSONL + un riepilogo testuale, con esportazione HTML / CSV / SVG. Vedi 04-USAGE-GUIDE.md per la guida completa, oppure
"Running a scan" qui sotto per la versione breve.
La ricerca sullo stato dell'arte ha rilevato reali lacune di copertura nella scansione delle vulnerabilità ICS/OT: la famiglia di plugin SCADA di Nessus è matura ma chiusa/commerciale; i contenuti ICS di Nuclei e Metasploit sono scarni; nmap NSE copre bene il fingerprinting ma non ha controlli a livello di CVE. Nessuno ha uno strato di controlli CVE attivi aperto, safety-first e attivamente estensibile per l'ICS. icsScanner colma questa lacuna.
| File | Scopo |
|---|---|
00-PROJECT-CHARTER.md | Ambito, decisioni, milestone a fasi (0–5), LOE |
01-METHODOLOGY-AND-CHECKLISTS.md | Metodo sicuro di sviluppo dei controlli attivi + il criterio "questo controllo è sicuro?" |
02-DISCLOSURE-PLAYBOOK.md | Il contratto disclosure_status per consumare in sicurezza i risultati upstream |
03-STYLE-AND-DECISIONS.md | Identità, denominazione e la decisione di pubblicazione per ora privata |
04-USAGE-GUIDE.md | Guida completa: CLI + web UI, formati di inventario target/policy di scansione, modello di sicurezza, riferimento API, risoluzione dei problemi |
lab-notes/gap-survey-and-prior-art.md | La rassegna dello stato dell'arte del 2026-08-12 (Nessus, Nuclei, Metasploit, nmap NSE, geeknik/scada-scanner, ICS Advisory Project) |
lab-notes/check-inventory.md | Mappatura dei propri risultati (entrambi i progetti affini) sui controlli pianificati, con stato di divulgazione |
lab-notes/default-credentials-sweep.md | Registro fase per fase della rassegna delle credenziali predefinite — la storia delle origini della maggior parte dei 98 controlli |
core/ | Motore — registry, caricamento target/policy, livello di sicurezza/throttling, logging, reporting |
core/passive.py / core/detect_match.py / core/detections.py | Modalità passiva a trasmissione zero — cattura/dissociazione/inventario, matching nativo dei rilevamenti, la sezione del report Observed-Activity |
checks/ | Contenuto del registry dei controlli, organizzato per protocollo; checks/candidates/ contiene stub in fase di ricerca, mai eseguibili |
detection-gen/ | Genera rilevamenti distribuibili (Sigma / Splunk-ESCU / Suricata / Zeek signature + policy ATT&CK-for-ICS) dagli stessi detection_hints di checks/ |
icsscanner.py | Driver CLI — scan attivo e discover sniff passivo; vedi sopra |
icsscanner-web.py / web/ | Web UI — un pannello di controllo locale sullo stesso motore |
templates/ | File YAML di esempio per inventario target e policy di scansione |
lab-notes/passive-mode.md | Architettura della modalità passiva + requisiti di sistema TSA (dimensionamento dal dataset PNNL OT-IDS) |
Tre modi per eseguirlo, raggruppati in base a quanto interagiscono con la rete. Scegli in base a ciò che l'ambiente target consente — la postura di trasmissione è la distinzione critica per la sicurezza:
| Modalità | Trasmette? | Da usare quando | Comandi |
|---|---|---|---|
| Passiva | No — solo RX, zero pacchetti (discover sniff) | OT in produzione dove il probing attivo non è consentito (sicurezza, dispositivi legacy fragili, change control) | discover sniff (SPAN/TAP/pcap/log Zeek); discover passive (ascolto ARP + Sparkplug — vedi l'avvertenza sotto) |
| Scansione attiva | Sì — invia probe e login opt-in | Asset di tua proprietà o per cui hai esplicita autorizzazione scritta al test | scan (CLI predefinita / file di policy / web UI); discover active (ARP sweep per individuare prima gli host) |
| Interoperabilità con Malcolm | Chiamate API in sola lettura al tuo Malcolm | Esegui già uno stack passivo Malcolm / Hedgehog | discover malcolm (legge l'inventario + correla; --push invia i risultati indietro); discover sniff --push-malcolm (invia i risultati di un'esecuzione passiva) |
Ogni modalità è dettagliata di seguito. scan e discover sniff sono i comandi principali; discover active /
discover passive sono helper di discovery secondari all'interno delle modalità Attiva / Passiva. La modalità sicura
(solo fingerprint, nessun controllo distruttivo) è quella predefinita in ogni modalità che può trasmettere.
Dettagli completi in 04-USAGE-GUIDE.md. Versione breve — tre modi per iniziare, tutti guidano lo stesso motore:
# 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
Copia templates/target-inventory.example.yaml (e facoltativamente templates/scan-policy.example.yaml)
prima di modificare — non scansionare direttamente dal template. Elenca solo i dispositivi che possiedi o per cui hai
esplicita autorizzazione scritta a testare. Ogni target è un esatto host: — un IP o FQDN, mai un
range CIDR; questa è una decisione di scope deliberata (piccoli elenchi di asset noti, non uno strumento di
scansione della rete), non una funzionalità mancante — vedi 04-USAGE-GUIDE.md.