whathost

📖 Sobre

whathost é uma ferramenta de reconhecimento de alto desempenho projetada para profissionais de segurança, testadores de penetração e caçadores de bug bounty. Ela resolve rapidamente endereços IP para hostnames por meio de inspeção de certificados SSL/TLS e consultas DNS PTR, fornecendo enumeração abrangente de hosts para avaliações de segurança.

Por que whathost?

• 🚀 Extremamente Rápido: Arquitetura multithread com workers configuráveis
• 🎯 Descoberta Dupla: Combina análise de certificados SSL e consultas DNS PTR
• 🔧 Altamente Configurável: Resolvedores DNS personalizados, substituição de SNI, formatos de saída flexíveis
• 📊 Múltiplos Modos de Saída: Legível por humanos, JSON ou modo silencioso para scripts
• 🛡️ Focado em Segurança: Criado para fluxos de trabalho de reconhecimento com deduplicação e rastreamento de estatísticas
• 🔌 Compatível com Pipelines: Integração perfeita de stdin/stdout para encadeamento de ferramentas

---

✨ Recursos

Capacidades Principais

• Enumeração de Certificados SSL/TLS

  • Extrair Subject Alternative Names (SANs)
  • Extrair Common Name (CN)
  • Suporte para portas personalizadas (por exemplo, :8443, :8080)
  • Substituição de SNI para cenários de virtual hosting

• Consultas DNS PTR

  • Resolução reversa de DNS
  • Suporte a resolvedor DNS personalizado (IP, porta, protocolo)
  • Timeouts configuráveis
  • Seleção de protocolo UDP/TCP

Recursos Avançados

• Otimização de Desempenho

  • Threads de trabalho configuráveis (padrão: 32)
  • Pooling e reutilização de conexões
  • Suporte a HTTP/2 para handshakes TLS mais rápidos
  • Limitação de taxa com atrasos configuráveis

• Flexibilidade de Saída

  • Formato legível por humanos com saída colorida
  • Saída JSON para automação
  • Modo silencioso (apenas hostnames)
  • Suporte a timestamp (RFC3339)
  • Opções de deduplicação

• Confiabilidade

  • Tratamento gracioso de erros
  • Recuperação de pânico
  • Relatório detalhado de estatísticas
  • Modo de log verboso

---

🚀 Instalação

Usando Go Install (Recomendado)

go install gitlab.com/bountrix/whathost@latest

A partir do código-fonte

git clone https://gitlab.com/bountrix/whathost.git
cd whathost
go build -o whathost
sudo mv whathost /usr/local/bin/whathost

Verificar a Instalação

whathost -version

📚 Uso

Exemplos Básicos

Verificação rápida a partir de ficheiro:

whathost -i targets.txt

Pipeline a partir de stdin:

cat ips.txt | whathost

Varredura de alta velocidade com 100 workers:

whathost -i targets.txt -t 100

Exemplos Avançados

Modo silencioso para saída limpa:

whathost -i targets.txt -silent | sort -u

Enumeração somente SSL (ignorar DNS):

whathost -i targets.txt -skip-dns -t 200

Somente DNS com resolvedor personalizado:

whathost -i targets.txt -skip-ssl -r 8.8.8.8 -p 53

Saída JSON com estatísticas:

whathost -i targets.txt -json -stats -dedupe > results.json

Varredura com limitação de taxa e atraso:

whathost -i targets.txt -delay 100ms -timeout 15

SNI personalizado para hosts virtuais:

whathost -i targets.txt -sni example.com -insecure

Depuração detalhada:

whathost -i targets.txt -v -stats

Fluxo de trabalho completo de reconhecimento:

cat targets.txt | whathost -t 100 -dedupe -timestamp -o results.txt -stats

Opções de Linha de Comando

Opções de Entrada/Saída

Flag	Alias	Descrição
-i		Arquivo de entrada contendo IPs (padrão: stdin)
-o		Arquivo de saída para resultados (padrão: stdout)
-json		Exibe os resultados em formato JSON
-silent	-s	Modo silencioso - exibe apenas os hostnames
-timestamp		Adiciona timestamps RFC3339 aos resultados

Opções de Desempenho

Flag	Alias	Descrição
-t	-threads	Número de workers concorrentes (padrão: 32)
-delay		Atraso entre requisições (ex.: 100ms, 1s)
-timeout		Timeout do cliente HTTP em segundos (padrão: 10)

Opções de DNS

Flag	Alias	Descrição
-r	-resolver	Endereço IP do resolvedor DNS personalizado
-p		Porta do resolvedor DNS (padrão: 53)
-protocol		Protocolo DNS: udp ou tcp (padrão: udp)
-dns-timeout		Timeout da consulta DNS em segundos (padrão: 5)
-skip-dns		Ignora consultas DNS PTR

Opções de SSL/TLS

Flag	Descrição
-sni	Substitui o hostname SNI para conexões SSL
-insecure	Ignora a verificação do certificado TLS (padrão: true)
-skip-ssl	Ignora as verificações de certificado SSL

Controle de Saída

Flag	Alias	Descrição
-dedupe		Remove hostnames duplicados na saída
-stats		Exibe estatísticas detalhadas ao final
-v	-verbose	Saída detalhada com informações de depuração
-banner		Exibe o banner ASCII na inicialização
-version		Exibe informações de versão

---

Formatos de Saída

Saída Padrão

[SSL-SAN] 143.43.221.133 -> example.com
[SSL-CN] 143.43.221.133 -> example.org
[DNS-PTR] 143.43.221.133 -> host.example.com
[SSL-SAN] 143.43.221.133:8443 -> api.example.com

Saída JSON

{
  "type": "SSL-SAN",
  "ip": "143.43.221.133",
  "hostname": "example.com",
  "source": "certificate"
}{
  "type": "SSL-CN",
  "ip": "143.43.221.133",
  "hostname": "example.org",
  "source": "certificate"
}{
  "type": "DNS-PTR",
  "ip": "143.43.221.133",
  "hostname": "host.example.com",
  "source": "dns"
}{
  "type": "SSL-SAN",
  "ip": "143.43.221.133",
  "hostname": "api.example.com",
  "port": "8443",
  "source": "certificate"
}

Saída em Modo Silencioso

example.com
example.org
host.example.com
api.example.com

Relatório de Estatísticas

╔════════════════════════════════════════════╗
║           Statistics Report                ║
╠════════════════════════════════════════════╣
║ Total IPs processed:    250                ║
║ SSL hostnames found:    487                ║
║ DNS PTR records:        198                ║
║ Unique hostnames:       623                ║
║ Failed checks:          12                 ║
║ Time elapsed:           45.3s              ║
║ Processing rate:        5.52 IPs/s         ║
╚════════════════════════════════════════════╝

Casos de Uso

Caça de Bug Bounty

Descobrir subdomínios a partir de intervalos de IP

cat ip-ranges.txt | whathost -silent -dedupe | httprobe

Teste de Penetração

Enumerar todos os hosts nos IPs descobertos

whathost -i scope-ips.txt -stats -o discovered-hosts.txt

Descoberta de Ativos

Encontrar todos os hostnames associados aos IPs da empresa

whathost -i company-ips.txt -json -dedupe > asset-inventory.json

Análise de Certificate Transparency

Extrair todos os SANs do monitoramento de certificados

cat ct-log-ips.txt | whathost -skip-dns -t 200 -silent