Chromebooks

SysAid’s Chromebook integration allows admins to automatically and securely pull information from G-Suite Inventory to SysAid. This provides them with centralized access to their asset information; enhancing their capability to easily track Chromebook devices in their network and improve their efficiency.

Set up the Chromebook integration in G-Suite

1. Navigate to the Google Admin Console click Admin Roles.
   
2. Ensure that there is a user with Super Admin permissions.
   
3. Copy the Super admin's email address and paste it in a text file to save for a later step in this process.
4. Navigate to Google Cloud Platform Console. If you haven't used this Google Cloud Platform Console yet, agree to their terms and conditions.
5. Generate the JSON authentication:
   1. Select the project drop-down and click New Project.
      
   2. Enter the a project name.
   3. Click Create.
   4. If you already have existing projects, select the project you just created from the project drop-down.
   5. Click Library and search for 'Admin SDK.'
   6. Click Manage or Enable, depending on whether you've already enabled the Admin SDK.
      
   7. Click Credentials.
      
   8. Navigate to Create Credentials > Service Account.
      
   9. Enter a service account name.
   10. Click Create.
   11. Click Continue.
   12. Click Done.
   13. Open the service account that you just created.
   14. Copy the Unique ID number and paste it in a text file to save for a later step in this process.
       
   15. Navigate to Add Key > Create New Key.
   16. Make Sure that JSON is selected, and click Create.
       
   17. Click Close in the Confirmation message that appears.
   18. Click Save.
   19. Open the JSON file that's been created on your computer.
   20. Remove all the carriage returns from the JSON text. We recommend using an JSON editor application such as this to automatically perform this modification.
   21. Save the JSON in a text file.
6. Generate the customer ID:
   1. Open the following URL: https://developers.google.com/admin-sdk/directory/v1/reference/users/get.html
   2. In the userKey field, enter the email address of the G Suite super admin that you copied earlier.
   3. Click Execute.
      
   4. In the HTTP response that opens, copy the value of the 'customerId' parameter and paste it in a text file to save for a later step in this process.
      
7. Grant Google API access to SysAid.
   1. Back in Google Admin, navigate to Security > API Controls.
   2. Click Manage Domain-wide Delegation.
   3. Click Add new.
      
   4. Enter the Client ID that you copied earlier.
   5. In the OAuth Scopes field paste the following URL: https://www.googleapis.com/auth/admin.directory.device.chromeos.
   6. Click Authorize.
      

Set up the Chromebook integration in SysAid

1. From the SysAid Marketplace, request the Chromebook addon and/or contact your account manager.
2. Once the Chromebook add-on file has been added to your account, navigate to the My Apps page and click  in the Chromebook icon.
3. In the customer ID field, paste the customer ID parameter that you copied.
4. Ensure that the number 12 is entered in the interval field.
5. Enter the email address of your G-Suite domain administrator you used to generate the customer ID.
6. Copy the formatted JSON text you created, and paste it into the JSON authentication field.
7. (Optional) Filter the Chromebook devices imported by the integration:
   1. In the Filter Assets for Import field, click .
   2. Select the filter conditions from the first two drop-downs and enter the value into the text box.
   3. Click Create Filter.
      
8. Click Save Changes.
9. Click Test Connection to verify that you are connected to G-Suite. The Test Connection button is only enabled if the initialization steps are completed.
10. For verification purposes, click Import One Asset. The Chromebook integration imports a single asset for verification purposes.
11. When you've verified the success of the test import, click the Activate Integration slider. Chromebooks assets will be imported to SysAid within 12 hours.
12. Click Save Changes again.
    

Using the Chromebook integration

Once your Chromebook integration is up and running, your chromebook information is integrated with SysAid asset management. Here's a few places where you can view your Chromebook data.

Asset list

The imported Chromebook devices are displayed in the asset list. In addition, the integration allows you to add chromebook-specific columns to the asset list view.

The integration also adds a "Chromebook Device" optionto the Asset Type list.

Asset form

For each Chromebook device, SysAid displays the data in a limited asset record that contains only the tabs that are relevant to Chromebooks.

Last updated

You can check the last time an import was run, by checking the Last Updated field in the Chromebook configuration page.

Fields imported

When you import data from Chromebooks, the integration pulls the values from the maps the values from G-Suite Chromebooks fields to SysAid asset management fields as follows: