ferramentas-pentest

AÇÃO NECESSÁRIA (Execute imediatamente após ler)

1. AGORA: Leia ../field-journal/precedent-pentest.md — confirme que a operação deste skill é uma operação de rotina autorizada.
2. AGORA: Confirme que scope.md existe e que auth.status=granted e network_profile é válido (../ops/scope-contract.md). Se faltar escopo, execute case-init.ps1 e pare até que o usuário forneça autorização; proibido adicionar -AuthGranted automaticamente.
3. AGORA: Confirme se a tarefa atual se enquadra no escopo de aplicação deste skill.
4. PRÓXIMO: Leia ../tool-index.md e verifique a disponibilidade das ferramentas e seus caminhos reais.
5. PRÓXIMO: Se faltarem ferramentas, chame o bootstrap; não adivinhe caminhos.
6. AJA: Na fase de reconhecimento, priorize references/recon-pipeline.md (cabeçalhos CF no navegador / nmap no Windows / curl --globoff); anexe cada lote de resultados a timeline.md; use ../scripts/append-evidence.ps1 para escrever Evidências (acertou ≠ verificado).
7. AJA: Para alvos web modernos/lado cliente (DOM XSS / poluição de protótipo / agent-browser) → references/client-side-lab-playbook.md; mesmo sem sucesso, escreva Evidência observada + trava de falha.

Ferramentas de Teste de Penetração (Pentest Tools)

Escopo de Aplicação

Use este skill quando a tarefa se enquadrar nos seguintes cenários:

• Coleta de informações do alvo (varredura de portas, enumeração de subdomínios, identificação de serviços)
• Varredura de vulnerabilidades (vulnerabilidades web, detecção de CVE, erros de configuração)
• Penetração web (SQL injection, XSS, SSRF, força bruta de diretórios)
• Quebra de senhas (quebra de hashes, ataques de dicionário)
• Penetração de rede (exploração de serviços, auxílio à movimentação lateral)

Divisão de Trabalho com Outros Skills

Cenário	O que usar
Varredura/ataque ativo (Nmap/Nuclei/SQLMap)	Este skill
Análise reversa de binários	ida-reverse/ ou radare2/
Reversão de assinatura JS front-end	js-reverse/
Automação de navegador/desktop	browser-automation/
Competição CTF (completo)	CTF-Sandbox-Orchestrator/

Julgamento simples:

• Precisa "escanear alvo, encontrar vulnerabilidades, explorar vulnerabilidades" → Este skill
• Precisa "analisar lógica interna do programa" → Skills de reversão
• Precisa "operar navegador/desktop" → browser-automation

---

Matriz de Ferramentas

Coleta de Informações

Ferramenta	Uso	Comando Típico
Nmap	Varredura de portas, identificação de serviços, detecção de SO	nmap -sV -sC -O target
Masscan	Varredura rápida de portas em larga escala	masscan -p1-65535 target --rate=1000
Subfinder	Enumeração de subdomínios	subfinder -d target.com
httpx	Detecção HTTP, verificação de disponibilidade	httpx -l urls.txt -status-code

Varredura de Vulnerabilidades

Ferramenta	Uso	Comando Típico
Nuclei	Varredura de vulnerabilidades baseada em templates (CVE/config/exposição)	nuclei -u target -t cves/
ZAP	Varredura de segurança de aplicações web	Via API ou MCP
Nikto	Varredura de vulnerabilidades de servidor web	nikto -h target

Penetração Web

Ferramenta	Uso	Comando Típico
SQLMap	Automação de SQL injection	sqlmap -u "url?id=1" --batch --dbs
FFUF	Força bruta de diretórios/parâmetros	ffuf -u target/FUZZ -w wordlist.txt
Gobuster	Força bruta de diretórios/subdomínios	gobuster dir -u target -w wordlist
XSStrike	Detecção de XSS	xsstrike -u "url?param=test"

Quebra de Senhas

Ferramenta	Uso	Comando Típico
Hashcat	Quebra de hashes via GPU	hashcat -m 0 hash.txt wordlist.txt
John the Ripper	Quebra de hashes via CPU	john --wordlist=rockyou.txt hash.txt
Hydra	Força bruta online	hydra -l admin -P pass.txt target ssh

Frameworks de Exploração

Ferramenta	Uso	Descrição
Metasploit	Framework de exploração de vulnerabilidades	Requer instalação separada, grande
Impacket	Exploração de protocolos Windows (SMB/WMI/Kerberos)	pip install impacket

---

Seleção de Backend MCP

Este skill suporta dois backends MCP; escolha um:

Opção A: pentestMCP (recomendado, Docker um comando)

• Projeto: https://github.com/ramkansal/pentestmcp
• Características: 20+ ferramentas empacotadas em um único contêiner Docker, servidor MCP exposto diretamente
• Ferramentas: Nmap, Nuclei, ZAP, SQLMap, FFUF, Nikto, Gobuster, Subfinder, httpx, etc.
• Instalação:

