Masscan Report Generator

Ein Python-Tool, das interaktive, React-basierte HTML-Visualisierungen aus Masscan-JSON-Ausgaben erstellt – mit einem D3.js-Kraft-basierten Netzwerkgraphen.

Screenshot

Features

Interaktiver Netzwerkgraph

• Kraft-basierte D3.js-Visualisierung zur Darstellung der Netzwerktopologie
• Hierarchische Struktur: Internet → Klasse A (/8) → Klasse B (/16) → Klasse C (/24) → Hosts → Ports
• Ziehen und Zoomen zur Erkundung des Netzwerks
• Farbcodierte Knoten nach Typ (Hosts, Ports, Netzsegmente)

Suche & Filter

• Live-Suche – Filtere Hosts und Ports während der Eingabe
• Port-Suchpräfix – Verwende :, um nur nach Ports zu suchen (z. B. :443)
• Wildcard-Unterstützung – Nutze * für Mustersuche (z. B. :*443, :80*, :*8*)
• Echtzeit-Hervorhebung passender Knoten im Graphen

Host-Detail-Modal

• Klicke auf einen beliebigen Graphenknoten, um detaillierte Informationen anzuzeigen
• Host-Knoten zeigen alle offenen Ports mit Dienstbeschreibungen
• Port-Knoten zeigen Dienstinfo, Protokoll und Sicherheitsrisikostufe
• Sicherheitsabzeichen farbcodiert: HOCH (rot), MITTEL (gelb), NIEDRIG (teal), SICHER (cyan)
• Links zur Dokumentation für jeden Dienst

PDF-Export

• Professionelle PDF-Berichte mit dunklem Theme
• Titelseite mit Zusammenfassungsstatistiken
• Graph-Screenshot aus der aktuellen Ansicht
• Management Summary in natürlicher Sprache
• Host-Details nach Netzklasse organisiert

Seitenleisten-Navigation

• Liste aller entdeckten Hosts mit ihren offenen Ports
• Klick zur Hervorhebung des Hosts und der Kindknoten im Graphen
• Port-Abzeichen zur schnellen Identifikation

Installation

Aus dem Quellcode

# Repository klonen oder herunterladen
cd masscan_report

# Abhängigkeiten installieren (optional, nur für PDF-Erstellung in der Entwicklung benötigt)
pip install pyinstaller  # Nur, wenn eine EXE gebaut werden soll

Standalone-Ausführbare Datei

Lade masscan_report.exe aus dem dist/-Ordner herunter – keine Python-Installation erforderlich.

Verwendung

Kommandozeile

# Mit Python
python masscan_report.py <input_json> [-o output.html]

# Mit der ausführbaren Datei
masscan_report.exe <input_json> [-o output.html]

Beispiele

# Bericht mit Standardausgabe erstellen (report.html)
python masscan_report.py scans/home.json

# Benutzerdefinierte Ausgabedatei festlegen
python masscan_report.py scans/network_scan.json -o network_report.html

# Mit der ausführbaren Datei
.\dist\masscan_report.exe .\scans\home.192.168.10000.json

Eingabeformat

Das Tool erwartet das JSON-Ausgabeformat von masscan:

[
  {"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}
  ]}
]

Dies mit masscan erzeugen:

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

Tastatur- & Maussteuerung

Suchsyntax

Projektstruktur

masscan_report/
├── masscan_report.py      # Hauptskript
├── port_descriptions.py   # Portdatenbank (6700+ Zeilen)
├── scans/                  # Beispiel-Scandateien
│   ├── home.json
│   └── home.192.168.10000.json
├── dist/
│   └── masscan_report.exe # Standalone-Ausführbare Datei
├── report.html            # Generierte Ausgabe
└── README.md
## Portbeschreibungsdatenbank

Die `port_descriptions.py` enthält detaillierte Informationen zu über 130 gängigen Ports, darunter:
- Dienstname und -beschreibung
- Technische Details
- Sicherheitsrisikobewertung
- Dokumentationslinks

## Erstellen der ausführbaren Datei

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

Die ausführbare Datei wird in dist/masscan_report.exe erstellt.

Anforderungen

• Python 3.8+ (für die Ausführung aus dem Quellcode)
• Moderner Webbrowser (zum Anzeigen der Berichte)
• Keine zusätzlichen Python-Pakete erforderlich (verwendet nur die Standardbibliothek)

Lizenz

MIT-Lizenz

Mitwirken

Beiträge sind willkommen! Du kannst gerne Issues und Pull-Requests einreichen.