reconFTW é uma ferramenta projetada para realizar recon automatizado em um domínio alvo, executando o melhor conjunto de ferramentas para realizar varredura e encontrar vulnerabilidades.
<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** é uma poderosa ferramenta automatizada de reconhecimento projetada para pesquisadores de segurança e testadores de penetração. Ela simplifica o processo de coleta de inteligência sobre um alvo, realizando enumeração de subdomínios, varredura de vulnerabilidades, OSINT e muito mais. Com design modular, opções extensivas de configuração e suporte a varredura distribuída via AX Framework, o reconFTW foi construído para entregar resultados abrangentes de forma eficiente.
O reconFTW aproveita uma ampla gama de técnicas, incluindo descoberta passiva e ativa de subdomínios, verificações de vulnerabilidades web (ex.: XSS, SSRF, SQLi), OSINT, fuzzing de diretórios, varredura de portas e captura de telas. Ele se integra a ferramentas e APIs de ponta para maximizar a cobertura e a precisão, garantindo que você esteja à frente em seus esforços de reconhecimento.
**Principais Recursos:**
- Enumeração abrangente de subdomínios (passiva, bruteforce, permutações, transparência de certificados, etc.)
- Varredura de vulnerabilidades para XSS, SSRF, SQLi, LFI, SSTI e mais
- OSINT para e-mails, metadados, vazamentos de APIs e configurações incorretas de terceiros
- Varredura distribuída com AX Framework para execução mais rápida
- Fluxos de trabalho personalizáveis com um arquivo de configuração detalhado
- Integração com Faraday para relatórios e visualização
- Suporte a implantações com Docker, Terraform e Ansible
**Aviso Legal:** O uso do reconFTW para atacar alvos sem consentimento prévio é ilegal. É responsabilidade do usuário obedecer a todas as leis aplicáveis. Os desenvolvedores não assumem responsabilidade por uso indevido ou danos causados por esta ferramenta. Use com responsabilidade.
---
## 📔 Índice
- [📔 Índice](#-índice)
- [✨ Recursos](#-recursos)
- [OSINT](#osint)
- [Subdomínios](#subdomínios)
- [Hosts](#hosts)
- [Análise Web](#análise-web)
- [Verificações de Vulnerabilidades](#verificações-de-vulnerabilidades)
- [Extras](#extras)
- [🏗️ Arquitetura](#️-arquitetura)
- [💿 Instalação](#-instalação)
- [Instalação Local (PC/VPS/VM)](#instalação-local-pcvpsvm)
- [Docker](#docker)
- [Terraform + Ansible](#terraform--ansible)
- [Testando a v2 beta (reescrita em Go)](#testando-a-v2-beta-reescrita-em-go)
- [⚙️ Configuração](#️-configuração)
- [🚀 Uso](#-uso)
- [Opções de Alvo](#opções-de-alvo)
- [Opções de Modo](#opções-de-modo)
- [Opções Gerais](#opções-gerais)
- [Exemplo de Uso](#exemplo-de-uso)
- [☁️ Suporte ao AX Framework (anteriormente Axiom)](#️-suporte-ao-ax-framework-anteriormente-axiom)
- [💻 Suporte ao Faraday](#-suporte-ao-faraday)
- [🧠 Integração com IA](#-integração-com-ia)
- [🗂️ Gerenciamento de Dados](#️-gerenciamento-de-dados)
- [Makefile](#makefile)
- [Manual](#manual)
- [🧪 Testes](#-testes)
- [Mapa Mental/Fluxo de Trabalho](#mapa-mentalfluxo-de-trabalho)
- [Vídeo de exemplo](#vídeo-de-exemplo)
- [🤝 Como Contribuir](#-como-contribuir)
- [🔒 Segurança](#-segurança)
- [❓ Precisa de Ajuda?](#-precisa-de-ajuda)
- [💖 Apoie Este Projeto](#-apoie-este-projeto)
- [🙏 Agradecimentos](#-agradecimentos)
- [📝 Registro de Alterações](#-registro-de-alterações)
- [🛠️ Desenvolvimento](#️-desenvolvimento)
- [📜 Licença](#-licença)
- [⭐ Histórico de Estrelas](#-histórico-de-estrelas)
---
## ✨ Recursos
O reconFTW está repleto de recursos para tornar o reconhecimento minucioso e eficiente. Abaixo está um detalhamento abrangente de suas capacidades, atualizado para refletir a funcionalidade mais recente no script e na configuração.
### OSINT
- **Informações de Domínio**: Consulta WHOIS para detalhes de registro de domínio ([whois](https://github.com/rfc1036/whois)).
- **Vazamentos de E-mail e Senhas**: Busca por e-mails e credenciais vazadas ([emailfinder](https://github.com/Josue87/EmailFinder) e [LeakSearch](https://github.com/JoelGMSec/LeakSearch)).
- **Mapeamento Microsoft 365/Azure**: Identifica tenants do Microsoft 365 e Azure ([msftrecon](https://github.com/Arcanum-Sec/msftrecon)).
- **Extração de Metadados**: Extrai metadados de documentos do Office indexados ([metagoofil](https://github.com/opsdisk/metagoofil)).
- **Vazamentos de API**: Detecta APIs expostas em fontes públicas ([porch-pirate](https://github.com/MandConsultingGroup/porch-pirate), [SwaggerSpy](https://github.com/UndeadSec/SwaggerSpy) e [postleaksNg](https://github.com/six2dez/postleaksNG)).
- **Google Dorking**: Consultas automatizadas de Google dork para informações sensíveis ([dorks_hunter](https://github.com/six2dez/dorks_hunter) e [xnldorker](https://github.com/xnl-h4ck3r/xnldorker)).
- **Análise do GitHub**: Varre organizações do GitHub em busca de repositórios e segredos com mecanismos selecionáveis ([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)).
- **Auditoria de GitHub Actions (Opcional)**: Audita artefatos de fluxos de trabalho e exposição de CI/CD com [gato](https://github.com/praetorian-inc/gato).
- **Configurações Incorretas de Terceiros**: Identifica serviços de terceiros mal configurados ([misconfig-mapper](https://github.com/intigriti/misconfig-mapper)).
- **Higiene de E-mail**: Revisa a configuração de SPF/DMARC para sinalizar problemas de spoofing ou entregabilidade.
- **Enumeração de Armazenamento em Nuvem**: Pesquisa buckets em grandes provedores em busca de exposição ([cloud_enum](https://github.com/initstring/cloud_enum)).
- **Domínios Spoofáveis**: Verifica domínios vulneráveis a spoofing ([spoofcheck](https://github.com/MattKeeley/Spoofy)).
### Subdomínios
- **Enumeração Passiva**: Usa APIs e fontes públicas para descoberta de subdomínios ([subfinder](https://github.com/projectdiscovery/subfinder) e [github-subdomains](https://github.com/gwen001/github-subdomains)).
- **Transparência de Certificados**: Consulta logs de transparência de certificados ([crt](https://github.com/cemulus/crt)).
- **Descoberta NOERROR**: Identifica subdomínios com respostas DNS NOERROR ([dnsx](https://github.com/projectdiscovery/dnsx), mais informações [aqui](https://www.securesystems.de/blog/enhancing-subdomain-enumeration-ents-and-noerror/)).
- **Bruteforce**: Realiza bruteforce de DNS com wordlists personalizáveis ([puredns](https://github.com/d3mondev/puredns) e wordlists personalizadas).
- **Permutações**: Gera permutações de subdomínios usando IA, regex e ferramentas ([Gotator](https://github.com/Josue87/gotator) como o único mecanismo de permutação, além de [regulator](https://github.com/cramppet/regulator) e [subwiz](https://github.com/hadriansecurity/subwiz)).
- **Web Scraping**: Extrai subdomínios de fontes passivas de URLs e metadados web ao vivo ([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)).
- **Registros DNS**: Resolve registros DNS para subdomínios ([dnsx](https://github.com/projectdiscovery/dnsx)).
- **Google Analytics**: Identifica subdomínios via IDs do Analytics ([AnalyticsRelationships](https://github.com/Josue87/AnalyticsRelationships)).
- **Handshake TLS**: Descobre subdomínios via portas TLS ([tlsx](https://github.com/projectdiscovery/tlsx)).
- **Busca Recursiva**: Realiza enumeração passiva ou bruteforce recursiva combinados ([dsieve](https://github.com/trickest/dsieve)).
- **Subdomain Takeover**: Detecta subdomínios vulneráveis ([nuclei](https://github.com/projectdiscovery/nuclei) e [dnstake](https://github.com/pwnesia/dnstake)).
- **Transferência de Zona DNS**: Verifica transferências de zona DNS mal configuradas ([dig](https://linux.die.net/man/1/dig)).
- **Buckets na Nuvem**: Identifica buckets na nuvem mal configurados e ativos de armazenamento expostos ([S3Scanner](https://github.com/sa7mon/S3Scanner) e [cloud_enum](https://github.com/initstring/cloud_enum)).
- **Nota sobre Cobertura na Nuvem**: As verificações de buckets na nuvem não incluem mais cobertura do Alibaba OSS após a substituição do CloudHunter pelo cloud_enum.
- **Migração de Saída na Nuvem**: Artefatos legados de buckets `cloudhunter_*` foram removidos; use `subdomains/cloud_enum_buckets_trufflehog.txt` em seu lugar.
- **Pesquisa Reversa de IP**: Descobre subdomínios via faixas de IP ([hakip2host](https://github.com/hakluke/hakip2host)).
### Hosts
- **Informações de IP**: Recupera dados de geolocalização e WHOIS ([ipinfo](https://www.ipinfo.io/)).
- **Detecção de CDN**: Identifica IPs atrás de CDNs ([cdncheck](https://github.com/projectdiscovery/cdncheck)).
- **Detecção de WAF**: Detecta Web Application Firewalls ([wafw00f](https://github.com/EnableSecurity/wafw00f)).
- **Varredura de Portas**: Varredura ativa com [nmap](https://github.com/nmap/nmap) (opcionalmente precedida por [naabu](https://github.com/projectdiscovery/naabu)) e varredura passiva com [smap](https://github.com/s0md3v/Smap).
- **Fingerprinting de Serviços**: Identifica serviços expostos em pares host:porta descobertos com [nerva](https://github.com/praetorian-inc/nerva).
- **Vulnerabilidades de Serviços (Opcional)**: O perfil de varredura de portas profunda pode enriquecer resultados com correspondência de CVEs via [vulners](https://github.com/vulnersCom/nmap-vulners).
- **Password Spraying**: Tenta password spraying em serviços identificados com seleção de mecanismo ([brutespray](https://github.com/x90skysn3k/brutespray) ou [brutus](https://github.com/praetorian-inc/brutus)).
- **Geolocalização**: Mapeia endereços IP para localizações geográficas ([ipinfo](https://www.ipinfo.io/)).
- **Descoberta IPv6**: Opcionalmente enumera e varre alvos IPv6 descobertos quando `IPV6_SCAN` está habilitado.
### Análise Web
- **Sondagem Web**: Detecta servidores web ativos em portas padrão e incomuns (([httpx](https://github.com/projectdiscovery/httpx))).
- **Capturas de Tela**: Captura capturas de tela de páginas web ([nuclei](https://github.com/projectdiscovery/nuclei)).
- **Fuzzing de Hosts Virtuais**: Identifica hosts virtuais por fuzzing de cabeçalhos HTTP ([VhostFinder](https://github.com/wdahlenburg/VhostFinder)).
- **Detecção de CMS**: Identifica sistemas de gerenciamento de conteúdo ([CMSeeK](https://github.com/Tuhinshubhra/CMSeeK)).
- **Extração de URLs**: Coleta URLs passiva e ativamente ([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)).
- **Análise de Padrões de URL**: Classifica URLs usando padrões ([urless](https://github.com/xnl-h4ck3r/urless), [gf](https://github.com/tomnomnom/gf) e [gf-patterns](https://github.com/1ndianl33t/Gf-Patterns)).
- **Reconhecimento de Tecnologia por Favicon**: Identifica tecnologias a partir de hashes de favicons ([favirecon](https://github.com/edoardottt/favirecon)).
- **Análise de JavaScript**: Extrai segredos e endpoints de arquivos 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)).
- **Extração de Source Maps**: Recupera dados sensíveis de source maps de JavaScript ([sourcemapper](https://github.com/denandz/sourcemapper)).
- **Detecção de GraphQL**: Descobre endpoints GraphQL com nuclei e opcionalmente realiza introspecção aprofundada ([GQLSpection](https://github.com/doyensec/GQLSpection)).
- **Descoberta de Parâmetros**: Realiza bruteforce de parâmetros ocultos em endpoints ([arjun](https://github.com/s0md3v/Arjun)).
- **Auditoria de WebSocket**: Valida handshakes de upgrade e tratamento de origem em endpoints `ws://` e `wss://`.
- **Reflexão gRPC**: Sonda portas gRPC comuns em busca de reflexão de serviços exposta ([grpcurl](https://github.com/fullstorydev/grpcurl)).
- **Fingerprinting de Serviços LLM (Opcional)**: Sonda endpoints web/API descobertos em busca de serviços LLM expostos com [julius](https://github.com/praetorian-inc/julius).
- **Fuzzing**: Realiza fuzzing de diretórios e parâmetros ([ffuf](https://github.com/ffuf/ffuf)).
- **Classificação por Extensão de Arquivo**: Organiza URLs por extensões de arquivo.
- **Geração de Wordlists**: Cria wordlists personalizadas para fuzzing.
- **Dicionário de Senhas**: Gera dicionários de senhas a partir de conteúdo ao vivo ([cewler](https://github.com/roys/cewler)).
- **Varredura de Shortname IIS**: Detecta vulnerabilidades de shortname IIS ([shortscan](https://github.com/bitquark/shortscan)).
### Verificações de Vulnerabilidades
- **CVEs**: Verifica CVEs e vulnerabilidades comuns [nuclei](https://github.com/projectdiscovery/nuclei)
- **Nuclei DAST**: Executa templates `nuclei -dast` sobre URLs coletadas e candidatos GF para cobertura adicional de DAST.
- **XSS**: Testa vulnerabilidades de cross-site scripting ([dalfox](https://github.com/hahwul/dalfox)).
- **SSL/TLS**: Verifica configurações incorretas de SSL/TLS ([testssl](https://github.com/drwetter/testssl.sh)).
- **SSRF**: Testa server-side request forgery ([interactsh](https://github.com/projectdiscovery/interactsh), valores de parâmetros com [ffuf](https://github.com/ffuf/ffuf) e payloads opcionais de protocolos alternativos).
- **CRLF**: Verifica vulnerabilidades de injeção CRLF ([crlfuzz](https://github.com/dwisiswant0/crlfuzz)).
- **LFI**: Testa local file inclusion via fuzzing ([ffuf](https://github.com/ffuf/ffuf)).
- **SSTI**: Detecta server-side template injection ([TInjA](https://github.com/Hackmanit/TInjA)).
- **SQLi**: Testa injeção SQL ([SQLMap](https://github.com/sqlmapproject/sqlmap) e [ghauri](https://github.com/r0oth3x49/ghauri)).
- **Links Quebrados**: Identifica links quebrados e referências externas provavelmente propensas a takeover ([second-order](https://github.com/mhmdiaa/second-order)).
- **Injeção de Comandos**: Testa vulnerabilidades de injeção de comandos ([commix](https://github.com/commixproject/commix)).
- **HTTP Request Smuggling**: Verifica vulnerabilidades de request smuggling ([smugglex](https://github.com/hahwul/smugglex)).
- **Cache Web**: Identifica vulnerabilidades de cache web ([Web-Cache-Vulnerability-Scanner](https://github.com/Hackmanit/Web-Cache-Vulnerability-Scanner) e [toxicache](https://github.com/xhzeem/toxicache)).
- **Bypass de 4XX**: Tenta contornar respostas 4XX ([nomore403](https://github.com/devploit/nomore403)).
- **Fuzzing de Parâmetros**: Realiza fuzzing de parâmetros de URL em busca de vulnerabilidades ([nuclei](https://github.com/projectdiscovery/nuclei)).
### Extras- **Multithreading**: Otimiza o desempenho ([Interlace](https://github.com/codingo/Interlace)).
- **Resolvedores Personalizados**: Gera resolvedores DNS ([dnsvalidator](https://github.com/vortexau/dnsvalidator)).
- **Suporte a Docker**: Imagem Docker oficial no [DockerHub](https://hub.docker.com/r/six2dez/reconftw).
- **Implantação AWS**: Implanta via Terraform e Ansible.
- **Suporte a IP/CIDR**: Escaneia faixas de IP e blocos CIDR.
- **Retomada de Escaneamento**: Retoma escaneamentos a partir da última etapa concluída.
- **Saída Personalizada**: Salva resultados em um diretório definido pelo usuário.
- **Modo Diff**: Destaca novas descobertas em escaneamentos subsequentes.
- **Filtragem de Escopo**: Suporta listas de escopo incluído e excluído ([inscope](https://github.com/tomnomnom/hacks/tree/master/inscope)).
- **Notificações**: Envia alertas via Slack, Discord ou Telegram ([notify](https://github.com/projectdiscovery/notify)).
- **Compactação de Resultados**: Comprime e envia resultados.
- **Integração Faraday**: Exporta resultados para [Faraday](https://github.com/infobyte/faraday) para relatórios.
- **Geração de Relatórios com IA**: Gera relatórios usando modelos de IA locais ([reconftw_ai](https://github.com/six2dez/reconftw_ai)).
- **Modo de Reescaneamento Rápido**: Ignora etapas pesadas automaticamente quando nenhum novo ativo é descoberto (`--quick-rescan` / `QUICK_RESCAN`).
- **Construtor de Hotlist**: Pontua e destaca os ativos de maior risco (`hotlist.txt`) com base em novas descobertas.
- **Rastreamento de Comandos**: Ative `SHOW_COMMANDS` para registrar cada comando executado nos logs de destino para depuração.
- **Armazenamento de Ativos**: Adiciona descobertas a `assets.jsonl` para automação downstream quando `ASSET_STORE` está habilitado.
- **Relatório Consolidado**: Gera automaticamente `report/report.json` e `report/index.html` ao final do escaneamento.
- **Suporte ARM**: Compatível com Raspberry Pi e arquiteturas ARM (incluindo MacOS MX).
- **Verificação de Saúde**: Verificação de saúde do sistema integrada via `--health-check` (também usada pelo `HEALTHCHECK` do Docker).
- **Modo Incremental**: Escaneia apenas novas descobertas desde a última execução (`--incremental`).
- **Limitação de Taxa Adaptativa**: Recua automaticamente em erros 429/503 (`--adaptive-rate`).
- **Registro Estruturado**: Saída de log JSON opcional para análise avançada (`STRUCTURED_LOGGING`).
- **Sanitização de Entrada**: Toda entrada do usuário é sanitizada para prevenir injeção de comandos.
- **Modo Simulação**: Pré-visualiza o que seria executado sem executar comandos (`--dry-run`).
- **Modo Paralelo**: Executa funções independentes em paralelo para escaneamentos mais rápidos (`--parallel`, desative com `--no-parallel`).
- **Arquitetura Modular**: Código dividido em 8 módulos focados para manutenibilidade.
- **Gerenciamento de Segredos**: Variáveis de ambiente, `secrets.cfg` e segredos de runtime do Docker (veja [SECURITY.md](https://github.com/six2dez/reconftw/blob/main/SECURITY.md)).
- **Disjuntor**: Ignora ferramentas automaticamente após falhas repetidas para evitar travamentos no escaneamento.
- **Sistema de Ponto de Verificação**: Retoma escaneamentos interrompidos a partir da última fase bem-sucedida.
- **Suporte Nativo a macOS**: Compatibilidade total com macOS (coreutils BSD, Homebrew Bash 4+).
---
## 🏗️ Arquitetura
O reconFTW usa uma arquitetura modular. O ponto de entrada principal (`reconftw.sh`) lida com a análise de argumentos e carrega 8 módulos especializados do diretório `modules/`.
### Layout do Diretório```
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
```
### Referência de Módulos
| Módulo | Linhas | Finalidade |
|--------|------:|---------|
| `core.sh` | 1024 | Gerenciamento do ciclo de vida, logging, notificações, traps de limpeza |
| `modes.sh` | 902 | Definições de modos de varredura, análise de argumentos, saída de ajuda |
| `subdomains.sh` | 1938 | Todas as funções de enumeração de subdomínios |
| `web.sh` | 1712 | Análise web, fuzzing, análise de JS, detecção de CMS |
| `vulns.sh` | 926 | Varredura de vulnerabilidades (XSS, SQLi, SSRF, etc.) |
| `osint.sh` | 500 | Funções de OSINT (WHOIS, e-mails, dorks, metadados) |
| `utils.sh` | 508 | Utilitários compartilhados, sanitização de entrada, validação |
| `axiom.sh` | 143 | Gerenciamento de frota distribuída Ax/Axiom |
A flag `--source-only` permite carregar o `reconftw.sh` sem executar a lógica principal, possibilitando testes unitários de funções individuais.
---
## 💿 Instalação
O reconFTW suporta múltiplos métodos de instalação para atender a diferentes ambientes. Certifique-se de ter espaço em disco suficiente (pelo menos 10 GB recomendados) e uma conexão de internet estável.
### Início Rápido
1) Clone e instale```yaml
git clone https://github.com/six2dez/reconftw
cd reconftw
./install.sh --verbose
```
2) Execute uma verificação (completa + retomada)```bash
./reconftw.sh -d example.com -r
```
3) Execução mínima (footprint apenas passivo)```bash
./reconftw.sh -d example.com -p
```
> Dica: execute novamente `./install.sh --tools` mais tarde para atualizar o toolchain sem reinstalar pacotes do sistema.
### Instalação Local (PC/VPS/VM)
1. **Pré-requisitos**:
- **Golang**: Versão mais recente (`install_golang` habilitado por padrão em `reconftw.cfg`).
- **Permissões do Sistema**: Se não estiver executando como root, configure o sudo para evitar solicitações:
```bash
sudo echo "${USERNAME} ALL=(ALL:ALL) NOPASSWD: ALL" | sudo tee -a /etc/sudoers.d/reconFTW
```
2. **Passos**: ```bash
git clone https://github.com/six2dez/reconftw
cd reconftw
./install.sh
./reconftw.sh -d target.com -r
```
3. **Notas**:
- O script `install.sh` instala dependências, ferramentas e configura caminhos (`GOROOT`, `GOPATH`, `PATH`).
- Defina `install_golang=false` em `reconftw.cfg` se o Golang já estiver configurado.
- Para instalações existentes, execute `./install.sh --tools` para atualizar binários Go, pacotes pipx e repositórios sem alterar pacotes do sistema.
- Consulte o [Guia de Instalação](https://github.com/six2dez/reconftw/wiki/0.-Installation-Guide) para instruções detalhadas.
### Docker
1. **Baixe a Imagem**: ```bash
docker pull six2dez/reconftw:main
```
2. **Execute o Container**: ```bash
docker run -it --rm \
-v "${PWD}/OutputFolder/:/reconftw/Recon/" \
six2dez/reconftw:main -d example.com -r
```
Para uma lista de alvos, vincule o arquivo de lista ao contêiner e referencie o caminho dentro do contêiner: ```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. **Ver os Resultados**:
- Os resultados são guardados no diretório `OutputFolder` no host (não dentro do contentor).
4. **Personalização**:
- Modifique a imagem Docker ou crie a sua própria; consulte o [Guia Docker](https://github.com/six2dez/reconftw/wiki/4.-Docker).
- Para omitir as ferramentas Ax em builds personalizados, passe `--build-arg INSTALL_AXIOM=false`.
- Monte a sua configuração do notify em `~/.config/notify/provider-config.yaml` dentro do contentor se utilizar notificações.
5. **Segredos em Tempo de Execução**:
Passe chaves de API e segredos através de variáveis de ambiente — nunca os incorpore na imagem: ```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
```
Vê [SECURITY.md](https://github.com/six2dez/reconftw/blob/main/SECURITY.md) para obter orientações completas sobre a gestão de segredos.
6. **Verificação de Saúde**:
A imagem Docker inclui um `HEALTHCHECK` integrado que executa `./reconftw.sh --health-check` a cada 60 segundos. Também pode executá-lo manualmente: ```bash
docker exec <container-id> ./reconftw.sh --health-check
```
### Terraform + Ansible
- Implante o reconFTW na AWS usando Terraform e Ansible.
- Siga o guia em [Terraform/README.md](https://github.com/six2dez/reconftw/blob/main/Terraform/README.md) para instruções de configuração.
---
## Experimentando o beta v2 (reescrita em Go)
O reconFTW está sendo reescrito em Go. A reescrita é distribuída como uma **pré-versão opcional**: ela está
listada na [página de releases](https://github.com/six2dez/reconftw/releases), e o GitHub
nunca aponta `releases/latest` para uma pré-versão — então, **se você não fizer nada, continuará recebendo
a versão em bash.** Isso é intencional.
O binário em Go é `reconftw`; o ponto de entrada em bash é `reconftw.sh`. Eles não sobrescrevem
um ao outro, então você pode manter ambos e reverter a qualquer momento.
O beta atual é **`v5.0.0-beta.1`**. Ele não é servido por `releases/latest`, então você
especifica a tag explicitamente:```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
```
Escolha o asset correspondente à sua plataforma na
[página de releases](https://github.com/six2dez/reconftw/releases/tag/v5.0.0-beta.1) — builds para `Darwin`
e `arm64`, um build estático musl e pacotes `.deb`/`.rpm` são todos publicados.
- [**O que a beta é, e o que ela não é**](https://github.com/six2dez/reconftw/blob/main/docs/V2-BETA-ANNOUNCEMENT.md) — incluindo três
coisas que explicitamente ainda não estão finalizadas.
- [**Reportar algo**](https://github.com/six2dez/reconftw/issues/new?template=v2-beta-feedback.md)
— o template de feedback da v2 beta. Bugs na versão bash ainda vão para o relatório de Bug normal.
## 🛠️ Solução de Problemas
- Bash 4+ no macOS: Os scripts se relançam automaticamente sob o Homebrew Bash. Se você vir uma mensagem sobre Bash < 4, execute `brew install bash`, abra um novo terminal e re-execute `./install.sh`.
- timeout no macOS: O macOS fornece `gtimeout` via `brew install coreutils`. Os scripts agora o detectam e usam automaticamente.
- Problemas de rede: Os instaladores ocultam a maior parte da saída dos comandos. Se algo falhar, re-execute com `upgrade_tools=true` em `reconftw.cfg`, execute `./install.sh --tools`, ou instale a ferramenta ausente manualmente (o erro indicará o nome dela).
- Binários GOPATH: Os binários são copiados para `/usr/local/bin`. Se preferir não fazer isso, garanta que `~/go/bin` esteja no seu `PATH`.
- Templates Nuclei: Se os templates não foram clonados, remova `~/nuclei-templates` e re-execute `./install.sh`.
## 🔑 Checklist de APIs (Opcional)
- `subfinder`: `~/.config/subfinder/provider-config.yaml`
- Tokens GitHub: `~/Tools/.github_tokens` (um por linha)
- Tokens GitLab: `~/Tools/.gitlab_tokens` (um por linha)
- WHOISXML: defina `WHOISXML_API` em `reconftw.cfg` ou como variável de ambiente
- Enumeração ASN (`asnmap`): defina `PDCP_API_KEY` no ambiente/config (`ASN_ENUM` é ignorado se não estiver definido)
- Slack/Discord/Telegram: configure `notify` em `~/.config/notify/provider-config.yaml`
- Servidor SSRF: defina `COLLAB_SERVER` no ambiente/cfg se for usado
- Servidor Blind XSS: defina `XSS_SERVER` no ambiente/cfg se for usado
## 💾 Requisitos
- Disco: 10–20 GB livres recomendados (toolchain + dados)
- Rede: conexão estável durante instalação e atualizações
- SO: Linux/macOS com Bash ≥ 4
- Extras: `shellcheck` e `shfmt` (opcionais) para `make lint`/`make fmt`
## ⚙️ Configuração
O arquivo `reconftw.cfg` controla toda a execução do reconFTW. Ele permite personalização detalhada de:
- **Caminhos de Ferramentas**: Defina caminhos para ferramentas, resolvers e wordlists (`tools`, `resolvers`, `fuzz_wordlist`).
```
---
[Read more](https://github.com/six2dez/reconftw)