Google Workspace¶
Identity & SaaS audit logs. Admin, login, and OAuth token activity from your Workspace tenant.
Status: available now - you connect this yourself
This source is live in the console. Create the read-only credential below, connect it on its card in Integrate -> Sources, and your dedicated instance starts collecting.
What SheerSight reads¶
SheerSight reads your Workspace audit activity through the Google Admin SDK Reports API, across three activity logs:
- login (sign-ins, failures, suspicious logins),
- admin (admin-console changes, role grants, security-setting changes),
- token (OAuth app authorizations and grants).
That feed powers detections such as a failed-authentication burst, impossible travel, an admin role being granted, and 2-step verification / MFA being turned off.
It is read-only. SheerSight cannot change settings, users, or data in your tenant.
What you'll need¶
- A Google Workspace super admin (needed once, to authorize the read-only scope).
- A Google Cloud project you can create a service account in.
- Your dedicated instance enrolled (see Your dedicated instance).
Create the read-only credential¶
You will create a service account, give it a key, and authorize it for exactly one read-only reports scope through domain-wide delegation.
- In the Google Cloud console, pick or create a project, then enable the Admin SDK API (APIs & Services -> Library -> "Admin SDK API" -> Enable).
- Go to IAM & Admin -> Service Accounts -> Create service account. Give it a name like
sheersight-reports. You do not need to grant it any project roles. - Open the new service account -> Keys -> Add key -> Create new key -> JSON, and download the key file. This is what you will paste into SheerSight.
- On the service account's Details page, copy its Client ID (the long numeric unique ID).
-
In the Google Admin console (admin.google.com), go to Security -> Access and data control -> API controls -> Domain-wide delegation -> Add new. Paste the Client ID from step 4, and for OAuth scopes enter exactly:
https://www.googleapis.com/auth/admin.reports.audit.readonly
Then Authorize. This is the only scope to add. It grants read access to audit reports and nothing else. 6. Choose an admin email for SheerSight to act as when it reads reports (any admin account with reports access works). You will paste this as the delegated admin.
Give delegation a few minutes
Domain-wide delegation can take a few minutes to propagate after you authorize it. A handful of early authorization retries right afterward are normal and clear on their own.
Connect it in SheerSight¶
In the console, open Integrate -> Sources -> Google Workspace and fill in:
| Field | Value |
|---|---|
| Service account key JSON | The JSON key file from step 3. Paste the entire file as downloaded, not just the private key. Your browser encodes it before encrypting it. |
| Delegated admin email | The admin address from step 6. |
There is no customer ID to enter. SheerSight reads your tenant as the delegated admin, so it always looks at that admin's own organization.
Press Connect. The value is encrypted in your browser and relayed as ciphertext to your dedicated instance, which decrypts it locally. See Connecting sources for the trust model.
Verify¶
- In Integrate -> Sources, the relayed credentials entry moves from pending to applied within a minute or two.
- The Google Workspace source badge moves from not connected to live.
- Login, admin, and token activity begin appearing, and matching detections start firing.
Spot-check the first backfill
Compare the event count and time range for the first poll against the Admin console's own audit view (Reporting -> Audit and investigation) for the same window, to confirm everything lines up.
Troubleshooting¶
- Authorized but no data. Give domain-wide delegation a few minutes to propagate, then re-check.
- Still nothing after that. Re-open Domain-wide delegation and confirm the client ID matches
the service account, and the scope is exactly
admin.reports.audit.readonlywith no extra scopes. - Wrong admin. The delegated admin must be an account that can read audit reports.
What SheerSight can and cannot do¶
The scope is read-only audit reports. SheerSight cannot change security settings, add or remove users, alter roles, or take any action in your Workspace tenant. It only reads the audit feed.