Customize Azure AD functionality for Self-Service Password Reset

IT Professionals looking to deploy self-service password reset can customize the experience to match their users.

Even if SSPR is not enabled users still a "contact your administrator" link on the password reset portal. Clicking this link emails your administrators asking for assistance in changing the user's password. This email is sent to the following recipients in the following order:

  1. If the Password administrator role is assigned, administrators with this role are notified
  2. If no Password administrators are assigned, then administrators with the User administrator role are notified
  3. If neither of the previous roles were assigned, then Global administrators are notified

In all cases, a maximum of 100 recipients are notified.

To find out more about the different administrator roles and how to assign them see the document Assigning administrator roles in Azure Active Directory

Disable contact your administrator emails

If your organization does not want administrators notified about password reset requests, the following configuration can be enabled

  • Enable self-service password reset for all end users. This option is under Password Reset > Properties.
    • If you do not wish users to reset their own passwords, you can scope access to an empty group we do not recommend this option.
  • Customize the helpdesk link to provide a web URL or mailto: address that users can use to get assistance. This option is under Password Reset > Customization > Custom helpdesk email or URL.

Customize ADFS sign-in page for SSPR

ADFS Administrators can add a link to their sign-in page using the guidance found in the article Add sign-in page description.

Using the command that follows on your ADFS server adds a link to the ADFS login page allowing users to enter the self-service password reset workflow directly.

Set-ADFSGlobalWebContent -SigninPageDescriptionText "<p><A href=’’>Can’t access your account?</A></p>"

Customize the sign-in and access panel look and feel

When your users access the login page, you can customize the logo that appears along with the sign-in page image to fit your company branding.

These graphics are shown in the following circumstances:

Graphics details

The following settings allow you to change the visual characteristics of the sign-in page and can be found under Azure Active Directory, Company branding, Edit company branding

  • Sign-in page image should be a PNG or JPG file 1420x1200 pixels and no larger than 500KB. We recommend it to be around 200 KB for best results.
  • Sign-in page background color is used when on high-latency connections and must be in the RGB hex format.
  • Banner image should be a PNG or JPG file 60x280 pixels and no larger than 10 KB.
  • Square logo (normal and dark theme) PNG or JPG 240x240 (resizable) no larger than 10 KB.

text options

The following settings allow you to add text to the sign-in page relevant to your organization. These settings can be found under Azure Active Directory, Company branding, Edit company branding

  • User name hint replaces the example text of with something more appropriate for your users, recommended to be left default when supporting internal and external users
  • Sign-in page text is a maximum of 256 characters in length. This text appears anywhere your users login online, and in the Azure AD Join experience on Windows 10. Use this text for terms of use, instructions, and tips for your users. Anyone can see your sign-in page so do not provide any sensitive information here.

Keep me signed in disabled

The option "Keep me signed in disabled" allows users to remain signed in when they close and reopen their browser window. This option does not impact session lifetimes. This setting is found under Azure Active Directory > Company branding > Edit company branding.

Some features of SharePoint Online and Office 2010 have a dependency on users being able to check this box. If you hide this option, users may get additional and unexpected sign-in prompts.

Directory name

You can change the name attribute under Azure Active Directory > Properties to show a friendly organization name seen in the portal and automated communications. This option is most visible in the form of automated emails in the forms that follow

  • Friendly name in email “Microsoft on behalf of CONTOSO demo”
  • Subject line in email “CONTOSO demo account email verification code”

Next steps

The following links provide additional information regarding password reset using Azure AD

  • Quick Start - Get up and running with Azure AD self service password management
  • Licensing - Configure your Azure AD Licensing
  • Data - Understand the data that is required and how it is used for password management
  • Rollout - Plan and deploy SSPR to your users using the guidance found here
  • Policy - Understand and set Azure AD password policies
  • Password Writeback - How does password writeback work with your on-premises directory
  • Reporting - Discover if, when, and where your users are accessing SSPR functionality
  • Technical Deep Dive - Go behind the curtain to understand how it works
  • Frequently Asked Questions - How? Why? What? Where? Who? When? - Answers to questions you always wanted to ask
  • Troubleshoot - Learn how to resolve common issues that we see with SSPR