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 explain 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 within [ProductName].

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

The Token Based authentication method is required.

Required Cisco Umbrella Credentials

The following credentials are required:

• 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 more information, 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