Docs

Integrations / Identity / Google Workspace

Reset Google Workspace 2-Step Verification

Turn off a user's 2-Step Verification in Google Workspace so they can enroll again, for example after a lost or new phone

This tool turns off a user's 2-Step Verification in Google Workspace. The user can then enroll again at their next sign-in. Use it when a user lost their phone, got a new phone, or is locked out.

What this tool does

When the tool runs, it:

  1. Sends a request to Google Workspace to turn off 2-Step Verification for the user.
  2. Returns a confirmation that the user can enroll again at their next sign-in.

The tool does not sign the user out and does not change the password. To also end the user's sessions, use Sign Out Google Workspace User. To 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. If your organization already uses Sign Out Google Workspace User, the grant has this 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 Reset 2-Step Verification row, click Enable.

Risotto names the new tool Reset Google Workspace 2-Step Verification. The tool has Approval set to Required by default, so an approver must accept each reset before it runs.

Tool options

  • Restrict to Requestor Only (default: on): when on, the tool can only reset 2-Step Verification for the ticket requestor. Turn it off to let IT staff reset it for 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.

Google rejected the request

The user does not have 2-Step Verification enrolled, or 2-Step Verification enforcement prevents the turn-off. Check the security policy of the user's organizational unit in Google Admin.

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