Guides
ProductDeveloperPartnerPersonal

Deploy the Chromebook Client

Cisco Security for Chromebook client allows you to enable both DNS layer and SWG layer protection for Chromebook users.

DNS Layer Protection

For DNS layer protection, DNS over HTTPS (DoH) is used to send DNS queries to Umbrella resolvers. These DNS queries are sent using DoH templates, which capture the Chromebook identities. The Chromebook identities are hashed using a salt value that you configure. After the salt value is configured on the Umbrella console, you can copy the DoH templates, configure the Enterprise policy on the Google Admin console, and propagate the DoH templates to the Chromebooks.

SWG Layer Protection

For SWG protection, Chromebooks are listed as identities in the web policy. Chromebooks are immediately protected by the default rule set and rules of the web policy. At any time, you can add your own rule sets and rules to the web policy and customize your Chromebook protection. For more information, see Add a Chromebook Specific Web Policy Ruleset.

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

📘

Important

If you are an existing Umbrella Chromebook customer and are migrating to the new Cisco Security for Chromebook client, see Migration Scenarios and carry out the relevant steps (both app and extension) before you install the new Cisco Security for Chromebook client.

Deploy Cisco Security for Chromebook Client

Deploy Cisco Security for Chromebook client using the Umbrella dashboard and the Google Admin console. Use the Umbrella dashboard to configure a salt value, get the URL for the DoH templates, and download the JSON file. The configuration and deployment procedures take approximately, 30 minutes.

Umbrella Dashboard

  1. From the Umbrella dashboard, navigate to Deployments > Core Identities > Chromebook Users and click  the Configure icon.
  1. To enable DoH protection, you must configure a salt value. To configure this value, click CONFIGURE adjacent to Define Salt.
  1. Enter the salt value, which can be between 8 and 32 characters, and include a combination of letters and numbers. Special characters are not allowed.

📘

Note

The salt value cannot be changed once it is saved and confirmed. You will have to raise a support ticket with Umbrella to change the salt value.

  1. After the salt value is configured, two DoH templates are created. The first template is the default template, which is used for all the managed Chromebooks. The second template is the managed guest session template, which is used only for managed guest session devices. Copy and save the configured salt value and the DoH template URLs. They will be required later when deploying Cisco Security for Chromebook client from the Google Admin console.
  1. Click Configure and download the Chromebook Client Configuration JSON file. Save this file to a known location.
  1. Enable the Secure Web Gateway module if you want to provide full web proxy protection for your internet traffic.

Google Admin Console

You can configure the default and the managed guest session DoH templates using the Google Admin console.

Configure Default Template

  1. Log in to the Google Admin console.
  2. Navigate to Devices > Chrome > Settings > Users & browser settings.
  3. Cisco Security for Chromebook is in the process of transitioning from Manifest V2 to Manifest V3 for Chrome extensions. In the meantime, Google recommends that you use the Manifest V2 Extensions Availability policy to ensure the continued functioning of Manifest V2 extensions. To enable the availability of Manifest V2 extensions, filter the settings for Manifest.
    The Manifest V2 Extension Availability setting is displayed.
  1. Select the parent organizational unit on which you want to enable the Manifest V2 extension availability policy. Click Manifest V2 extension availability.
  2. In the Configuration drop-down list, choose Enable manifest V2 extensions.
  1. Filter the settings for DNS. The DNS settings are displayed.
  1. Click DNS-over-HTTPS and configure it to Enable DNS-over-HTTPS with insecure fallback.
  1. Return to the Users & Browser Settings page and click DNS-over-HTTPS with Identifiers.
  1. Enter the URL of the Default DoH template and the salt value that you copied from the Umbrella dashboard earlier, and click Save.
  1. From Apps & Extensions, navigate to Users & browsers > Organizational Units.
  2. Expand Organizational Units and choose the organization to which you want to deploy Cisco Security for Chromebook client.
  3. Click the + (Expand) icon and select Add from Chrome Web Store.
  1. In the Chrome Web Store, navigate to Extensions and search for the Cisco Security for Chromebook client extension using the ID  jgnjaoilojahgagddnkeankieagghabk.
  1. Click Select.

    The extension is added to the selected organization unit.

  2. Copy the JSON file that you downloaded and paste it into the Policy for extensions section.

