Read Umbrella networks, roaming computers, sites, destination lists, DNS activity and domain categories and risk, and add or remove destinations in a list.
Explore 12 workflow actions for Cisco Umbrella, including account permissions and operation limits.
10 read actions2 write actions
WORKFLOW ACTIONS
What you can configure.
Choose an action in the workflow builder, connect an account, and map its inputs. These actions are available in the catalog; your account access and a successful test determine whether they work for your setup.
Add destinations
Write
Add up to 500 domains, URLs or IPs to a destination list, such as a block list (scope policies.destinations:write).
Permissions and limits
Account permissions
An Umbrella API key with the scope each step names
A repeated request may repeat the external action. Review the previous result before retrying a write.
Get destination list
Read
Read one destination list (scope policies.destinationLists:read).
Permissions and limits
Account permissions
An Umbrella API key with the scope each step names
Get domain categorization
Read
Read a domain's status and its content and security categories (scope investigate.investigate:read).
Permissions and limits
Account permissions
An Umbrella API key with the scope each step names
Get domain risk score
Read
Read a domain's risk score and indicators (scope investigate.investigate:read).
Permissions and limits
Account permissions
An Umbrella API key with the scope each step names
Get roaming computer
Read
Read one roaming computer (scope deployments.roamingcomputers:read).
Permissions and limits
Account permissions
An Umbrella API key with the scope each step names
List destination lists
Read
List allow and block destination lists (scope policies.destinationLists:read).
Permissions and limits
Account permissions
An Umbrella API key with the scope each step names
List destinations
Read
List the domains, URLs and IPs in a destination list (scope policies.destinations:read).
Permissions and limits
Account permissions
An Umbrella API key with the scope each step names
List DNS activity
Read
Read DNS activity over a time range, optionally by domain, verdict, identity or threat (scope reports.granularEvents:read).
Permissions and limits
Account permissions
An Umbrella API key with the scope each step names
List networks
Read
List the organization's networks (scope deployments.networks:read).
Permissions and limits
Account permissions
An Umbrella API key with the scope each step names
List roaming computers
Read
List roaming computers, optionally by name, DNS-layer status or last sync (scope deployments.roamingcomputers:read).
Permissions and limits
Account permissions
An Umbrella API key with the scope each step names
List sites
Read
List the organization's sites (scope deployments.sites:read).
Permissions and limits
Account permissions
An Umbrella API key with the scope each step names
Remove destinations
Write
Remove up to 500 destinations from a destination list by their IDs (scope policies.destinations:write).
Permissions and limits
Account permissions
An Umbrella API key with the scope each step names
A repeated request may repeat the external action. Review the previous result before retrying a write.
SETUP
Start with a controlled test.
01Connect the intended account
Use the account and permissions required for your process. Review the connection check before configuring a workflow action.
02Review inputs and access
Select a listed operation and map its required inputs. Use test records and add a human approval before writes that need review.
03Confirm the result
Inspect step outputs and confirm the result in Cisco Umbrella. A saved workflow is not a completed provider action.