Tines

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:

Login to your <a href="https://login.umbrella.com/" rel="nofollow noopener noreferrer" target="_blank">Cisco Umbrella</a> 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

1. Login to your <a href="https://login.umbrella.com/" rel="nofollow noopener noreferrer" target="_blank">Cisco Umbrella</a> 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):

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.

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.

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:

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 <code>Edit as JSON</code> 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" ] }

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 <code>Domains</code> field, enter <code>api.umbrella.com</code> 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 <code>Location of token from response</code>. This will be referenced each time an action is run in your workflows that calls this credential.

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

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 <code>Edit as JSON</code> 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" ] }
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 <code>Domains</code> field, enter <code>api.umbrella.com</code> 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 <code>Location of token from response</code>. 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 <a href="https://www.tines.com/docs/credentials/connect-flows/cisco-umbrella" rel="nofollow noopener noreferrer" target="_blank">here</a>.

For more on creating credentials in Tines, click <a href="https://explained.tines.com/en/articles/6877578-what-are-credentials-in-tines">here</a>.

You can find a selection of Cisco Umbrella stories in the <a href="https://www.tines.com/story-library?s=cisco+umbrella" rel="nofollow noopener noreferrer" target="_blank">story library</a>

First, get your Cisco Umbrella API Key

Then, create a Cisco Umbrella credential in Tines