Gerador de Relatórios PDF a partir do Nuclei

Uma ferramenta de automação de nível profissional projetada para preencher a lacuna entre a varredura técnica de vulnerabilidades e a elaboração de relatórios executivos. Desenvolvido por Adi Mahluf (Tenroot Cyber Security).

🚀 Visão Geral

Este projeto fornece um fluxo de trabalho "um comando" contínuo para auditar ativos web. Ele aproveita o motor de alto desempenho Nuclei para identificar vulnerabilidades e configurações incorretas, e então compila automaticamente os resultados brutos em um relatório PDF formatado e pronto para o cliente. É especialmente adaptado para Arquitetos de Segurança e equipes de Resposta a Incidentes que precisam entregar dados claros e acionáveis para as partes interessadas.

🛠️ Pré-requisitos

Para garantir que a ferramenta funcione corretamente em diferentes ambientes, os seguintes componentes devem estar instalados em sua estação de trabalho.

1. Motor Nuclei (v3.x+)

O motor de varredura principal. Certifique-se de estar usando a versão 3.0 ou superior para suportar modelos e flags modernos.

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

2. Python 3 e Ambiente Virtual

O script de relatório requer Python 3.10+ e a biblioteca fpdf2 para recursos modernos de PDF e suporte a Unicode. Instruções de Configuração:

# 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. Ferramentas Utilitárias

Necessário para lidar com permissões de script e codificação entre plataformas.

sudo apt install dos2unix -y

📥 Instalação

1. Clone o Repositório:

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

2. Corrigir Codificação e Permissões: Certifique-se de que os scripts tenham direitos de execução e usem terminações de linha Unix.

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

3. Adicione sua Marca: Coloque o logotipo da sua empresa na pasta raiz do projeto e nomeie-o exatamente como logo.png.

##📑 Uso Execute o script de auditoria fornecendo o domínio alvo. O script padrão é o Modo Furtivo (limitado por taxa) para evitar ser bloqueado por Firewalls de Aplicação Web (WAF).

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

• Exemplo (Furtivo): ./scan.sh tenroot.io
• Exemplo (Agressivo): ./scan.sh internal-site.local --aggressive

A ferramenta gerará um arquivo nomeado: Report_domain.com_YYYYMMDD-HHMM.pdf.

📋 Recursos do Relatório

• Resumo de Risco Executivo: Uma contagem de alto nível das descobertas categorizadas de Crítico a Informativo.
• Descobertas Detalhadas: Descrições técnicas de cada vulnerabilidade ou tecnologia identificada, incluindo a URL afetada.
• Conselhos de Remediação: Passos de mitigação acionáveis e passo a passo extraídos diretamente dos modelos do Nuclei.

📷 Imagens

⚠️ Solução de Problemas

Aviso Legal: Esta ferramenta é destinada apenas para testes de segurança autorizados. O desenvolvedor não assume nenhuma responsabilidade por uso indevido ou danos causados por esta aplicação