sevco.io

Google Cloud Identity

About Google Cloud Identity

Google Cloud Identity is a unified identity and endpoint management platform that is integrated into Google Workspace.

Why You Should Integrate Google Cloud Identity

This integration is the only way to gain provide insight into systems that are accessing Google resources or that are synched into Google’s directory from Active Directory.

The Data We Collect and How We Use It

The table below lists the fields we collect from Google Cloud Identity and how they map to the fields in our Sevco platform. This data is only used internally; we do not share it with any parties outside of Sevco. Refer to our privacy policy for details.

Google Cloud Identity FieldSevco Field
nameid
osVersionOS
lastSyncTimelast_activity_time
imeiimei
serialNumberserial_number
wifiMacAddressesmac_addresses
assetTagadditonal_fields.asset_tag (this field is currently not searchable)

Integrate Google Cloud Identity

  1. Add a source: Follow our instructions to add a Sevco source.

  2. Provide credentials: You'll be asked to provide source credentials that Sevco will use to connect to Google Cloud Identity:

Credential, Parameter, or PermissionWhere You Can Find This Value
Credential:
service_account_json

Description:
The contents of the service account's JSON key file.
This information is available in the Google Cloud Console's IAM & AdminService Accounts section. Instructions below.

Refer to Google instructions for working with service accounts for details.
Permission scope:
https://www.googleapis.com/auth/cloud-identity.devices.readonly

Description:
The service account must have permission to this scope.
This setting is available in the G Suite Admin Panel's Manage API Client Access section under the Client Name ID specified for your service account.
The scope is specified in the One or More API Scopes section. Instructions below.
Credential:
admin_email

Description:
This account is your Cloud Identity administrator account.
The email address of the Google Workspace Admin who granted account permissions in step 6 of the instructions below.

Get the Required Credentials From Google Cloud Identity

Step 1. Enable Cloud APIs in the Google Cloud Console

  1. Select the project that you want Sevco to connect to.

  2. Go to APIs & ServicesDashboard.

  3. Verify that the Cloud Identity API API is listed. It is required to fetch Cloud Identity devices.

    If it does not appear in the list, click Enable APIs and Services at the top of the screen, search for Cloud identity APIs, and click Enable.

Step 2. Create a Service Account and Grant Permissions

  1. In the Google Cloud Console IAM & AdminService Accounts section, click Create Service Account. Provide Name and Description, then click Create and Continue.
  2. In the next tab, continue without setting any roles; continue to click Create Key and create a JSON type key. Your JSON key will be downloaded.
  3. Finish creating the user and go back to the service accounts screen. You can now view the client-id for the service account. Copy it.
  4. Open the G Suite Admin Panel and navigate to SecurityAPI Controls, then click Manage Domain Wide Delegation, and Add Client.
  5. In the Client Name field, specify the client ID of your service account.
  6. In the One or More API Scopes section, specify this scope: https://www.googleapis.com/auth/cloud-identity.devices.readonly

If you encounter any errors, they are most likely related to incorrect credentials or insufficient permissions. Verify all your work in this section.

Contact Us

If you're having problems integrating a source, or if you've found something wrong in this document, please email us at [email protected].


What’s Next

Configure another source: