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

> Conecta Cisco Umbrella a Myrmex con una API key y un secret de Umbrella: créalos y agrega la integración.

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

Conecta **Cisco Umbrella** para que Myrmex pueda leer en tiempo real tus datos de seguridad en la capa DNS —actividad, dominios principales y solicitudes bloqueadas o marcadas— para investigación y análisis. Myrmex se conecta mediante la **API de Umbrella** (`api.umbrella.com`) usando una API key y un secret (credenciales de cliente OAuth 2.0).

## Qué puede hacer Myrmex

<CardGroup cols={2}>
  <Card title="Visibilidad de seguridad DNS" icon="shield-halved">
    Lee la actividad en la capa DNS, los eventos de seguridad y las solicitudes bloqueadas, bajo demanda.
  </Card>

  <Card title="Investigar dominios" icon="magnifying-glass">
    Trae los dominios e identidades principales a las investigaciones en el Workspace.
  </Card>

  <Card title="Analizar la actividad" icon="chart-line">
    Consulta la actividad DNS en tiempo real para respaldar tus análisis.
  </Card>

  <Card title="Correlacionar" icon="diagram-project">
    Cruza los eventos DNS con datos de tus otras integraciones.
  </Card>
</CardGroup>

## Antes de comenzar

* Una cuenta de **Cisco Umbrella** con acceso al dashboard.
* Permiso para crear **API Keys** en el dashboard de Umbrella (**Admin → API Keys**).
* Los scopes adecuados para lo que Myrmex deba leer (los scopes de lectura, como Reports, bastan para el análisis).

## Paso 1 — Crear la API Key en Cisco Umbrella

<Steps>
  <Step title="Abre API Keys">
    En el dashboard de Umbrella, ve a **Admin → API Keys**.
  </Step>

  <Step title="Crea una key">
    Haz clic en **Add** para crear una nueva key, asígnale un nombre y selecciona los scopes que necesita Myrmex (los scopes de lectura bastan para el análisis).
  </Step>

  <Step title="Copia la key y el secret">
    Copia la **API Key** y el **Key Secret**. El secret se muestra una sola vez: guárdalo de forma segura. Ingresarás ambos en Myrmex.
  </Step>
</Steps>

## Paso 2 — Agregar la integración en Myrmex

Desde el **Directory**, elige **Add Integration → Cisco Umbrella** y luego completa:

| Field                     | Descripción                                                                                                        |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| **Name**                  | Un nombre único para esta organización de Umbrella.                                                                |
| **Description**           | Nota opcional para identificarla.                                                                                  |
| **Username (API Key)**    | La API Key de Umbrella del Paso 1.                                                                                 |
| **Password (Key Secret)** | El Key Secret correspondiente.                                                                                     |
| **Host**                  | El host de la API de Umbrella (por defecto `api.umbrella.com`).                                                    |
| **Port**                  | El puerto HTTPS (por defecto `443`).                                                                               |
| **Collector**             | [Collector](/es/documentation/agent-endpoint-security/collector-mode) opcional para enrutar la conexión de la API. |

## Conectar

Haz clic en **Connect**. Myrmex solicita un token de acceso al endpoint de tokens de Umbrella (`/auth/v2/token`) usando tu key y tu secret, valida la conexión y finaliza. Umbrella aparecerá entonces en **Environment → Integrations**.

<Note>
  Myrmex realiza por ti el intercambio de credenciales de cliente OAuth 2.0: tú solo proporcionas la API Key y el Key Secret. Los datos se leen en tiempo real cuando lo solicitas; nada de Umbrella se almacena del lado de Myrmex.
</Note>