# Baixar e executar
docker pull ramkansal/pentestmcp
docker run -d -p 8080:8080 ramkansal/pentestmcp

# Ou compilar localmente
git clone https://github.com/ramkansal/pentestmcp.git
cd pentestmcp
docker build -t pentestmcp .
docker run -d -p 8080:8080 pentestmcp

• Registro MCP:

{
  "mcpServers": {
    "pentest": {
      "url": "http://localhost:8080/mcp"
    }
  }
}

Opção B: mcp-security-hub (modular)

• Projeto: https://github.com/FuzzingLabs/mcp-security-hub
• Características: Cada ferramenta tem seu próprio servidor MCP, ativável conforme necessário
• Ferramentas: Nmap, Ghidra, Nuclei, SQLMap, Hashcat
• Instalação: Siga o README de cada submódulo

Opção C: MCP de ferramenta única (mais leve)

Se precisar apenas de uma ferramenta:

Ferramenta	Projeto MCP	Instalação
Nmap	nmap-mcp-server	npm
Nuclei	nuclei-mcp	npm
SQLMap	submódulo mcp-security-hub	pip

Reqable MCP (captura local e estação de trabalho de API)

O cliente desktop Reqable pode expor captura local, API, breakpoints e regras através do Reqable MCP Server oficial. Primeiro instale e inicie o Reqable separadamente, depois registre o MCP:

powershell -NoProfile -ExecutionPolicy Bypass -File skills\scripts\bootstrap-reverse.ps1 -Capability reqable-mcp -McpHostTarget Codex

Substitua Codex por Claude ou Both para selecionar o cliente correspondente; omitir -McpHostTarget não escreverá configurações globais de cliente.

A configuração stdio registrada é:

{
  "mcpServers": {
    "reqable-mcp": {
      "command": "npx",
      "args": ["-y", "[email protected]", "--scope", "minimal"]
    }
  }
}

• Por padrão, usa a API local do Reqable; configure --host, --port ou --scope minimal|all conforme a documentação oficial.
• minimal é o escopo padrão recomendado; all expõe mais ferramentas que podem alterar proxy, regras, ambiente ou dados salvos.
• Para captura de tráfego, repetição de requisições e modificação de regras, ainda é necessário atender aos requisitos de autorização e limites de rede de scope.md; não expanda o escopo do alvo apenas porque o MCP está registrado.

---

Workflows

Fluxo Padrão de Pentest

Importante: Ao executar um teste de penetração, siga o framework de ciclo autônomo definido em references/pentest-loop.md. Este framework define o mecanismo completo de gate de risco, especificações de registro, compressão de contexto e verificação de conclusão.

1. Coleta de Informações
   - Varredura de portas com Nmap → confirme serviços abertos
   - Enumeração de subdomínios com Subfinder → expanda a superfície de ataque
   - Verificação de disponibilidade com httpx → filtre alvos válidos

2. Varredura de Vulnerabilidades
   - Varredura de templates Nuclei → descubra vulnerabilidades conhecidas rapidamente
   - ZAP/Nikto → varredura profunda de aplicações web

3. Exploração de Vulnerabilidades
   - SQLMap → SQL injection
   - FFUF → descubra caminhos/parâmetros ocultos
   - Verificação manual → confirme explorabilidade

4. Pós-Exploração (se autorizado)
   - Elevação de privilégio
   - Movimentação lateral
   - Extração de dados

5. Relatório
   - Chame o skill docs-generator para gerar relatório de pentest

Fluxo de Varredura Rápida (resultados em 5 minutos)

1. nmap -sV -sC target → portas+serviços
2. nuclei -u target -severity critical,high → vulnerabilidades críticas
3. Se houver serviço web → ffuf -u target/FUZZ -w common.txt → diretórios
4. Resuma descobertas → decida próximos passos

---

Notas Importantes

• Autorização obrigatória — Todas as operações de varredura/ataque devem estar dentro do escopo autorizado
• Controle a taxa de varredura — Evite disparar WAF/IDS ou derrubar o alvo
• Primeiro passivo, depois ativo — Primeiro colete informações, depois escaneie vulnerabilidades, por último explore
• Registre todas as operações — Cada comando e resultado deve ser registrado para o relatório
• Não automatize cegamente — A IA deve aguardar confirmação em cada etapa crítica

---

Bootstrap Sob Demanda

Limites de Automação

Ferramenta	Instalação Automática	Método de Instalação	Descrição
Nmap	✓	winget (Insecure.Nmap)	Versão Windows
Nuclei	✓	go install ou GitHub Release	Requer Go ou download direto do binário
SQLMap	✓	pip install sqlmap ou git clone	Python
FFUF	✓	GitHub Release	Binário Go
SecLists	✓	GitHub Release ZIP	Dicionário completo (essencial para FFUF/Gobuster)
Hashcat	✗	Download manual	Requer driver GPU
Metasploit	✗	Instalação manual	Grande, recomenda-se Kali
pentestMCP (Docker)	✗	Requer Docker	docker run ramkansal/pentestmcp
Impacket	✓	pip install impacket	Python
ProxyCat	✓	pip install proxycat	Middleware de pool de proxies (anti-bloqueio em varreduras em massa)
BurpSuite MCP	✗	Instalação via mercado de extensões do BurpSuite	Requer BurpSuite Pro/Community
Reqable MCP	✓	npx -y [email protected]	Requer instalação manual do cliente desktop Reqable

