# Reset Google Workspace User Password

Reset a user's Google Workspace password and send a temporary password to the requestor by direct message

This tool resets a user's Google Workspace password. It sets a new **temporary password** and, by default, makes the user change it at the next sign-in. Use it when a user is locked out or forgot their password.

> **Note:** Risotto sends the temporary password to the requestor **by direct message
> only**. The password is not in the channel, the ticket, or the tool result. If
> Risotto cannot send the direct message, run the reset again to get a new
> password.

## What this tool does

When the tool runs, it:

1. Finds a Slack or Microsoft Teams account for the requestor, to send the password privately. If it finds none, it stops and does not change the account.
2. Makes a temporary password of 16 characters. The password has at least one lowercase letter, one uppercase letter, one digit and one symbol.
3. Sets the temporary password on the Google Workspace user. By default, it also sets the account so the user must change the password at the next sign-in.
4. Sends the temporary password to the requestor by **direct message**.
5. Returns a confirmation that does not contain the password.

The direct message always goes to the requestor of the ticket, also when the tool resets the password of a different user.

## 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` 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. Only a super admin can reset the password of another admin.
- The requestor can receive direct messages from Risotto in Slack or Microsoft Teams.

## Enable the tool

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

Risotto names the new tool **Reset Google Workspace User Password**. 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 the password of the ticket requestor. Turn it off to let IT staff reset passwords for other users.

The tool has two parameters:

| Parameter               | Description                                                                                                    |
| ----------------------- | -------------------------------------------------------------------------------------------------------------- |
| `email_address`         | Optional. The email address of the user. When it is empty, the tool uses the ticket requestor's email address. |
| `force_change_password` | Optional. Default: true. Makes the user change the temporary password at the next sign-in.                     |

## Troubleshooting

### no reachable Slack or Microsoft Teams account was found

The tool sends the temporary password only by direct message. Make sure the requestor can receive direct messages from Risotto, then run the reset again. The account does not change when this error occurs.

### 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` scope, or the admin who connected it does not have the **User Management** privilege. Click **Reconnect** on the connector and approve the scope. To reset the password of an admin, a super admin must give the consent.

### Failed to deliver the temporary password

The reset finished, but the direct message failed. Nobody received the new password. Make sure the requestor can receive direct messages, then run the reset again to make a new password.

### 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)
- [Entra Reset User Password](https://www.tryrisotto.com/docs/integrations/tools/entra/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/reset_password
