ChromeOS Edge DX Deployment

To monitor and manage ChromeOS devices, you must deploy a browser extension that acts as an Edge DX Agent. Optionally, you can also set up Google Cloud connections for additional data collection.

Prerequisites

• Supports ChromeOS and ChromeOS Flex devices
• Chrome Enterprise Upgrade

Install and configure the browser extension

You must deploy the ControlUp DEX browser extension for ChromeOS and configure the Chrome policies described in this section.

1. In the Chrome Admin console (admin.google.com), go to Devices > Chrome > Apps and extensions.

2. Select the organizational unit that contains the devices on which you want to deploy the extension.

3. Click the type of extension you want to add (Users and browsers, Kiosks, or Managed guest sessions), and select to add an extension by ID.
   

4. Add the following extension ID from the Chrome Web Store: cmllcafpnpcfnappeekbmjbellnlcoea

5. Set the Installation policy of the ChromeOS DEX extension to Force-installed so that the extension is installed on all devices in the selected organizational unit.

6. Configure the extension to connect to your Edge DX tenant:

   1. In the Edge DX Downloads page, go to Thin Clients > ChromeOS, and copy the JSON configuration. The JSON contains your unique tenant name and device registration code.
   2. In the Google Admin console, open the configuration for the browser extension and paste the JSON in the Policy for extensions field.

Read Google's documentation about app/extension deployment to learn more.

Configure Chrome policies

To access Chrome policy configuration, open the Admin console and go to Devices > Chrome > Settings. Make sure you apply the policies to the correct organizational units.

Read Google's documentation about Chrome policies to learn more.

User and browser or Managed guest session settings

Depending on your ChromeOS deployment scenario, configure the following settings under either the User and browser settings or Managed guest session settings tab.

Device settings

Configure the following settings under the Device settings tab.

Set up Google Cloud connections

Optionally, you can connect to Google Cloud with OAuth to get additional data such as hardware model, serial number, CPU model, disk info, and the active user. You can also subscribe to Google Pub/Sub to get real-time data about drops in Wi-Fi signal.

We recommend you set up both connections to get the most data. These connections might also be required for upcoming features and additional data collection.

Step 1 - Create a service account

In the Google Admin console (admin.google.com), create a service account with the role Super Admin. You'll need to authenticate with this account during a later step.

You must also configure the following Chrome security settings so that you need to authenticate with the service account only once:

1. In the Google Admin console, go to Security > Access and data control > Google Cloud session control.
2. Based on your preference, perform one of the following steps:
   • Select Never require authentication.
   • Select Require reauthentication, and then select Exempt trusted apps. If you choose this method, then you must perform the steps in this Google article to designate the ControlUp DEX Platform extension as a trusted app.

Step 2 - Configure Pub/Sub in the Google Cloud console

1. Go to the Google Cloud console (console.cloud.google.com) and create a new project for the Edge DX connector (you can also use an existing project, depending on your preference).
2. Go to IAM & Admin > Organizational policies.
3. Search for the policy Domain restricted sharing and make sure it is set to Allow all. Read Google's documentation about organization policies to learn more.
4. Go to the Pub/Sub Topics page and click Create topic.
5. Leave the default topic settings enabled and click Create.
6. Set access controls for the topic:
   1. In the Permissions tab, click Add principal.
   2. Add the principal cloud-pub-sub-publisher@chrome-reporting.iam.gserviceaccount.com.
   3. Assign the role Pub/Sub Publisher.
   4. Click Save.
7. Set access controls for the subscription:
   1. Click on the subscription that was automatically created when you created the topic.
   2. In the Permissions tab, click Add principal.
   3. Add the principal of the service account you created for the connection.
   4. Assign the roles Pub/Sub Viewer and Pub/Sub Subscriber.
   5. Click Save.

Take note of the Topic name and Subscription name. You'll need these in the next step.

Step 3 - Add connection details in ControlUp

1. In ControlUp, go to Devices > Configuration > Settings > Connectors.
   
2. If you chose to configure Pub/Sub in the steps described above, paste the Topic name and Subscription name.
3. Click Configure using OAuth2 and sign in using the service account.