devcop95/bugbounty-lab101
Un workspace completo per bug bounty per ricercatori HackerOne. Include l'applicazione dello scope, una pipeline automatizzata di recon/vuln (oltre 400 strumenti), template di report, watchlist CVE/CWE e un laboratorio VM locale per la pratica. Progettato per una caccia disciplinata ed etica.
██████╗ ███████╗██╗ ██╗ ██╗ ██████╗ ██╗██╗ ██╗
██╔══██╗██╔════╝██║ ██║███║██╔═████╗███║╚██╗██╔╝
██║ ██║█████╗ ██║ ██║╚██║██║██╔██║╚██║ ╚███╔╝
██║ ██║██╔══╝ ╚██╗ ██╔╝ ██║████╔╝██║ ██║ ██╔██╗
██████╔╝███████╗ ╚████╔╝ ██║╚██████╔╝ ██║██╔╝ ██╗
╚═════╝ ╚══════╝ ╚═══╝ ╚═╝ ╚═════╝ ╚═╝╚═╝ ╚═╝
Un workspace costruito attorno al workflow reale del bug bounty su HackerOne: scegli un programma, documenta lo scope, scansiona entro i limiti, concatena le vulnerabilità e redigi il report in un formato che i triager accettano rapidamente. L'arsenale generico di oltre 400 strumenti di pentesting e il laboratorio VM locale sono disponibili come supporto — non come punto di partenza.
┌─────────────────────────────────────────────────────────────────────┐
│ │
│ 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
Prima di inviare, leggi docs/hackerone-workflow.md (dedup su Hacktivity, qualità del report, passi successivi all'invio).
Questo laboratorio integra T3MP3ST come motore di sicurezza offensiva — un framework multi-agente che trasforma il tuo agente di coding AI in un cacciatore di zero-day.
# 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/
| Funzionalità | Descrizione |
|---|---|
| War Room UI | Interfaccia web per la pianificazione e l'esecuzione delle missioni |
| Recon Engine | nmap, DNS, fingerprinting HTTP — 90.1% pass@1 su XBEN |
| Exploit Loop | Kill chain a 8 operatori (Recon → Scanner → Exploiter → ...) |
| Payload DB | Oltre 200 payload (SQLi, XSS, SSTI, LFI, SSRF, CMDi, XXE) |
| MCP Server | node t3mp3st/dist/mcp-server.js per l'integrazione con l'agente |
| Evidence Vault | Findings persistenti, evidenze e tracciamento dei retest |
T3MP3ST funziona senza API key collegando il tuo agente AI locale (Claude Code, Codex, Hermes). Nell'interfaccia War Room, apri Settings e collega il tuo agente — poi descrivi i target in linguaggio naturale.
| Comando | Descrizione | Esempio |
|---|---|---|
bugbounty-hunter.sh new <prog> | Crea un tracker di scope per un programma | ./bugbounty-hunter.sh new acme-corp |
bugbounty-hunter.sh scope <target> | Verifica che il target sia nello scope | ./bugbounty-hunter.sh scope target.com |
bugbounty-hunter.sh full <target> | Pipeline completa (da recon a report) | ./bugbounty-hunter.sh full target.com |
bugbounty-hunter.sh recon <target> | Solo recon, incluso l'arricchimento passivo Shodan CTL | ./bugbounty-hunter.sh recon target.com |
bugbounty-hunter.sh report <target> | Genera il report con il template H1 | ./bugbounty-hunter.sh report target.com |
pentest.sh <url> | Arsenale generico (oltre 400 strumenti) | pentest.sh https://target.com |
pentest.sh matrix | Matrice completa degli strumenti | pentest.sh matrix |
pentest.sh search <function> | Cerca uno strumento | pentest.sh search sql_injection |
pentest.sh express <url> | Scansione express | pentest.sh express https://target.com |
pentest.sh install | Installa gli strumenti mancanti | pentest.sh install |
./start-server.sh | Avvia la War Room T3MP3ST (basata su AI) | ./start-server.sh |
npm run server | Avvia T3MP3ST dalla directory t3mp3st/ | cd t3mp3st && npm run server |
Tutti i comandi di scansione attiva in bugbounty-hunter.sh verificano lo scope rispetto a programs/*.md prima di toccare il target. L'integrazione passiva Shodan CTL è opzionale e utilizza il submodule bloccato vendor/shodan_reconsx quando recons101x non è installato. I suoi hostname vengono filtrati per scope prima di qualsiasi probing HTTP.