Generador de Informes PDF desde Nuclei

Una herramienta de automatización de grado profesional diseñada para cerrar la brecha entre el escaneo técnico de vulnerabilidades y la generación de informes ejecutivos. Desarrollada por Adi Mahluf (Tenroot Cyber Security).

🚀 Descripción general

Este proyecto proporciona un flujo de trabajo de "un solo comando" para auditar activos web. Aprovecha el motor de alto rendimiento Nuclei para identificar vulnerabilidades y configuraciones incorrectas, y luego compila automáticamente los resultados brutos en un informe PDF formateado y listo para el cliente. Está diseñado específicamente para Arquitectos de Seguridad y equipos de Respuesta a Incidentes que necesitan entregar datos claros y procesables a las partes interesadas.

🛠️ Requisitos previos

Para garantizar que la herramienta funcione correctamente en diferentes entornos, los siguientes componentes deben estar instalados en su estación de trabajo.

1. Motor Nuclei (v3.x+)

El motor de escaneo principal. Asegúrese de usar la versión 3.0 o superior para soportar plantillas y banderas modernas.

go install -v [github.com/projectdiscovery/nuclei/v3/cmd/nuclei@latest](https://github.com/projectdiscovery/nuclei/v3/cmd/nuclei@latest)

2. Python 3 y entorno virtual

El script de generación de informes requiere Python 3.10+ y la biblioteca fpdf2 para funciones modernas de PDF y soporte Unicode. Instrucciones de configuración:

# Install venv tools if missing (Ubuntu/WSL)
sudo apt update && sudo apt install python3-venv python3-full -y
# Create and configure the environment
python3 -m venv venv
./venv/bin/pip install fpdf2

3. Herramientas de utilidad

Necesarias para manejar los permisos de scripts y la codificación multiplataforma.

sudo apt install dos2unix -y

📥 Instalación

1. Clonar el repositorio:

git clone [https://github.com/YourUsername/Nuclei-PDF-Generator.git](https://github.com/YourUsername/Nuclei-PDF-Generator.git)
cd Nuclei-PDF-Generator

2. Corregir codificación y permisos: Asegúrese de que los scripts tengan permisos de ejecución y usen finales de línea Unix.

chmod +x scan.sh
dos2unix scan.sh generate_report.py

3. Agregar su marca: Coloque el logotipo de su empresa en la carpeta raíz del proyecto y asígnele exactamente el nombre logo.png.

##📑 Uso Ejecute el script de auditoría proporcionando el dominio de destino. El script utiliza por defecto el modo sigiloso (con límite de velocidad) para evitar ser bloqueado por los firewalls de aplicaciones web (WAF).

./scan.sh <domain_name> [--aggressive]

• Ejemplo (sigiloso): ./scan.sh tenroot.io
• Ejemplo (agresivo): ./scan.sh internal-site.local --aggressive

La herramienta generará un archivo llamado: Report_domain.com_YYYYMMDD-HHMM.pdf.

📋 Características del informe

• Resumen ejecutivo de riesgos: Un recuento de alto nivel de hallazgos categorizados desde Crítico hasta Informativo.
• Hallazgos detallados: Descripciones técnicas de cada vulnerabilidad o tecnología identificada, incluida la URL afectada.
• Consejos de remediación: Pasos de mitigación procesables y paso a paso extraídos directamente de las plantillas de Nuclei.

📷 Imágenes

⚠️ Solución de problemas

Aviso legal: Esta herramienta está destinada únicamente a pruebas de seguridad autorizadas. El desarrollador no asume ninguna responsabilidad por el mal uso o los daños causados por esta aplicación.