📘

Note

The JSON configuration parameters googleDirectoryService and vaIPs apply only to Cisco Umbrella Chromebook client and not to Cisco Security for Chromebook client.

  1. Choose Force install and then click Save.
    The Cisco Security for Chromebook client extension is installed. Force install ensures that Chromebook users in the selected organization unit cannot remove or disable the extension.
  1. Check if Cisco Security for Chromebook client is installed on the Chromebooks and if the old Umbrella Chromebook Client (app and extension) is blocked.
  1. Access the URL https://policy-debug.checkumbrella.com and verify if the device is being protected by Umbrella. For DNS customers, the “You are protected by Cisco Umbrella DNS!” message is displayed.

For SIG customers, the “You are protected by Cisco Umbrella SWG!” message is displayed.

It may take Google up to eight hours to push the Chrome extension to all your Chromebooks. After the client is installed in a Chromebook, allow a few hours for Chromebook traffic to appear on your Umbrella dashboard.

📘

Note

Chromebooks must be connected and logged in.

Configure Managed Guest Session Template

  1. Log in to the Google Admin console.
  2. Navigate to Devices > Chrome > Settings > Managed guest session settings.
  3. Cisco Security for Chromebook is in the process of transitioning from Manifest V2 to Manifest V3 for Chrome extensions. In the meantime, Google recommends that you use the Manifest V2 Extensions Availability policy to ensure the continued functioning of Manifest V2 extensions. To ensure the availability of Manifest V2 extensions, filter the settings for Manifest.
    The Manifest V2 Extension Availability setting is displayed. Click Manifest V2 Extension Availability.
  1. Select the parent organizational unit on which you want to enable the Manifest V2 extension availability policy. From the Configuration drop-down menu, select Enable Manifest V2 extensions.
  1. Filter the settings for DNS.

    The DNS settings are displayed.

  1. Click DNS-over-HTTPS and configure it to Enable DNS-over-HTTPS with insecure fallback.
  1. Return to Managed guest session settings and click DNS-over-HTTPS with Identifiers.
  1. Enter the URL of the Managed Guest Session DoH template and the salt value copied from the Umbrella dashboard, and click Save.
  1. From Apps & Extensions, navigate to Managed Guest Session > Organizational Units.
  2. Expand Organizational Units and choose the organization to which you want to deploy Cisco Security for Chromebook client.

📘

Important

If you are an existing Umbrella Chromebook customer and are migrating to the new Cisco Security for Chromebook client, block or delete Cisco Umbrella Chromebook Client (both app and extension) before you install Cisco Security for Chromebook client.

  1. Click the + (Expand) icon and select Add from Chrome Web Store.
  1. In the Chrome web Store, navigate to Extensions and search for the Cisco Security for Chromebook client extension using the ID  jgnjaoilojahgagddnkeankieagghabk.
  1. Change the publicSession value to true in the JSON file that you downloaded, and copy the JSON file and paste it into the Policy for Extensions section.
  1. Choose Force Install and click Save.
    The Cisco Security for Chromebook client extension is installed. Force install ensures that Chromebook users in the selected organization unit cannot remove or disable the extension.
  1. Check if Cisco Security for Chromebook client is installed on the Chromebooks and if Umbrella Chromebook client (app and extension) is blocked.
  1. Open the URL https://policy-debug.checkumbrella.com and verify if the device is being protected by Umbrella. For DNS customers, the “You are protected by Cisco Umbrella DNS!” message is displayed.
  1. For SIG customers, the “You are protected by Cisco Umbrella SWG!” message is displayed.

It may take Google up to eight hours to push the Chrome extension to all your Chromebooks. After the client is installed in a Chromebook, allow a few hours for Chromebook traffic to appear on your Umbrella dashboard.

📘

Note

Chromebooks must be connected and logged in.

For information on verifying the deployment and on debugging, see Verify and Debug.


Integrate Google Workspace Identities > Deploy the Chromebook Client > Verify and Debug