Skip to content

Google Workspace

This article includes information on adding Google Workspace as an integration to sync objects to Oblique. To use Google as an identity provider to authenticate to Oblique, see Single sign-on.

When you connect a Google Workspace to Oblique, Oblique will automatically sync the workspace’s users, user fields, groups, and group members.

As you add, suspend, or remove users, add or remove groups, or change group membership in Google, these changes are automatically synced to Oblique. If connected in read-write mode, Oblique can also change Google group membership.

You can add multiple Google workspaces to Oblique. Each is a separate integration, identified by its domain.

Oblique syncs the following from your Google Workspace. In read-write mode, Oblique can also change Google group membership.

Google object Oblique object Capability
Users Users Read-only
User fields User attributes Read-only
Users Accounts Read-only
Groups Resources Read-only
Group roles Roles Read-only
Group membership Entitlements Read-write
Group nesting Entitlements Read-write

Oblique only syncs users and groups in the domain the integration is connected to, which is shown on the integration’s detail page. Users and groups in your workspace’s other domains, such as secondary domains, aren’t synced.

Oblique syncs each Google Workspace user as an Oblique user.

Oblique uses the following user fields from Google to identify users:

  • id
  • primaryEmail
  • displayName
  • fullName

A user who is suspended or archived in Google is soft deleted in Oblique. They’re restored if they’re restored in Google.

Oblique syncs the following user fields from Google as user attributes:

  • title
  • employeeType
  • managerEmail
  • department
  • costCenter
  • buildingId
  • floorName
  • floorSection
  • thumbnailPhotoUrl

Oblique syncs each user in the Google Workspace as an Oblique account. Users who are suspended or archived can’t sign in, so they aren’t synced as accounts, and neither are their group memberships. They’re added back if their user is restored in the workspace.

Oblique automatically matches Google accounts to users in Oblique. Google accounts are matched to Oblique users by their ID (id). Oblique syncs every Google user as an Oblique user, so it matches every Google account.

Oblique syncs the following from Google as resources:

  • Each group in the domain

Group members outside your domain aren’t synced.

In Google, where a group is a member of another group, Oblique represents this as the nested group having an entitlement to the outer group. In Oblique, you can see the access that members of the nested group have through the outer group.

Oblique syncs Google group roles as Oblique roles.

Every entitlement from Google is for exactly one role.

Oblique also reads sign-in reports from your workspace’s audit log, for sign-ins to third-party apps with Sign in with Google (OIDC) or SAML single sign-on. Oblique uses these to suggest integrations to add and apps that might be in scope for user access reviews.

You must be a Super Administrator in Google Workspace to connect this integration.

If you don’t want to give Oblique access to sign-in reports, a Groups Admin can connect a read-write integration, and a Groups Reader can connect a read-only one.

If you don’t have sufficient permissions, create an install link so someone who does can connect the integration without being an Oblique admin.

The Google integration requests the following scopes for your Google Workspace:

Google scope What Oblique uses it for Needed for read-only Needed for read-write
openid Identify the administrator who connected the integration Yes Yes
email Read the administrator’s email, and the workspace domain it belongs to Yes Yes
admin.directory.user.readonly Read users Yes Yes
admin.directory.group.readonly Read groups and their members Yes Yes
admin.directory.orgunit.readonly Read organizational units and the users in each Yes Yes
admin.reports.audit.readonly Read sign-in reports to suggest apps
admin.directory.group Add, update, and remove group members Yes

The admin.reports.audit.readonly scope is optional. If the administrator who connects the integration can’t read sign-in reports, Oblique still syncs users and groups, but doesn’t suggest apps.

Oblique connects to Google Workspace as the person who connects the integration.

If their Google account is suspended or deleted, or they revoke Oblique’s access, syncing stops until someone reconnects.

You must be an admin to add an integration.

To add a Google integration, navigate to the Integrations page:

  1. Select Add integration.
  2. Select Google Workspace.
  3. Under Connect, select Read-write to let Oblique manage Google groups, or Read-only to let Oblique read but not manage them. By default, this is read-write.
  4. Select Connect Google Workspace.
  5. Sign in to Google and approve the access Oblique asks for.

Oblique will immediately start syncing the workspace’s users and groups.

Configure Oblique app to authorize access to your Google Workspace APIs

Section titled “Configure Oblique app to authorize access to your Google Workspace APIs”

If your organization restricts which third-party apps can reach Google Workspace APIs, a Google administrator must configure the Oblique app before you can connect Oblique to your workspace.

To configure the Oblique app in the Google Admin console, navigate to Security > Access and data control > API controls:

  1. Under App access control, select Manage app access.
  2. Select Configure new app.
  3. Search and select the client ID 298647613525-enafl8d47h08hjjrt6tbj432j57na4ki.apps.googleusercontent.com, which is the Oblique app.
  4. Select the organization or org units for which you are configuring the app, then select Continue.
  5. Select Trusted, then select Continue.
  6. Select Finish.

Change Google integration’s authorizations

Section titled “Change Google integration’s authorizations”
You must be an admin to change an integration’s authorizations.

To reconnect the Google integration, including to change the administrator it is tied to, from the integration’s detail page:

  1. Navigate to the Settings tab.
  2. Under Connection, select Reconnect.
  3. Sign in to Google and approve the access Oblique asks for.

You can only reconnect the current workspace. To change the workspace, instead delete the integration and add another one.

To give a read-only integration write access, from the integration’s detail page:

  1. Navigate to the Settings tab.
  2. Under Permissions, select Upgrade to read-write.
  3. Sign in to Google and approve the extra access Oblique asks for.

A read-write integration can’t be changed back to read-only. Instead, remove the integration and add it again.

In read-write mode, the Google integration lets Oblique manage access in your Google Workspace. Oblique does this by updating Google group membership. An entitlement for an Oblique group or team to a Google group is flattened and written in Google as an individual entitlement for each member’s account.

Oblique can add an account to a group, change its role in the group, and remove it from the group.

Oblique can also nest a group in another group, and remove it from that group. Oblique can’t change a nested group’s role.

Oblique can’t create Google groups.

You must be an admin to remove an integration.

To remove a Google integration, from the integration’s detail page:

  1. Navigate to the Settings tab.
  2. At the bottom of the page, under Delete integration, select Delete integration….
  3. In the confirmation dialog, type the text to confirm, then select Delete integration.

This will immediately stop all syncing and remove all resources from the integration. Access that Oblique granted in Google stays as it is.