Docs

Integrations / Identity / Google Workspace

Google Workspace

Configure Google Workspace identity and admin integration with Risotto

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

Prerequisites

  • Google Workspace Admin access
  • Ability to authorize OAuth applications

Setup Process

Step 1: Start OAuth Authorization

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

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

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

Re-authorizing

To reconnect or refresh permissions:

  1. Disconnect Google Workspace (see 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:

Something wrong or missing? Report an issue · View as Markdown