Chromebooks
    • 07 Jun 2022
    • PDF

    Chromebooks

    • PDF

    Article summary

    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.
      ChromebooksfilesAdminRoles.png
    2. Ensure that there is a user with Super Admin permissions.
      Chromebooksfilessuperadminsuperadmin.jpg
    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.
        ChromebooksfilesNewProject.png
      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.
        ChromebooksfilesAdminSDK.png
      7. Click Credentials.
        ChromebooksCredentials2.jpg
      8. Navigate to Create Credentials > Service Account.
        ChromebooksfilesServiceAccount.png
      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.
        ChromebooksfilesUniqueID.jpg
      15. Navigate to Add Key > Create New Key.
      16. Make Sure that JSON is selected, and click Create.
        ChromebooksfilesJSONcreatekeyJSONcreatekey.jpg
      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.
        ChromebooksfilesExecute.png
      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.
        ChromebooksCBcustomerIDresultCBcustomerIDresult.png
    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.
        image.png
      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.
        ChromebooksfilesAddClientAddClient.jpg

    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 IntegrationsfilesGreenCog6.jpg 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 ChromebooksfilesFilterButton.jpg.
      2. Select the filter conditions from the first two drop-downs and enter the value into the text box.
      3. Click Create Filter.
        ChromebooksfilesFilter.jpg
    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.
      ChromebooksfilesChromebookSetup2.jpg

    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.

    ChromebooksfilesChromebooksAssetList.png

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

    ChromebooksfilesAssettype-Chromebook.PNG

    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.
    ChromebooksfilesChromebookAssetDetailsChromebookAssetDetails.png

    Last updated

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

    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:

    Chromebooks Field
    SysAid Field
    ModelModel
    Serial numberSerial
    ChromeVersionChromebook Chrome Version
    EnrollmentTimeChromebook Enrollment Time
    Auto-update expirationWarranty Expiration
    Asset IDChromebook Asset ID
    UserDescription (The values of these two fields are concatenated together into SysAid's Description field)
    Notes
    LocationLocation
    RecentUser(s)Owner (The most recent of the recent users is automatically mapped to the Owner field in SysAid)
    CPU UtilizationChromebook CPU Usage
    Memory usageChromebook Memory Usage
    Disk space usageChromebook Diskspace Usage
    Organizational UnitChromebook Organization Unit
    Last policy syncChromebook Policy Last Update
    StatusChromebook Status

    What's Next