Google ChromeOS Provisioning

Prerequisites

• Google Workspace account with admin privileges
• Google ChromeOS Enterprise/Signage subscriptions for your ChromeOS devices

Connect your Organization with Google Workspace

In the first step, connect your Organization with Google Workspace. This allows communication between signageOS and Google Workspace APIs and provisioning.

In Google Workspace

Getting Customer ID

1. Log in to Google Workspace as a user with admin privileges
2. Navigate to Account -> Account settings
3. Copy your Customer ID and save it for later

Getting a Service Account Token

1. Follow the Google guide: https://developers.google.com/identity/protocols/oauth2/service-account to get the Service Account token
   1. In the OAuth scopes (comma-delimited) field, enter the list of scopes that your application should be granted access to fill in at least

      https://www.googleapis.com/auth/admin.directory.device.chromeos

In signageOS

1. Navigate to your Organization detail page
2. Go to "Google ChromeOS Setup" tab
3. Fill in the Customer ID and Service Account token

Provision devices

Now select devices in Google Workspace and import them to signageOS using Bulk provisioning.

In Google Workspace

1. Log in to Google Workspace as a user with admin privileges
2. Navigate to Devices -> Chrome -> Devices
3. Select the Organization Unit with devices you want to manage in signageOS
4. Click Export
5. Download the CSV file

In signageOS

1. Navigate to Bulk provisioning page
2. Click Register devices
3. Switch to Bulk upload
4. Select the Organization that you linked to Google Workspace
5. Upload your CSV export with devices from Google Workspace

All imported devices will be registered and provisioned in "Initial" mode. To complete the provisioning, install signageOS CloudControl Extension.

Installing CloudControl App

1. In your Google Admin console, navigate to Devices -> Chrome -> Apps & Extensions -> Kiosk Tab -> bottom right corner click the "+" icon -> Add by URL

2. Fill in https://2.signageos.io/app/chromeos/1.0.0/app/index.html

3. Click Save

Installing CloudControl extension for PWA App

In Google Workspace

1. Log in to Google Workspace as a user with admin privileges
2. Navigate to Devices -> Chrome -> Devices -> Apps&Extensions
3. 
   Fill in the following values:
   Extension ID: igmapgpamlgdlbmmkjpnanbbbbkcjdkn
   From URL: https://2.signageos.io/app/chromeos/1.0.0/extension/manifest.xml
   
   
   
4. Ensure you enable "Allow app to manage power" and "Enable device attributes API"
5. Ensure "Enable health monitoring is enabled" and the rest of the options are disabled
6. Save the settings (The save button is in the top right corner)
7. Finalize the settings by configuring signageOS CoreApp to Auto-launch

Setting up display control

Many ChromeOS devices do not include a built-in display, as such if you require support for features that control the panel such as Display Off/On, Brightness, etc. please follow this guide article in our documentation.