How it works: Microsoft Entra self-service password reset

Microsoft Entra self-service password reset (SSPR) gives users the ability to change or reset their password, with no administrator or help desk involvement. If a user's account is locked or they forget their password, they can follow prompts to unblock themselves and get back to work. This ability reduces help desk calls and loss of productivity when a user can't sign in to their device or an application.

How does the password reset process work?

A user can reset or change their password using the SSPR portal. They must first register their desired authentication methods. When a user accesses the SSPR portal, the Microsoft Entra platform considers the following factors:

• How should the page be localized?
• Is the user account valid?
• What organization does the user belong to?
• Where is the user's password managed?

When a user selects the Can't access your account link from an application or page, or goes directly to https://passwordreset.activedirectory.windowsazure.cn, the language used in the SSPR portal is based on the following options:

• By default, the browser locale is used to display the SSPR in the appropriate language. The password reset experience is localized into the same languages that Microsoft 365 supports.
• If you want to link to the SSPR in a specific localized language, append ?mkt= to the end of the password reset URL along with the required locale.
  • For example, to specify the Spanish es-us locale, use ?mkt=es-us - https://passwordreset.activedirectory.windowsazure.cn/?mkt=es-us.

After the SSPR portal is displayed in the required language, the user is prompted to enter a user ID and pass a captcha. Microsoft Entra ID now verifies that the user is able to use SSPR by doing the following checks:

• Checks that the user has SSPR enabled.
  • If the user isn't enabled for SSPR, the user is asked to contact their administrator to reset their password.
• Checks that the user has the right authentication methods defined on their account in accordance with administrator policy.
  • If the policy requires only one method, check that the user has the appropriate data defined for at least one of the authentication methods enabled by the administrator policy.
    • If the authentication methods aren't configured, the user is advised to contact their administrator to reset their password.
  • If the policy requires two methods, check that the user has the appropriate data defined for at least two of the authentication methods enabled by the administrator policy.
    • If the authentication methods aren't configured, the user is advised to contact their administrator to reset their password.
  • If an Azure administrator role is assigned to the user, then the strong two-gate password policy is enforced. For more information, see Administrator reset policy differences.
• Checks to see if the user's password is managed on-premises, such as if the Microsoft Entra tenant is using federated, or password hash synchronization:
  • If SSPR writeback is configured and the user's password is managed on-premises, the user is allowed to proceed to authenticate and reset their password.
  • If SSPR writeback isn't deployed and the user's password is managed on-premises, the user is asked to contact their administrator to reset their password.

If all of the previous checks are successfully completed, the user is guided through the process to reset or change their password.

To get started with SSPR, complete the following tutorial:

Require users to register when they sign in

You can enable the option to require a user to complete the SSPR registration if they use modern authentication or web browser to sign in to any applications using Microsoft Entra ID. This workflow includes the following applications:

• Microsoft 365
• Microsoft Entra admin center
• Access Panel
• Federated applications
• Custom applications using Microsoft Entra ID

When you don't require registration, users aren't prompted during sign-in, but they can manually register. Users can either visit https://account.activedirectory.windowsazure.cn/PasswordReset/Register.aspx?regref=ssprsetup or select the Register for password reset link under the Profile tab in the Access Panel.

Reconfirm authentication information

To make sure that authentication methods are correct when they're needed to reset or change their password, you can require users confirm their info registered information after a certain period of time. This option is only available if you enable the Require users to register when signing in option.

Valid values to prompt a user to confirm their registered methods are from 0 to 730 days. Setting this value to 0 means that users are never asked to confirm their authentication information. When using the combined registration experience users will be required to confirm their identity before reconfirming their information.

Authentication methods

When a user is enabled for SSPR, they must register at least one authentication method. We highly recommend that you choose two or more authentication methods so that your users have more flexibility in case they're unable to access one method when they need it.

The following authentication methods are available for SSPR:

• Mobile app notification
• Mobile app code
• Email
• Mobile phone
• Office phone (available only for tenants with paid subscriptions)
• Security questions

Users can only reset their password if they register an authentication method that the administrator has enabled.

Number of authentication methods required

You can configure the number of the available authentication methods a user must provide to reset or unlock their password. This value can be set to either one or two.

Users should register multiple authentication methods so they can sign-in another way if they're unable to access one method.

If a user doesn't register the minimum number of required methods, they see an error page when they try to use SSPR. They need to request that an administrator reset their password. For more information, see Change authentication methods.

Mobile app and SSPR

