Gerador de Relatórios do Masscan

Uma ferramenta Python que gera visualizações HTML interativas baseadas em React a partir da saída JSON do masscan, apresentando um gráfico de rede dirigido por força com D3.js.

Captura de Tela

Funcionalidades

Gráfico de Rede Interativo

• Visualização D3.js dirigida por força mostrando a topologia de rede
• Estrutura hierárquica: Internet → Classe A (/8) → Classe B (/16) → Classe C (/24) → Hosts → Portas
• Arraste e zoom para explorar a rede
• Nós codificados por cores por tipo (hosts, portas, segmentos de rede)

Pesquisa e Filtro

• Pesquisa ao vivo - filtre hosts e portas enquanto digita
• Prefixo de pesquisa de porta - use : para pesquisar apenas portas (ex.: :443)
• Suporte a curingas - use * para correspondência de padrões (ex.: :*443, :80*, :*8*)
• Realce em tempo real dos nós correspondentes no gráfico

Modal de Detalhes do Host

• Clique em qualquer nó do gráfico para ver informações detalhadas
• Nós de host exibem todas as portas abertas com descrições dos serviços
• Nós de porta mostram informações do serviço, protocolo e nível de risco de segurança
• Distintivos de segurança codificados por cores: ALTO (vermelho), MÉDIO (amarelo), BAIXO (azul-petróleo), SEGURO (ciano)
• Links para documentação de cada serviço

Exportação para PDF

• Relatórios PDF profissionais com estilo de tema escuro
• Página de título com estatísticas resumidas
• Captura de tela do gráfico extraída da visualização atual
• Resumo executivo em linguagem natural
• Detalhes do host organizados por classe de rede

Navegação na Barra Lateral

• Lista de todos os hosts descobertos com suas portas abertas
• Clique para realçar o host e os nós filhos no gráfico
• Distintivos de porta para identificação rápida

Instalação

A partir do Código Fonte

# Clone ou baixe o projeto
cd masscan_report

# Instale dependências (opcional, necessário apenas para geração de PDF em desenvolvimento)
pip install pyinstaller  # Apenas se for construir o executável

Executável Independente

Baixe masscan_report.exe da pasta dist/ - nenhuma instalação do Python é necessária.

Uso

Linha de Comando

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

# Usando o executável
masscan_report.exe <input_json> [-o output.html]

Exemplos

# Gerar relatório com saída padrão (report.html)
python masscan_report.py scans/home.json

# Especificar arquivo de saída personalizado
python masscan_report.py scans/network_scan.json -o network_report.html

# Usando o executável
.\dist\masscan_report.exe .\scans\home.192.168.10000.json

Formato de Entrada

A ferramenta espera o formato de saída JSON do 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}
  ]}
]

Gere isso com o masscan:

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

Controles de Teclado e Mouse

Sintaxe de Pesquisa

Estrutura do Projeto

masscan_report/
├── masscan_report.py      # Script principal
├── port_descriptions.py   # Banco de dados de portas (6700+ linhas)
├── scans/                  # Arquivos de varredura de exemplo
│   ├── home.json
│   └── home.192.168.10000.json
├── dist/
│   └── masscan_report.exe # Executável independente
├── report.html            # Saída gerada
└── README.md

Banco de Dados de Descrições de Portas

O port_descriptions.py contém informações detalhadas para mais de 130 portas comuns, incluindo:

• Nome e descrição do serviço
• Detalhes técnicos
• Avaliação de risco de segurança
• Links para documentação

Construindo o Executável

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

O executável será criado em dist/masscan_report.exe.

Requisitos

• Python 3.8+ (para executar a partir do código fonte)
• Navegador web moderno (para visualizar relatórios)
• Nenhum pacote Python adicional necessário (usa apenas a biblioteca padrão)

Licença

Licença MIT

Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar issues e pull requests.