# 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](https://www.tryrisotto.com/docs/integrations/tools/google/reset_password).

## Prerequisites

- The [Google Workspace tools connector](https://www.tryrisotto.com/docs/integrations/google-workspace-tools) 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](https://www.tryrisotto.com/docs/integrations/google-workspace-tools) 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.

## Related

- [Google Workspace tools connector](https://www.tryrisotto.com/docs/integrations/google-workspace-tools)
- [Reset Google Workspace User Password](https://www.tryrisotto.com/docs/integrations/tools/google/reset_password)
- [Reset Google Workspace 2-Step Verification](https://www.tryrisotto.com/docs/integrations/tools/google/reset_two_step_verification)
- [Set Google Workspace User Suspension](https://www.tryrisotto.com/docs/integrations/tools/google/set_user_suspension)

Source: https://www.tryrisotto.com/docs/integrations/tools/google/sign_out_user
