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    

Jamf Registration

By downloading an XML file from Umbrella, optionally updating it, and then pasting part of its contents into your Jamf system, Jamf 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 Jamf, see Jamf's documentation.

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
  • Jamf Pro 10.2.0 or higher.
    Note: For Jamf Schools, see CSC and Additional MDMs.
  • You must first configure your Jamf MDM system. Configure Jamf as required so that it is able to push configuration information to both CSC and Umbrella. For information about configuring Jamf, see Jamf documentation. For support, contact Jamf support.

Register Your iOS Device

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

  1. In Umbrella, navigate to Deployments > Core Identities > Mobile Devices and click Manage MDMs.
  1. Under Jamf, click Download MobileConfig.
  1. Add an email address to generate problem reports and click Download.
    This email address is where diagnostic reports are sent when a user clicks the I icon from within the iOS device. Once set, this email address is automatically added when managing an MDM.
  1. Copy and paste the XML code between the <!-- Jamf... --> comments into your MDM profile.
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
    <dict>
        <key>PayloadContent</key>
        <array>
<!-- Jamf - copy from here to paste into the Jamf UI to provision a DNS proxy -->
    <dict>
              
 .....                      

    </dict>
<!-- Jamf - end copy -->
  1. In your new profile, applied for the CSC group, choose Custom Settings and then Configure. Paste the edited XML here.
    If successful, your mobile device registers with Umbrella and is listed at Deployments > Core Identities > Mobile Devices. CSC on your mobile device updates to connect to Umbrella so that your iOS device is protected by Umbrella.

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.

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.

Updated about a month ago

Jamf Registration


Suggested Edits are limited on API Reference Pages

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