Overview

Cisco Umbrella offers flexible, cloud-delivered security. It combines multiple security functions into one solution, so you can extend data protection to devices, remote users, and distributed locations anywhere.

Available Integrations

Product(s)	Supported Asset Type(s)	Integration Type
Cisco Umbrella	Devices	Source

Why You Should Integrate

Integrating with Cisco Umbrella will provide visibility into your devices deployed with Cisco Umbrella. These fall into two categories:

Roaming Computers - Any device with the Cisco Umbrella Client installed
Network Devices - Any hardware device that can route DNS traffic to the Umbrella recursive DNS servers

How Does the Integration Work

This integration pulls all devices from the /networkdevices and /roamingcomputers endpoints from Cisco Umbrella's REST API.

This data is only used internally; we do not share it with any parties outside of Sevco. Refer to our privacy policy for details.

⚠️
Please review the configuration instructions in the section below before setting up permissions for apps.

Configuration

Configure the Access Schema

Field	Description	Example
`API Key`*	API Key retrieved from the Cisco Umbrella Server console	`vvw9z5sig3tt88igmrbeyepmqc3obe0k`
`Key Secret`*	Key Secret associated with the API Key	`stcs6zq025u40uhfl54dcd4yrqxp6krh`

Add an Integration: Select the integration(s) you'd like to add.
- Collect devices
Configure General Information: OPTIONAL: You can use the following fields to provide additional information about your configuration.

Field	Description	Example
`Name (optional)`	Uniquely identifiable attribute of the configuration to delineate other similar configurations with the existing organization.	`DMZ network`
`Contact Person (optional)`	A placeholder to input a name or email address of a contact associated with the integration.	`Jane Doe`
`Link to Console (optional)`	A placeholder to input a link to the console of the product Sevco is integrating with for quick reference and access when configuring or editing the integration.	`www.product.com/devices`
`Email me about frequent errors`	Select this toggle to receive an email whenever an Integration has a ≥30% error rate in a 24-hour period.	n/a

Activate Config: Select "Activate" to enable this configuration and begin pulling data.

External Documentation

Creating credentials

You'll be asked to provide source API access key that Sevco will use to connect to Cisco Umbrella. Follow the instructions in this guide to generate an API Key. Please note that Legacy API Keys are deprecated by Cisco and therefore no longer supported by Sevco.

Required Permissions

Sevco requires Read access on the following resources:

Deployments / Network Devices
Deployments / Roaming Computers

API Documentation

Cisco Umbrella API - Overview

Contact Us

If you're having problems configuring an Integration, or if you've found something wrong in this document, please email us at [email protected] or suggest edits directly by selecting the Suggest Edits link located in the upper right hand corner of the documentation.