Prepare a Google Workspace identifier
01In brief #sec_2a601c71
REVIEWIT collects Google Workspace through a Google Cloud service account, authorized by domain-wide delegation to act on behalf of an administrator you designate. It only requests read scopes, one by one: a scope you have not delegated does not block the others.
The exact list of scopes depends on the resources you want to collect. It is calculated in REVIEWIT, at the Prepare step of the connection wizard, or later from the connection record (« What needs to be granted »).
021. Create the service account #sec_24fc4961
In the Google Cloud console:
- Choose or create a project; enable the APIs required by the selected resources (Admin SDK, and depending on the scope: Gmail, Drive, Calendar, Chat, Groups Settings, Cloud Identity, Keep, Apps Script, Resource Manager).
- IAM & Admin › Service Accounts › Create; no role is needed on the project.
- Keys › Add key › JSON: the file is uploaded in the REVIEWIT wizard.
- Note the service account's numeric Client ID.
032. Delegate the scopes #sec_1217326e
In the Google Admin console ( Security › Access and data control › API control › Domain-wide delegation ), a super-admin:
- Add; the service account's Client ID;
- paste the list of scopes that REVIEWIT displays at the Prepare step — a single line, separated by commas;
- Authorize.
043. The Google Cloud step #sec_9e26fed5
Google Cloud resources (service accounts, IAM roles) additionally require that the delegated administrator hold a read IAM role on at least one project. REVIEWIT checks this by listing visible projects: an empty list means refusal.
054. Declare and verify #sec_e15c662f
Return to the assistant: step Identifier, drop the JSON key and the delegated administrator's address; then Verify. REVIEWIT requests each scope at the Google token point, in the administrator's name, and remembers those that are granted; it compares the organization with that of the connection. It displays the verdict for each resource; what is still missing returns to the Prepare step.
06To go further #sec_90dfd44b
- Understand a collection connection
- Rights reference by resource
- Read a verdict