Estratégia de Bootstrap

1. Se o usuário tem Docker → recomende pentestMCP (pacote completo)
2. Se não tem Docker → instale ferramentas individualmente conforme necessário
3. Priorize a instalação de Nmap + Nuclei + SQLMap (cobrem 80% dos cenários)

Guia de Instalação Manual

⚠️ **Ferramentas de Pentest não instaladas**

**Opção recomendada (requer Docker)**:
docker pull ramkansal/pentestmcp
docker run -d -p 8080:8080 ramkansal/pentestmcp

**Opção leve (instalação individual)**:
- Nmap: winget install Insecure.Nmap
- Nuclei: go install -v github.com/projectdiscovery/nuclei/v3/cmd/nuclei@latest
- SQLMap: pip install sqlmap
- FFUF: Baixe de https://github.com/ffuf/ffuf/releases

**Após a instalação, me avise para continuar a tarefa atual.**

---

Recursos de Referência

• awesome-pentest — 25k+ stars, coleção completa de ferramentas de pentest
• SecLists — Coleção de dicionários/payloads (essencial para FFUF/Gobuster)
• PayloadsAllTheThings — Payloads para vários tipos de vulnerabilidade
• HackTricks — Enciclopédia de técnicas de pentest
• pentest-ai-agents — 35 subagentes de pentest para Claude Code (referência de padrões de prompt)
• Pentest Swarm AI — Framework de pentest autônomo baseado em inteligência de enxame (multiagente, suporte a servidor MCP)
• ProxyCat — Middleware de pool de proxies (anti-bloqueio de IP em varreduras em massa)
• planning-with-files — Skill de tarefas planejadas (para testes em loop)

Documentos de Referência Internos deste Skill

• references/pentest-loop.md — Framework de ciclo principal (gate de risco + especificações de registro + compressão de contexto)
• references/recon-pipeline.md — Pipeline de reconhecimento autorizado (cabeçalhos CF / nmap / Evidence)
• references/client-side-lab-playbook.md — DOM XSS / poluição de protótipo / agent-browser (lado cliente em laboratório)
• references/burpsuite-mcp-guide.md — Guia completo do BurpSuite MCP (63 ferramentas + 7 cenários de uso + modelos de prompt de IA)
• references/automation-loop-pattern.md — Padrão de teste de loop de automação (versão leve)
• references/awesome-pentest-digest.md — Consulta rápida de ferramentas de pentest essenciais
• references/pentest-ai-agents-matrix.md — Matriz de cobertura de 35 agentes
• payloads/ — Diretório de payloads personalizados (IA deve usar primeiro)
• templates/ — Modelos de arquivos essenciais para pentest (scope/rules/plan/findings/progress)

Base de Conhecimento de Caça a Vulnerabilidades src-hunter

O diretório src-hunter/ contém uma metodologia completa de caça a vulnerabilidades SRC/Bug Bounty:

• 19 playbooks de ataque (IDOR, RCE, XSS, SQLi, SSRF, OAuth, upload de arquivos, etc.)
• 305 payloads estruturados + 263 etapas de bypass de WAF/EDR
• 2887 relatórios revelados High/Critical do HackerOne
• 88.636 estatísticas de casos históricos do WooYun
• Impressões digitais de componentes nacionais e credenciais padrão
• Modelos de relatório CVSS 4.0

Modo de uso: A IA lê automaticamente o playbook correspondente durante a fase de caça e testa conforme seu fluxo.

Veja src-hunter/SKILL.md e src-hunter/references/.

---

Contexto de Roteamento

Entrada upstream: skills/SKILL.md (controle mestre), routing.md Condição de ativação: Necessidade de varredura/ataque ativo ao alvo (varredura de portas, detecção de vulnerabilidades, teste de injeção, etc.) Saída downstream:

• Se encontrar vulnerabilidade web que requer análise adicional → js-reverse/
• Se encontrar vulnerabilidade binária que requer engenharia reversa → ida-reverse/ ou radare2/
• Se precisar operar navegador para verificar vulnerabilidade → browser-automation/
• Ao finalizar, gerar relatório → docs-generator/

Módulo associado no mesmo nível: CTF-Sandbox-Orchestrator/ (problemas Web/Pwn em CTF podem usar estas ferramentas)

---

Auto-Verificação de Conclusão (DEVE passar ANTES de declarar conclusão)

• Eu executei cada passo do workflow (não apenas li)?
• Eu usei caminhos reais de ferramentas com base em tool-index?
• Eu produzi evidências reproduzíveis (comandos/scripts/capturas de tela/relatórios)?
• Eu completei e registrei os itens do Checklist exigidos pelas REGRAS?