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

> Conecte o Cisco Umbrella ao Myrmex com uma API key e um secret do Umbrella — crie-os e adicione a integração.

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

Conecte o **Cisco Umbrella** para que o Myrmex possa ler seus dados de segurança na camada de DNS em tempo real — atividade, principais domínios e requisições bloqueadas ou sinalizadas — para investigação e análise. O Myrmex conecta-se pela **API do Umbrella** (`api.umbrella.com`) usando uma API key e um secret (client credentials OAuth 2.0).

## O Que o Myrmex Pode Fazer

<CardGroup cols={2}>
  <Card title="Visibilidade de segurança DNS" icon="shield-halved">
    Leia a atividade na camada de DNS, eventos de segurança e requisições bloqueadas, sob demanda.
  </Card>

  <Card title="Investigar domínios" icon="magnifying-glass">
    Traga os principais domínios e identidades para as investigações no Workspace.
  </Card>

  <Card title="Analisar atividade" icon="chart-line">
    Consulte a atividade de DNS em tempo real para apoiar suas análises.
  </Card>

  <Card title="Correlacionar" icon="diagram-project">
    Faça referência cruzada de eventos de DNS com dados das suas outras integrações.
  </Card>
</CardGroup>

## Antes de Começar

* Uma conta do **Cisco Umbrella** com acesso ao dashboard.
* Permissão para criar **API Keys** no dashboard do Umbrella (**Admin → API Keys**).
* Os escopos adequados ao que o Myrmex deve ler (escopos de leitura, como Reports, são suficientes para análise).

## Passo 1 — Crie a API Key no Cisco Umbrella

<Steps>
  <Step title="Abra API Keys">
    No dashboard do Umbrella, vá em **Admin → API Keys**.
  </Step>

  <Step title="Crie uma key">
    Clique em **Add** para criar uma nova key, dê um nome a ela e selecione os escopos de que o Myrmex precisa (escopos de leitura são suficientes para análise).
  </Step>

  <Step title="Copie a key e o secret">
    Copie a **API Key** e o **Key Secret**. O secret é exibido apenas uma vez — armazene-o com segurança. Você informará ambos no Myrmex.
  </Step>
</Steps>

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

No **Directory**, escolha **Add Integration → Cisco Umbrella** e preencha:

| Field                     | Descrição                                                                                                    |
| ------------------------- | ------------------------------------------------------------------------------------------------------------ |
| **Name**                  | Um nome único para esta organização do Umbrella.                                                             |
| **Description**           | Nota opcional para identificá-la.                                                                            |
| **Username (API Key)**    | A API Key do Umbrella do Passo 1.                                                                            |
| **Password (Key Secret)** | O Key Secret correspondente.                                                                                 |
| **Host**                  | O host da API do Umbrella (padrão `api.umbrella.com`).                                                       |
| **Port**                  | A porta HTTPS (padrão `443`).                                                                                |
| **Collector**             | [Collector](/pt/documentation/agent-endpoint-security/collector-mode) opcional para rotear a conexão da API. |

## Conectar

Clique em **Connect**. O Myrmex solicita um token de acesso ao endpoint de token do Umbrella (`/auth/v2/token`) usando sua key e secret, valida a conexão e conclui. O Umbrella então aparece em **Environment → Integrations**.

<Note>
  O Myrmex realiza a troca de client-credentials do OAuth 2.0 por você — você fornece apenas a API Key e o Key Secret. Os dados são lidos em tempo real quando você pergunta; nada do Umbrella é armazenado no lado do Myrmex.
</Note>