Guides
ProductDeveloperPartnerPersonal

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

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 Download.
2588
  1. Click Download and download the JSON 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.
1328
"googleDirectoryService":	{
	"Value": false
}
"organizationInfo": {
	"Value": {
	  "organizationId":	1234567,
	  "regToken": "1234567890ABCdef"
  }
}
"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.
175
  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.
175
  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.
8. 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