Skip to content

Configuring Multi-factor Authentication with Username and Password

This scenario involves obtaining the username first and validating that before authenticating the user using the password.


Consider a scenario where you want to log in users' to your application by validating the username and authenticating the user using the password that the user enters.


Configure username validation

To configure MFA using username and password:

  1. On the management console, go to Main > Identity > Service Providers > List.

  2. Click Edit on the service provider you have created.

  3. Expand the Local and Outbound Authentication Configuration section and click Advanced Configuration.

  4. Click Add Authentication Step twice to add two authentication steps for the application.

  5. Select the following authenticators from the Local Authenticators dropdown.

    Authentication step Local authenticator
    First step Identifier First
    Second step Username & Password


    The Identifier First is not an authenticator, so having only the identifier in the authentication flow will fail the authentication. If there are no authenticators configured other than identifier, an error occurs when updating the service provider.

  6. Click Update to save your configurations.


The reCAPTCHA validation capability is available for the Identifier First authentication flow handler as an update in WSO2 IS 6.1.0 from update level 32 onwards. See the instructions on how to upgrade the WSO2 Identity Server.

Configure the server

By default, the username is not validated, and WSO2 Identity Server does not check whether it exists in the user store.

To enable username validation for applications: 1. Add the following code segment to <IS_HOME>/repository/conf/deployment.toml file to start validating the username.

name = "IdentifierExecutor"
enable = true

validate_username = true
  1. Restart the Identity Server.

Try it out

  1. Access the following sample PickUp application URL:
  2. Click Login, and enter admin's username.
  3. On the next screen, enter admin's password and click Continue.
  4. You will be successfully logged in to the application. Logout of the application.
  5. Click Login again, and enter a username that is not registered on the IS.
  6. Click Continue.

    You will get an error message a user with the username you entered is not registered on the IS.

    username validation error