Cisco Umbrella V2

Version: 1.3
Updated: Jul 03, 2023

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

• September 25, 2019 - First upload
• January, 26, 2023 - Integration refactored
• May 18, 2023 (v1.2)
  • The integration previously known as "CISCO Umbrella OIF" has been renamed to "Cisco Umbrella V2"
• July 3, 2023 (v1.3) - Removed leading/trailing spaces