Docs

Integrations / Identity / Google Workspace

Sign Out Google Workspace User

Sign a user out of all Google Workspace web and device sessions, for example after a lost or stolen device

This tool signs a user out of all web and device sessions in Google Workspace and resets their sign-in cookies. The user must sign in again. Use it when a device is lost or stolen.

What this tool does

When the tool runs, it:

  1. Sends a sign-out request for the user to Google Workspace.
  2. Returns a confirmation that all web and device sessions are no longer valid.

The sign-out can take a few minutes to reach all devices. The tool does not change the user's password. To also set a new password, use Reset Google Workspace User Password.

Prerequisites

  • The Google Workspace tools connector is connected. The tool runs on the connector's grant. It does not use the Admin API card on Settings > Integrations > Google Workspace.
  • The connector grant includes the https://www.googleapis.com/auth/admin.directory.user.security scope. When you add this tool, Risotto adds the scope to the connector consent. An admin must click Reconnect on the connector and approve the scope.
  • The Google admin who gave consent has the User Management admin privilege.

Enable the tool

  1. Select Tools in the sidebar.
  2. In the Tool groups list, select Google.
  3. On the Google Workspace Sign Out User row, click Enable.

Risotto names the new tool Sign Out Google Workspace User. The tool has Approval set to Required by default, so an approver must accept each sign-out before it runs.

Tool options

  • Restrict to Requestor Only (default: on): when on, the tool can only sign out the ticket requestor. Turn it off to let IT staff sign out other users.

The tool has one parameter, email_address. It is optional. When it is empty, the tool uses the ticket requestor's email address.

Troubleshooting

Google is not connected for this org

Connect the Google Workspace tools connector on the Tools app card of Settings > Integrations > Google Workspace, then run the tool again.

Google refused the call

The connector grant does not include the admin.directory.user.security scope, or the admin who connected it does not have the User Management privilege. Click Reconnect on the connector and approve the scope.

not found in Google Workspace

Make sure the email address belongs to a user in your Google Workspace domain.

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