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

# Cisco Umbrella

> Collega Cisco Umbrella a Myrmex con una API key e un secret Umbrella — creali e aggiungi l'integrazione.

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

Collega **Cisco Umbrella** in modo che Myrmex possa leggere in tempo reale i tuoi dati di sicurezza a livello DNS — attività, domini principali e richieste bloccate o segnalate — per indagini e analisi. Myrmex si connette tramite l'**API Umbrella** (`api.umbrella.com`) utilizzando una API key e un secret (client credentials OAuth 2.0).

## Cosa può fare Myrmex

<CardGroup cols={2}>
  <Card title="Visibilità sulla sicurezza DNS" icon="shield-halved">
    Leggi attività a livello DNS, eventi di sicurezza e richieste bloccate, su richiesta.
  </Card>

  <Card title="Indaga sui domini" icon="magnifying-glass">
    Recupera domini principali e identità nelle indagini all'interno del Workspace.
  </Card>

  <Card title="Analizza l'attività" icon="chart-line">
    Interroga l'attività DNS in tempo reale per supportare le tue analisi.
  </Card>

  <Card title="Correla" icon="diagram-project">
    Metti in relazione gli eventi DNS con i dati provenienti dalle tue altre integrazioni.
  </Card>
</CardGroup>

## Prima di iniziare

* Un account **Cisco Umbrella** con accesso alla dashboard.
* L'autorizzazione a creare **API Keys** nella dashboard di Umbrella (**Admin → API Keys**).
* Gli scope appropriati per ciò che Myrmex deve leggere (gli scope di lettura come Reports sono sufficienti per l'analisi).

## Passo 1 — Crea la API Key in Cisco Umbrella

<Steps>
  <Step title="Apri API Keys">
    Nella dashboard di Umbrella, vai su **Admin → API Keys**.
  </Step>

  <Step title="Crea una key">
    Fai clic su **Add** per creare una nuova key, assegnale un nome e seleziona gli scope necessari a Myrmex (gli scope di lettura sono sufficienti per l'analisi).
  </Step>

  <Step title="Copia la key e il secret">
    Copia la **API Key** e il **Key Secret**. Il secret viene mostrato una sola volta — conservalo in modo sicuro. Inserirai entrambi in Myrmex.
  </Step>
</Steps>

## Passo 2 — Aggiungi l'integrazione in Myrmex

Dal **Directory**, scegli **Add Integration → Cisco Umbrella**, quindi compila:

| Field                     | Descrizione                                                                                                        |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| **Name**                  | Un nome univoco per questa organizzazione Umbrella.                                                                |
| **Description**           | Nota opzionale per identificarla.                                                                                  |
| **Username (API Key)**    | La API Key Umbrella del Passo 1.                                                                                   |
| **Password (Key Secret)** | Il Key Secret corrispondente.                                                                                      |
| **Host**                  | L'host dell'API Umbrella (predefinito `api.umbrella.com`).                                                         |
| **Port**                  | La porta HTTPS (predefinita `443`).                                                                                |
| **Collector**             | [Collector](/it/documentation/agent-endpoint-security/collector-mode) opzionale per instradare la connessione API. |

## Connetti

Fai clic su **Connect**. Myrmex richiede un access token all'endpoint token di Umbrella (`/auth/v2/token`) utilizzando la tua key e il tuo secret, convalida la connessione e completa. Umbrella appare quindi in **Environment → Integrations**.

<Note>
  Myrmex gestisce per te lo scambio client-credentials OAuth 2.0 — devi solo fornire la API Key e il Key Secret. I dati vengono letti in tempo reale quando lo richiedi; nulla proveniente da Umbrella viene memorizzato lato Myrmex.
</Note>