Google Workspace Integration Setup Guide
Follow these steps to connect your Google Workspace directory for automated access reviews.
1
Create Service Account
First, you need to create a Service Account in the Google Cloud Console.
- Go to the Google Cloud Console Service Accounts page.
- Select an existing project or create a new one.
- Click + CREATE SERVICE ACCOUNT.
- Enter a name (e.g., "Pensure Scanner") and click CREATE AND CONTINUE.
- Click DONE (no specific roles are needed on the project itself).
2
Enable Admin SDK API
The service account needs access to the Admin SDK.
- Go to Admin SDK API library page.
- Click ENABLE.
3
Generate Key & Client ID
You need the JSON key file and the Client ID for the next steps.
- Go back to the Service Accounts list.
- Click on your newly created service account email.
- Go to the KEYS tab.
- Click ADD KEY > Create new key.
- Select JSON and click CREATE. The file will download automatically.
- Keep this file safe! You will paste its content into Pensure later.
- Go to the DETAILS tab and copy the Unique ID (Client ID).
4
Authorize Domain-Wide Delegation
Authorize the service account to access user data in your Google Workspace.
- Go to the Google Workspace Admin Console (Domain-Wide Delegation).
- Click Add new.
- In Client ID, paste the Unique ID you copied in Step 3.
- In OAuth Scopes, paste exactly:
https://www.googleapis.com/auth/admin.directory.user.readonly - Click AUTHORIZE.
5
Configure Pensure
Now go back to Pensure Settings and enter the details.
- Admin Email: Enter the email address of a Super Admin user in your Google Workspace (e.g.,
[email protected]). The service account will impersonate this user. - Service Account JSON: Open the JSON file you downloaded in Step 3 with a text editor. Copy the entire content and paste it into the field.