Cisco Umbrella V2

Version: 1.4
Updated: April 27, 2026

Cisco Umbrella is cloud-delivered enterprise network security which provides users with defense against cybersecurity threats.

Actions

• List Destination Lists (Enrichment) - Get the Destination Lists.
• Create Destination List (Containment) - Create a Destination List.
• List Users (Enrichment) - List the users in the organization.

Configure Cisco Umbrella V2 in Automation Service and Cloud SOAR

Before you can use this automation integration, you must configure its authentication settings so that the product you're integrating with can communicate with Sumo Logic. For general guidance, see Configure Authentication for Automation Integrations.

How to open the integration's configuration dialog

1. Access App Central and install the integration. (You can configure at installation, or after installation with the following steps.)
2. Go to the Integrations page.
   Classic UI. In the main Sumo Logic menu, select Automation and then select Integrations in the left nav bar.
   New UI. In the main Sumo Logic menu, select Automation > Integrations. You can also click the Go To... menu at the top of the screen and select Integrations.
3. Select the installed integration.
4. Hover over the resource name and click the Edit button that appears.
   

In the configuration dialog, enter information from the product you're integrating with. When done, click TEST to test the configuration, and click SAVE to save the configuration:

• Label. Enter the name you want to use for the resource.

• API URL. Enter the the API URL for your Cisco Umbrella V2 instance, for example, https://api.umbrella.com

• API Key. Enter an API key for Cisco Umbrella V2.

• API Secret. Enter the secret for the API key.

• Connection Timeout (s). Set the maximum amount of time the integration will wait for a server's response before terminating the connection. Enter the connection timeout time in seconds (for example, 180).

• Verify Server Certificate. Select to validate the server’s SSL certificate.

• Automation Engine. Select Cloud execution for this certified integration. Select a bridge option only for a custom integration. See Cloud or Bridge execution.

• Proxy Options. Select whether to use a proxy. (Applies only if the automation engine uses a bridge instead of cloud execution.)

  • Use no proxy. Communication runs on the bridge and does not use a proxy.
  • Use default proxy. Use the default proxy for the bridge set up as described in Using a proxy.
  • Use different proxy. Use your own proxy service. Provide the proxy URL and port number.

For information about Cisco Umbrella, see Cisco Umbrella documentation.

Change Log

Version	Date	Description
v1.4	April 27, 2026	Upgraded the python3_generic Docker image (Python 3.8) to python3_12_generic (Python 3.12) to address Python 3.8 end-of-life and improve security and performance.
v1.3	July 3, 2023	Removed leading and trailing spaces.
v1.2	May 18, 2023	Renamed the integration from Cisco Umbrella OIF to Cisco Umbrella V2.
v1.1	January 26, 2023	Refactored the integration.
	September 25, 2019	Initial release of the Cisco Umbrella V2 integration.