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
Name: Required
Description: Optional
Scroll down and select
Edit as JSONand 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
Domainsfield, enterapi.umbrella.comto 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
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