Générateur de Rapport Masscan

Un outil Python qui génère des visualisations HTML interactives basées sur React à partir de la sortie JSON de masscan, avec un graphe réseau dirigé par la force D3.js.

Capture d'écran

Fonctionnalités

Graphe réseau interactif

• Visualisation D3.js dirigée par la force montrant la topologie réseau
• Structure hiérarchique : Internet → Classe A (/8) → Classe B (/16) → Classe C (/24) → Hôtes → Ports
• Glisser-déposer et zoom pour explorer le réseau
• Nœuds codés par couleur selon le type (hôtes, ports, segments réseau)

Recherche & Filtre

• Recherche en direct - filtrer les hôtes et ports au fur et à mesure de la saisie
• Préfixe de recherche de port - utiliser : pour rechercher uniquement les ports (ex : :443)
• Support des caractères génériques - utiliser * pour la correspondance de motifs (ex : :*443, :80*, :*8*)
• Mise en évidence en temps réel des nœuds correspondants sur le graphe

Fenêtre modale des détails de l'hôte

• Cliquer sur n'importe quel nœud du graphe pour afficher les informations détaillées
• Nœuds hôtes affichent tous les ports ouverts avec les descriptions de service
• Nœuds ports affichent les informations de service, le protocole et le niveau de risque de sécurité
• Badges de sécurité codés par couleur : ÉLEVÉ (rouge), MOYEN (jaune), FAIBLE (sarcelle), SÉCURISÉ (cyan)
• Liens vers la documentation pour chaque service

Export PDF

• Rapports PDF professionnels avec thème sombre
• Page de titre avec statistiques récapitulatives
• Capture d'écran du graphe prise depuis la vue actuelle
• Résumé exécutif en langage naturel
• Détails des hôtes organisés par classe réseau

Barre latérale de navigation

• Liste de tous les hôtes découverts avec leurs ports ouverts
• Cliquer pour mettre en évidence l'hôte et ses nœuds enfants sur le graphe
• Badges de ports pour une identification rapide

Installation

Depuis les sources

# Cloner ou télécharger le projet
cd masscan_report

# Installer les dépendances (optionnel, nécessaire uniquement pour la génération PDF en développement)
pip install pyinstaller  # Seulement si vous compilez l'exécutable

Exécutable autonome

Téléchargez masscan_report.exe depuis le dossier dist/ - aucune installation Python requise.

Utilisation

Ligne de commande

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

# Avec l'exécutable
masscan_report.exe <input_json> [-o output.html]

Exemples

# Générer un rapport avec le nom par défaut (report.html)
python masscan_report.py scans/home.json

# Spécifier un fichier de sortie personnalisé
python masscan_report.py scans/network_scan.json -o network_report.html

# Avec l'exécutable
.\dist\masscan_report.exe .\scans\home.192.168.10000.json

Format d'entrée

L'outil attend le format de sortie JSON de 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}
  ]}
]

Générer ceci avec masscan :

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

Contrôles clavier et souris

Syntaxe de recherche

Structure du projet

masscan_report/
├── masscan_report.py      # Script principal
├── port_descriptions.py   # Base de données des ports (6700+ lignes)
├── scans/                  # Exemples de fichiers de scan
│   ├── home.json
│   └── home.192.168.10000.json
├── dist/
│   └── masscan_report.exe # Exécutable autonome
├── report.html            # Sortie générée
└── README.md

Base de données des descriptions de ports

Le fichier port_descriptions.py contient des informations détaillées pour plus de 130 ports courants, incluant :

• Nom et description du service
• Détails techniques
• Évaluation du risque de sécurité
• Liens vers la documentation

Compilation de l'exécutable

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

L'exécutable sera créé dans dist/masscan_report.exe.

Prérequis

• Python 3.8+ (pour exécution depuis les sources)
• Navigateur web moderne (pour visualiser les rapports)
• Aucun paquet Python supplémentaire requis (utilise uniquement la bibliothèque standard)

License

MIT License

Contribuer

Les contributions sont les bienvenues ! N'hésitez pas à soumettre des problèmes et des demandes de tirage (pull requests).