About Google Workspace
Connecting Google Workspace lets Iru Identity read users from your Google directory and keep your directory in sync. When someone joins, changes, or leaves, those updates flow into Iru on their own. Iru reads the directory through Google with the consent of a Google Workspace admin. There is no report to configure and no credential to type into Iru. You sign in to Google and allow access. Iru requests read-only access to users, custom user attributes, and groups. Google Workspace is the only Directory Sync provider that sends its own groups, each with its own members. Group sync is optional and off until you turn it on. Workday and BambooHR sync users only.Connect Google Workspace to Iru Identity
Navigate to Directory
Select Connect Source
Select Google Workspace
Name the connection
Select Connect
Sign in and allow access
Map Your Data to Iru
On the Mapping tab, choose which Google value identifies each person, and which Google columns fill the Iru profile.Set the unique user identifier
id is the usual choice. Iru uses that value to update the same user on every later sync, including when the name or email changes. After you save, it can’t be changed.When a column name has spaces or symbols, wrap it in backticks, such as `Cost Center`.Choose whether to import managers
Map Google columns to Iru attributes
name.givenName, name.familyName, and primaryEmail are the usual columns for first name, last name, and email. Google custom user attributes appear in the list too.A column left under Not mapped is not written to the user. On a row you did map, select Don’t overwrite when a later sync should leave the value already stored in Iru as it is.To build a value instead of copying a column, write an IQL expression. See Attribute mapping.Select Next
Finish and Turn It On
On the Configuration tab, choose who the connection syncs, whether new users are invited, and how often Iru reads Google Workspace. Select Edit to change these settings after the connection exists.Review connection details
Choose whether new users are invited
Choose which people sync
/Engineering to sync that organizational unit and everything under it. Leave the path empty to sync the whole directory.Set the sync schedule
Enable the connection
Sync groups
Group sync is off until you turn it on. Users sync either way. See Sync groups for how to review groups, ignore one, and what happens when a group leaves Google.Choose whether groups sync
Exclude groups you don't need
name and memberCount. Leave it empty to sync every group.For example, memberCount < 2 || name.startsWith("test-") skips groups with fewer than two members and groups whose names start with test-.Save and sync
Re-authenticate
When Google access is revoked, or the authorizing admin loses admin rights, the connection shows that it needs to be re-authenticated and automatic syncing stops.Navigate to Directory
Select the Google Workspace source
Select Re-connect