Cisco Umbrella
  • 2 Minutes To Read
  • Print
  • Share
  • Dark
    Light

Cisco Umbrella

  • Print
  • Share
  • Dark
    Light

Cisco Umbrella is a secure internet gateway in the cloud, including DNS and IP layer enforcement and command and control callback blocking.

Types of Assets Fetched

This adapter fetches the following types of assets:

  • Devices

Parameters

  1. Cisco Umbrella Domain (required, default: https://management.api.umbrella.com) - The hostname or IP address of the Cisco Umbrella server.
  2. Network API Key and Network API Secret (required) - The API Key and API Secret for the Umbrella Network Devices API. For details on generating the API Key and the API Secret, see Cisco Umbrella - Network Devices API.
  3. Management API Key and Management API Secret (required) - The API Key and API Secret for the Umbrella Management API. For details on generating the API Key and the API Secret, see Cisco Umbrella - Management API.
  4. mspID (optional, defualt: empty) - The managed service provider ID. It is required if you are using Cisco Umbrella for MSPs.
  5. Verify SSL (required, default: False) - Verify the SSL certificate offered by the value supplied in Cisco Umbrella Domain. For more details, see SSL Trust & CA Settings.
    • If enabled, the SSL certificate offered by the value supplied in Cisco Umbrella Domain will be verified against the CA database inside of Axonius. If the SSL certificate can not be validated against the CA database inside of Axonius, the connection will fail with an error.
    • If disabled, the SSL certificate offered by the value supplied in Cisco Umbrella Domain will not be verified against the CA database inside of Axonius.
  6. HTTPS Proxy (optional, default: empty) - A proxy to use when connecting to the value supplied in Cisco Umbrella Domain.
    • If supplied, Axonius will utilize the proxy when connecting to the value supplied in Cisco Umbrella Domain.
    • If not supplied, Axonius will connect directly to the value supplied in Cisco Umbrella Domain.
  7. For details on the common adapter connection parameters and buttons, see Adding a New Adapter Connection.

image.png

APIs

Axonius is using the following Cisco Umbrella APIs:

  • Umbrella Network Devices API - Allows you to register network devices as identities to the Umbrella dashboard. Once the device is registered as an identity, you can use the API to add and remove the device from configured policies. Once registered, the device is automatically added to the default policy. You can also remove a policy from being applied to a device, with the exception of the default policy, which cannot be removed.
  • Umbrella Management API - Enables direct customers, SPs, MSPs, and MSSPs to manage organizations, networks, network devices, users, and roaming computers, and integrate actions in those areas into your workflows.
Was This Article Helpful?