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 network identities with policies.

How Does the Integration Work

This integration pulls network device and roaming computer objects from Cisco Umbrella.

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

Choose a Schema: A schema is a configuration template that defines a specific way to connect, authenticate, and interact with a source. The following are the available schemas
- Single Org: fetches all devices associated with specified customer ID
- MSP: fetches devices from all Org IDs
Configure plugin: Configure the Cisco Umbrella

Single Org

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

Add an Integration: Select the integration(s) you'd like to add.

Collect Devices

Field	Description	Example
`Customer ID`	Optional customer id	`abcD-EF12-3456`

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 Umbrella API Authentication - Generate an API Key to generate an API Key.

Ensure the API key created is a Legacy Management API Key.

Required Permissions

Sevco requires read only access to view network devices and roaming computers.

API Documentation

Cisco Umbrella Network Devices API

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.

Tags: cloud