Guides
ProductDeveloperPartnerPersonal
Guides

Deploy the Cisco Umbrella Chromebook Client

The Cisco Umbrella Chromebook client provides Umbrella's DNS layer protection to Chromebook users. This deployment results in your Chromebooks being listed as identities in a DNS policy. Your Chromebooks are immediately protected by the default DNS policy. At any time, you can add your own DNS policies and customize your Chromebooks' protections. For more information, see Add a Chromebook Specific DNS Policy.

Deploying the Cisco Umbrella Chromebook client is a multi-step process:

The JSON file downloaded from Umbrella during this procedure contains information required by the Cisco Umbrella Chromebook client so that it can operate with Umbrella. Information held within this file is required to access the Cisco Umbrella Chromebook client through Google's Chrome Web Store. During the deployment process, this file is uploaded to Google, which is then able to push the Cisco Umbrella Chromebook client to all of your Chromebooks. After the client is installed in a Chromebook, allow a few hours for Chromebook traffic to begin appearing in your Umbrella dashboard.

Prerequisites

  • A G Suite admin account is required. Integrating the G Suite Identity Service is optional. For more information, see Integrate the G Suite Identity Service.
  • Umbrella login credentials
  • Chromebooks with ChromeOS v55 or later
  • Chromebooks are not in Kiosk mode
  • Port 53 UDP accessible to 208.67.220.220 and 208.67.222.222
  • https://registration.polaris.qq.opendns.com is accessible
  • Chromebooks must be connected and logged in
  • Cisco Umbrella root certificate installed — To avoid certificate errors when accessing an Umbrella block page, you must install the Cisco Umbrella root certificate on your Chromebooks. See Install the Cisco Umbrella Root Certificate.
    For more information about how to push the Umbrella root certificate from Google's admin console to all of your Chromebook devices, see Set up TLS (or SSL) inspection on Chrome devices.
  • In the G Suite Admin console, disallow the incognito window. From the Incognito mode menu, choose Disallow incognito mode. For more information, search for Incognito Mode in Chrome Enterprise and Education Help.

Trusted Network Detection

If you are implementing Trusted Network Detection, we recommend that you check your DHCP server and confirm that it is providing Chromebook devices with the same virtual appliance (VA) IP address as other devices on your network. For more information, see Enable Trusted Network Detection.

Step 1: Install the Cisco Umbrella Chromebook Client Extension

You cannot deploy the Cisco Umbrella Chromebook client directly to your Chromebooks. You must deploy from the Google Admin console.

  1. Navigate to Deployments > Core Identities > Chromebook Users and click Configure.
  1. Click Download and download the Chromebook client configuration file.
    Note: Save this file to a known location. The regToken value listed in this file is required during the installation of the Cisco Umbrella Chromebook client application.
{"failClose":{"Value":false},"failOpenRetryInterval":{"Value":5},"googleDirectoryService":{"Value":false},"organizationInfo":{"Value":{"organizationId":<ORG-ID>,”productId":3,"regToken”:”<REG-TOKEN>”}},”publicSession":{"Value":false},"vaIPs":{"Value":[]}}

👍

Cisco Umbrella Virtual Appliances

To use the Cisco Umbrella Chromebook client in a network with Umbrella VAs, you must add the IP addresses of your VAs to the configuration file before uploading it. Enclose each VA IP address with double quotes and separate multiple VA IP addresses with a comma. For example:

"vaIPs":{
"Value":[
    "192.168.100.10",
    "192.168.100.11"
  ]
}

  1. Log into the Google Admin console.
1194
  1. Navigate to Devices > Chrome > Apps & Extensions > Overview.
1169
  1. From Apps & Extensions, navigate to Users & browsers > Organizational Units.
1129
  1. Expand Organizational Units and choose the organization you want to deploy the Cisco Umbrella Chromebook client into.
  2. Click the + (Expand) icon and choose Add from Chrome Web Store.
  1. In the Chrome Web Store, navigate to Extensions and then search for the Cisco Umbrella Chromebook client extension using the Cisco Umbrella Chromebook Client ID jcdhmojfecjfmbdpchihbeilohgnbdci.
  2. Click Select.
    The extension is added to the selected organization unit.
1099
  1. Choose Force Install and then click Save.
    The Cisco Umbrella Chromebook client extension is installed. Force Install ensures that Chromebook users in the selected Organization Unit cannot remove or disable the extension.
1102 1600
  1. Install the Cisco Umbrella Chromebook Client app. See Step 2: Install the Cisco Umbrella Chromebook Client Application.

Step 2: Install the Cisco Umbrella Chromebook Client Application

  1. Return to the Google Admin console.
  2. Click the + (Expand) icon and choose Add from Chrome Web Store.
  1. Search for the Cisco Umbrella Chromebook client app using the unique Cisco Umbrella Chromebook Client ID cpnjigmgeapagmdimmoenaghmhilodfg.
    Note: This ID is specific to the client app. Do not use the ID for the client extension listed earlier.
1100
  1. Click Select.
    The app is added to the selected organization unit.
  2. Choose Force Install and then click Save.
    The Cisco Umbrella Chromebook client app is installed. Force Install ensures that Chromebook users in the selected Organization Unit cannot remove or disable the app.
1253
  1. Copy the JSON file that you downloaded during Step 1: Install the Cisco Umbrella Chromebook Client Extension and paste it into the Policy for Extensions section.
401
  1. Click Save.
    The Cisco Umbrella Chromebook client app is installed and the configuration file uploaded.
1070

It can take Google upwards of eight hours to push the DNS Umbrella Chromebook client to all of your Chromebooks. After the client is installed in a Chromebook, allow a few hours for Chromebook traffic to begin appearing in your Umbrella dashboard.
Note: Chromebooks must be connected and logged in.

  1. Apply DNS policies to your organization's Chromebooks. For more information, see Add a Chromebook Specific DNS Policy.

G Suite Identity Service < Deploy the Cisco Chromebook Client > Add Chromebook-Specific Policies