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

Login to your Cisco Umbrella account. New users can "Sign-up" for a Cisco Umbrella account if they do not already have one.
From the sidebar, click "Admin" and then "API Keys"
From the top right-hand corner, click "Add"
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):

Login to your Tines tenant
Navigate to the team that will be using the API and click "Credentials"
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:

Login to your Tines tenant
Navigate to the team that will be using the API and click Credential
Click + New Credential and select HTTP Request
Input the values for the Cisco Umbrella credential
1. Name: Required
2. Description: Optional

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

{
  "url": "https://api.umbrella.com/auth/v2/token",
  "content_type": "application/x-www-form-urlencoded",
  "method": "post",
  "payload": {
    "grant_type": "client_credentials"
  },
  "basic_auth": [
    "YOUR API KEY",
    "=secret"
  ]
}

Select Done
Scroll down to the section titled "Basic Auth" and replace "YOUR API KEY" with your API key.
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.
In the Domains field, enter api.umbrella.com to restrict this credential to only being used in requests to that domain.
You're not done yet! Select Save for the Credential to save and re-open.
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.
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.
TTL: Set to 3500
Select Save
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

Exabeam Authentication Guide

Feedly Authentication Guide

ConductorOne Authentication Guide

ThreatQ Authentication Guide

Imperva WAF Authentication Guide