The deployment-mssp Developer Hub

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

Get Started    

Navigate the MSSP Console

The Umbrella for MSSPs console includes the following components to manage customers:

Centralized Reports

Centralized Reports give you a single-pane-of-glass view of your entire customer base. You can quickly assess the health of your deployment, view security activity volumes, and identify any issues that require your immediate attention. These top-level reports help to assess and prioritize customers, allows 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 your customers. For more information, see Monitor Customers Through Centralized Reports.

The available centralized reports are:

  • Overview Report—Gives you a quick snapshot of two key features for all your customers: Activity Volume, and Deployment and Health Status.
  • Deployment Status Report—Gives you an overview of the total number of networks, Umbrella roaming clients, and VAs for your customer base.
  • Security Summary Report—Gives you an overview of traffic and security events for all your customers.


At the top of the Overview, Deployment Status, and Security Summary reports you'll find the Notifications area. Any notifications from Umbrella, including new feature announcements or information about scheduled maintenance, appear here.

  1. Navigate to Centralized Reports > Overview.
  2. Click the Expand icon to open the Message Center.

Centralized Settings

Centralized Settings are policy settings that are shared with your customers' and trials' Umbrella dashboards. These settings include Destination Lists, Block Pages, Content Settings, Security Settings, Custom Integrations, and Advanced Settings. For more information, see Centralized Settings.

Customer Management

Customer Management is where you manage your customers and trials. You can add new customer accounts, start and change trials, make changes to customer settings, and access customer and trial Umbrella dashboards. For more information, see:

  1. Click Trials or Customers to toggle between the Customer Management page and the Trial Management page.
  2. Click Start a New Account to add a new customer or start a trial—depending on license used. For more information, see Manage Licensing.


The Customer Management overview lets you quickly access customer information and customer Umbrella dashboards. Information listed includes:

  • Total Seats—The combined total number of seats currently in use for all customer accounts.
  • MSLA Volume—The total number of Managed Services License Agreements (MSLAs) currently in use.
  • Total Customers—The total number of customer accounts managed by this MSSP console. This includes accounts that have expired.

Note: The option to use MSLA licensing is only available when requested from your Cisco Sales Representative. For more information on how to use MSLA licensing, see the MSLA Ordering Guide.

  1. Navigate to Customer Management.
  2. Expand a customer to go to the Customer Management page for that customer.
  3. Click View Dashboard to go to the customer's Umbrella dashboard.


The Trial Management overview lets you quickly access trial information, trial Umbrella dashboards and start new trials. Information listed includes:

  • Total Seats—The combined total number of seats currently in use for all trials.
  • MSLA Volume—The total number of Managed Services License Agreements (MSLAs) currently in use.
  • Total Trials—The total number of trials accounts managed by this MSSP console. This includes trials that have expired.
  1. Navigate to Customer Management and click Trials.
  2. Expand a trial to go to the Trial Management page for that customer.
  3. Click View Dashboard to go to the trial's Umbrella dashboard.

Download Customer and Trial Information

Click the Download CVS 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 quickly filter both the Customers and Trials Management page to view only Active or Expired customers and trials.

  1. Click Filters and then Active or Expired.
    The page updates to list on active or expired customers or trials.

You can also sort customers and trials.

  1. Click Sort by and select a sorting option and then select Ascending or Descending.

Searching for Customers and Trials

Use the MSSP console's search capabilities to find customers and trials. The search bar starts listing customers and trials as soon as you enter a letter. Clicking a customer or trial takes you to that customer or trial's Umbrella dashboard.


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

MSSP Settings

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

  • Admins—Allows you to add a new MSSP staff administrator to Umbrella for MSSPs. An administrator created in Umbrella for MSSPs has full administrator level control to all customer Umbrella dashboards. If you would like to limit the new administrator to a single customer Umbrella dashboard, we recommend that you access the customer's Umbrella dashboard and create a new login that is limited to just that Umbrella dashboard. 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 MSSP console settings. This log works in the same fashion as the Admin Audit Log for a customer's Umbrella dashboard but is specific to Umbrella for MSSPs. An MSSP administrator sees entries related to events generated within Umbrella for MSSPs. A typical action recorded would be the addition or deletion of a customer or seats assigned to a customer.
  • Contacts—Allows you to update your billing and support contact information. You can only have one billing contact and one support contact. For support, if customers that have access to their organization's Umbrella dashboard submit a ticket, the email for the ticket goes to this contact. Umbrella dashboard customers do not have access to Cisco support. The initial billing and support contacts are created when your account is first provisioned by Cisco. Once provisioned, you can change this information at any time.
    Note: MSSPs provide first level support to their customers; however, the MSSP can contact Cisco support for assistance. Email [email protected] or click the Support link in the MSSP console.
  • Dashboard Co-branding—Allows you to add a graphic—such as a company logo—to your dashboard. For more information, see Add Your Logo to the MSSP Console .
  • API Keys—Allows you to create an API key that is used for authentication to the Console Reporting API. For more information, see About the API Endpoints for the Umbrella Console.
  • PSA Integration Details—Allows you to integrate a PSA with Umbrella for ticket creation and usage data. For more information, see Integrate a PSA.
    The MSSP console supports both Connectwise and AutoTask. For more information on ConnectWise PSA integration, see the Umbrella and ConnectWise PSA Integration Setup Guide. For more information about AutoTask PSA integration, see Autotask and Umbrella Integration.
  • Log Management—Allows you to store the DNS, URL and IP logs of your customers offline to an Amazon S3 bucket. After logs have been uploaded, they can be downloaded and kept for compliance reasons or security analysis. For more information, see Centralized Umbrella Log Management.
  • Purchasing—Allows you to select how you will procure licenses on behalf of your customer. How you create trials is dependent on your selection here. For more information, see Manage Licensing.

Welcome to Cisco Umbrella for MSSPs < Navigate the MSSP Console > Manage MSSP Trials

Updated 9 months ago

Navigate the MSSP Console

Suggested Edits are limited on API Reference Pages

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