The Umbrella User Guide Developer Hub

Welcome to the Umbrella User Guide developer hub. You'll find comprehensive guides and documentation to help you start working with Umbrella User Guide as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Virtual Appliances

When you are using virtual appliances (VAs) for Internal Network or Active Directory visibility and granularity, Cisco Umbrella roaming client behavior changes. VAs act as DNS forwarders and send all public DNS requests to Umbrella and forward internal DNS requests to the network's internal DNS servers.


If a computer running the Umbrella roaming client enters a network with VAs set in DHCP's DNS settings, the Umbrella roaming client does the following:

  • Disables itself. The Umbrella roaming client is running but enters a "standby" state.
  • The DNS servers revert to what is provided by the VAs.
  • Reporting in the Umbrella dashboard will show as the Internal Network IP or Active Directory identity of the user or computer and not as the Umbrella roaming client hostname.

Umbrella roaming client-specific policies will not be enforced until you roam onto a network without VAs.

This state is reflected in the Deployments > Core Identities > Roaming Computers page. A roaming computer protected by a VA is green and states that it is protected by a VA.

Updated 5 months ago

Virtual Appliances

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.