Add password-based single sign-on to an application

This article shows you how to set up password-based single sign-on (SSO) in Azure Active Directory (Azure AD). With password-based SSO, a user signs in to the application with a username and password the first time it's accessed. After the first sign-on, Azure AD sends the username and password to the application.

Password-based SSO uses the existing authentication process provided by the application. When you enable password-based SSO for an application, Azure AD collects and securely stores usernames and passwords for the application. User credentials are stored in an encrypted state in the directory. Password-based SSO is supported for any cloud-based application that has an HTML-based sign-in page.

Choose password-based SSO when:

  • An application doesn't support the SAML SSO protocol.
  • An application authenticates with a username and password instead of access tokens and headers.

The configuration page for password-based SSO is simple. It includes only the URL of the sign-on page that the application uses. This string must be the page that includes the username input field.


To configure password-based SSO in your Azure AD tenant, you need:

  • An Azure account with an active subscription. Create an account for free
  • One of the following roles: Global Administrator, Cloud Application Administrator, Application Administrator, or owner of the service principal.
  • An application that supports password-based SSO.

Configure password-based single sign-on

  1. Sign in to the Azure portal with the appropriate role.
  2. Select Azure Active Directory in Azure Services, and then select Enterprise applications.
  3. Search for and select the application that you want to add password-based SSO.
  4. Select Single sign-on and then select Password-based.
  5. Enter the URL for the sign-in page of the application.
  6. Select Save.

Azure AD parses the HTML of the sign-in page for username and password input fields. If the attempt succeeds, you're done. Your next step is to Assign users or groups to the application.

After you've assigned users and groups, you can provide credentials to be used for a user when they sign in to the application.

  1. Select Users and groups, select the checkbox for the user's or group's row, and then select Update Credentials.
  2. Enter the username and password to be used for the user or group. If you don't, users are prompted to enter the credentials themselves upon launch.

Manual configuration

If Azure AD's parsing attempt fails, you can configure sign-on manually.

  1. Select Configure {application name} Password Single Sign-on Settings to display the Configure sign-on page.
  2. Select Manually detect sign-in fields. More instructions that describe manual detection of sign-in fields appear.
  3. Select Capture sign-in fields. A capture status page opens in a new tab, showing the message metadata capture is currently in progress.
  4. If the My Apps Extension Required box appears in a new tab, select Install Now to install the My Apps Secure Sign-in Extension browser extension. (The browser extension requires Microsoft Edge or Chrome.) Then install, launch, and enable the extension, and refresh the capture status page. The browser extension then opens another tab that displays the entered URL.
  5. In the tab with the entered URL, go through the sign-in process. Fill in the username and password fields, and try to sign in. (You don't have to provide the correct password.) A prompt asks you to save the captured sign-in fields.
  6. Select OK. The browser extension updates the capture status page with the message Metadata has been updated for the application. The browser tab closes.
  7. In the Azure AD Configure sign-on page, select Ok, I was able to sign-in to the app successfully.
  8. Select OK.

Next steps