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 is Cisco's cloud-based security platform providing you with the first line of defense against internet-based threats, protecting your users when they connect using any device, in any place, at any time. 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.

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 an Identity and Protect Your Network.

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.

However, some customers, especially those still evaluating Umbrella, may find it easier to protect a single computer with our roaming client. For more information about the roaming client, see the Roaming Client Setup Guide.

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.