Cisco Umbrella is a cloud security platform that provides the first line of defense against threats on the internet wherever users go. By learning from internet activity patterns, Umbrella automatically uncovers current and emerging threats.

Connect Cisco Umbrella with LogicHub

1. Navigate to Automations > Integrations.
2. Search for Cisco Umbrella.
3. Click Details, then the + icon. Enter the required information in the following fields.
   • Label: Enter a connection name.
   • Reference Values: Define variables here to templatize integration connections and actions. For example, you can use https://www.{{hostname}}.com where, hostname is a variable defined in this input. For more information on how to add data, see 'Add Data' Input Type for Integrations.
   • Verify SSL: Select option to verify connecting server's SSL certificate (Default is Verify SSL Certificate).
   • Remote Agent: Run this integration using the LogicHub Remote Agent.
   • Access Key: To access Cisco Umbrella REST API, provide a valid Access Key.
   • Secret Key: To access Cisco Umbrella REST API, provide a valid Secret Key.
4. After you've entered all the details, click Connect.

Actions for Cisco Umbrella

Retrieve Devices

Retrieves the list of Network Devices from Cisco Umbrella

Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

Output

JSON containing the following items:

{
  "error": null,
	"has_error": false,
  "result": {}
}

Get Domain Status

Look up the status, and security and content category IDs for the domain.

Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

Output

JSON containing the following items:

{
  "error": null,
	"has_error": false,
  "result": {}
}

Get Destination List

Retrieve all the Destination Lists.

Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

Output

JSON containing the following items:

{
  "error": null,
	"has_error": false,
  "result": {}
}

Add to Destination List

Add destinations to a destination list.

Input Field

Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection.

Output

JSON containing the following items:

{
  "status": {
    "code": 200,
    "text": "OK"
  },
  "data": {
    "id": 17165029,
    "organizationId": 2199035,
    "access": "block",
    "isGlobal": false,
    "name": "Test destination",
    "thirdpartyCategoryId": null,
    "createdAt": 1682697484,
    "modifiedAt": 1721125783,
    "isMspDefault": false,
    "markedForDeletion": false,
    "bundleTypeId": 2,
    "meta": {
      "destinationCount": 5
    }
  },
  "error": null,
  "has_error": false
}

Release Notes

• v1.0.3- Added a parameter Destination Value in the Add to Destination List action.
• v1.0.1 - Initial release.