Skip to main content

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.
This article covers the Google Workspace directory connection. It is separate from the Google Workspace sign-in connection. For concepts shared across every sync provider, see Directory Sync.

Connect Google Workspace to Iru Identity

1

Navigate to Directory

Navigate to Directory in the left-hand navigation bar (under Identity). Select the Sync tab.
2

Select Connect Source

Select Connect Source in the upper-right.
3

Select Google Workspace

Under Select user source, select Google Workspace.
4

Name the connection

Enter an optional Display name and Description.
5

Select Connect

Select Connect. Google opens in a new window. If your browser blocks it, allow popups for Iru and select Try again.
6

Sign in and allow access

In the Google window, sign in with a Google Workspace admin account and allow the requested access. Return to Iru when Google is done.
Authorize with an admin account that is not tied to one person. Iru syncs with the access that account granted, so the connection keeps working when people change roles.

Map Your Data to Iru

On the Mapping tab, choose which Google value identifies each person, and which Google columns fill the Iru profile.
1

Set the unique user identifier

Set Unique user identifier to a Google column that never changes for a person. Google’s 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`.
2

Choose whether to import managers

Direct Manager Mapping is off until you turn it on. Leave it off when manager relationships should stay out of Iru. Turn it on when Iru should record each person’s manager from Google Workspace.
3

Map Google columns to Iru attributes

Each row maps one Google Workspace attribute to one Iru attribute. 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.
4

Select Next

Select Next to save the mappings. You land on the connection’s detail page.

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.
1

Review connection details

Connection details shows the provider, whether the connection is Connected, the Authorized admin who granted access, and Last sync. Iru reads the directory with that admin account’s consent. Use Re-connect when a different Google Workspace admin needs to grant access. Your attribute mapping is not affected.
2

Choose whether new users are invited

Under Invites, set Invites for new users. Don’t send creates the user and leaves the invitation for you to send later. Send emails an invitation to each user this connection creates. A user created as suspended is not invited, and a user held for review is not invited. See Invite new users.
3

Choose which people sync

Org unit path limits which people this connection syncs. Enter a path such as /Engineering to sync that organizational unit and everything under it. Leave the path empty to sync the whole directory.
If you narrow the path later, Iru treats the people it no longer includes as having left Google Workspace. When the connection removes users who leave the source, those people are removed from Iru.
4

Set the sync schedule

Under Sync schedule, set Interval to how often Iru reads the directory. Choose Manual only when you want no automatic sync and will use Sync now on the Sync tab instead.
5

Enable the connection

From the actions menu in the upper-right, select Enable. A new connection stays disabled until you do this, so nothing syncs before you have reviewed the settings. To sync right away, open the Sync tab and select Sync now.

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.
1

Choose whether groups sync

Select Edit. On the Configuration tab, under Groups, set Group sync.Don’t sync groups brings in users only. This is the default.Sync groups and membership also brings in each Google group and that group’s members. Iru creates a matching group and keeps its members in step with Google on every sync.
2

Exclude groups you don't need

The Exclude group IQL expression field appears only when Group sync is set to Sync groups and membership. The expression can use the group’s 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-.
3

Save and sync

Select Save. Groups appear after the next sync. To sync right away, open the Sync tab and select Sync now.
If you connected Google Workspace before group sync was available, select Re-connect first. Older connections did not request access to groups.

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.
1

Navigate to Directory

Navigate to Directory and select the Sync tab.
2

Select the Google Workspace source

Select your Google Workspace connection.
3

Select Re-connect

Select Re-connect, then sign in to Google with a Google Workspace admin account and allow access. Your attribute mapping is not affected.

Directory Sync

The shared concepts behind every Directory Sync provider.

Sync groups

Bring Google groups and their membership into Iru, and keep them current on every sync.

Attribute mapping

Map Google fields to Iru user fields, and reshape values with IQL.

Connect Workday

Read workers from a Workday report. Workday syncs users only.

Connect BambooHR

Read BambooHR’s standard employee directory. BambooHR syncs users only.