devcop95/bugbounty-lab101
Um workspace completo de bug bounty para pesquisadores do HackerOne. Inclui aplicação de escopo, pipeline automatizado de recon/vuln (mais de 400 ferramentas), modelos de relatório, listas de observação de CVE/CWE e um laboratório de prática em VM local. Construído para caça disciplinada e ética.
██████╗ ███████╗██╗ ██╗ ██╗ ██████╗ ██╗██╗ ██╗
██╔══██╗██╔════╝██║ ██║███║██╔═████╗███║╚██╗██╔╝
██║ ██║█████╗ ██║ ██║╚██║██║██╔██║╚██║ ╚███╔╝
██║ ██║██╔══╝ ╚██╗ ██╔╝ ██║████╔╝██║ ██║ ██╔██╗
██████╔╝███████╗ ╚████╔╝ ██║╚██████╔╝ ██║██╔╝ ██╗
╚═════╝ ╚══════╝ ╚═══╝ ╚═╝ ╚═════╝ ╚═╝╚═╝ ╚═╝
Um espaço de trabalho construído em torno do fluxo de trabalho real de bug bounty no HackerOne: escolher um programa, documentar o escopo, escanear dentro dos limites, encadear descobertas e reportar num formato que os triagers aceitam rapidamente. O arsenal genérico de pentesting com mais de 400 ferramentas e o laboratório de VMs local estão disponíveis como suporte — não como ponto de entrada.
┌─────────────────────────────────────────────────────────────────────┐
│ │
│ SCOPE RECON/VULN REPORT │
│ ═════ ══════════ ══════ │
│ │
│ ┌───────────┐ ┌───────────────────┐ ┌───────────────┐ │
│ │programs/ │────▶ bugbounty-hunter ───▶ report.md │ │
│ │*.md │ │ .sh │ │ (H1 template) │ │
│ └───────────┘ └────────┬──────────┘ └───────┬───────┘ │
│ scope check │ │ │
│ (blocks if not ▼ ▼ │
│ documented) ┌─────────────┐ ┌──────────────┐ │
│ │auto-scanner │ │ Hacktivity │ │
│ │ (arsenal) │ │ dedup check │ │
│ └─────────────┘ └──────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────┘
cd bugbounty-lab101
chmod +x bugbounty/*.sh auto-scanner/*.sh
# If the repository was cloned without submodules:
git submodule update --init --recursive
cd bugbounty
./bugbounty-hunter.sh new program-name
# Edit ../programs/program-name.md with the EXACT scope from the H1 policy
./bugbounty-hunter.sh scope target.com # must say "Scope OK" before proceeding
./bugbounty-hunter.sh full target.com # recon -> vuln -> brute -> secrets -> api -> report
./bugbounty-hunter.sh report target.com
# Complete bugbounty/reports/target.com/report-YYYYMMDD.md with the H1 template
Antes de submeter, leia docs/hackerone-workflow.md (deduplicação no Hacktivity, qualidade do relatório, passos pós-submissão).
Este laboratório integra o T3MP3ST como o seu motor de segurança ofensiva — um framework multiagente que transforma o seu agente de IA de programação num caçador de zero-days.
# 1. Clone T3MP3ST into the lab (it's .gitignored, separate repo)
git clone https://github.com/DevCop95/T3MP3ST t3mp3st
cd t3mp3st && npm install && cd ..
# 2. Configure API keys
cp t3mp3st/.env.example t3mp3st/.env
# Edit t3mp3st/.env with your LLM provider key(s)
# 3. Start the server
./start-server.sh
# War Room → http://127.0.0.1:3333/ui/
| Funcionalidade | Descrição |
|---|---|
| War Room UI | Interface web para planeamento e execução de missões |
| Recon Engine | nmap, DNS, HTTP fingerprinting — 90.1% pass@1 no XBEN |
| Exploit Loop | Cadeia de ataque com 8 operadores (Recon → Scanner → Exploiter → ...) |
| Payload DB | Mais de 200 payloads (SQLi, XSS, SSTI, LFI, SSRF, CMDi, XXE) |
| MCP Server | node t3mp3st/dist/mcp-server.js para integração com agentes |
| Evidence Vault | Descobertas persistentes, evidências e acompanhamento de retestes |
O T3MP3ST funciona sem chaves de API ao ligar o seu agente de IA local (Claude Code, Codex, Hermes). Na interface do War Room, abra Settings e ligue o seu agente — depois descreva os alvos em linguagem natural.
| Comando | Descrição | Exemplo |
|---|---|---|
bugbounty-hunter.sh new <prog> | Criar rastreador de escopo para um programa | ./bugbounty-hunter.sh new acme-corp |
bugbounty-hunter.sh scope <target> | Verificar se o alvo está no escopo | ./bugbounty-hunter.sh scope target.com |
bugbounty-hunter.sh full <target> | Pipeline completo (recon até relatório) | ./bugbounty-hunter.sh full target.com |
bugbounty-hunter.sh recon <target> | Apenas recon, incluindo enriquecimento passivo via Shodan CTL | ./bugbounty-hunter.sh recon target.com |
bugbounty-hunter.sh report <target> | Gerar relatório com o template H1 | ./bugbounty-hunter.sh report target.com |
pentest.sh <url> | Arsenal genérico (mais de 400 ferramentas) | pentest.sh https://target.com |
pentest.sh matrix | Matriz completa de ferramentas | pentest.sh matrix |
pentest.sh search <function> | Procurar uma ferramenta | pentest.sh search sql_injection |
pentest.sh express <url> | Scan expresso | pentest.sh express https://target.com |
pentest.sh install | Instalar ferramentas em falta | pentest.sh install |
./start-server.sh | Iniciar o T3MP3ST War Room (com IA) | ./start-server.sh |
npm run server | Iniciar o T3MP3ST a partir do diretório t3mp3st/ | cd t3mp3st && npm run server |
Todos os comandos de scan ativo em bugbounty-hunter.sh verificam o escopo contra programs/*.md antes de tocar no alvo. A integração passiva com o Shodan CTL é opcional e usa o submódulo fixado vendor/shodan_reconsx quando o recons101x não está instalado. Os seus hostnames são filtrados por escopo antes de qualquer sondagem HTTP.