When using a mobile app as a method for password reset, like Microsoft Authenticator, the following considerations apply if an organization hasn't migrated to the centralized Authentication methods policy:

• When administrators require one method be used to reset a password, verification code is the only option available.
• When administrators require two methods be used to reset a password, users are able to use notification OR verification code in addition to any other enabled methods.

Number of methods required to reset	One	Two
Mobile app features available	Code	Code or Notification

Users can register their mobile app at https://account.activedirectory.windowsazure.cn/proofup.aspx?culture=en-US.

Change authentication methods

If you start with a policy that has only one required authentication method for reset or unlock registered and you change that to two methods, what happens?

Number of methods registered	Number of methods required	Result
1 or more	1	Able to reset or unlock
1	2	Unable to reset or unlock
2 or more	2	Able to reset or unlock

Changing the available authentication methods may also cause problems for users. If you change which authentication methods are available, users without the minimum amount of data available can't use SSPR.

Consider the following example scenario:

1. The original policy is configured with two authentication methods required. It uses only the office phone number and the security questions.
2. The administrator changes the policy to no longer use the security questions, but allows the use of a mobile phone and an alternate email.
3. Users without the mobile phone or alternate email fields populated now can't reset their passwords.

Notifications

To improve awareness of password events, SSPR lets you configure notifications for both the users and identity administrators.

Notify users on password resets

If this option is set to Yes, users resetting their password receive an email notifying them that their password has been changed. The email is sent via the SSPR portal to their primary and alternate email addresses that are stored in Microsoft Entra ID. If no primary or alternate email address is defined SSPR will attempt email notification via the users User Principal Name (UPN). No one else is notified of the reset event.

Notify all admins when other admins reset their passwords

If this option is set to Yes, then Global Administrators receive an email to their primary email address stored in Microsoft Entra ID. The email notifies them that another administrator has changed their password by using SSPR.

If you observe issues in receiving notifications, please check your spam settings.

If you want custom administrators to receive the notification emails, use SSPR customizations and set up a custom helpdesk link or email.

On-premises integration

In a hybrid environment, you can configure Microsoft Entra Connect cloud sync to write password change events back from Microsoft Entra ID to an on-premises directory.

Microsoft Entra ID checks your current hybrid connectivity and provides messages in the Microsoft Entra admin center. For help with resolving possible errors, see Troubleshoot Microsoft Entra Connect.

To get started with SSPR writeback, complete the following tutorial:

Write back passwords to your on-premises directory

You can enable password writeback using the Microsoft Entra admin center. You can also temporarily disable password writeback without having to reconfigure Microsoft Entra Connect.

• If the option is set to Yes, then writeback is enabled. Federated, or password hash synchronized users are able to reset their passwords.
• If the option is set to No, then writeback is disabled. Federated, or password hash synchronized users aren't able to reset their passwords.

Allow users to unlock accounts without resetting their password

By default, Microsoft Entra ID unlocks accounts when it performs a password reset. To provide flexibility, you can choose to allow users to unlock their on-premises accounts without having to reset their password. Use this setting to separate those two operations.

• If set to Yes, users are given the option to reset their password and unlock the account, or to unlock their account without having to reset the password.
• If set to No, users are only be able to perform a combined password reset and account unlock operation.

On-premises Active Directory password filters

SSPR performs the equivalent of an admin-initiated password reset in Active Directory. If you use a third-party password filter to enforce custom password rules, and you require that this password filter is checked during Microsoft Entra self-service password reset, ensure that the third-party password filter solution is configured to apply in the admin password reset scenario. Microsoft Entra password protection for Active Directory Domain Services is supported by default.

Password reset for B2B users

Password reset and change are fully supported on all business-to-business (B2B) configurations. B2B user password reset is supported in the following three cases:

• Users from a partner organization with an existing Microsoft Entra tenant: If your partner has a Microsoft Entra tenant, we respect whatever password reset policies are enabled on that tenant. For password reset to work, the partner organization just needs to make sure that Microsoft Entra SSPR is enabled. There's no other charge for Microsoft 365 customers.
• Users who sign up through self-service sign-up: If your partner used the self-service sign-up feature to get into a tenant, we let them reset the password with the email they registered.
• B2B users: Any new B2B users created by using the new Microsoft Entra B2B capabilities can also reset their passwords with the email they registered during the invite process.

To test this scenario, go to https://passwordreset.activedirectory.windowsazure.cn with one of these partner users. If the user defined an alternate email or authentication email, password reset works as expected.

Next steps

To get started with SSPR, complete the following tutorial: