Cisco Umbrella

Cisco Umbrella is cloud-delivered enterprise network security that provides users with a first line of defense against cyber security threats.

The following sections provide prerequisites, resources, and instructions for integrating with SaaS Management.

Stored Information for Cisco Umbrella
Required Minimum Permissions for Cisco Umbrella
Cisco Umbrella Authentication Method
Required Cisco Umbrella Credentials
Integrating Cisco Umbrella With SaaS Management
Cisco Umbrella API Endpoint

Stored Information for Cisco Umbrella

The following table describes the available integration tasks and stored data.

Available Integration Tasks

Information Stored

Application Roster

User ID
Email
First Name
Last Name

Application Access

User ID
Last Login

Note:The information stored is subject to change as enhancements are made to the SaaS application.

Required Minimum Permissions for Cisco Umbrella

Full Admin user role is required to generate API keys.

Cisco Umbrella Authentication Method

Token Based

Required Cisco Umbrella Credentials

API Key
API Secret

Integrating Cisco Umbrella With SaaS Management

To integrate Cisco Umbrella with SaaS Management, perform the following tasks.

Generating an Umbrella API Key and Secret
Integrating Cisco Umbrella With SaaS Management

Generating an Umbrella API Key and Secret

You need to generate an Umbrella API key and secret before Integrating Cisco Umbrella With SaaS Management.

For more information on generating an Umbrella API key and secret, see the Cisco Umbrella API documentation topic: Create Umbrella API Key.

To generate an Umbrella API Key and Secret:

1. Sign in to the Cisco Umbrella console with the user having administrator-level access.
2. Go to Admin > API Keys > API Keys.
3. On the top right corner of the UI, click the Add button.
4. Enter a name for the key.
5. Under Key scopes, check the Admin box to give full admin permission.
6. Click Create Key to generate a new API Key and API Secret.
7. Copy and paste the API Key and API Secret values to a file. You will need these values when Integrating Cisco Umbrella With SaaS Management.

Integrating Cisco Umbrella With SaaS Management

Complete the following steps to integrate Cisco Umbrella with SaaS Management.

To integrate Cisco Umbrella with SaaS Management:

1. Complete the prerequisite steps in Generating an Umbrella API Key and Secret
2. Add the Cisco Umbrella application in SaaS Management. For details, see Adding an Application.
3. Copy and paste the following Cisco Umbrella information into SaaS Management:
API Key  
API Secret 
4. Click Authorize.

Cisco Umbrella API Endpoint

Application Roster and Application Access

https://api.umbrella.com/admin/v2/users