Skip to content

Configure conditional authentication

Given below are the high-level steps for enabling conditional authentication in your application.


Register your application on the WSO2 Identity Server Console.

Before you proceed (only for JDK 17)

If your system operates on JDK 17, refer to Enable adaptive authentication to deploy WSO2 Identity Server with conditional authentication.

Enable conditional authentication

Follow the steps given below.

  1. On the WSO2 Identity Server Console, click Applications.
  2. Select the application for which you wish to apply a conditional login flow and go to its Login Flow tab.
  3. Click Start with default configuration to define the login flow starting with the username and password login.
  4. Turn on Conditional Authentication by switching the toggle on. You can define your conditional authentication script in the editor.

    Enable conditional auth


    As a security measure, WSO2 Identity Server does not allow the usage of two consecutive periods (..) in authentication scripts.

Add conditional authentication script

There are two ways to add a conditional authentication script: