reconFTW è uno strumento progettato per eseguire ricognizione automatizzata su un dominio target lanciando il miglior set di strumenti per effettuare scansioni e scoprire vulnerabilità.
<h1 align="center">
<br>
<a href="https://github.com/six2dez/reconftw"><img src="https://raw.githubusercontent.com/six2dez/reconftw/main/images/banner.png" alt="reconftw"></a>
<br>
reconFTW
<br>
</h1>
<p align="center">
<a href="https://github.com/six2dez/reconftw/releases/tag/v4.1"><img src="https://img.shields.io/badge/release-v4.1-2ea043?style=for-the-badge" alt="Release"></a>
<a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge" alt="License"></a>
<a href="https://github.com/six2dez/reconftw/issues?q=is%3Aissue+is%3Aclosed"><img src="https://img.shields.io/github/issues-closed-raw/six2dez/reconftw.svg?style=for-the-badge" alt="Closed Issues"></a>
<a href="https://discord.gg/R5DdXVEdTy"><img src="https://img.shields.io/discord/1048623782912340038.svg?style=for-the-badge&logo=discord&label=discord" alt="Discord"></a>
<a href="https://t.me/joinchat/H5bAaw3YbzzmI5co"><img src="https://img.shields.io/badge/telegram-@ReconFTW-26A5E4?style=for-the-badge&logo=telegram&logoColor=white" alt="Telegram"></a>
<a href="https://twitter.com/Six2dez1"><img src="https://img.shields.io/badge/twitter-@Six2dez1-1D9BF0?style=for-the-badge&logo=x&logoColor=white" alt="Twitter"></a>
</p>
<p align="center">
<a href="https://docs.reconftw.com"><img src="https://img.shields.io/badge/GitBook-%23000000.svg?style=for-the-badge&logo=gitbook&logoColor=white" alt="Docs"></a>
<a href="https://github.com/six2dez/reconftw"><img src="https://img.shields.io/badge/Bash%20Script-%23121011.svg?style=for-the-badge&logo=gnu-bash&logoColor=white" alt="Bash Script"></a>
<a href="https://github.com/six2dez/reconftw"><img src="https://img.shields.io/badge/Linux-FCC624?style=for-the-badge&logo=linux&logoColor=black" alt="Linux"></a>
<a href="https://github.com/six2dez/reconftw"><img src="https://img.shields.io/badge/macOS-000000?style=for-the-badge&logo=macos&logoColor=F0F0F0" alt="macOS"></a>
<a href="https://github.com/six2dez/reconftw"><img src="https://img.shields.io/badge/github-%23121011.svg?style=for-the-badge&logo=github&logoColor=white" alt="GitHub"></a>
</p>
<p align="center">
<a href="https://github.com/six2dez/reconftw/actions"><img src="https://img.shields.io/badge/github_actions-%232671E5.svg?style=for-the-badge&logo=githubactions&logoColor=white" alt="GitHub Actions"></a>
<a href="https://hub.docker.com/r/six2dez/reconftw"><img src="https://img.shields.io/badge/docker-%230db7ed.svg?style=for-the-badge&logo=docker&logoColor=white" alt="Docker"></a>
<a href="https://github.com/six2dez/reconftw/tree/main/Terraform"><img src="https://img.shields.io/badge/terraform-%23844FBA.svg?style=for-the-badge&logo=terraform&logoColor=white" alt="Terraform"></a>
<a href="https://github.com/six2dez/reconftw/tree/main/Terraform"><img src="https://img.shields.io/badge/ansible-%231A1918.svg?style=for-the-badge&logo=ansible&logoColor=white" alt="Ansible"></a>
<a href="https://github.com/six2dez/reconftw"><img src="https://img.shields.io/badge/Go-00ADD8.svg?style=for-the-badge&logo=go&logoColor=white" alt="Go"></a>
<a href="https://github.com/six2dez/reconftw"><img src="https://img.shields.io/badge/Python-3776AB.svg?style=for-the-badge&logo=python&logoColor=white" alt="Python"></a>
</p>
<p align="center">
<a href="https://www.buymeacoffee.com/six2dez"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-ffdd00?style=for-the-badge&logo=buy-me-a-coffee&logoColor=black" alt="Buy Me a Coffee"></a>
<a href="https://github.com/sponsors/six2dez"><img src="https://img.shields.io/badge/sponsor-30363D?style=for-the-badge&logo=GitHub-Sponsors&logoColor=EA4AAA" alt="GitHub Sponsors"></a>
<a href="https://www.paypal.com/paypalme/six2dez"><img src="https://img.shields.io/badge/PayPal-00457C?style=for-the-badge&logo=paypal&logoColor=white" alt="PayPal"></a>
</p>
**reconFTW** è un potente strumento di ricognizione automatizzata progettato per ricercatori di sicurezza e penetration tester. Semplifica il processo di raccolta di informazioni su un target eseguendo enumerazione dei sottodomini, scansione delle vulnerabilità, OSINT e altro ancora. Grazie a un design modulare, a opzioni di configurazione estese e al supporto per la scansione distribuita tramite AX Framework, reconFTW è costruito per fornire risultati completi in modo efficiente.
reconFTW sfrutta un'ampia gamma di tecniche, tra cui la scoperta passiva e attiva di sottodomini, controlli delle vulnerabilità web (es. XSS, SSRF, SQLi), OSINT, fuzzing delle directory, scansione delle porte e acquisizione di screenshot. Si integra con strumenti e API all'avanguardia per massimizzare copertura e accuratezza, assicurandoti di restare al passo nei tuoi sforzi di ricognizione.
**Caratteristiche principali:**
- Enumerazione completa dei sottodomini (passiva, bruteforce, permutazioni, trasparenza dei certificati, ecc.)
- Scansione delle vulnerabilità per XSS, SSRF, SQLi, LFI, SSTI e altro
- OSINT per email, metadati, fughe di API e misconfigurazioni di terze parti
- Scansione distribuita con AX Framework per un'esecuzione più rapida
- Workflow personalizzabili con un file di configurazione dettagliato
- Integrazione con Faraday per report e visualizzazione
- Supporto per deployment con Docker, Terraform e Ansible
**Disclaimer:** L'utilizzo di reconFTW per attaccare target senza previo consenso è illegale. È responsabilità dell'utente rispettare tutte le leggi applicabili. Gli sviluppatori non si assumono alcuna responsabilità per usi impropri o danni causati da questo strumento. Usalo in modo responsabile.
---
## 📔 Indice dei contenuti
- [📔 Indice dei contenuti](#-table-of-contents)
- [✨ Caratteristiche](#-features)
- [OSINT](#osint)
- [Sottodomini](#subdomains)
- [Host](#hosts)
- [Analisi Web](#web-analysis)
- [Controlli delle Vulnerabilità](#vulnerability-checks)
- [Extra](#extras)
- [🏗️ Architettura](#️-architecture)
- [💿 Installazione](#-installation)
- [Installazione Locale (PC/VPS/VM)](#local-installation-pcvpsvm)
- [Docker](#docker)
- [Terraform + Ansible](#terraform--ansible)
- [Prova la beta v2 (riscrittura in Go)](#trying-the-v2-beta-go-rewrite)
- [⚙️ Configurazione](#️-configuration)
- [🚀 Utilizzo](#-usage)
- [Opzioni del Target](#target-options)
- [Opzioni della Modalità](#mode-options)
- [Opzioni Generali](#general-options)
- [Esempi di Utilizzo](#example-usage)
- [☁️ Supporto AX Framework (precedentemente Axiom)](#️-ax-framework-support-previously-axiom)
- [💻 Supporto Faraday](#-faraday-support)
- [🧠 Integrazione AI](#-ai-integration)
- [🗂️ Gestione dei Dati](#️-data-management)
- [Makefile](#makefile)
- [Manuale](#manual)
- [🧪 Test](#-testing)
- [Mindmap/Workflow](#mindmapworkflow)
- [Video di esempio](#sample-video)
- [🤝 Come Contribuire](#-how-to-contribute)
- [🔒 Sicurezza](#-security)
- [❓ Hai Bisogno di Aiuto?](#-need-help)
- [💖 Supporta Questo Progetto](#-support-this-project)
- [🙏 Ringraziamenti](#-thanks)
- [📝 Changelog](#-changelog)
- [🛠️ Sviluppo](#️-development)
- [📜 Licenza](#-license)
- [⭐ Cronologia Stelle](#-star-history)
---
## ✨ Caratteristiche
reconFTW è ricco di funzionalità per rendere la ricognizione approfondita ed efficiente. Di seguito una ripartizione dettagliata delle sue capacità, aggiornata per riflettere le ultime funzionalità nello script e nella configurazione.
### OSINT
- **Informazioni sul Dominio**: Ricerca WHOIS per i dettagli di registrazione del dominio ([whois](https://github.com/rfc1036/whois)).
- **Fughe di Email e Password**: Cerca email e credenziali trapelate ([emailfinder](https://github.com/Josue87/EmailFinder) e [LeakSearch](https://github.com/JoelGMSec/LeakSearch)).
- **Mapping Microsoft 365/Azure**: Identifica i tenant Microsoft 365 e Azure ([msftrecon](https://github.com/Arcanum-Sec/msftrecon)).
- **Estrazione Metadati**: Estrae metadati da documenti Office indicizzati ([metagoofil](https://github.com/opsdisk/metagoofil)).
- **Fughe API**: Rileva API esposte in fonti pubbliche ([porch-pirate](https://github.com/MandConsultingGroup/porch-pirate), [SwaggerSpy](https://github.com/UndeadSec/SwaggerSpy) e [postleaksNg](https://github.com/six2dez/postleaksNG)).
- **Google Dorking**: Query Google dork automatizzate per informazioni sensibili ([dorks_hunter](https://github.com/six2dez/dorks_hunter) e [xnldorker](https://github.com/xnl-h4ck3r/xnldorker)).
- **Analisi GitHub**: Scansiona le organizzazioni GitHub per repository e segreti con motori selezionabili ([enumerepo](https://github.com/trickest/enumerepo), [trufflehog](https://github.com/trufflesecurity/trufflehog), [gitleaks](https://github.com/gitleaks/gitleaks), [titus](https://github.com/praetorian-inc/titus), [noseyparker](https://github.com/praetorian-inc/noseyparker)).
- **Audit GitHub Actions (Opzionale)**: Audita gli artefatti dei workflow e l'esposizione CI/CD con [gato](https://github.com/praetorian-inc/gato).
- **Misconfigurazioni di Terze Parti**: Identifica servizi di terze parti configurati in modo errato ([misconfig-mapper](https://github.com/intigriti/misconfig-mapper)).
- **Igiene della Posta**: Esamina la configurazione SPF/DMARC per segnalare problemi di spoofing o di consegna.
- **Enumerazione Storage Cloud**: Sonda i bucket dei principali provider per esposizioni ([cloud_enum](https://github.com/initstring/cloud_enum)).
- **Domini Spoofabili**: Controlla i domini vulnerabili allo spoofing ([spoofcheck](https://github.com/MattKeeley/Spoofy)).
### Sottodomini
- **Enumerazione Passiva**: Utilizza API e fonti pubbliche per la scoperta di sottodomini ([subfinder](https://github.com/projectdiscovery/subfinder) e [github-subdomains](https://github.com/gwen001/github-subdomains)).
- **Trasparenza dei Certificati**: Interroga i log di trasparenza dei certificati ([crt](https://github.com/cemulus/crt)).
- **Scoperta NOERROR**: Identifica sottodomini con risposte DNS NOERROR ([dnsx](https://github.com/projectdiscovery/dnsx), maggiori informazioni [qui](https://www.securesystems.de/blog/enhancing-subdomain-enumeration-ents-and-noerror/)).
- **Bruteforce**: Esegue il bruteforce DNS con wordlist personalizzabili ([puredns](https://github.com/d3mondev/puredns) e wordlist personalizzate).
- **Permutazioni**: Genera permutazioni di sottodomini utilizzando AI, regex e strumenti ([Gotator](https://github.com/Josue87/gotator) come unico motore di permutazione, più [regulator](https://github.com/cramppet/regulator) e [subwiz](https://github.com/hadriansecurity/subwiz)).
- **Web Scraping**: Estrae sottodomini da fonti URL passive e metadati web live ([urlfinder](https://github.com/projectdiscovery/urlfinder), [waymore](https://github.com/xnl-h4ck3r/waymore), [httpx](https://github.com/projectdiscovery/httpx), [csprecon](https://github.com/edoardottt/csprecon)).
- **Record DNS**: Risolve i record DNS per i sottodomini ([dnsx](https://github.com/projectdiscovery/dnsx)).
- **Google Analytics**: Identifica sottodomini tramite ID Analytics ([AnalyticsRelationships](https://github.com/Josue87/AnalyticsRelationships)).
- **Handshake TLS**: Scopre sottodomini tramite porte TLS ([tlsx](https://github.com/projectdiscovery/tlsx)).
- **Ricerca Ricorsiva**: Esegue enumerazione passiva o bruteforce ricorsiva combinata ([dsieve](https://github.com/trickest/dsieve)).
- **Subdomain Takeover**: Rileva sottodomini vulnerabili ([nuclei](https://github.com/projectdiscovery/nuclei) e [dnstake](https://github.com/pwnesia/dnstake)).
- **Trasferimento di Zona DNS**: Controlla trasferimenti di zona DNS configurati in modo errato ([dig](https://linux.die.net/man/1/dig)).
- **Bucket Cloud**: Identifica bucket cloud configurati in modo errato e asset di storage esposti ([S3Scanner](https://github.com/sa7mon/S3Scanner) e [cloud_enum](https://github.com/initstring/cloud_enum)).
- **Nota sulla Copertura Cloud**: I controlli dei bucket cloud non includono più la copertura Alibaba OSS dopo la sostituzione di CloudHunter con cloud_enum.
- **Migrazione Output Cloud**: Gli artefatti legacy dei bucket `cloudhunter_*` sono stati rimossi; usa invece `subdomains/cloud_enum_buckets_trufflehog.txt`.
- **Reverse IP Lookup**: Scopre sottodomini tramite intervalli IP ([hakip2host](https://github.com/hakluke/hakip2host)).
### Host
- **Informazioni IP**: Recupera geolocalizzazione e dati WHOIS ([ipinfo](https://www.ipinfo.io/)).
- **Rilevamento CDN**: Identifica IP dietro CDN ([cdncheck](https://github.com/projectdiscovery/cdncheck)).
- **Rilevamento WAF**: Rileva Web Application Firewall ([wafw00f](https://github.com/EnableSecurity/wafw00f)).
- **Scansione delle Porte**: Scansione attiva con [nmap](https://github.com/nmap/nmap) (opzionalmente preceduta da [naabu](https://github.com/projectdiscovery/naabu)) e scansione passiva con [smap](https://github.com/s0md3v/Smap).
- **Fingerprinting dei Servizi**: Identifica i servizi esposti sulle coppie host:porta scoperte con [nerva](https://github.com/praetorian-inc/nerva).
- **Vulnerabilità dei Servizi (Opzionale)**: Il profilo di scansione porte approfondito può arricchire i risultati con il matching CVE tramite [vulners](https://github.com/vulnersCom/nmap-vulners).
- **Password Spraying**: Tenta il password spraying sui servizi identificati con selezione del motore ([brutespray](https://github.com/x90skysn3k/brutespray) o [brutus](https://github.com/praetorian-inc/brutus)).
- **Geolocalizzazione**: Mappa gli indirizzi IP alle posizioni geografiche ([ipinfo](https://www.ipinfo.io/)).
- **Scoperta IPv6**: Opzionalmente enumera e scansiona i target IPv6 scoperti quando `IPV6_SCAN` è abilitato.
### Analisi Web
- **Sondaggio Web**: Rileva server web live su porte standard e non standard (([httpx](https://github.com/projectdiscovery/httpx))).
- **Screenshot**: Acquisisce screenshot delle pagine web ([nuclei](https://github.com/projectdiscovery/nuclei)).
- **Fuzzing Virtual Host**: Identifica virtual host fuzzando gli header HTTP ([VhostFinder](https://github.com/wdahlenburg/VhostFinder)).
- **Rilevamento CMS**: Identifica i sistemi di gestione dei contenuti ([CMSeeK](https://github.com/Tuhinshubhra/CMSeeK)).
- **Estrazione URL**: Raccoglie URL passivamente e attivamente ([urlfinder](https://github.com/projectdiscovery/urlfinder), [waymore](https://github.com/xnl-h4ck3r/waymore), [katana](https://github.com/projectdiscovery/katana), [github-endpoints](https://gist.github.com/six2dez/d1d516b606557526e9a78d7dd49cacd3) e [JSA](https://github.com/w9w/JSA)).
- **Analisi dei Pattern URL**: Classifica gli URL utilizzando pattern ([urless](https://github.com/xnl-h4ck3r/urless), [gf](https://github.com/tomnomnom/gf) e [gf-patterns](https://github.com/1ndianl33t/Gf-Patterns)).
- **Ricognizione Tech Favicon**: Identifica le tecnologie dagli hash delle favicon ([favirecon](https://github.com/edoardottt/favirecon)).
- **Analisi JavaScript**: Estrae segreti ed endpoint dai file JS ([subjs](https://github.com/lc/subjs), [JSA](https://github.com/w9w/JSA), [xnLinkFinder](https://github.com/xnl-h4ck3r/xnLinkFinder), [getjswords](https://github.com/m4ll0k/BBTz), [mantra](https://github.com/MrEmpy/mantra), [jsluice](https://github.com/BishopFox/jsluice)).
- **Estrazione Source Map**: Recupera dati sensibili dalle source map JavaScript ([sourcemapper](https://github.com/denandz/sourcemapper)).
- **Rilevamento GraphQL**: Scopre endpoint GraphQL con nuclei e opzionalmente esegue introspezione approfondita ([GQLSpection](https://github.com/doyensec/GQLSpection)).
- **Scoperta Parametri**: Esegue il bruteforce dei parametri nascosti sugli endpoint ([arjun](https://github.com/s0md3v/Arjun)).
- **Audit WebSocket**: Valida gli handshake di upgrade e la gestione dell'origine sugli endpoint `ws://` e `wss://`.
- **Riflessione gRPC**: Sonda le porte gRPC comuni per la riflessione dei servizi esposti ([grpcurl](https://github.com/fullstorydev/grpcurl)).
- **Fingerprinting Servizi LLM (Opzionale)**: Sonda gli endpoint web/API scoperti per servizi LLM esposti con [julius](https://github.com/praetorian-inc/julius).
- **Fuzzing**: Esegue fuzzing di directory e parametri ([ffuf](https://github.com/ffuf/ffuf)).
- **Ordinamento Estensioni File**: Organizza gli URL per estensioni di file.
- **Generazione Wordlist**: Crea wordlist personalizzate per il fuzzing.
- **Dizionario Password**: Genera dizionari di password dal contenuto live ([cewler](https://github.com/roys/cewler)).
- **Scansione IIS Shortname**: Rileva vulnerabilità IIS shortname ([shortscan](https://github.com/bitquark/shortscan)).
### Controlli delle Vulnerabilità
- **CVE**: Controlla CVE e vulnerabilità comuni [nuclei](https://github.com/projectdiscovery/nuclei)
- **Nuclei DAST**: Esegue i template `nuclei -dast` sugli URL raccolti e sui candidati GF per una copertura DAST aggiuntiva.
- **XSS**: Testa le vulnerabilità di cross-site scripting ([dalfox](https://github.com/hahwul/dalfox)).
- **SSL/TLS**: Controlla le misconfigurazioni SSL/TLS ([testssl](https://github.com/drwetter/testssl.sh)).
- **SSRF**: Testa la server-side request forgery ([interactsh](https://github.com/projectdiscovery/interactsh), valori dei parametri con [ffuf](https://github.com/ffuf/ffuf), e payload di protocollo alternativi opzionali).
- **CRLF**: Controlla le vulnerabilità di iniezione CRLF ([crlfuzz](https://github.com/dwisiswant0/crlfuzz)).
- **LFI**: Testa la local file inclusion tramite fuzzing ([ffuf](https://github.com/ffuf/ffuf)).
- **SSTI**: Rileva la server-side template injection ([TInjA](https://github.com/Hackmanit/TInjA)).
- **SQLi**: Testa l'iniezione SQL ([SQLMap](https://github.com/sqlmapproject/sqlmap) e [ghauri](https://github.com/r0oth3x49/ghauri)).
- **Link Rotti**: Identifica link rotti e riferimenti esterni probabilmente soggetti a takeover ([second-order](https://github.com/mhmdiaa/second-order)).
- **Iniezione di Comandi**: Testa le vulnerabilità di iniezione di comandi ([commix](https://github.com/commixproject/commix)).
- **HTTP Request Smuggling**: Controlla le vulnerabilità di request smuggling ([smugglex](https://github.com/hahwul/smugglex)).
- **Cache Web**: Identifica le vulnerabilità della cache web ([Web-Cache-Vulnerability-Scanner](https://github.com/Hackmanit/Web-Cache-Vulnerability-Scanner) e [toxicache](https://github.com/xhzeem/toxicache)).
- **Bypass 4XX**: Tenta di bypassare le risposte 4XX ([nomore403](https://github.com/devploit/nomore403)).
- **Fuzzing dei Parametri**: Fuzza i parametri URL per vulnerabilità ([nuclei](https://github.com/projectdiscovery/nuclei)).
### Extra- **Multithreading**: Ottimizza le prestazioni ([Interlace](https://github.com/codingo/Interlace)).
- **Resolver personalizzati**: Genera resolver DNS ([dnsvalidator](https://github.com/vortexau/dnsvalidator)).
- **Supporto Docker**: Immagine Docker ufficiale su [DockerHub](https://hub.docker.com/r/six2dez/reconftw).
- **Distribuzione AWS**: Si distribuisce tramite Terraform e Ansible.
- **Supporto IP/CIDR**: Scansiona intervalli IP e blocchi CIDR.
- **Ripresa delle scansioni**: Riprende le scansioni dall'ultimo passaggio completato.
- **Output personalizzato**: Salva i risultati in una directory definita dall'utente.
- **Modalità Diff**: Evidenzia nuovi risultati nelle scansioni successive.
- **Filtro dell'ambito**: Supporta elenchi in-scope e out-of-scope ([inscope](https://github.com/tomnomnom/hacks/tree/master/inscope)).
- **Notifiche**: Invia avvisi tramite Slack, Discord o Telegram ([notify](https://github.com/projectdiscovery/notify)).
- **Compressione dei risultati**: Comprime e invia i risultati.
- **Integrazione Faraday**: Esporta i risultati in [Faraday](https://github.com/infobyte/faraday) per il reporting.
- **Generazione di report AI**: Genera report utilizzando modelli AI locali ([reconftw_ai](https://github.com/six2dez/reconftw_ai)).
- **Modalità di riscansione rapida**: Salta automaticamente le fasi pesanti quando non vengono scoperti nuovi asset (`--quick-rescan` / `QUICK_RESCAN`).
- **Generatore di hotlist**: Valuta ed evidenzia gli asset più rischiosi (`hotlist.txt`) in base ai nuovi risultati.
- **Tracciamento dei comandi**: Attiva `SHOW_COMMANDS` per registrare ogni comando eseguito nei log di destinazione per il debug.
- **Archivio asset**: Aggiunge i risultati a `assets.jsonl` per l'automazione a valle quando `ASSET_STORE` è abilitato.
- **Report consolidato**: Genera automaticamente `report/report.json` e `report/index.html` al termine della scansione.
- **Supporto ARM**: Compatibile con Raspberry Pi e architetture ARM (incluso MacOS MX).
- **Controllo di integrità**: Controllo di integrità del sistema integrato tramite `--health-check` (usato anche da Docker `HEALTHCHECK`).
- **Modalità incrementale**: Scansiona solo i nuovi risultati dall'ultima esecuzione (`--incremental`).
- **Limitazione della velocità adattiva**: Riduce automaticamente la velocità su errori 429/503 (`--adaptive-rate`).
- **Registrazione strutturata**: Output di log JSON opzionale per analisi avanzate (`STRUCTURED_LOGGING`).
- **Sanificazione dell'input**: Tutto l'input utente viene sanificato per prevenire l'iniezione di comandi.
- **Modalità di prova**: Anteprima di ciò che verrebbe eseguito senza eseguire comandi (`--dry-run`).
- **Modalità parallela**: Esegue funzioni indipendenti in parallelo per scansioni più veloci (`--parallel`, disattivabile con `--no-parallel`).
- **Architettura modulare**: Il codice è suddiviso in 8 moduli mirati per la manutenibilità.
- **Gestione dei segreti**: Variabili d'ambiente, `secrets.cfg` e segreti di runtime Docker (vedi [SECURITY.md](https://github.com/six2dez/reconftw/blob/main/SECURITY.md)).
- **Interruttore automatico**: Salta automaticamente gli strumenti dopo ripetuti errori per evitare blocchi della scansione.
- **Sistema di checkpoint**: Riprende le scansioni interrotte dall'ultima fase riuscita.
- **Supporto nativo macOS**: Piena compatibilità con macOS (coreutils BSD, Homebrew Bash 4+).
---
## 🏗️ Architettura
reconFTW utilizza un'architettura modulare. Il punto di ingresso principale (`reconftw.sh`) gestisce l'analisi degli argomenti e carica 8 moduli specializzati dalla directory `modules/`.
### Struttura delle directory```
reconftw/
├── reconftw.sh # Entry point — arg parsing, module loading, dispatch
├── reconftw.cfg # Default configuration
├── install.sh # Installer
├── Makefile # Data management, lint, fmt, test targets
├── modules/
│ ├── core.sh # Lifecycle, logging, notifications, cleanup (1024 lines)
│ ├── modes.sh # Scan modes, argument parsing, help (902 lines)
│ ├── subdomains.sh # Subdomain enumeration (1938 lines)
│ ├── web.sh # Web analysis, fuzzing, JS checks (1712 lines)
│ ├── vulns.sh # Vulnerability scanning (926 lines)
│ ├── osint.sh # OSINT functions (500 lines)
│ ├── axiom.sh # Ax/Axiom fleet helpers (143 lines)
│ └── utils.sh # Utilities, sanitization, validation (508 lines)
├── tests/
│ ├── run_tests.sh # Test runner
│ ├── unit/ # bats-core unit tests
│ ├── integration/ # Integration tests
│ └── fixtures/ # Test data
├── Docker/
│ └── Dockerfile # Official Docker image
└── Terraform/ # AWS deployment
```
### Riferimento ai Moduli
| Modulo | Righe | Scopo |
|--------|------:|---------|
| `core.sh` | 1024 | Gestione del ciclo di vita, logging, notifiche, trap di pulizia |
| `modes.sh` | 902 | Definizioni delle modalità di scansione, parsing degli argomenti, output di aiuto |
| `subdomains.sh` | 1938 | Tutte le funzioni di enumerazione dei sottodomini |
| `web.sh` | 1712 | Analisi web, fuzzing, analisi JS, rilevamento CMS |
| `vulns.sh` | 926 | Scansione delle vulnerabilità (XSS, SQLi, SSRF, ecc.) |
| `osint.sh` | 500 | Funzioni OSINT (WHOIS, email, dorks, metadati) |
| `utils.sh` | 508 | Utility condivise, sanificazione degli input, validazione |
| `axiom.sh` | 143 | Gestione della flotta distribuita Ax/Axiom |
Il flag `--source-only` consente di includere `reconftw.sh` senza eseguire la logica principale, permettendo il test unitario delle singole funzioni.
---
## 💿 Installazione
reconFTW supporta molteplici metodi di installazione per adattarsi a diversi ambienti. Assicurati di avere spazio su disco sufficiente (almeno 10 GB consigliati) e una connessione internet stabile.
### Avvio rapido
1) Clona e installa```yaml
git clone https://github.com/six2dez/reconftw
cd reconftw
./install.sh --verbose
```
2) Esegui una scansione (completa + ripresa)```bash
./reconftw.sh -d example.com -r
```
3) Esecuzione minima (footprint solo passivo)```bash
./reconftw.sh -d example.com -p
```
> Suggerimento: esegui di nuovo `./install.sh --tools` in seguito per aggiornare la toolchain senza reinstallare i pacchetti di sistema.
### Installazione Locale (PC/VPS/VM)
1. **Prerequisiti**:
- **Golang**: versione più recente (`install_golang` abilitato per impostazione predefinita in `reconftw.cfg`).
- **Permessi di sistema**: se non esegui come root, configura sudo per evitare richieste di password:
```bash
sudo echo "${USERNAME} ALL=(ALL:ALL) NOPASSWD: ALL" | sudo tee -a /etc/sudoers.d/reconFTW
```
2. **Passaggi**: ```bash
git clone https://github.com/six2dez/reconftw
cd reconftw
./install.sh
./reconftw.sh -d target.com -r
```
3. **Note**:
- Lo script `install.sh` installa le dipendenze, gli strumenti e configura i percorsi (`GOROOT`, `GOPATH`, `PATH`).
- Imposta `install_golang=false` in `reconftw.cfg` se Golang è già configurato.
- Per configurazioni esistenti, esegui `./install.sh --tools` per aggiornare i binari Go, i pacchetti pipx e i repository senza toccare i pacchetti di sistema.
- Consulta la [Guida all'installazione](https://github.com/six2dez/reconftw/wiki/0.-Installation-Guide) per istruzioni dettagliate.
### Docker
1. **Scarica l'immagine**: ```bash
docker pull six2dez/reconftw:main
```
2. **Esegui il Container**: ```bash
docker run -it --rm \
-v "${PWD}/OutputFolder/:/reconftw/Recon/" \
six2dez/reconftw:main -d example.com -r
```
Per un elenco di target, monta il file dell'elenco nel container e fai riferimento al percorso all'interno del container: ```bash
docker run -it --rm \
-v "${PWD}/domains.txt:/reconftw/domains.txt:ro" \
-v "${PWD}/OutputFolder/:/reconftw/Recon/" \
six2dez/reconftw:main -l /reconftw/domains.txt -r
```
3. **Visualizza i risultati**:
- I risultati vengono salvati nella directory `OutputFolder` sull'host (non all'interno del container).
4. **Personalizzazione**:
- Modifica l'immagine Docker o creane una tua; consulta la [Guida Docker](https://github.com/six2dez/reconftw/wiki/4.-Docker).
- Per saltare gli strumenti Ax nelle build personalizzate, usa `--build-arg INSTALL_AXIOM=false`.
- Monta la tua configurazione notify in `~/.config/notify/provider-config.yaml` all'interno del container se utilizzi le notifiche.
5. **Segreti in fase di esecuzione**:
Passa chiavi API e segreti tramite variabili d'ambiente — non incorporarli mai nell'immagine: ```bash
docker run -it --rm \
-e SHODAN_API_KEY="your-key" \
-e PDCP_API_KEY="your-projectdiscovery-key" \
-e COLLAB_SERVER="your-server" \
-e XSS_SERVER="your-server" \
-v "${PWD}/OutputFolder/:/reconftw/Recon/" \
six2dez/reconftw:main -d example.com -r
```
See [SECURITY.md](https://github.com/six2dez/reconftw/blob/main/SECURITY.md) per la guida completa sulla gestione dei segreti.
6. **Health Check**:
L'immagine Docker include un `HEALTHCHECK` integrato che esegue `./reconftw.sh --health-check` ogni 60 secondi. Puoi anche eseguirlo manualmente: ```bash
docker exec <container-id> ./reconftw.sh --health-check
```
### Terraform + Ansible
- Distribuisci reconFTW su AWS utilizzando Terraform e Ansible.
- Segui la guida in [Terraform/README.md](https://github.com/six2dez/reconftw/blob/main/Terraform/README.md) per le istruzioni di configurazione.
---
## Provare la beta v2 (riscrittura in Go)
reconFTW è in fase di riscrittura in Go. La riscrittura viene distribuita come **pre-release opzionale**: è
elencata nella [pagina delle release](https://github.com/six2dez/reconftw/releases), e GitHub
non punta mai `releases/latest` a una pre-release — quindi **se non fai nulla, continui a ricevere
la release bash.** Questa è una scelta deliberata.
Il binario Go è `reconftw`; il punto di ingresso bash è `reconftw.sh`. Non si sovrascrivono
a vicenda, quindi puoi tenerli entrambi e tornare indietro in qualsiasi momento.
La beta attuale è **`v5.0.0-beta.1`**. Non è servita da `releases/latest`, quindi devi
specificare esplicitamente il tag:```bash
curl -sSL "https://github.com/six2dez/reconftw/releases/download/v5.0.0-beta.1/reconftw_Linux_x86_64.tar.gz" | tar xz
sudo install -m 755 reconftw /usr/local/bin/reconftw
reconftw version
```
Scegli l’asset corrispondente alla tua piattaforma dalla
[pagina di rilascio](https://github.com/six2dez/reconftw/releases/tag/v5.0.0-beta.1) — sono pubblicati build `Darwin`
e `arm64`, una build musl statica e pacchetti `.deb`/`.rpm`.
- [**Cos’è la beta e cosa non è**](https://github.com/six2dez/reconftw/blob/main/docs/V2-BETA-ANNOUNCEMENT.md) — incluse tre
cose che non sono ancora esplicitamente finite.
- [**Segnala qualcosa**](https://github.com/six2dez/reconftw/issues/new?template=v2-beta-feedback.md)
— il modello di feedback per la beta v2. I bug nella release bash vanno ancora al normale modello Bug report.
## 🛠️ Risoluzione dei problemi
- Bash 4+ su macOS: Gli script si riavviano automaticamente con Homebrew Bash. Se vedi un messaggio su Bash < 4, esegui `brew install bash`, apri un nuovo terminale e ri-esegui `./install.sh`.
- timeout su macOS: macOS fornisce `gtimeout` tramite `brew install coreutils`. Gli script ora lo rilevano e lo usano automaticamente.
- Problemi di rete: Gli installer nascondono la maggior parte dell’output dei comandi. Se qualcosa fallisce, ri-esegui con `upgrade_tools=true` in `reconftw.cfg`, esegui `./install.sh --tools`, oppure installa manualmente lo strumento mancante (l’errore lo indicherà).
- Binari GOPATH: I binari vengono copiati in `/usr/local/bin`. Se preferisci non farlo, assicurati che `~/go/bin` sia nel tuo `PATH`.
- Modelli Nuclei: Se i modelli non sono stati clonati, rimuovi `~/nuclei-templates` e ri-esegui `./install.sh`.
## 🔑 Checklist API (Opzionale)
- `subfinder`: `~/.config/subfinder/provider-config.yaml`
- Token GitHub: `~/Tools/.github_tokens` (uno per riga)
- Token GitLab: `~/Tools/.gitlab_tokens` (uno per riga)
- WHOISXML: imposta `WHOISXML_API` in `reconftw.cfg` o come variabile d’ambiente
- Enumerazione ASN (`asnmap`): imposta `PDCP_API_KEY` in env/config (`ASN_ENUM` viene saltato se non impostato)
- Slack/Discord/Telegram: configura `notify` in `~/.config/notify/provider-config.yaml`
- Server SSRF: imposta `COLLAB_SERVER` in env/cfg se usato
- Server Blind XSS: imposta `XSS_SERVER` in env/cfg se usato
## 💾 Requisiti
- Disco: 10–20 GB liberi consigliati (toolchain + dati)
- Rete: connessione stabile durante installazione e aggiornamenti
- Sistema operativo: Linux/macOS con Bash ≥ 4
- Extra: `shellcheck` e `shfmt` (opzionali) per `make lint`/`make fmt`
## ⚙️ Configurazione
Il file `reconftw.cfg` controlla l’intera esecuzione di reconFTW. Consente una personalizzazione granulare di:
- **Percorsi degli strumenti**: Imposta percorsi per strumenti, resolver e wordlist (`tools`, `resolvers`, `fuzz_wordlist`).
- **Chiavi API**: Configura chiavi per Shodan, WHOISXML, ecc. tramite variabili d’ambiente o `secrets.cfg` (vedi [SECURITY.md](https://github.com/six2dez/reconftw/blob/main/SECURITY.md)).
- **Modalità di scansione**: Abilita/disabilita moduli (es. `OSINT`, `SUBDOMAINS_GENERAL`, `VULNS_GENERAL`).
- **Prestazioni**: Regola thread, limiti di velocità e timeout (es. `FFUF_THREADS`, `HTTPX_RATELIMIT`).
- **Limitazione adattiva della velocità**: Riduce automaticamente su errori 429/503 (`ADAPTIVE_RATE_LIMIT`, `MIN_RATE_LIMIT`, `MAX_RATE_LIMIT`).
- **Scansione incrementale**: Scansiona solo i nuovi risultati dall’ultima esecuzione (`INCREMENTAL_MODE`).
```
---
[Read more](https://github.com/six2dez/reconftw)
Scopri gli strumenti più utilizzati dalla nostra community.
Nessun dato di popolarità ancora.