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

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

## Related

- [Google Workspace tools connector](https://www.tryrisotto.com/docs/integrations/google-workspace-tools)
- [Sign Out Google Workspace User](https://www.tryrisotto.com/docs/integrations/tools/google/sign_out_user)
- [Reset Google Workspace User Password](https://www.tryrisotto.com/docs/integrations/tools/google/reset_password)

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