> ## Documentation Index
> Fetch the complete documentation index at: https://hc.saas-manager.biz.nuro.jp/llms.txt
> Use this file to discover all available pages before exploring further.

# Cisco Umbrella

> Cisco Umbrella integration guide: admin login, API key generation, and simple Admina setup

## Supported Features

<Badge color="blue">Account Deletion</Badge> <Badge color="blue">Account Provisioning</Badge>

## Advance Preparation

### How to Log In

On [the Cisco Umbrella login page](https://dashboard.umbrella.com), enter **your email address** and **password** to **log in**.

<img src="https://mintcdn.com/admina-sbn/ibHAD7VhlI5mZAsA/images/integrations/yyed0q40i0/2025-05-30-152400.png?fit=max&auto=format&n=ibHAD7VhlI5mZAsA&q=85&s=774b547d9c685599018b955ab247b5ba" alt="Cisco Umbrella login screen" width="520" height="498" data-path="images/integrations/yyed0q40i0/2025-05-30-152400.png" />

### How to Check Your Client ID and Client Secret

After logging in to **Cisco Umbrella**, click **Admin** > **API Keys** in the left menu.

<img src="https://mintcdn.com/admina-sbn/ibHAD7VhlI5mZAsA/images/integrations/yyed0q40i0/screenshot-2025-05-29-at-11-40-21.png?fit=max&auto=format&n=ibHAD7VhlI5mZAsA&q=85&s=06d0f3c9eae2d5ca8630eee690c2cc66" alt="Admin > API Keys menu" data-og-width="3410" width="3410" data-og-height="858" height="858" data-path="images/integrations/yyed0q40i0/screenshot-2025-05-29-at-11-40-21.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/admina-sbn/ibHAD7VhlI5mZAsA/images/integrations/yyed0q40i0/screenshot-2025-05-29-at-11-40-21.png?w=280&fit=max&auto=format&n=ibHAD7VhlI5mZAsA&q=85&s=571b80528ad87eec3f17f6f02f213096 280w, https://mintcdn.com/admina-sbn/ibHAD7VhlI5mZAsA/images/integrations/yyed0q40i0/screenshot-2025-05-29-at-11-40-21.png?w=560&fit=max&auto=format&n=ibHAD7VhlI5mZAsA&q=85&s=56630e3ed0d2d8d028ba581956ada97a 560w, https://mintcdn.com/admina-sbn/ibHAD7VhlI5mZAsA/images/integrations/yyed0q40i0/screenshot-2025-05-29-at-11-40-21.png?w=840&fit=max&auto=format&n=ibHAD7VhlI5mZAsA&q=85&s=fe10fe68831e80a1a230377fbaf1d645 840w, https://mintcdn.com/admina-sbn/ibHAD7VhlI5mZAsA/images/integrations/yyed0q40i0/screenshot-2025-05-29-at-11-40-21.png?w=1100&fit=max&auto=format&n=ibHAD7VhlI5mZAsA&q=85&s=64780fee033196e1725896466cbc4df3 1100w, https://mintcdn.com/admina-sbn/ibHAD7VhlI5mZAsA/images/integrations/yyed0q40i0/screenshot-2025-05-29-at-11-40-21.png?w=1650&fit=max&auto=format&n=ibHAD7VhlI5mZAsA&q=85&s=f165d7c145ad52a3c4d4fc5a67590bb0 1650w, https://mintcdn.com/admina-sbn/ibHAD7VhlI5mZAsA/images/integrations/yyed0q40i0/screenshot-2025-05-29-at-11-40-21.png?w=2500&fit=max&auto=format&n=ibHAD7VhlI5mZAsA&q=85&s=c812f3eabb69455839a91133d7f85d7f 2500w" />

Click **the plus sign** in the top right to add a new API key.

<img src="https://mintcdn.com/admina-sbn/ibHAD7VhlI5mZAsA/images/integrations/yyed0q40i0/screenshot-2025-05-29-at-11-41-13.png?fit=max&auto=format&n=ibHAD7VhlI5mZAsA&q=85&s=012fe069a9d0cb867601d96ed8c202ec" alt="Add API Key button" width="3226" height="1006" data-path="images/integrations/yyed0q40i0/screenshot-2025-05-29-at-11-41-13.png" />

Then, in the "**API Key Name**" field, enter the name of your new API key.

In the "**Key Scope**" list, check **Admin** > **Users・Roles**.

<img src="https://mintcdn.com/admina-sbn/ibHAD7VhlI5mZAsA/images/integrations/yyed0q40i0/screenshot-2025-05-29-at-11-41-53.png?fit=max&auto=format&n=ibHAD7VhlI5mZAsA&q=85&s=2d1b1ad3b976bec15a288e69c09c01f1" alt="Key Scope settings" width="1162" height="1090" data-path="images/integrations/yyed0q40i0/screenshot-2025-05-29-at-11-41-53.png" />

By default, **Admin/Users** is set to "**Read-Only**".

Change this to "**Read/Write**".

<img src="https://mintcdn.com/admina-sbn/ibHAD7VhlI5mZAsA/images/integrations/yyed0q40i0/screenshot-2025-05-29-at-11-42-55.png?fit=max&auto=format&n=ibHAD7VhlI5mZAsA&q=85&s=b50a900cfc3b141900ca64c79a16ade2" alt="Change to Read/Write" width="2358" height="670" data-path="images/integrations/yyed0q40i0/screenshot-2025-05-29-at-11-42-55.png" />

Click "**CREATE KEY**" at the bottom of the page.

<img src="https://mintcdn.com/admina-sbn/ibHAD7VhlI5mZAsA/images/integrations/yyed0q40i0/screenshot-2025-05-29-at-11-43-38.png?fit=max&auto=format&n=ibHAD7VhlI5mZAsA&q=85&s=f484277be069ad9a6432dfcb80745565" alt="CREATE KEY button" width="2370" height="1022" data-path="images/integrations/yyed0q40i0/screenshot-2025-05-29-at-11-43-38.png" />

Copy the displayed **API Key** and **Key Secret**.

**The API Key** is **your client ID** and **the Key Secret** is **your client secret**.

<Info>
  Your key secret will only be displayed to you once, so be sure to keep it safe as you won't be able to view it again once you leave the page.
</Info>

<img src="https://mintcdn.com/admina-sbn/ibHAD7VhlI5mZAsA/images/integrations/yyed0q40i0/screenshot-2025-05-29-at-11-44-04.png?fit=max&auto=format&n=ibHAD7VhlI5mZAsA&q=85&s=b4d06791b8069f12076eedc73f84238f" alt="API Key and Key Secret display" width="1892" height="362" data-path="images/integrations/yyed0q40i0/screenshot-2025-05-29-at-11-44-04.png" />

## Setting up the Integration

In Admina, search for **Cisco Umbrella**.

Enter the workspace name, **Client ID** (API Key) **and Client Secret** (Key Secret) obtained in the previous step, and click **Connect**.

<img src="https://mintcdn.com/admina-sbn/ibHAD7VhlI5mZAsA/images/integrations/yyed0q40i0/2025-06-02-165331.png?fit=max&auto=format&n=ibHAD7VhlI5mZAsA&q=85&s=89ab4c138dc64fb0cb29bf78e526312a" alt="Admina integration screen" width="475" height="593" data-path="images/integrations/yyed0q40i0/2025-06-02-165331.png" />

If the connection is successful, the registered user information will be displayed in the account list.

If it doesn't complete successfully, **edit it** from the Status tab on the Integration screen and try the integration again.

If the issue is not resolved, please contact us via chat.
