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:
- Sends a sign-out request for the user to Google Workspace.
- 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.securityscope. 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
- Select Tools in the sidebar.
- In the Tool groups list, select Google.
- 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.
Related
Something wrong or missing? Report an issue · View as Markdown