# Google Workspace

Configure Google Workspace identity and admin integration with Risotto

Connect your Google Workspace to Risotto for automated group management and access control.

> **Note:** **Looking for Dashboard SSO?** This integration is for managing user access to
> applications through Risotto. To configure SSO for signing into the Risotto
> dashboard itself, see [Dashboard Authentication
> Setup](https://www.tryrisotto.com/docs/guides/dashboard-authentication).

## Prerequisites

- **Google Workspace Admin** access
- Ability to authorize OAuth applications

## Setup Process

### Step 1: Start OAuth Authorization

1. **Navigate to Settings**

   In your Risotto dashboard, go to **Settings** > **Integrations** and click the **Google Workspace** card. You need to be an Org Admin in Risotto to finish the connection.

2. **Click Connect**

   On the **Admin API** card, click **Connect** to start the OAuth flow.

   *Product example: The Google Workspace integration page in the Risotto dashboard, not connected, with Connect on the Admin API card.*

3. **Authorize Access**

   Google opens its authorization page.

   1. Sign in with your Google Workspace admin account.
   2. Review the requested permissions.
   3. Click **Allow** to grant access.

4. **Complete Setup**

   Google sends you back to **Settings > Integrations > Google Workspace**. The **Admin API** card now shows **Connected**. If Google did not grant the required admin scopes, Risotto shows an error instead and nothing is saved: connect again with a Google Workspace super admin account.

## Permissions Granted

When you authorize Risotto, you're granting the following permissions:

- **Sign-in and basic profile** - Your email address and basic profile (`openid`, `userinfo.email`, `userinfo.profile`)
- **Read user profiles** - View directory user information (`admin.directory.user.readonly`)
- **Manage Google Groups** - Read groups and change their memberships (`admin.directory.group`)
- **Manage group settings** - Read and change group settings (`apps.groups.settings`)

## Configuration

Once connected, Risotto can:

- Add users to Google Groups and remove them when access rules grant, revoke, or expire access
- Check group membership, group settings, and group managers
- Read user directory information

## Group requests

Turn on **Group requests** to let Risotto handle a request to join a Google Group that has no [access rule](https://www.tryrisotto.com/docs/dashboard/applications/access-rules). The switch is on the **Admin API** card under **Settings > Integrations > Google Workspace**. It is off by default and applies to your whole organization.

When someone asks to join a group that no access rule covers, Risotto reads the group's own settings in Google:

- If only invited users can join, Risotto refuses the request.
- If anyone can join without approval, Risotto adds the user.
- If the group needs approval to join, Risotto sends a direct message to every owner and manager of the group. Any one of them can approve.

If Risotto cannot find any of the owners or managers in Slack or Microsoft Teams, it escalates the ticket to your team. A group that needs approval but has no owner or manager is not offered.

- An access rule for a group always takes priority over this switch.
- When you turn the switch on, Risotto adds a runbook named "Google Group access requests". When you turn it off, Risotto deletes that runbook, so your changes to it are lost.
- Risotto keeps a group's settings and its owner list for up to one day. A change in Google can take a day to apply.
- Risotto needs the **Manage group settings** permission (`apps.groups.settings`) to read a group's settings. If Google returns a permissions error, [reconnect Google Workspace](#re-authorizing).

> **Note:** A runbook's **Request Approval** step can ask only the approvers that the
> runbook tags. It cannot ask a group owner that the agent finds during the run.
> To have group owners approve, use **Group requests**.

## Managing the Connection

Once connected, the **Admin API** card has a **Connected** menu and a **Group requests** switch.

### Group requests

Turn on **Group requests** to have Risotto handle access requests for Google Groups that don't have an access rule. Each group's own settings decide who can join. If a group requires approval, Risotto asks the group's managers before it adds the user. Turning the switch on adds a runbook named **Google Group access requests**.

### Revoking Access

If you need to disconnect Google Workspace:

1. In Risotto, go to **Settings** > **Integrations** > **Google Workspace**
2. On the **Admin API** card, click **Connected**, then click **Disconnect...**
3. In the **Disconnect from Google Workspace?** dialog, click **Disconnect**
4. Optionally, revoke access in [Google Account settings](https://myaccount.google.com/permissions)

*Product example: The Google Workspace integration page in the Risotto dashboard once connected, with the Group requests switch and the Admin API card's Connected menu open on Disconnect.*

### Re-authorizing

To reconnect or refresh permissions:

1. Disconnect Google Workspace (see [Revoking Access](https://www.tryrisotto.com/docs/integrations/idp/google-workspace#revoking-access))
2. On the **Admin API** card, click **Connect**
3. Complete the OAuth flow again

## Troubleshooting

**Authorization Failed**

- Ensure you're using a Google Workspace admin account
- Check that third-party app access is enabled. In the Google Admin console, go to **Menu** > **Security** > **Access and data control** > **API controls** > **Manage Third-Party App Access**
- If Risotto shows "Google did not grant the required admin scopes", connect again with a Google Workspace super admin account

**Groups Not Syncing**

- Check group settings in Google Admin console
- Ensure groups are not restricted
- Verify you have the necessary admin permissions

**Permission Errors**

- Re-authorize the connection to refresh permissions
- Verify your admin account has the necessary privileges

## Support

For help with Google Workspace integration:

- Check your [Google Admin console](https://admin.google.com) settings
- Review [Google Workspace OAuth documentation](https://developers.google.com/workspace/guides/auth-overview)
- Contact your Risotto administrator

Source: https://www.tryrisotto.com/docs/integrations/idp/google-workspace
