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.
Supported options
Section titled “Supported options”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:
idprimaryEmaildisplayNamefullName
A user who is suspended or archived in Google is soft deleted in Oblique. They’re restored if they’re restored in Google.
Attributes
Section titled “Attributes”Oblique syncs the following user fields from Google as user attributes:
titleemployeeTypemanagerEmaildepartmentcostCenterbuildingIdfloorNamefloorSectionthumbnailPhotoUrl
Accounts
Section titled “Accounts”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.
Resources
Section titled “Resources”Oblique syncs the following from Google as resources:
- Each group in the domain
Group members outside your domain aren’t synced.
Group nesting
Section titled “Group nesting”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.
Connected apps
Section titled “Connected apps”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.
Required permissions
Section titled “Required permissions”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.
Add Google integration
Section titled “Add Google integration”To add a Google integration, navigate to the Integrations page:
- Select Add integration.
- Select Google Workspace.
- 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.
- Select Connect Google Workspace.
- 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:
- Under App access control, select Manage app access.
- Select Configure new app.
- Search and select the client ID
298647613525-enafl8d47h08hjjrt6tbj432j57na4ki.apps.googleusercontent.com, which is the Oblique app. - Select the organization or org units for which you are configuring the app, then select Continue.
- Select Trusted, then select Continue.
- Select Finish.
Change Google integration’s authorizations
Section titled “Change Google integration’s authorizations”To reconnect the Google integration, including to change the administrator it is tied to, from the integration’s detail page:
- Navigate to the Settings tab.
- Under Connection, select Reconnect.
- 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:
- Navigate to the Settings tab.
- Under Permissions, select Upgrade to read-write.
- 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.
Manage entitlements
Section titled “Manage entitlements”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.
Manage Google group membership
Section titled “Manage Google group membership”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.
Remove Google integration
Section titled “Remove Google integration”To remove a Google integration, from the integration’s detail page:
- Navigate to the Settings tab.
- At the bottom of the page, under Delete integration, select Delete integration….
- 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.