Overview

Torii integrates with Cisco Umbrella and syncs:

• Torii supports syncing multiple Cisco Umbrella accounts.
• You can constantly be updated with application information from our Integrations Page >> Integration Capabilities button >> Integration Capabilities table

Requirements

• Make sure you have a Cisco Umbrella account and you must have Full Admin access.

Getting Cisco Umbrella API Key, Key Secret and Dashboard URL

• Create an API key
  1. Go to your Umbrella dashboard and sign in with your credentials.
  2. Click on Admin.
     
  3. Under the Admin menu, choose API Keys.
     
  4. On the API Keys tab, click Add.
  5. Enter a name for the key (for example, Torii).
  6. Under Key Scope, select Admin, check Users, and set it to Read-Only.
  7. Set Expiry Date to Never expire, or choose a date and renew the key before it expires.
  8. Click Create Key, then copy the API Key and Key Secret.

  Important
  The Key Secret is shown only once. Copy it before closing the window.

• Dashboard URL - you can find your account number in the Umbrella dashboard URL:

  https://dashboard.umbrella.com/o/<your_account_number>/

Connect Cisco Umbrella Integration

1. Go to the Integrations page and click on the Cisco Umbrella tile
   
2. Click Connect 
   

3. In the "Connect Cisco Umbrella" window, enter the API Key, Key Secret and Dashboard URL, then click Connect.
   
   

4. Once the integration is connected and synced, it will display a green checkbox.
   

Q&A

Q: I connected Cisco Umbrella with a legacy API key. Do I need to change anything?

A: No. Existing connections keep syncing as usual. If you reconnect the integration, create a new API key as described above, because legacy keys can no longer be used to connect.