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.
What this tool does
When the tool runs, it:
- 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.
- Makes a temporary password of 16 characters. The password has at least one lowercase letter, one uppercase letter, one digit and one symbol.
- 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.
- Sends the temporary password to the requestor by direct message.
- 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 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.userscope. 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
- Select Tools in the sidebar.
- In the Tool groups list, select Google.
- 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 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
Something wrong or missing? Report an issue · View as Markdown