Сканер уязвимостей для протоколов ICS/OT, ориентированный прежде всего на безопасность.
Сканер уязвимостей для протоколов ICS/OT, в первую очередь ориентированный на безопасность. Он идентифицирует устройства и проверяет их на наличие известных CVE и небезопасных настроек по умолчанию — активно (опрашивая явный, авторизованный список целей) или пассивно (читая SPAN/TAP или pcap и ничего не передавая) — сопоставляет находки с CVE и может выдавать готовый к развёртыванию контент обнаружения для Zeek, Suricata, Sigma и Splunk.
Ответственное использование. icsScanner может отправлять активные пробы и попытки аутентификации в работающие промышленные системы, где неожиданный трафик может нарушить физические процессы. Сканируйте только те устройства, которыми вы владеете или которые явно авторизованы для тестирования. Активные проверки по умолчанию отключены (безопасный режим сообщает только результаты фингерпринтинга); пассивный режим (
discover sniff) ничего не передаёт и является правильным выбором в работающих OT-сетях. См. SECURITY.md.
Корпус проверок охватывает множество протоколов ICS/OT. Большинство проверок нацелены на заводские учётные данные по умолчанию и небезопасные
настройки по умолчанию; кандидаты для сопоставления с CVE строятся из структурированных лент уязвимостей — ICS Advisory
Project, японского MyJVN, OT-рекомендаций CISA CSAF 2.0 и Базы данных уязвимостей ЕС ENISA. Отчётность —
JSONL + текстовое резюме, с экспортом в HTML / CSV / SVG. Полное руководство см. в 04-USAGE-GUIDE.md, или
«Running a scan» ниже для краткой версии.
Исследование предшествующих работ выявило реальные пробелы в покрытии сканирования уязвимостей ICS/OT: семейство плагинов SCADA в Nessus зрелое, но закрытое/коммерческое; контент ICS в Nuclei и Metasploit скуден; nmap NSE хорошо покрывает фингерпринтинг, но не имеет проверок на уровне CVE. Ни у кого нет открытого, ориентированного на безопасность, активно расширяемого слоя активных проверок CVE для ICS. icsScanner заполняет этот пробел.
| Файл | Назначение |
|---|---|
00-PROJECT-CHARTER.md | Область охвата, решения, поэтапные вехи (0–5), LOE |
01-METHODOLOGY-AND-CHECKLISTS.md | Метод безопасной разработки активных проверок + критерий «является ли это безопасной проверкой?» |
02-DISCLOSURE-PLAYBOOK.md | Контракт disclosure_status для безопасного использования находок из внешних источников |
03-STYLE-AND-DECISIONS.md | Идентичность, именование и решение о публикации пока в закрытом виде |
04-USAGE-GUIDE.md | Полное руководство: CLI + веб-интерфейс, форматы инвентаря целей/политики сканирования, модель безопасности, справочник API, устранение неполадок |
lab-notes/gap-survey-and-prior-art.md | Обзор предшествующих работ от 2026-08-12 (Nessus, Nuclei, Metasploit, nmap NSE, geeknik/scada-scanner, ICS Advisory Project) |
lab-notes/check-inventory.md | Сопоставление собственных находок (обоих смежных проектов) с запланированными проверками, со статусом раскрытия |
lab-notes/default-credentials-sweep.md | Поэтапный журнал обзора учётных данных по умолчанию — история происхождения большинства из 98 проверок |
core/ | Движок — реестр, загрузка целей/политик, слой безопасности/ограничения частоты, логирование, отчётность |
core/passive.py / core/detect_match.py / core/detections.py | Пассивный режим без передачи — захват/разбор/инвентаризация, нативное сопоставление обнаружений, раздел отчёта Observed-Activity |
checks/ | Содержимое реестра проверок, организованное по протоколам; checks/candidates/ содержит заготовки на стадии исследования, никогда не исполняемые |
detection-gen/ | Генерирует готовые к развёртыванию обнаружения (Sigma / Splunk-ESCU / Suricata / Zeek signature + политика ATT&CK-for-ICS) из тех же checks/ detection_hints |
icsscanner.py | Драйвер CLI — активный scan и пассивный discover sniff; см. выше |
icsscanner-web.py / web/ | Веб-интерфейс — локальная панель управления поверх того же движка |
templates/ | Примеры YAML-файлов инвентаря целей и политики сканирования |
lab-notes/passive-mode.md | Архитектура пассивного режима + системные требования TSA (расчёт размеров по набору данных PNNL OT-IDS) |
Три способа запуска, сгруппированные по степени взаимодействия с сетью. Выбирайте в зависимости от того, что допускает целевая среда — режим передачи данных является критически важным для безопасности различием:
| Режим | Передаёт данные? | Когда использовать | Команды |
|---|---|---|---|
| Пассивный | Нет — только приём (RX), ноль пакетов (discover sniff) | Работающая OT-сеть, где активное зондирование запрещено (безопасность, хрупкие устаревшие устройства, контроль изменений) | discover sniff (SPAN/TAP/pcap/Zeek-логи); discover passive (прослушивание ARP + Sparkplug — см. оговорку ниже) |
| Активное сканирование | Да — отправляет пробы и, при явном согласии, выполняет входы | Активы, которыми вы владеете или на тестирование которых у вас есть явное письменное разрешение | scan (CLI по умолчанию / файл политики / веб-интерфейс); discover active (ARP-обход для предварительного поиска хостов) |
| Взаимодействие с Malcolm | Только чтение через API-вызовы к вашему собственному Malcolm | У вас уже развёрнут пассивный стек Malcolm / Hedgehog | discover malcolm (чтение инвентаря + корреляция; --push отправляет находки обратно); discover sniff --push-malcolm (отправка находок пассивного запуска) |
Каждый режим подробно описан ниже. scan и discover sniff — основные команды; discover active /
discover passive — вспомогательные средства обнаружения в рамках активного / пассивного режимов. Безопасный режим
(только фингерпринтинг, без деструктивных проверок) включён по умолчанию в каждом режиме, который может передавать данные.
Подробности в 04-USAGE-GUIDE.md. Кратко — три способа запуска, все используют один и тот же движок:
# 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
Скопируйте templates/target-inventory.example.yaml (и, при желании, templates/scan-policy.example.yaml)
перед редактированием — не сканируйте прямо из шаблона. Указывайте только те устройства, которыми вы владеете или на тестирование которых у вас есть
явное письменное разрешение. Каждая цель — это один точный host: — IP или FQDN, никогда не
диапазон CIDR; это осознанное решение по области охвата (небольшие списки известных активов, а не инструмент
сетевого сканирования), а не отсутствующая функция — см. 04-USAGE-GUIDE.md.