Um scanner de vulnerabilidades com foco em segurança para protocolos ICS/OT.
Um scanner de vulnerabilidades focado em segurança para protocolos ICS/OT. Identifica dispositivos e os verifica em relação a CVEs conhecidas e padrões inseguros — ativamente (sondando uma lista de alvos explícita e autorizada) ou passivamente (lendo um SPAN/TAP ou pcap e não transmitindo nada) — correlaciona descobertas com CVEs e pode emitir conteúdo de detecção implantável para Zeek, Suricata, Sigma e Splunk.
Uso responsável. O icsScanner pode enviar sondagens ativas e tentativas de autenticação a sistemas industriais em produção, onde tráfego inesperado pode interromper processos físicos. Sonde apenas dispositivos que você possui ou está explicitamente autorizado a testar. As verificações ativas estão desativadas por padrão (o modo seguro relata apenas fingerprint); o modo passivo (
discover sniff) não transmite nada e é a escolha certa em redes OT em produção. Consulte SECURITY.md.
O corpus de verificações abrange muitos protocolos ICS/OT. A maioria das verificações visa credenciais padrão de fábrica e padrões
inseguros; os candidatos à correlação de CVEs são construídos a partir de feeds estruturados de vulnerabilidades — o ICS Advisory
Project, o MyJVN do Japão, os avisos OT CSAF 2.0 da CISA e a Base de Dados de Vulnerabilidades da UE da ENISA. O relatório é
JSONL + um resumo em texto, com exportação HTML / CSV / SVG. Consulte 04-USAGE-GUIDE.md para o guia completo, ou
"Running a scan" abaixo para a versão resumida.
A pesquisa de trabalhos anteriores encontrou lacunas reais de cobertura na verificação de vulnerabilidades ICS/OT: a família de plugins SCADA do Nessus é madura, mas fechada/comercial; o conteúdo ICS do Nuclei e do Metasploit é escasso; o nmap NSE cobre bem o fingerprinting, mas não tem verificações em nível de CVE. Ninguém tem uma camada aberta, focada em segurança e ativamente extensível de verificação ativa de CVEs para ICS. O icsScanner preenche essa lacuna.
| Arquivo | Finalidade |
|---|---|
00-PROJECT-CHARTER.md | Escopo, decisões, marcos faseados (0–5), LOE |
01-METHODOLOGY-AND-CHECKLISTS.md | Método seguro de desenvolvimento de verificações ativas + o critério "esta é uma verificação segura?" |
02-DISCLOSURE-PLAYBOOK.md | O contrato disclosure_status para consumir descobertas upstream com segurança |
03-STYLE-AND-DECISIONS.md | Identidade, nomenclatura e a decisão de publicação privada por enquanto |
04-USAGE-GUIDE.md | Guia completo: CLI + interface web, formatos de inventário de alvos/política de varredura, modelo de segurança, referência da API, solução de problemas |
lab-notes/gap-survey-and-prior-art.md | A varredura de trabalhos anteriores de 2026-08-12 (Nessus, Nuclei, Metasploit, nmap NSE, geeknik/scada-scanner, ICS Advisory Project) |
lab-notes/check-inventory.md | Mapeamento das próprias descobertas (ambos os projetos irmãos) para verificações planejadas, com status de divulgação |
lab-notes/default-credentials-sweep.md | Registro fase a fase da varredura de credenciais padrão — a história de origem da maioria das 98 verificações |
core/ | Motor — registro, carregamento de alvos/políticas, camada de segurança/limitação de taxa, logging, relatórios |
core/passive.py / core/detect_match.py / core/detections.py | Modo passivo de transmissão zero — captura/dissecação/inventário, correspondência de detecção nativa, a seção de relatório Observed-Activity |
checks/ | Conteúdo do registro de verificações, organizado por protocolo; checks/candidates/ contém stubs em estágio de pesquisa, nunca executáveis |
detection-gen/ | Gera detecções implantáveis (Sigma / Splunk-ESCU / Suricata / assinatura Zeek + política ATT&CK-for-ICS) a partir dos mesmos detection_hints de checks/ |
icsscanner.py | Driver CLI — scan ativo e discover sniff passivo; veja acima |
icsscanner-web.py / web/ | Interface web — um painel de controle local sobre o mesmo motor |
templates/ | Arquivos YAML de exemplo de inventário de alvos e política de varredura |
lab-notes/passive-mode.md | Arquitetura do modo passivo + requisitos de sistema TSA (dimensionamento a partir do conjunto de dados PNNL OT-IDS) |
Três formas de executá-lo, agrupadas por quanto elas tocam a rede. Escolha conforme o que o ambiente-alvo permite — a postura de transmissão é a distinção crítica de segurança:
| Modo | Transmite? | Use quando | Comandos |
|---|---|---|---|
| Passivo | Não — somente RX, zero pacotes (discover sniff) | OT em produção onde sondagem ativa é proibida (segurança, dispositivos legados frágeis, controle de mudanças) | discover sniff (SPAN/TAP/pcap/Zeek-logs); discover passive (escuta ARP + Sparkplug — veja a ressalva abaixo) |
| Varredura ativa | Sim — envia sondas e logins opcionais | Ativos que você possui ou tem permissão escrita explícita para testar | scan (CLI padrão / arquivo de política / interface web); discover active (varredura ARP para encontrar hosts primeiro) |
| Interoperabilidade com Malcolm | Chamadas de API somente leitura para o seu próprio Malcolm | Você já executa uma pilha passiva Malcolm / Hedgehog | discover malcolm (lê o inventário + correlaciona; --push envia os achados de volta); discover sniff --push-malcolm (envia os achados de uma execução passiva) |
Cada modo é detalhado abaixo. scan e discover sniff são os comandos principais; discover active /
discover passive são auxiliares secundários de descoberta dentro dos modos Ativo / Passivo. O modo seguro
(somente fingerprint, sem verificações destrutivas) é o padrão em todo modo que pode transmitir.
Detalhes completos em 04-USAGE-GUIDE.md. Versão resumida — três formas de entrada, todas acionando o mesmo 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
Copie templates/target-inventory.example.yaml (e, opcionalmente, templates/scan-policy.example.yaml)
antes de editar — não faça a varredura diretamente a partir do template. Liste apenas dispositivos que você possui ou para os quais tem
permissão escrita explícita para testar. Cada alvo é um host: exato — um IP ou FQDN, nunca um
intervalo CIDR; esta é uma decisão de escopo deliberada (listas pequenas de ativos conhecidos, não uma ferramenta de varredura de rede),
não uma funcionalidade ausente — consulte 04-USAGE-GUIDE.md.