Self-service password reset policies - Azure Active Directory - Microsoft Entra (2023)

In Azure Active Directory (Azure AD), there's a password policy that defines settings like the password complexity, length, or age. There's also a policy that defines acceptable characters and length for usernames.

When self-service password reset (SSPR) is used to change or reset a password in Azure AD, the password policy is checked. If the password doesn't meet the policy requirements, the user is prompted to try again. Azure administrators have some restrictions on using SSPR that are different to regular user accounts.

This article describes the password policy settings and complexity requirements associated with user accounts in your Azure AD tenant, and how you can use PowerShell to check or set password expiration settings.

Username policies

Every account that signs in to Azure AD must have a unique user principal name (UPN) attribute value associated with their account. In hybrid environments with an on-premises Active Directory Domain Services (AD DS) environment synchronized to Azure AD using Azure AD Connect, by default the Azure AD UPN is set to the on-prem UPN.

The following table outlines the username policies that apply to both on-premises AD DS accounts that are synchronized to Azure AD, and for cloud-only user accounts created directly in Azure AD:

Azure AD password policies

A password policy is applied to all user accounts that are created and managed directly in Azure AD. Some of these password policy settings can't be modified, though you can configure custom banned passwords for Azure AD password protection or account lockout parameters.

By default, an account is locked out after 10 unsuccessful sign-in attempts with the wrong password. The user is locked out for one minute. Further incorrect sign-in attempts lock out the user for increasing durations of time. Smart lockout tracks the last three bad password hashes to avoid incrementing the lockout counter for the same password. If someone enters the same bad password multiple times, this behavior will not cause the account to lock out. You can define the smart lockout threshold and duration.

The Azure AD password policy doesn't apply to user accounts synchronized from an on-premises AD DS environment using Azure AD Connect, unless you enable EnforceCloudPasswordPolicyForPasswordSyncedUsers.

The following Azure AD password policy options are defined. Unless noted, you can't change these settings:

Administrator reset policy differences

By default, administrator accounts are enabled for self-service password reset, and a strong default two-gate password reset policy is enforced. This policy may be different from the one you have defined for your users, and this policy can't be changed. You should always test password reset functionality as a user without any Azure administrator roles assigned.

With a two-gate policy, administrators don't have the ability to use security questions.

The two-gate policy requires two pieces of authentication data, such as an email address, authenticator app, or a phone number. A two-gate policy applies in the following circumstances:

• All the following Azure administrator roles are affected:

  • Application administrator
  • Application proxy service administrator
  • Authentication administrator
  • Azure AD Joined Device Local Administrator
  • Billing administrator
  • Compliance administrator
  • Device administrators
  • Directory synchronization accounts
  • Directory writers
  • Dynamics 365 administrator
  • Exchange administrator
  • Global administrator or company administrator
  • Helpdesk administrator
  • Intune administrator
  • Mailbox Administrator
  • Partner Tier1 Support
  • Partner Tier2 Support
  • Password administrator
  • Power BI service administrator
  • Privileged Authentication administrator
  • Privileged role administrator
  • Security administrator
  • Service support administrator
  • SharePoint administrator
  • Skype for Business administrator
  • User administrator

• If 30 days have elapsed in a trial subscription; or

• A custom domain has been configured for your Azure AD tenant, such as contoso.com; or

• Azure AD Connect is synchronizing identities from your on-premises directory

  (Video) Lab 3 - Set up Azure Password Policies and Self-Service Password Reset

You can disable the use of SSPR for administrator accounts using the Set-MsolCompanySettings PowerShell cmdlet. The -SelfServePasswordResetEnabled $False parameter disables SSPR for administrators. Policy changes to disable or enable SSPR for administrator accounts can take up to 60 minutes to take effect.

Exceptions

A one-gate policy requires one piece of authentication data, such as an email address or phone number. A one-gate policy applies in the following circumstances:

• It's within the first 30 days of a trial subscription

  -Or-

• A custom domain isn't configured (the tenant is using the default *.onmicrosoft.com, which isn't recommended for production use) and Azure AD Connect isn't synchronizing identities.

Password expiration policies

A global administrator or user administrator can use the Microsoft Azure AD Module for Windows PowerShell to set user passwords not to expire.

You can also use PowerShell cmdlets to remove the never-expires configuration or to see which user passwords are set to never expire.

This guidance applies to other providers, such as Intune and Microsoft 365, which also rely on Azure AD for identity and directory services. Password expiration is the only part of the policy that can be changed.

Set or check the password policies by using PowerShell

To get started, download and install the Azure AD PowerShell module and connect it to your Azure AD tenant.

After the module is installed, use the following steps to complete each task as needed.

Check the expiration policy for a password

1. Open a PowerShell prompt and connect to your Azure AD tenant using a global administrator or user administrator account.

2. Run one of the following commands for either an individual user or for all users:

   • To see if a single user's password is set to never expire, run the following cmdlet. Replace <user ID> with the user ID of the user you want to check, such as driley@contoso.onmicrosoft.com:

     Get-AzureADUser -ObjectId <user ID> | Select-Object @{N="PasswordNeverExpires";E={$_.PasswordPolicies -contains "DisablePasswordExpiration"}}

   • To see the Password never expires setting for all users, run the following cmdlet:

     Get-AzureADUser -All $true | Select-Object UserPrincipalName, @{N="PasswordNeverExpires";E={$_.PasswordPolicies -contains "DisablePasswordExpiration"}}

Set a password to expire

1. Open a PowerShell prompt and connect to your Azure AD tenant using a global administrator or user administrator account.

   (Video) How to enable and configure SSPR with password writeback to Azure AD DS

2. Run one of the following commands for either an individual user or for all users:

   • To set the password of one user so that the password expires, run the following cmdlet. Replace <user ID> with the user ID of the user you want to check, such as driley@contoso.onmicrosoft.com

     Set-AzureADUser -ObjectId <user ID> -PasswordPolicies None

   • To set the passwords of all users in the organization so that they expire, use the following cmdlet:

     Get-AzureADUser -All $true | Set-AzureADUser -PasswordPolicies None

Set a password to never expire

1. Open a PowerShell prompt and connect to your Azure AD tenant using a global administrator or user administrator account.

2. Run one of the following commands for either an individual user or for all users:

   • To set the password of one user to never expire, run the following cmdlet. Replace <user ID> with the user ID of the user you want to check, such as driley@contoso.onmicrosoft.com

     Set-AzureADUser -ObjectId <user ID> -PasswordPolicies DisablePasswordExpiration

   • To set the passwords of all the users in an organization to never expire, run the following cmdlet:

     Get-AzureADUser -All $true | Set-AzureADUser -PasswordPolicies DisablePasswordExpiration

   Warning

   (Video) How do I use Azure AD SSPR | Self-Service Password Reset | Microsoft 365

   Passwords set to -PasswordPolicies DisablePasswordExpiration still age based on the pwdLastSet attribute. Based on the pwdLastSet attribute, if you change the expiration to -PasswordPolicies None, all passwords that have a pwdLastSet older than 90 days require the user to change them the next time they sign in. This change can affect a large number of users.

Next steps

To get started with SSPR, see Tutorial: Enable users to unlock their account or reset passwords using Azure Active Directory self-service password reset.

If you or users have problems with SSPR, see Troubleshoot self-service password reset