> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Google Workspace

> Connect Google Workspace to Iru Identity so it reads users, and optionally groups, from your Google directory and keeps Iru current as people join, move, and leave.

### About Google Workspace

Connecting **Google Workspace** lets Iru Identity read users from your Google directory and keep your [directory](https://docs.iru.com/en/identity/directory/directory-overview.md) 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](https://docs.iru.com/en/identity/directory/group-sync.md) is optional and off until you turn it on. **Workday** and **BambooHR** sync users only.

> [!NOTE]
>
> This article covers the Google Workspace directory connection. It is separate from the [Google Workspace sign-in connection](https://docs.iru.com/en/identity/connections/google-workspace.md). For concepts shared across every sync provider, see [Directory Sync](https://docs.iru.com/en/identity/directory/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.

> [!TIP]
>
> 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](https://docs.iru.com/en/identity/directory/attribute-mapping.md#writing-expressions).

**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](https://docs.iru.com/en/identity/directory/directory-sync#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.

> [!WARNING]
>
> 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](https://docs.iru.com/en/identity/directory/group-sync.md) 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**.

> [!NOTE]
>
> 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.

### Related Articles

> [card] [Directory Sync](https://docs.iru.com/en/identity/directory/directory-sync)
>
> The shared concepts behind every Directory Sync provider.

> [card] [Sync groups](https://docs.iru.com/en/identity/directory/group-sync.md)
>
> Bring Google groups and their membership into Iru, and keep them current on every sync.

> [card] [Attribute mapping](https://docs.iru.com/en/identity/directory/attribute-mapping.md)
>
> Map Google fields to Iru user fields, and reshape values with IQL.

> [card] [Connect Workday](https://docs.iru.com/en/identity/directory/hris-workday.md)
>
> Read workers from a Workday report. Workday syncs users only.

> [card] [Connect BambooHR](https://docs.iru.com/en/identity/directory/hris-bamboohr.md)
>
> Read BambooHR's standard employee directory. BambooHR syncs users only.


## Related topics

- [Google Workspace](https://docs.iru.com/en/identity/connections/google-workspace.md)
- [User Directory Integration with Google Workspace](https://docs.iru.com/en/endpoint/integrations/directory-services/user-directory-integration-with-google-workspace.md)
- [Directory Sync](https://docs.iru.com/en/identity/directory/directory-sync.md)
