Cisco Umbrella Authentication Guide

How to authenticate Cisco Umbrella for use with Tines

Daniel Stoeski avatar
Written by Daniel Stoeski
Updated over a week ago

Cisco Umbrella is cloud-delivered enterprise network security that provides users with a first line of defense against cybersecurity threats. Here's our guide for authenticating Cusco Umbrella for use with Tines:

First, get your Cisco Umbrella API Key

  1. Login to your Cisco Umbrella account. New users can "Sign-up" for a Cisco Umbrella account if they do not already have one.

  2. From the sidebar, click "Admin" and then "API Keys"

  3. From the top right-hand corner, click "Add"

  4. Fill in the required fields, click "Create Key" and then copy the API key and the Key Secret

Then, create a Cisco Umbrella credential in Tines

Cisco Umbrella connect flow (recommended):

  1. Login to your Tines tenant

  2. Navigate to the team that will be using the API and click "Credentials"

  3. Click "+ New Credential" and select "Cisco Umbrella" and follow the prompts to connect.

Manual credential creation

This method is not recommended as the Cisco Umbrella connect flow creates this credential with much less complexity. However, if you need to create this credential set manually, see the following steps below:

  1. Login to your Tines tenant

  2. Navigate to the team that will be using the API and click Credential

  3. Click + New Credential and select HTTP Request

  4. Input the values for the Cisco Umbrella credential

    1. Name: Required

    2. Description: Optional

  5. Scroll down and select Edit as JSON and copy the below payload in:

    "url": "",
    "content_type": "application/x-www-form-urlencoded",
    "method": "post",
    "payload": {
    "grant_type": "client_credentials"
    "basic_auth": [
  6. Select Done

  7. Scroll down to the section titled "Basic Auth" and replace "YOUR API KEY" with your API key.

  8. Scroll down past the "Basic Auth" section to the section titled "Secret" and paste in your API key secret. You'll note the "Basic Auth" section references this field, but you will paste in the secret in the "Secret" section to keep the key hidden.

  9. In the Domains field, enter to restrict this credential to only being used in requests to that domain.

  10. You're not done yet! Select Save for the Credential to save and re-open.

  11. Scroll down and select Run request. This will run the HTTP request and show the results in JSON. If you successfully configured your HTTP request credential correctly, you will see a 200 status returned.

  12. Copy the path to the access token by selecting the copy icon next to the key (see picture below) in the successfully run request and paste the value in the section Location of token from response. This will be referenced each time an action is run in your workflows that calls this credential.

  13. TTL: Set to 3500

  14. Select Save

  15. Optional

    1. Access: What other teams can also use the credential

Read about our connect flows here.

For more on creating credentials in Tines, click here.

You can find a selection of Cisco Umbrella stories in the story library

Did this answer your question?