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

Setting up Google Cloud access

1. Create a new project in your Google Cloud panel and setup a Service Account (you can follow this guide)
   
   
2. Open the Service Account details and create a Service Account Key -> Download the JSON file and save it for later use
   
3. Copy the Service Account email and navigate back to Google Admin console
   - Select Account -> Admin roles -> Locate ChromeOS Device management -> Add admin
   
4. Add a Service Account
   
5. Navigate back to Account -> Admin roles -> Open ChromeOS Device management detail -> display Privileges -> Make sure that following options are checked:
   Under Chrome management:
   - Manage User Settings
   - Manage ChromeOS Devices
   - Manage ChromeOS Device Settings
   - View Reports
6. In Google Cloud platform,  with your project selected open the hamburger menu -> APIs & Services -> Enabled APIs & services
7. Click "+ ENABLE APIS AND SERVICES" and search for "admin sdk api" and enable it
   

In signageOS

1. Navigate to your Organization detail page
2. Go to "Google ChromeOS Setup" tab
3. Fill in the Service Account Email address, Customer ID and Service Account Private key (found in JSON from step 2.)

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.

Next, you can choose one of these options:

• Install CloudControl extension for any 3rd party PWA
• Install CloudControl extension with signageOS CoreApp for the deployment of solutions based on DevSpace

To complete the provisioning, install at least signageOS CloudControl Extension.

Installing CoreApp

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.