Discover

Script Bash e Python personalizzati utilizzati per automatizzare varie attività di penetration testing, tra cui ricognizione, scansione, enumerazione e creazione di payload malevoli tramite Metasploit. Per l'uso con Ubuntu. Supporto limitato per Kali Linux.

• Lee Baird @discoverscripts
• Jay "L1ghtn1ng" Townsend @jay_townsend1

---

Configurazione e utilizzo

• Scarica nella tua directory home.

cd ~
git clone https://github.com/leebaird/discover
cd discover/
./discover.sh

• Al primo avvio, Discover chiede il tuo nome (massimo 10 lettere) e lo salva in ~/.discover/operator-name. Quel nome viene scritto su ogni riga del registro di controllo dell'engagement. Per modificarlo in seguito, modifica o elimina quel file e riavvia Discover.
• Seleziona l'opzione 18 Update del menu principale per aggiornare il sistema operativo e installare le dipendenze.
• Alcune opzioni richiedono credenziali di root per essere eseguite.

---

Helper shell opzionali (config/zshrc)

cd ~/discover/config/
./install.sh

Host	Cosa fa install.sh
Ubuntu / altro (incl. macOS)	Copia zshrc in ~/.bash_aliases e lo esegue con source
Kali (rilevato tramite /etc/os-release)	Aggiunge zshrc a ~/.zshrc

Installa inoltre tmux.conf in ~/.tmux.conf e vimrc in ~/.vimrc.

Comandi utili (dopo l'installazione / nuova shell):

Comando	Scopo
n	Riepilogo di rete (IP esterno/interno, DNS, MAC, iface; ss senza TIME-WAIT; ping 8.8.8.8)
s	cd ~/discover e breve git status (senza pull)
m / ms	Avvia DB MSF + console / arresta DB MSF
web / web2	Server HTTP sulla porta 80 (sudo) / 8000
now	Data/ora formattata (non sovrascrive date)
update	Aggiornamento Grok + catena completa di apt upgrade
bh, th, smb, sip	BloodHound, theHarvester, smbserver, ordinamento IP

L'identità di rete (IP, DNS, MAC) viene calcolata quando esegui n / web / upload — non all'avvio della shell — così le nuove shell restano veloci e i valori restano aggiornati dopo cambi di VPN/wifi.

Note

• Su Ubuntu e altri host non-Kali, una nuova esecuzione sovrascrive ~/.bash_aliases con la copia del repo.
• Su Kali, rieseguire install.sh aggiunge di nuovo il blocco e può duplicarlo; modifica ~/.zshrc o installa una sola volta.
• La zsh predefinita su macOS/Kali non carica ~/.bash_aliases a meno che tu non la esegua con source da ~/.zshrc.

---

Menu principale

RECON
1.  Domain
2.  Person

SCANNING
3.  Generate target list
4.  CIDR
5.  List
6.  IP, range, or URL
7.  Rerun Nmap scripts and MSF aux

WEB
8.  Insecure direct object reference
9.  Open multiple tabs in Firefox
10. Nikto
11. SSL

MISC
12. Generate a malicious payload
13. Start a Metasploit listener
14. CVE lookup
15. Parse XML
16. Dev
17. Notes
18. Update
19. Exit

---

RICOGNIZIONE

Dominio

RECON

1.  Passive
2.  Breaches
3.  Find registered domains
4.  Google dorks
5.  Web search

6.  Active
7.  Open report
8.  Previous menu

Nota: Passive e Active non possono essere eseguiti come root.

---

Flusso di lavoro dell'engagement

1. Passive — genera il report HTML in $HOME/data/<domain>/.
2. Apri il report (o completa Active) in modo che l'engagement sia su statusd.
3. Audit > Import — nomi, nomi/titoli/email, sottodomini o il pacchetto di un altro operatore nel report corrente.
4. Active — httpx / whatweb / gowitness; pagine Active e Subdomains; NVD CVSS opzionale.
5. Shodan (opzionale) — pagina Active Enrich (casella Shodan).
6. Alerts (opzionale) — pagina Active, a sinistra di Enrich. Check now monitora le versioni del Software.
7. Filtro Software su Active, poi Subdomains filtrati, poi scansioni host in modalità operatore.
8. Export — su Report > Audit (solo Discover-hosted): pacchetto Client, Defender o Operator.

---

Ricognizione passiva

Utilizza Amass, ARIN, DNSRecon, dnstwist, Metasploit, subfinder, Shodan CTL (hostname CT gratuiti; nessuna API key), theHarvester, Whois e molteplici siti web.

• Ottieni API key gratuite per massimizzare i risultati con theHarvester ($HOME/.theHarvester/api-keys.yaml).
• Passive genera un report HTML in $HOME/data/<domain>/.
• Find registered domains aggiorna pages/registered-domains.htm in un report esistente. Un dominio senza email di registrazione viene escluso dalla pagina.
• Menu HTML Reports: Passive, Active e Audit.
• Nomi: le società pubbliche statunitensi estraggono DEF 14A / Form 4 da SEC EDGAR.
• Riepilogo: sede centrale dal 10-K e poi dal footer del sito web (override tramite tools/company-manual.tsv); link ai profili social quando trovati.

---

Import

Su Reports > Audit, Import (solo Discover-hosted) ha come target l'engagement corrente.

Scelta	Cosa fa
Operator scans	Unisce il report decompresso di un altro operatore (host-scans, screenshot, dati Active, le sue righe di audit)
Names	Unisce tools/names-manual.tsv (Name, Title, Phone; commenti con #; titolo/telefono compilati hanno la precedenza)
Names, titles, and emails	Unisce un dump esterno di nomi in Names ed Emails
Subdomains	Sorgenti esistenti (Firefox / Pentest-Tools / TSV) o CSV subdomain,ip,category; Active opzionale sugli host pubblici nuovi

CLI (stessi backend):

bash recon/import-names.sh --report /home/user/data/example.com --json
bash recon/import-names-titles-emails.sh --report /home/user/data/example.com --source /path/to/dump --json
bash recon/import-subdomains.sh --report /home/user/data/example.com \
  --mode team-csv --import /home/user/team-hosts.csv --json
# existing: --mode existing --import firefox|/path/to/export
# optional CSV: --run-active

Un elenco CSV salta gli host già presenti in tools/subdomains. IP vuoto poi dig. Un host indirizzato a 1.1.1.1, o uno che si risolve in 1.1.1.1, viene escluso. Categoria: prima le regole Discover, altrimenti CSV. Non scrive mai recon/subdomain-categories.tsv.

---

Attivo

Opzione 6 del menu Domain. Eseguire dopo Passive (e facoltativamente Import subdomains).

Enter the location of a previous Discover scan:
/home/user/data/example.com

• Legge gli hostname pubblici da tools/subdomains (gli indirizzi RFC1918 memorizzati vengono saltati).
• dig A @1.1.1.1 prima di httpx. Una risposta privata, loopback, link-local o 0.0.0.0 viene esclusa da httpx e aggiunta a tools/private-subs (tools/dns-private.tsv). L'IP pubblico memorizzato non viene modificato. Il DNS della VPN non viene utilizzato.
• httpx (tools/httpx.jsonl); alive = 200–399, 401, 403 o 405.
• whatweb + gowitness sugli URL alive; unione con recon/active-tech.py.
• Rieseguire Active per sostituire tali artefatti e ricostruire Active / Subdomains.

Gli artefatti risiedono in tools/ (httpx.jsonl, whatweb.json, gowitness/, software-cves-cache.json).

Filtro software e scansioni host