Cisco Umbrella

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 UmbrellaDevicesSource

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

  1. 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
  2. Configure plugin: Configure the Cisco Umbrella

Single Org

FieldDescriptionExample
Access Key*API Access Key retrieved from the Cisco Umbrella Server consoleABCDEF0123456789
Secret Key*Secret Key associated with the API Access Key***********************
  1. Add an Integration: Select the integration(s) you'd like to add.

Collect Devices

FieldDescriptionExample
Customer IDOptional customer idabcD-EF12-3456
  1. Configure General Information: OPTIONAL: You can use the following fields to provide additional information about your configuration.
FieldDescriptionExample
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 errorsSelect this toggle to receive an email whenever an Integration has a ≥30% error rate in a 24-hour period.n/a
  1. 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