The isp-deployment Developer Hub

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

Get Started    

Navigate the ISP Console

The ISP console includes the following components: Centralized Reports, Centralized Settings, Customer Management, and ISP Settings.


The ISP console also includes enhanced search capabilities that allow you to search for customers and select the orgs that you manage. The search box includes a type-ahead feature that automatically suggests results based on the letter typed.


When you click a name, you are taken to that organization's Umbrella dashboard, which opens in a new tab.

Centralized Reports

Centralized Reports give you a single-pane-of-glass view of your entire customer base. You use these reports to monitor your deployment, quickly assessing its health and identifying any issues that require your immediate attention. These top level reports enable you to assess and prioritize customers, allowing you to drill down to those that require your immediate attention, whether that means changing policies, remediating infected workstations, changing networks, or redeploying software. These reports are designed to give you a sense of the overall protection level and deployment status for all of your customers.


The available centralized reports are:

  • Overview—Gives you a quick snapshot of two key features for all your customers: Activity Volume, and Deployment and Health Status.
  • Deployment Status—Gives you an overview of the total number of networks, Umbrella roaming clients, and VAs for your customer base.
  • Security Summary—Gives you an overview of traffic and security events for all of your customers.
  • Cloud Services—This report shows you the use of cloud-based SaaS services across your customer base by matching their DNS traffic to the Umbrella list of known cloud services. This helps you deal with possible shadow IT, the introduction of security threats through the use of non-approved tools and possibly even the opportunity to sell a solution to meet the needs of users of this cloud service.


At the top of the Centralized Reports > Service Status page is the Notifications area. Any notifications from Umbrella, including new feature announcements or information about scheduled maintenance, appear here.

  1. If closed, click the Expand icon to open the Message Center.

Centralized Settings

Centralized Settings are policy settings shared among multiple customers. These settings include Destination Lists, Block Pages, Content Settings, Security Settings, and Custom Integrations.


To learn more about how to configure these settings, go to ISP Centralized Settings.

Customer Management

The Customer Management page allows you to provision new customers, make changes to existing customers and gain an overview of all your customers.


This overview includes the number of seats you've purchased and the total number of customers.


Click the *Download CSV icon to export commonly required information about your customers to a .CSV formatted file. This information includes the fingerprint and orgID, as well as the commands you'll need to install the Umbrella roaming client.




You can limit the number of customers you view to only those you want to see by typing in the Search for Customers box.

Umbrella Roaming Client Parameters

Below Centralized Settings is the Deployment Parameters area, which provides you with the information you need to deploy the Umbrella roaming client. The values for Org ID, Fingerprint, and User ID are the ones you'll pass to the installer when deploying the Umbrella roaming client en masse. Instructions for common RMM, including scripts, are linked as a resource.

ISP Settings


Under ISP Settings, an administrator has access to the following:

  • Admins—Allows you to add a new administrator to Umbrella for ISPs. An administrator created in Umbrella for ISPs has full administrator level control to all customer organizations. If you would like to limit the new administrator to a single org, we recommend that you go into the individual customer organization and create a new login that is limited to just that org. This might be used if an end-customer wants access to their reporting data. You can also enable two-step verification for your administrative accounts. See also, Delegated Administration.
  • Audit Log—Records changes made by administrators to ISP console settings. This log works in the same fashion as the Admin Audit Log for an individual organization but is specific to Umbrella for ISPs. An administrator sees entries related to events generated within Umbrella for ISPs. A typical action recorded would be the addition or deletion of an organization or seats assigned to an organization.
  • Billing—Allows you to update your billing contact information. You can only have one contact listed here. The initial contact is created when your account is first provisioned by Cisco. Once provisioned, you can change this information at any time. For Country, you can find your two letter country code here.
  • Dashboard Co-branding—Allows you to add a graphic—such as a company logo—to your dashboard. For more information on how to do this, read Umbrella for MSPs Console Co-Branding.
    Note: You can only run a single integration at a time.

Delegated Administration

Within the ISP Settings > Admins section of Umbrella for ISPs, Delegated Admin is a feature that allows the Umbrella for ISPs administrator to assign one of five roles to other people within the ISP's organization. These roles can give the assignee the ability to manage customers, but be denied total access to Umbrella for ISPs, or be given permission to provision new software, but be denied the right to make changes, or be given permissions to update centralized settings, but be restricted from other configurations.

It’s also possible to create a “Read Only” user for Umbrella for ISPs who has full administrative access to one or more of your customer’s dashboards. In that way, responsibility for handling individual customers can be passed to an ISP user that otherwise has limited access to the console.

Welcome to Cisco Umbrella for ISPs < Navigate the ISP Console > Add a New Customer

Updated 4 years ago

Navigate the ISP Console

Suggested Edits are limited on API Reference Pages

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