Connect your own Cisco Umbrella/Secure Access (DNS/SIG/ZTNA) and/or Meraki (SD-WAN) organization to manage destination lists, policies, identities, ZTNA private resources, reporting, networks, appliance health, VPN topology and alerts from Imperal -- plus bulk operations and a tenant health audit. Uses your own Umbrella API key/secret and/or Meraki API key -- nothing is hosted or proxied by Imperal beyond the request itself. Note: Duo (MFA) is a separate product and out of scope for this first release.
Every capability exposed by Cisco Secure Access, metered per action and guarded by the two-step safety protocol.
connect_umbrellawriteConnect your Cisco Umbrella/Secure Access account by saving its API key and secret, after checking they actually work. Create one in Umbrella dashboard > Admin > API Keys.
connect_merakiwriteConnect your Cisco Meraki organization by saving its Dashboard API key, after checking it actually works. Create one in Meraki Dashboard > My profile > API access.
disconnect_ciscowriteDisconnect a Cisco Umbrella/Secure Access or Meraki connection: deletes the saved credentials. Nothing in Cisco itself is changed.
list_connectionsreadList the connected Cisco Umbrella/Secure Access and Meraki accounts.
list_destination_listsreadList Umbrella/Secure Access destination lists (domain allow/block lists).
get_destination_listreadRead one destination list in full.
create_destination_listwriteCreate a new destination list.
update_destination_listwriteUpdate an existing destination list's name.
delete_destination_listwritePermanently delete a destination list. Cannot be undone.
add_destination_list_entrywriteAdd domains/URLs/IPs to a destination list.
remove_destination_list_entrywriteRemove domains/URLs/IPs from a destination list.
list_policiesreadList Umbrella/Secure Access policies (destination-list + identity bindings).
get_policyreadRead one policy in full.
list_umbrella_networksreadList Umbrella network identities (fixed-IP sites).
list_roaming_computersreadList Umbrella roaming client computers.
list_virtual_appliancesreadList Umbrella Virtual Appliances.
list_meraki_organizationsreadList Meraki organizations visible to the connected API key.
list_meraki_networksreadList networks in the connected Meraki organization.
get_meraki_networkreadRead one Meraki network in full.
create_meraki_networkwriteCreate a new network in the connected Meraki organization.
update_meraki_networkwriteUpdate selected fields of an existing Meraki network. Only given fields change.
delete_meraki_networkwritePermanently delete a Meraki network. Cannot be undone.
list_uplink_statusesreadList SD-WAN uplink statuses for appliances in the connected Meraki organization.
list_vpn_topologyreadList Meraki VPN (AutoVPN) topology -- peer status between networks.
list_appliance_healthreadList Meraki MX appliance health/connectivity status across the connected organization.
reboot_appliancewriteReboot a Meraki MX appliance by serial number.
list_alertsreadList Meraki alerts across the organization, optionally filtered to one network.
create_alert_webhookwriteCreate a webhook receiver on a Meraki network so alerts push to an HTTPS URL.
bulk_update_destination_listswriteSet the same access value (allow/block) on several Umbrella destination lists in one call, by explicit ids. Continues past per-item failures and reports each outcome, same convention as every other bulk_* tool in the portfolio.
bulk_reboot_applianceswriteReboot several Meraki appliances in one call, by explicit serial numbers. Continues past per-item failures and reports each outcome.
audit_secure_accesswriteBuild one aggregated health report across the connected Cisco Umbrella/Secure Access and Meraki organization: unassigned destination lists, offline roaming computers, offline appliances, and recent alert volume -- the same 'audit_*' value-add pattern as every other connector in the portfolio.
More extensions in Security ready to enable in one click.
Enable Cisco Secure Access in your Imperal workspace in one click - 10,000 free starter credits included.