Генератор отчетов Masscan

Инструмент на Python, который создает интерактивные HTML-визуализации на основе React из выходных данных masscan в формате JSON, используя силовой граф D3.js.

Скриншот

Возможности

Интерактивный граф сети

• Силовой граф на D3.js — отображает топологию сети
• Иерархическая структура: Интернет → Класс A (/8) → Класс B (/16) → Класс C (/24) → Узлы → Порты
• Перетаскивание и масштабирование для изучения сети
• Цветовая маркировка узлов по типу (узлы, порты, сегменты сети)

Поиск и фильтрация

• Живой поиск — фильтрация узлов и портов по мере ввода
• Префикс поиска порта — используйте : для поиска только по портам (например, :443)
• Поддержка масок — используйте * для поиска по шаблону (например, :*443, :80*, :*8*)
• Подсветка в реальном времени совпадающих узлов на графе

Модальное окно сведений об узле

• Нажмите на любой узел графа, чтобы просмотреть подробную информацию
• Узлы-хосты отображают все открытые порты с описаниями служб
• Узлы-порты показывают информацию о службе, протоколе и уровне риска
• Значки безопасности цветом: ВЫСОКИЙ (красный), СРЕДНИЙ (жёлтый), НИЗКИЙ (бирюзовый), БЕЗОПАСНЫЙ (голубой)
• Ссылки на документацию для каждой службы

Экспорт в PDF

• Профессиональные PDF-отчёты в тёмной теме
• Титульная страница со сводной статистикой
• Снимок графа, сделанный с текущего вида
• Резюме на естественном языке
• Сведения об узлах, сгруппированные по классам сети

Боковая панель навигации

• Список всех обнаруженных узлов с открытыми портами
• Нажмите, чтобы подсветить узел и дочерние узлы на графе
• Значки портов для быстрой идентификации

Установка

Из исходного кода

# Клонируйте или загрузите проект
cd masscan_report

# Установите зависимости (только для сборки PDF при разработке)
pip install pyinstaller  # Только если собираете exe

Готовый исполняемый файл

Скачайте masscan_report.exe из папки dist/ — установка Python не требуется.

Использование

Командная строка

# Используя Python
python masscan_report.py <input_json> [-o output.html]

# Используя исполняемый файл
masscan_report.exe <input_json> [-o output.html]

Примеры

# Создать отчёт с именем по умолчанию (report.html)
python masscan_report.py scans/home.json

# Указать собственное имя файла
python masscan_report.py scans/network_scan.json -o network_report.html

# Используя исполняемый файл
.\dist\masscan_report.exe .\scans\home.192.168.10000.json

Формат входных данных

Инструмент ожидает выходной формат masscan JSON:

[
  {"ip": "192.168.1.1", "timestamp": "1234567890", "ports": [
    {"port": 80, "proto": "tcp", "status": "open", "reason": "syn-ack", "ttl": 64}
  ]},
  {"ip": "192.168.1.1", "timestamp": "1234567891", "ports": [
    {"port": 443, "proto": "tcp", "status": "open", "reason": "syn-ack", "ttl": 64}
  ]}
]

Создайте его с помощью masscan:

masscan 192.168.1.0/24 -p1-65535 --rate 1000 -oJ scan_results.json

Управление клавиатурой и мышью

Синтаксис поиска

Структура проекта

masscan_report/
├── masscan_report.py      # Основной скрипт
├── port_descriptions.py   # База данных портов (6700+ строк)
├── scans/                  # Примеры файлов сканирования
│   ├── home.json
│   └── home.192.168.10000.json
├── dist/
│   └── masscan_report.exe # Готовый исполняемый файл
├── report.html            # Созданный отчёт
└── README.md

База данных описаний портов

Файл port_descriptions.py содержит подробную информацию о 130+ распространённых портах, включая:

• Имя службы и описание
• Технические детали
• Оценка риска безопасности
• Ссылки на документацию

Сборка исполняемого файла

pip install pyinstaller
pyinstaller --onefile --name masscan_report --add-data "port_descriptions.py;." masscan_report.py

Исполняемый файл будет создан в dist/masscan_report.exe.

Требования

• Python 3.8+ (для запуска из исходного кода)
• Современный веб-браузер (для просмотра отчётов)
• Дополнительные пакеты Python не требуются (использует только стандартную библиотеку)

Лицензия

MIT License

Вклад

Приветствуются любые улучшения! Смело создавайте issue и pull request.