Generate an API key and secret

Generate a new API key and retrieve both the API Key and the corresponding Secret before you onboard an Umbrella organization to Security Cloud Control.

If you do not currently have an API key, use this procedure to create one.

Before you begin

The management API key from Umbrella is used for these Umbrella services.

You cannot onboard an Umbrella organization without allowing Security Cloud Control access to these services.

Procedure

Step 1

Access the Cisco Umbrella dashboard and log in to your organization.

Step 2

In the Umbrella dashboard, click Admin in the navigation pane and select API Keys.

Step 3

Click Create API Key.

If you already have an API key but do not have the secret saved, navigate to the Admin > API Keys screen and click Refresh to update the key and secret.

Step 4

To create a new API key and secret, click the add button.

Step 5

Enter a Name and add the scopes listed here to the API key:

  • Deployments

  • Policies

Step 6

Click Generate Key.

Step 7

Copy the API Key and the corresponding secret. Paste the information into a note or .txt file to store it temporarily until you are ready to use it.