This guide explains how to configure Asset Management integration with Google Workspace (G Suite) using OAuth 2.0 authentication. This integration enables Asset Management to securely access and manage device and user data from your Google environment.
Step 1: Create a New Google Cloud Project
Log in to the Google API Console using an administrator account and create a new project.
Select New Project and provide a descriptive name (for example, “AM Integration”).
The organization and location fields will be prefilled based on your domain.
Step 2: Enable Required APIs
Enable the necessary APIs for your project.
- Select Enable APIs and Services.
- Search for Admin SDK API.
- Click Enable.
After enabling the API, navigate to the “OAuth consent screen” from the menu.
Step 3: Configure OAuth Consent Screen
Set up the OAuth consent screen for your application:
- Select Internal or External based on your organization’s needs.
- Complete the setup steps:
- App Information
- Scopes
- Test Users
- Summary
Step 4: Create OAuth 2.0 Client Credentials
Generate OAuth credentials to connect Asset Management to Google:
- Go to Credentials and click Create Credentials.
- Select OAuth client ID.
- Choose Web application as the application type.
- Enter a descriptive name.
Add the following to “Authorized Redirect URIs”:
- Your district TIPWeb-IT URL with:
/AuthCallback/IndexAsync - https://oauth.pstmn.io/v1/browser-callback
- https://oauth.pstmn.io/v1/callback
After creation, copy the Client ID and Client Secret for use in Asset Management.
Step 5: Assign Google Admin Privileges
Assign appropriate permissions to the Google account used for integration:
- Log in to the Google Admin Console.
- Go to Users and select the integration account.
- Open Admin roles and privileges.
Required privileges include:
- Chrome Management
- Mobile Device Management
Assign permissions as follows:
- Read access (required for data retrieval)
- Manage access (optional, required only if enabling/disabling devices via Asset Management)
After assigning the role, log in to Asset Management and navigate to Integration Settings, then select Authorize G Suite using the configured account.