# Shodan: inteligência passiva de hosts durante o recon

> Como usar a CLI e a API do Shodan para enriquecimento passivo, e como o Tandera o usa sem enviar tráfego ao alvo.

O Shodan escaneia a internet continuamente e vende acesso aos resultados. Para um pentester o valor é que você pode saber quais portas, serviços e banners um host expõe **sem enviar um único pacote** — a varredura já aconteceu, no cronograma de outra pessoa.

## Instalação

```bash
pip install shodan
shodan init <YOUR_API_KEY>
```

Um plano pago é necessário para a maioria das queries úteis; a camada gratuita é muito limitada.

## Comandos principais

```bash
# tudo que o Shodan sabe sobre um endereço
shodan host 93.184.216.34

# busca por organização
shodan search 'org:"Example Inc"' --fields ip_str,port,hostnames

# pivota sobre um hash de favicon do httpx
shodan search 'http.favicon.hash:-1545961456' --fields ip_str,port

# pivô baseado em certificado
shodan search 'ssl.cert.subject.CN:"example.com"' --fields ip_str,port,hostnames

# conta sem gastar créditos de query em resultados
shodan count 'org:"Example Inc" port:3389'
```

## Saída

```json
{"ip_str":"93.184.216.34","ports":[80,443,8443],
 "hostnames":["example.com"],"org":"Example Inc",
 "data":[{"port":8443,"product":"nginx","version":"1.18.0","timestamp":"2026-08-20T04:11:00Z"}]}
```

## Onde ele entra no Tandera

O Shodan roda na fase de **enrich** do `recon_web_lite` e do `recon_web_full`. Como consulta um dataset de terceiros em vez do alvo, é permitido no fluxo lite `NonIntrusive` — que é exatamente por que ele é valioso ali: dá aos fluxos lite inteligência de porta e serviço que eles não conseguiriam obter de outra forma.

## Usando em um pentest

**Os dados têm um timestamp, e ele importa.** Um serviço que o Shodan viu três meses atrás pode ter sumido. Todo resultado do Shodan é uma pista para verificar com `httpx` ou `nmap`, nunca um finding por si só. Verifique o campo `timestamp` antes de agir sobre qualquer coisa.

**Hashes de favicon e de certificado são os melhores pivôs.** O `http.favicon.hash` da sua rodada de `httpx` vai achar infraestrutura irmã — staging, DR, um ambiente antigo — que nenhuma enumeração baseada em DNS alcança.

**Ele vê o que o perímetro esqueceu.** Hosts expostos diretamente, fora da CDN e fora do load balancer, são a especialidade do Shodan. Esses são frequentemente os alvos de maior valor num engajamento.

**Respeite o limite de escopo.** Buscas `org:` retornam tudo que a organização possui, incluindo redes fora do seu engajamento. Filtre antes de sondar.

---

Canonical: https://tandera.io/pt-br/tools/shodan
This page as markdown: https://tandera.io/pt-br/tools/shodan.md
Index for agents: https://tandera.io/llms.txt

Every page here is also available as markdown: append `.md` to the path (e.g. `/recon.md`, `/index.md` for this homepage, `/blog/<slug>.md`), or request the canonical path with `Accept: text/markdown`.