> ## 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

> Collega Shodan a Myrmex: aggiungi l'API key del tuo account per mappare l'esposizione esterna e arricchire le indagini in tempo reale.

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

Collega **Shodan** in modo che Myrmex possa mappare la tua superficie di attacco esterna — host, servizi, porte e banner esposti su internet — e arricchire le indagini con intelligence su dispositivi e IP. Myrmex interroga l'API REST di Shodan in tempo reale attraverso un [Collector](/it/documentation/agent-endpoint-security/collector-mode).

<Note>
  Myrmex interroga Shodan su richiesta e legge i risultati in tempo reale: nulla viene memorizzato dalla parte di Myrmex.
</Note>

## Cosa può fare Myrmex

<CardGroup cols={2}>
  <Card title="Esposizione esterna" icon="globe">
    Individua host esposti su internet, porte aperte e servizi in esecuzione.
  </Card>

  <Card title="Arricchimento di IP e host" icon="magnifying-glass">
    Arricchisci gli indicatori durante il lavoro di [Threat Intelligence](/it/documentation/detection-response/threat-intelligence).
  </Card>

  <Card title="CVE note" icon="bug">
    Fai emergere le vulnerabilità segnalate sui servizi esposti.
  </Card>

  <Card title="Recon con l'AI" icon="robot">
    Lascia che [Orion](/it/documentation/multi-agent-system/orion) usi Shodan per la ricognizione.
  </Card>
</CardGroup>

## Prima di iniziare

* Un account Shodan. Alcuni endpoint (ricerca host, scansione su richiesta) richiedono un piano a pagamento o crediti di query/scan disponibili.
* Un [Collector](/it/documentation/agent-endpoint-security/collector-mode) in grado di raggiungere `api.shodan.io` tramite HTTPS in uscita.

## Passaggio 1 — Crea la credenziale in Shodan

<Steps>
  <Step title="Accedi">
    Vai su `account.shodan.io` e accedi.
  </Step>

  <Step title="Copia la tua API key">
    Nella pagina **Account**, copia la tua **API Key**.
  </Step>

  <Step title="Incollala in Myrmex">
    La aggiungerai come token API nel passaggio successivo.
  </Step>
</Steps>

<Note>
  Shodan si autentica con l'API key passata come parametro di query (`?key=<APIKEY>`): non ci sono nome utente né password.
</Note>

## Passaggio 2 — Aggiungi l'integrazione in Myrmex

Dalla **Directory**, scegli **Add Integration → Shodan**, quindi compila:

| Field           | Description                                                                                              |
| --------------- | -------------------------------------------------------------------------------------------------------- |
| **Name**        | Un nome univoco per questa istanza Shodan.                                                               |
| **Description** | Nota facoltativa per identificare l'account.                                                             |
| **Collector**   | Il [Collector](/it/documentation/agent-endpoint-security/collector-mode) che si connette all'API Shodan. |
| **API URL**     | L'host dell'API Shodan (predefinito `api.shodan.io`).                                                    |
| **Port**        | Porta dell'API (predefinita `443`).                                                                      |
| **API Key**     | L'API key del tuo account Shodan.                                                                        |

## Connessione

Fai clic su **Connect** per convalidare l'API key. Shodan comparirà quindi in **Environment → Integrations** e potrai usarlo — in tempo reale — nella [Threat Intelligence](/it/documentation/detection-response/threat-intelligence) e nella recon.