Guides
ProductDeveloper
Guides

Workspace ONE Registration

By downloading an XML file from Umbrella, optionally updating it, and then pasting part of its contents into your Workspace ONE system, Workspace ONE is able to push configuration information to both the Cisco Security Connector (CSC) and Umbrella so that your iOS device is registered with Umbrella. The result is that your iOS device is protected by Umbrella.

For information about configuring Workspace ONE, see Workspace ONE’s documentation.

👍

Version Information

Umbrella supports Workspace ONE Mobility Management On-Prem and Cloud versions 9.2 or higher. Workspace ONE was previously known as AirWatch.

Table of Contents

Anonymization

Umbrella provides you with the option of anonymizing mobile devices for reporting and administration purposes. When you anonymize a mobile device, its label is hidden and replaced by your device's serial number. The label name is anonymized in both the Umbrella dashboard and in the CSC app UI. For information about how to anonymize your device, see Anonymize Devices.

Prerequisites

  • The Cisco Security Connector requirements.
  • Workspace ONE Mobility Management On-Prem and Cloud versions 9.2 or higher.
  • You must first configure your Workspace ONE MDM system. Configure Workspace ONE as required so that it is able to push configuration information to both CSC and Umbrella. For information about configuring Workspace ONE, see Workspace ONE documentation. For support, contact Workspace ONE support.

Procedure

Note: You must log into your Umbrella dashboard as an administrator.

Step 1: Add an Organization Administrator’s Email Address

The administrator email address is the email address that your end-user can use to send diagnostic reports from the app by clicking the I (vertical line) icon from within the iOS device. These reports can then be passed onto Cisco support. Once set, this email address is automatically added when managing an MDM.

  1. Navigate to Deployments > Core Identities > Mobile Devices and click Settings.
948
  1. In Mobile Device Settings, add an email address, select operation mode (fail open or fail closed), select a notifications level (Protection failure notifications only or notify on all state changes), choose a device identification method, and click Save.
404

Step 2: Add a Mobile Device

  1. In Umbrella, navigate to Deployments > Core Identities > Mobile Devices and click Manage.
948
  1. Under Deployment Type, click the Managed by MDM radio button, and then click Next.
999
  1. In the Managed Mobile Clients modal, click iOS.
634
  1. Under Workspace ONE, click Download MobileConfig.
634
  1. In the opened dialog, click Download.
    This email address is where diagnostic reports are sent when a user clicks the I (vertical line) icon from within the iOS device. Once set, this email address is automatically added when managing an MDM.
580
  1. In your new profile, applied for the CSC group, choose Custom Settings and then Configure. Paste the XML from the dashboard download (above) here. It should start and end with <dict> and </dict>.
    If successful, your mobile device registers with Umbrella and is listed at Deployments > Core Identities > Manage MDMs. CSC on your mobile device updates to connect to Umbrella so that your iOS device is protected by Umbrella.

We recommend also deploying the Umbrella Root CA under the Certificates payload of your Workspace One profile. The Root CA will allow HTTPS blocked and proxied pages to be certificate error-free.

1399

If you have anonymized your device (see Anonymize Devices) Umbrella hides the device's true label name by replacing it with the device's serial number. Existing active devices anonymize with 24 hours. New devices anonymize immediately.

910

As no changes can be made in Umbrella to the actual provisioned device, these mobile devices are simply listed in Umbrella as identities; however, you can now use Umbrella to apply policies to these mobile device identities. For more information, see Apply Umbrella Policies.

Verify Umbrella on Your iOS Device

  1. In the CSC app, tap the Status icon and confirm that it shows Protected by Umbrella.
  2. For protection details, tap Protected by Umbrella.

Install Umbrella Root Certificate

To apply the policy to your mobile device, you must install the Umbrella Root Certificate Authority (CA) certificate on the mobile device. Download the Umbrella Root CA certificate from the DNS policy or from Deployments > Configuration > Root Certificate.


MobileIron Configuration < Workspace ONE Registration > Generic MDM System Registration