Generatore di Report Masscan

Uno strumento Python che genera visualizzazioni HTML interattive basate su React a partire dall'output JSON di masscan, con un grafico di rete force-directed basato su D3.js.

Screenshot

Caratteristiche

Grafico di rete interattivo

• Visualizzazione force-directed con D3.js che mostra la topologia di rete
• Struttura gerarchica: Internet → Classe A (/8) → Classe B (/16) → Classe C (/24) → Host → Porte
• Trascina e ingrandisci per esplorare la rete
• Nodi colorati per tipo (host, porte, segmenti di rete)

Ricerca e filtro

• Ricerca live - filtra host e porte durante la digitazione
• Prefisso di ricerca per porte - usa : per cercare solo le porte (es. :443)
• Supporto wildcard - usa * per corrispondenze parziali (es. :*443, :80*, :*8*)
• Evidenziazione in tempo reale dei nodi corrispondenti sul grafico

Modale dei dettagli dell'host

• Clicca su qualsiasi nodo del grafico per visualizzare informazioni dettagliate
• Nodi host mostrano tutte le porte aperte con descrizioni dei servizi
• Nodi porta mostrano informazioni sul servizio, protocollo e livello di rischio di sicurezza
• Badge di sicurezza colorati: ALTO (rosso), MEDIO (giallo), BASSO (verde acqua), SICURO (ciano)
• Collegamenti alla documentazione per ogni servizio

Esportazione PDF

• Report PDF professionali con tema scuro
• Pagina del titolo con statistiche riassuntive
• Screenshot del grafico acquisito dalla vista corrente
• Riepilogo esecutivo in linguaggio naturale
• Dettagli degli host organizzati per classe di rete

Navigazione laterale

• Elenco di tutti gli host scoperti con le loro porte aperte
• Clicca per evidenziare l'host e i nodi figli sul grafico
• Badge delle porte per una rapida identificazione

Installazione

Dal sorgente

# Clone or download the project
cd masscan_report

# Install dependencies (optional, only needed for PDF generation in development)
pip install pyinstaller  # Only if building exe

Eseguibile standalone

Scarica masscan_report.exe dalla cartella dist/ - non è richiesta alcuna installazione di Python.

Utilizzo

Riga di comando

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

# Using executable
masscan_report.exe <input_json> [-o output.html]

Esempi

# Generate report with default output (report.html)
python masscan_report.py scans/home.json

# Specify custom output file
python masscan_report.py scans/network_scan.json -o network_report.html

# Using the executable
.\dist\masscan_report.exe .\scans\home.192.168.10000.json

Formato di input

Lo strumento prevede il formato di output JSON di 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}
  ]}
]

Genera questo con masscan:

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

Controlli tastiera e mouse

Sintassi di ricerca

Struttura del progetto

masscan_report/
├── masscan_report.py      # Main script
├── port_descriptions.py   # Port database (6700+ lines)
├── scans/                  # Sample scan files
│   ├── home.json
│   └── home.192.168.10000.json
├── dist/
│   └── masscan_report.exe # Standalone executable
├── report.html            # Generated output
└── README.md

Database delle descrizioni delle porte

Il file port_descriptions.py contiene informazioni dettagliate per oltre 130 porte comuni, tra cui:

• Nome e descrizione del servizio
• Dettagli tecnici
• Valutazione del rischio di sicurezza
• Collegamenti alla documentazione

Creazione dell'eseguibile

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

L'eseguibile verrà creato in dist/masscan_report.exe.

Requisiti

• Python 3.8+ (per esecuzione dal sorgente)
• Browser web moderno (per visualizzare i report)
• Nessun pacchetto Python aggiuntivo richiesto (utilizza solo librerie standard)

Licenza

Licenza MIT

Contributi

I contributi sono benvenuti! Sentiti libero di inviare issue e pull request.