Un escáner de vulnerabilidades centrado en la seguridad para protocolos ICS/OT.
Un escáner de vulnerabilidades centrado en la seguridad para protocolos ICS/OT. Identifica dispositivos y los comprueba contra CVE conocidos y configuraciones predeterminadas inseguras — activamente (sondeando una lista de objetivos explícita y autorizada) o pasivamente (leyendo un SPAN/TAP o un pcap sin transmitir nada) — correlaciona los hallazgos con CVE, y puede emitir contenido de detección desplegable para Zeek, Suricata, Sigma y Splunk.
Uso responsable. icsScanner puede enviar sondeos activos e intentos de autenticación a sistemas industriales en producción, donde el tráfico inesperado puede interrumpir procesos físicos. Escanee únicamente dispositivos que posea o para los que esté explícitamente autorizado a probar. Las comprobaciones activas están desactivadas por defecto (el modo seguro solo informa de la huella); el modo pasivo (
discover sniff) no transmite nada y es la opción adecuada en redes OT en producción. Consulte SECURITY.md.
El corpus de comprobaciones abarca muchos protocolos ICS/OT. La mayoría de las comprobaciones se dirigen a credenciales predeterminadas de fábrica y
configuraciones predeterminadas inseguras; los candidatos de correlación de CVE se construyen a partir de fuentes estructuradas de vulnerabilidades — el ICS Advisory
Project, MyJVN de Japón, los avisos OT CSAF 2.0 de CISA y la Base de Datos de Vulnerabilidades de la UE de ENISA. La generación de informes es
JSONL + un resumen en texto, con exportación a HTML / CSV / SVG. Consulte 04-USAGE-GUIDE.md para la guía completa, o
"Ejecutar un escaneo" más abajo para la versión breve.
La investigación de trabajos previos encontró lagunas reales de cobertura en el escaneo de vulnerabilidades ICS/OT: la familia de plugins SCADA de Nessus es madura pero cerrada/comercial; el contenido ICS de Nuclei y Metasploit es escaso; nmap NSE cubre bien la identificación de huellas pero no tiene comprobaciones a nivel de CVE. Nadie tiene una capa abierta, centrada en la seguridad y activamente extensible de comprobaciones activas de CVE para ICS. icsScanner llena esa laguna.
| Archivo | Propósito |
|---|---|
00-PROJECT-CHARTER.md | Alcance, decisiones, hitos por fases (0–5), LOE |
01-METHODOLOGY-AND-CHECKLISTS.md | Método seguro de desarrollo de comprobaciones activas + la puerta "¿es esta una comprobación segura?" |
02-DISCLOSURE-PLAYBOOK.md | El contrato disclosure_status para consumir hallazgos de origen de forma segura |
03-STYLE-AND-DECISIONS.md | Identidad, nomenclatura y la decisión de publicación privada por ahora |
04-USAGE-GUIDE.md | Guía completa: CLI + interfaz web, formatos de inventario de objetivos/política de escaneo, modelo de seguridad, referencia de API, solución de problemas |
lab-notes/gap-survey-and-prior-art.md | El barrido de trabajos previos del 2026-08-12 (Nessus, Nuclei, Metasploit, nmap NSE, geeknik/scada-scanner, ICS Advisory Project) |
lab-notes/check-inventory.md | Asignación de hallazgos propios (ambos proyectos hermanos) a las comprobaciones planificadas, con estado de divulgación |
lab-notes/default-credentials-sweep.md | Registro fase por fase del barrido de credenciales predeterminadas — la historia de origen de la mayoría de las 98 comprobaciones |
core/ | Motor — registro, carga de objetivos/políticas, capa de seguridad/limitación de velocidad, registro de logs, generación de informes |
core/passive.py / core/detect_match.py / core/detections.py | Modo pasivo de cero transmisión — captura/disección/inventario, coincidencia de detecciones nativa, la sección de informe de Actividad Observada |
checks/ | Contenido del registro de comprobaciones, organizado por protocolo; checks/candidates/ contiene esbozos en fase de investigación, nunca ejecutables |
detection-gen/ | Genera detecciones desplegables (Sigma / Splunk-ESCU / Suricata / firma Zeek + política ATT&CK-for-ICS) a partir de los mismos detection_hints de checks/ |
icsscanner.py | Controlador CLI — scan activo y discover sniff pasivo; véase arriba |
icsscanner-web.py / web/ | Interfaz web — un panel de control local sobre el mismo motor |
templates/ | Archivos YAML de ejemplo de inventario de objetivos y política de escaneo |
lab-notes/passive-mode.md | Arquitectura del modo pasivo + requisitos de sistema TSA (dimensionamiento a partir del conjunto de datos PNNL OT-IDS) |
Tres formas de ejecutarlo, agrupadas según cuánto tocan la red. Elige según lo que permita el entorno objetivo — la postura de transmisión es la distinción crítica para la seguridad:
| Modo | ¿Transmite? | Úsalo cuando | Comandos |
|---|---|---|---|
| Pasivo | No — solo RX, cero paquetes (discover sniff) | OT en vivo donde el sondeo activo no está permitido (seguridad, dispositivos legacy frágiles, control de cambios) | discover sniff (SPAN/TAP/pcap/Zeek-logs); discover passive (escucha ARP + Sparkplug — ver la advertencia más abajo) |
| Escaneo activo | Sí — envía sondas e inicios de sesión opcionales | Activos que posees o para los que tienes permiso escrito explícito de probar | scan (CLI por defecto / archivo de política / interfaz web); discover active (barrido ARP para encontrar hosts primero) |
| Interoperabilidad con Malcolm | Llamadas API de solo lectura a tu propio Malcolm | Ya ejecutas una pila pasiva Malcolm / Hedgehog | discover malcolm (leer inventario + correlacionar; --push envía los hallazgos de vuelta); discover sniff --push-malcolm (enviar los hallazgos de una ejecución pasiva) |
Cada modo se detalla a continuación. scan y discover sniff son los comandos principales; discover active /
discover passive son ayudantes secundarios de descubrimiento dentro de los modos Activo / Pasivo. El modo seguro
(solo fingerprint, sin comprobaciones destructivas) es el predeterminado en todos los modos que pueden transmitir.
Todos los detalles en 04-USAGE-GUIDE.md. Versión corta — tres formas de entrada, todas impulsando el mismo motor:
# 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 (y opcionalmente templates/scan-policy.example.yaml)
antes de editar — no escanees directamente desde la plantilla. Solo enumera dispositivos que poseas o para los que tengas
permiso escrito explícito de probar. Cada objetivo es un único host: exacto — una IP o FQDN, nunca un
rango CIDR; esta es una decisión deliberada de alcance (listas pequeñas de activos conocidos, no una herramienta de barrido de red), no una funcionalidad faltante — consulta 04-USAGE-GUIDE.md.