Docs

Integrations / Identity / Microsoft Entra

Reset User Password

Reset a user's password in Microsoft Entra ID and deliver a temporary password by direct message

Resets a user's password in Microsoft Entra ID by setting a new temporary password and (by default) requiring the user to change it at their next sign-in. This is typically used when a user is locked out or has forgotten their password.

What this tool does

When executed, the tool:

  1. Resolves a reachable Slack or Microsoft Teams account for the requestor (so the temporary password can be delivered privately). If none is found, it stops without touching the account.
  2. Looks up the user in Entra by email address.
  3. Sets a new temporary password and, by default, flags the account so the user must change it at next sign-in.
  4. Sends the temporary password to the requestor by direct message only.
  5. Returns a sanitized confirmation to the channel that never contains the password.

By default the tool only operates on the ticket requestor. This can be changed with the Restrict to Requestor Only setting so IT staff can reset passwords on behalf of other users.

What the user sees

When the user next signs in with the temporary password, Microsoft shows an Update your password prompt before they can continue. It explains that they need to update their password because this is their first time signing in or because their password has expired. They enter the temporary password in the Current password field, choose a new one in New password, repeat it in Confirm password, and click Sign in.

Prerequisites

This tool calls Microsoft Graph with an Entra app registration using application (client credentials) permissions. The app registration must have:

RequirementValue
API permissionUser-PasswordProfile.ReadWrite.All (application, with admin consent)
API permissionUser.Read.All (application, to look up the user by email)
Directory roleUser Administrator assigned to the app's service principal

Setup

You have two options for providing credentials. Adding the permissions to your existing Entra app is preferred — it reuses the connection you already configured under your Identity Provider integration.

If you already connected Microsoft Entra ID as an Identity Provider, extend that same app registration:

  1. Add the API permissions

    1. In the Azure Portal, open Microsoft Entra ID > App registrations and select your Risotto app registration.
    2. Go to API permissions > Add a permission > Microsoft Graph > Application permissions.
    3. Add User-PasswordProfile.ReadWrite.All and (if not already present) User.Read.All.
    4. Click Grant admin consent for [Your Organization] and confirm.
  2. Assign the User Administrator role

    1. In Microsoft Entra ID, go to Roles and administrators. 2. Open the User Administrator role and click Add assignments. 3. Search for your app registration by name and assign it.
  3. Leave the tool credentials blank in Risotto

    When the tool's credential fields (Entra Tenant ID (Optional), Entra Client ID (Optional), Entra Client Secret (Optional)) are left empty, Risotto automatically falls back to your organization's Entra credentials. No further configuration is needed.

Option B — Create a dedicated Entra app

If you prefer to isolate this tool with its own credentials and only the permissions it needs:

  1. Register an application

    1. In the Azure Portal, open Microsoft Entra ID > App registrations > New registration.
    2. Name it (e.g. Risotto Entra Password Reset), choose Accounts in this organizational directory only, and click Register.
    3. Copy the Application (client) ID and Directory (tenant) ID.
  2. Add the API permissions

    1. Go to API permissions > Add a permission > Microsoft Graph > Application permissions.
    2. Add User-PasswordProfile.ReadWrite.All and User.Read.All.
    3. Click Grant admin consent for [Your Organization] and confirm.
  3. Assign the User Administrator role

    1. In Microsoft Entra ID > Roles and administrators, open the User Administrator role.
    2. Click Add assignments, search for the new app registration, and assign it.
  4. Create a client secret

    1. Go to Certificates & secrets > New client secret.
    2. Add a description and expiration, then click Add.
    3. Copy the secret value immediately — it is only shown once.
  5. Configure the tool in Risotto

    Select Tools in the sidebar and select Entra in the Tool groups list. Open the tool and click Edit. In Tool Configuration, fill in:

    FieldValue
    Entra Tenant ID (Optional)Directory (tenant) ID
    Entra Client ID (Optional)Application (client) ID
    Entra Client Secret (Optional)The secret value you copied

    Click Save.

Tool options

When using this tool in a runbook, you can configure:

  • Restrict to Requestor Only (default: on) — when enabled, the tool can only reset the ticket requestor's password. Disable to allow resets on behalf of other users.

The user is always required to change the temporary password at their next sign-in — this is part of the reset itself, not a configurable option. For an approval step before the reset runs, use the standard tool approval setting on the tool itself.

Troubleshooting

  • "no reachable Slack or Microsoft Teams account was found" — the temporary password can only be delivered by DM. Confirm the requestor can receive direct messages from Risotto, then run the reset again.
  • "requires the User-PasswordProfile.ReadWrite.All application permission … and the User Administrator role" — the app registration is missing the API permission, admin consent, or the directory role. Re-check the setup steps above.
  • "User not found in Microsoft Entra ID" — verify the email matches the user's mail or userPrincipalName in Entra.

Something wrong or missing? Report an issue · View as Markdown