> ## Documentation Index
> Fetch the complete documentation index at: https://docs.myrmex.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Shodan

> Conecte o Shodan ao Myrmex — adicione a chave de API da sua conta para mapear a exposição externa e enriquecer investigações em tempo real.

import { Note, Steps, Step, CardGroup, Card, Tip } from '@mintlify/components';

Conecte o **Shodan** para que o Myrmex possa mapear sua superfície de ataque externa — hosts expostos à internet, serviços, portas e banners — e enriquecer investigações com inteligência de dispositivos e IPs. O Myrmex consulta a API REST do Shodan em tempo real através de um [Collector](/pt/documentation/agent-endpoint-security/collector-mode).

<Note>
  O Myrmex consulta o Shodan sob demanda e lê resultados em tempo real — nada é armazenado do lado do Myrmex.
</Note>

## O Que o Myrmex Pode Fazer

<CardGroup cols={2}>
  <Card title="Exposição externa" icon="globe">
    Descubra hosts voltados para a internet, portas abertas e serviços em execução.
  </Card>

  <Card title="Enriquecimento de IP e host" icon="magnifying-glass">
    Enriqueça indicadores durante o trabalho de [Threat Intelligence](/pt/documentation/detection-response/threat-intelligence).
  </Card>

  <Card title="CVEs conhecidas" icon="bug">
    Traga à tona vulnerabilidades reportadas em serviços expostos.
  </Card>

  <Card title="Recon com IA" icon="robot">
    Deixe o [Orion](/pt/documentation/multi-agent-system/orion) usar o Shodan para reconhecimento.
  </Card>
</CardGroup>

## Antes de Começar

* Uma conta Shodan. Alguns endpoints (busca de hosts, scanning sob demanda) precisam de um plano pago ou de query/scan credits disponíveis.
* Um [Collector](/pt/documentation/agent-endpoint-security/collector-mode) que consiga alcançar `api.shodan.io` por HTTPS de saída.

## Passo 1 — Crie a Credencial no Shodan

<Steps>
  <Step title="Faça login">
    Acesse `account.shodan.io` e faça login.
  </Step>

  <Step title="Copie sua chave de API">
    Na página **Account**, copie sua **API Key**.
  </Step>

  <Step title="Cole-a no Myrmex">
    Você vai adicioná-la como o token de API no próximo passo.
  </Step>
</Steps>

<Note>
  O Shodan autentica com a chave de API passada como parâmetro de query (`?key=<APIKEY>`) — não há usuário nem senha.
</Note>

## Passo 2 — Adicione a Integração no Myrmex

No **Directory**, escolha **Add Integration → Shodan** e preencha:

| Field           | Descrição                                                                                               |
| --------------- | ------------------------------------------------------------------------------------------------------- |
| **Name**        | Um nome único para esta instância do Shodan.                                                            |
| **Description** | Nota opcional para identificar a conta.                                                                 |
| **Collector**   | O [Collector](/pt/documentation/agent-endpoint-security/collector-mode) que se conecta à API do Shodan. |
| **API URL**     | O host da API do Shodan (padrão `api.shodan.io`).                                                       |
| **Port**        | Porta da API (padrão `443`).                                                                            |
| **API Key**     | A chave de API da sua conta Shodan.                                                                     |

## Conectar

Clique em **Connect** para validar a chave de API. O Shodan então aparece em **Environment → Integrations**, e você pode usá-lo — ao vivo — em [Threat Intelligence](/pt/documentation/detection-response/threat-intelligence) e recon.