The Umbrella Deployment Documentation Developer Hub

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

Get Started    

Welcome to Cisco Umbrella

Umbrella SIG Documentation

Looking for Umbrella SIG documentation? You'll find it here: Welcome to Cisco Umbrella SIG.

Cisco Umbrella is a cloud-based security platform that provides you with multiple levels of defense against internet-based threats and enables you to extend protection from your network to branch offices to roaming users. Umbrella integrates secure web gateway, firewall, DNS-layer security, and cloud access security broker (CASB) functionality for the most effective protection against threats. The quickest way to get started is to open your favorite browser, log into your Umbrella dashboard at, add a network identity, and then point your DNS to Umbrella.

Umbrella Packages

Not all features described here are available to all Umbrella packages. For example, the intelligent proxy is not available to all packages. Throughout this documentation, we highlight where features differ between packages and point out when a feature is only available to a specific package. If you encounter a feature described here that you do not have access to, contact your sales representative for more information about your current package. See also, Cisco Umbrella Packages.

Get Started — Add an Identity and Protect Your Systems

An identity is an entity that you can enforce policy against and report on. It can be very high level—an entire network can be an identity—or very granular—down to the individual logged in Active Directory user.

The two kinds of identities that most people configure first are either networks or roaming computers.

To add your first identity, see Add Network Identity.

After you've added an identity, the next step is to get your network setup to use Umbrella's recursive DNS service. You need to explicitly point the DNS settings in your operating system or hardware firewall/router to Umbrella's name server IP addresses and turn off the automatic DNS servers provided by your ISP. Umbrella supports both IPv4 and IPv6 addresses. For more information, see Point Your DNS to Cisco Umbrella.

And finally, once you are pointing your system to Umbrella, add policies to Umbrella so that you can take full advantage of its many advanced features. For more information, see Manage Policies.

Welcome to Cisco Umbrella > Manage Identities

Welcome to Cisco Umbrella

Suggested Edits are limited on API Reference Pages

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