The Umbrella Documentation Hub

Welcome to the Umbrella documentation hub. Here you'll find access to all of our Cisco Umbrella user guides.

Get Started    

Before You Begin

  1. Roaming Client and AnyConnect Roaming Security Module Incompatibility
  2. Obtain an Umbrella Account
  3. Download the Roaming Security Module Profile File from the Umbrella dashboard

Roaming Client and AnyConnect Roaming Security Module Incompatibility

The Umbrella Roaming Security module and the Umbrella roaming client are incompatible. If you are deploying the Umbrella Roaming Security module, any existing installation of the Umbrella roaming client will be detected and removed automatically during installation of the Roaming Security module. Ensure that automated delivery of the standalone roaming client is disabled to prevent it from being placed back.

Existing roaming client installations will be automatically migrated to the Umbrella Roaming Security module unless an OrgInfo.json file is co-located with the AnyConnect installer, configured for web-deployment or pre-deployed in the Umbrella module's directory. You may also wish to manually uninstall the Umbrella roaming client prior to deploying the Umbrella Roaming Security module; however, this is not required.

Any automated push to re-install the standalone roaming client must be stopped, or an exception added for computers with the roaming module installed. The presence of both the roaming client and the roaming module may lead to unintended behavior.

Obtain an Umbrella Account

The Umbrella dashboard is where you obtain the profile (OrgInfo.json) for the AnyConnect Umbrella Roaming Security module to include in your deployment. From the Umbrella dashboard, you also manage policy and activity reporting for the roaming client. If you need assistance signing into Umbrella, contact your Cisco account representative.

What AnyConnect file do I need to use to deploy?

Note, additional operating system packages may be available and required. This guide specifies Windows and MacOS packages which support the roaming module.

If you're deploying from an ASA deploy:

  • Full installation package—Windows / Head-end deployment (PKG)
  • Full installation package—Mac OS X / Head-end deployment (PKG)

If you're deploying manually for testing:

  • Full installation package—Mac OS X / Standalone installer (DMG)
  • Full installation package—Window / Standalone installer (ZIP or MSI). Includes installation packages for DART, NAM, Core/VPN, Phone Home, Hostscan, ISE Posture, and WebSecurity components.

Download the AnyConnect Roaming Security Profile from the Umbrella Dashboard

The OrgInfo.json file contains specific information about your Umbrella organization that lets the Roaming Security module know where to report and which policies to enforce.

To prepare for deploying the Umbrella Roaming Security module, you must obtain the OrgInfo.json file from the Umbrella dashboard.

  1. Navigate to Deployments > Core Identities > Roaming Computers and click Roaming Client.
  1. Under AnyConnect Umbrella Roaming Security Module, click Download Module Profile to download the OrgInfo.json file.

For specific installation/deployment steps and package and file specifics, see the Cisco AnyConnect Secure Mobility Client Administrator Guide.

Important

When you deploy the OrgInfo.json file for the first time, it is copied to the data subdirectory (/umbrella/data), where several other registration files are also created. Therefore, if you need to deploy a replacement OrgInfo.json file, the data subdirectory must be deleted. Alternatively, you can uninstall the Umbrella Roaming Security module (which deletes the data subdirectory) and reinstall with the new OrgInfo.json file.

The OrgInfo.json is specific information about your Umbrella dashboard instance that lets the Roaming Security module know where to report to and which policies to enforce. If you use another OrgInfo.json file from a different dashboard to install the Roaming Security module, the client computer will appear in that dashboard instead.


Prerequisites < Before You Begin > Get the Roaming Security Module Up and Running

Updated 2 months ago

Before You Begin


Suggested Edits are limited on API Reference Pages

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