This documentation is for WSO2 Identity Server 5.3.0 . View documentation for the latest release.
Skip to end of metadata
Go to start of metadata

This topic guides you through configuring reCAPTCHA for the single sign-on flow. By configuring reCAPTCHA, you can mitigate or block brute force attacks.

  1. Set up reCAPTCHA with WSO2 Identity Server. For instructions on how to do this and more information about reCAPTCHA, see Setting Up reCAPTCHA

  2. If you want to modify the filter mapping for reCAPTCHA: 
    1. Open the web.xml file in the <IS_HOME>/repository/conf/tomcat/carbon/WEB-INF directory.
    2. Locate the following filter and modify the relevant URL patterns if required. 

  3. Start WSO2 Identity Server and sign in to the Management Console.
  4. On the Main tab, click Identity > Identity Providers > Resident.
  5. To configure captcha:
    1. Expand Login Policies > Captcha for SSO Login
    2. Provide the required data as given below. 

      FieldDescriptionSample Value
      EnableThis determines whether the captcha verification at SSO should be enabled or not.Enable
      Max failed attempts

      This defines the maximum number of failed attempts allowed without having to use the captcha.

      This value should be less than the number of failed attempts configured for account locking in the next step.


  6. To configure account locking: 

    This configuration ensures that user account gets locked when an incorrect password is typed even after using the captcha.

    1. Expand  Login Policies > Account Locking.

    2. Provide the required data as given below. 

      FieldDescriptionSample Value
      Account Lock Enabled

      This determines whether the accounts should get locked for failed logins or not.

      Maximum Failed Login Attempts

      This defines the maximum number of failed attempts allowed.

      Account Unlock TimeThis defines the duration in minutes for which the account is locked for.5
      Lock Timeout Increment Factor

      This defines how the account unlock time should be increased for every subsequent account locking.


  7. Click Update.
    You have successfully configured reCAPTCHA for SSO.

  8. Access the WSO2 Identity Server Dashboard.

  9. Attempt signing in as an administrator with an incorrect password for three times. The reCAPTCHA appears.

  • No labels