Un scanner de vulnérabilités axé sur la sécurité pour les protocoles ICS/OT.
Un scanner de vulnérabilités priorisant la sécurité pour les protocoles ICS/OT. Il identifie les appareils et les vérifie par rapport à des CVE connues et des configurations par défaut non sécurisées — activement (en sondant une liste de cibles explicite et autorisée) ou passivement (en lisant un port SPAN/TAP ou un pcap sans rien transmettre) — corrèle les résultats aux CVE, et peut émettre du contenu de détection déployable pour Zeek, Suricata, Sigma et Splunk.
Usage responsable. icsScanner peut envoyer des sondes actives et des tentatives d'authentification à des systèmes industriels en production, où un trafic inattendu peut perturber des processus physiques. Ne scannez que les appareils que vous possédez ou que vous êtes explicitement autorisé à tester. Les vérifications actives sont désactivées par défaut (le mode sûr ne rapporte que l'empreinte) ; le mode passif (
discover sniff) ne transmet rien et constitue le bon choix sur les réseaux OT en production. Voir SECURITY.md.
Le corpus de vérifications couvre de nombreux protocoles ICS/OT. La plupart des vérifications ciblent les identifiants par défaut d'usine et les
configurations par défaut non sécurisées ; les candidats à la corrélation CVE sont construits à partir de flux de vulnérabilités structurés — le
ICS Advisory Project, MyJVN du Japon, les avis OT CSAF 2.0 de la CISA et la base de données des vulnérabilités de l'UE de l'ENISA. Le reporting est
en JSONL + un résumé texte, avec export HTML / CSV / SVG. Voir 04-USAGE-GUIDE.md pour le guide complet, ou
« Running a scan » ci-dessous pour la version courte.
La recherche sur l'état de l'art a révélé de réelles lacunes de couverture en matière de scan de vulnérabilités ICS/OT : la famille de plugins SCADA de Nessus est mature mais fermée/commerciale ; le contenu ICS de Nuclei et Metasploit est mince ; nmap NSE couvre bien l'empreinte réseau mais n'a pas de vérifications au niveau CVE. Personne ne dispose d'une couche de vérification CVE active ouverte, priorisant la sécurité et activement extensible pour l'ICS. icsScanner comble cette lacune.
| Fichier | Objectif |
|---|---|
00-PROJECT-CHARTER.md | Périmètre, décisions, jalons par phases (0–5), LOE |
01-METHODOLOGY-AND-CHECKLISTS.md | Méthode de développement de vérifications actives sûres + le critère « cette vérification est-elle sûre ? » |
02-DISCLOSURE-PLAYBOOK.md | Le contrat disclosure_status pour consommer en toute sécurité les résultats amont |
03-STYLE-AND-DECISIONS.md | Identité, nommage et la décision de publication privée pour l'instant |
04-USAGE-GUIDE.md | Guide complet : CLI + interface web, formats d'inventaire de cibles/politique de scan, modèle de sécurité, référence API, dépannage |
lab-notes/gap-survey-and-prior-art.md | L'analyse de l'état de l'art du 2026-08-12 (Nessus, Nuclei, Metasploit, nmap NSE, geeknik/scada-scanner, ICS Advisory Project) |
lab-notes/check-inventory.md | Correspondance entre nos propres résultats (les deux projets frères) et les vérifications prévues, avec statut de divulgation |
lab-notes/default-credentials-sweep.md | Journal phase par phase du balayage des identifiants par défaut — l'origine de la plupart des 98 vérifications |
core/ | Moteur — registre, chargement des cibles/politiques, couche de sécurité/limitation de débit, journalisation, reporting |
core/passive.py / core/detect_match.py / core/detections.py | Mode passif sans transmission — capture/dissection/inventaire, correspondance de détection native, la section du rapport Observed-Activity |
checks/ | Contenu du registre de vérifications, organisé par protocole ; checks/candidates/ contient des ébauches en phase de recherche, jamais exécutables |
detection-gen/ | Génère des détections déployables (Sigma / Splunk-ESCU / Suricata / signature Zeek + politique ATT&CK-for-ICS) à partir des mêmes detection_hints de checks/ |
icsscanner.py | Pilote CLI — scan actif et discover sniff passif ; voir ci-dessus |
icsscanner-web.py / web/ | Interface web — un panneau de contrôle local au-dessus du même moteur |
templates/ | Exemples de fichiers YAML d'inventaire de cibles et de politique de scan |
lab-notes/passive-mode.md | Architecture du mode passif + exigences système TSA (dimensionnement à partir du jeu de données PNNL OT-IDS) |
Trois façons de l'exécuter, regroupées selon leur degré d'interaction avec le réseau. Choisissez selon ce que l'environnement cible autorise — la posture de transmission est la distinction critique pour la sécurité :
| Mode | Transmet ? | À utiliser quand | Commandes |
|---|---|---|---|
| Passif | Non — RX uniquement, zéro paquet (discover sniff) | OT en production où le sondage actif est interdit (sécurité, équipements legacy fragiles, gestion des changements) | discover sniff (SPAN/TAP/pcap/Zeek-logs) ; discover passive (écoute ARP + Sparkplug — voir la mise en garde ci-dessous) |
| Scan actif | Oui — envoie des sondes, et des connexions opt-in | Actifs que vous possédez ou pour lesquels vous disposez d'une autorisation écrite explicite de test | scan (CLI par défaut / fichier de politique / interface web) ; discover active (balayage ARP pour trouver d'abord les hôtes) |
| Interop Malcolm | Appels API en lecture seule vers votre propre Malcolm | Vous exécutez déjà une pile passive Malcolm / Hedgehog | discover malcolm (lire l'inventaire + corréler ; --push renvoie les résultats) ; discover sniff --push-malcolm (pousser les résultats d'une exécution passive) |
Chaque mode est détaillé ci-dessous. scan et discover sniff sont les commandes principales ; discover active /
discover passive sont des assistants de découverte secondaires au sein des modes Actif / Passif. Le mode sécurisé
(empreinte uniquement, sans vérifications destructives) est la valeur par défaut dans chaque mode susceptible de transmettre.
Tous les détails dans 04-USAGE-GUIDE.md. Version courte — trois façons d'entrer, toutes pilotant le même moteur :
# 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
Copiez templates/target-inventory.example.yaml (et éventuellement templates/scan-policy.example.yaml)
avant de modifier — ne lancez pas de scan directement depuis le modèle. Ne listez que les appareils que vous possédez ou pour
lesquels vous disposez d'une autorisation écrite explicite de test. Chaque cible est un host: exact — une IP ou un FQDN, jamais une
plage CIDR ; il s'agit d'une décision de périmètre délibérée (petites listes d'actifs connus, pas un outil de balayage réseau),
et non d'une fonctionnalité manquante — voir 04-USAGE-GUIDE.md.