Generador de Informes de Masscan

Una herramienta Python que genera visualizaciones HTML interactivas basadas en React a partir de la salida JSON de masscan, con un gráfico de red dirigido por fuerzas de D3.js.

Captura de pantalla

Características

Gráfico de Red Interactivo

• Visualización dirigida por fuerzas de D3.js que muestra la topología de red
• Estructura jerárquica: Internet → Clase A (/8) → Clase B (/16) → Clase C (/24) → Hosts → Puertos
• Arrastrar y hacer zoom para explorar la red
• Nodos codificados por colores según el tipo (hosts, puertos, segmentos de red)

Búsqueda y Filtro

• Búsqueda en vivo - filtra hosts y puertos mientras escribes
• Prefijo de búsqueda de puertos - usa : para buscar solo puertos (ej., :443)
• Soporte de comodines - usa * para coincidencia de patrones (ej., :*443, :80*, :*8*)
• Resaltado en tiempo real de los nodos coincidentes en el gráfico

Modal de Detalles del Host

• Haz clic en cualquier nodo del gráfico para ver información detallada
• Nodos de host muestran todos los puertos abiertos con descripciones de servicios
• Nodos de puerto muestran información del servicio, protocolo y nivel de riesgo de seguridad
• Insignias de seguridad codificadas por colores: ALTO (rojo), MEDIO (amarillo), BAJO (verde azulado), SEGURO (cian)
• Enlaces a documentación para cada servicio

Exportación a PDF

• Informes PDF profesionales con estilo de tema oscuro
• Página de título con estadísticas resumidas
• Captura de pantalla del gráfico tomada desde la vista actual
• Resumen ejecutivo en lenguaje natural
• Detalles del host organizados por clase de red

Navegación Lateral

• Lista de todos los hosts descubiertos con sus puertos abiertos
• Haz clic para resaltar el host y los nodos hijos en el gráfico
• Insignias de puerto para identificación rápida

Instalación

Desde el código fuente

# 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

Ejecutable Independiente

Descarga masscan_report.exe de la carpeta dist/ - no requiere instalación de Python.

Uso

Línea de Comandos

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

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

Ejemplos

# 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 de Entrada

La herramienta espera el formato de salida 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}
  ]}
]

Genera esto con masscan:

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

Controles de Teclado y Ratón

Sintaxis de Búsqueda

Estructura del Proyecto

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

Base de Datos de Descripciones de Puertos

port_descriptions.py contiene información detallada de más de 130 puertos comunes, incluyendo:

• Nombre y descripción del servicio
• Detalles técnicos
• Evaluación de riesgo de seguridad
• Enlaces a documentación

Compilación del Ejecutable

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

El ejecutable se creará en dist/masscan_report.exe.

Requisitos

• Python 3.8+ (para ejecutar desde el código fuente)
• Navegador web moderno (para visualizar informes)
• No se requieren paquetes Python adicionales (usa solo la biblioteca estándar)

Licencia

Licencia MIT

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar problemas y solicitudes de extracción.