loginradiusloginradius Blog

Testing Brute-force Lockout with LoginRadius

In this blog, you'll learn about brute-force lockout, the creation of a basic app using Identity Experience Framework, and how to unlock a user account using APIs.

First, let's understand some basic terminology.

Basic Terminology

  1. Brute-force attack: A method where every possible combination of characters or values is systematically tried to gain unauthorized access to a system, application, or data.
  2. Brute-force lock: Brute-force lock is a type of account lock made to prevent a bruteforce attack.
  3. Brute-force lockout: Brute-force lockout is a security mechanism that blocks access after a certain number of failed authentication attempts to prevent unauthorized access through repeated trial and error.
  4. CAPTCHA (Completely Automated Public Turing test to tell Computers and Humans Apart): CAPTCHA is a method used to determine whether a user is human by presenting a challenge that is easy for humans to solve but difficult for bots.
  5. Multi-Factor Authentication (MFA): MFA is a security method that requires multiple forms of identification to grant access, typically combining something the user knows, has, and is.

In LoginRadius, you can implement brute-force lockout using APIs.

To implement brute-force lockout, please register in the LoginRadius Admin Console.

Let's go through the API implementation of brute-force lockout and user unlock.

API Implementation for Brute-force Lockout

Creating a Basic Application

  1. To implement brute-force lockout using API, create a simple app with login and registration features.
  2. This can be done by using Admin Console.
  3. Navigate through Deployment > Identity Experience Framework.
  4. You can design the required application using theme, customization, preview, and implement options.
  5. You can also customize the predefined templates if needed.

You can view the created app using the link https://<app-name>.hub.loginradius.com/auth.aspx in the implement section of the Identity Experience Framework or from the preview section.

Brute-force Lockout


In LoginRadius, the brute-force lockout feature can be enabled from the Admin Console.



  1. Register with a new user and log in with the correct email and password. It is observed that the user is redirected to the profile page after authentication.


  1. Now, log out and try to log in with incorrect credentials.
  2. If the password is incorrect successively till the lockout threshold, the account gets locked.
  3. Therefore, brute-force lockout is achieved.


In the Admin Console, you can set the brute-force lockout threshold, lockout type, and suspend effective period.

Lockout Types in LoginRadius

LoginRadius supports the following lockout types:

  1. Suspend: Suspends further login attempts after multiple failed tries for a certain amount of time, deterring automated attacks and enhancing system security by limiting access from suspicious sources.

    • A security measure used to unlock a locked account on entering valid credentials by presenting a challenge to solve.
    • This challenge is often easy for humans to solve but difficult for the bots.

    Refer CAPTCHA in miscellaneous section to learn more.

  3. Security Questions: A personalized query set up by the user to verify identity to unlock a locked account with valid credentials.
  4. Block: Restricts login attempts from a specific source (email ID or username) after multiple failed tries, enhancing security against unauthorized access.

Unlocking an Account Locked through Brute-force Lockout

You can unlock the locked user account in two ways, using:

  1. Account Update API from the LoginRadius Account API collection.
  2. Auth Unlock Account by Access Token from the LoginRadius Authentication API collection.

For more understanding on Auth Unlock Account, refer Auth Security Configuration

Account Update API from the LoginRadius Account API Collection

Calling the Account Update API with the provided endpoint, using the given method, providing the apisecret and apikey, and formatting the given body will unlock the account.

  1. Endpoint: https://api.loginradius.com/identity/v2/manage/account/{uid}
  2. Method: PUT
  3. Parameters: apisecret, apikey
  4. Body:
  "FirstName": "Test",
  "MiddleName": null,
  1. Response:
    "LoginLockedType": "None",
    "Email": [
            "Type": "Primary",
            "Value": "[email protected]"



  • Unlocking user accounts previously locked due to brute force lockout using LoginRadius APIs demonstrates the platform's account management and security enhancement efficiency.
  • Moving forward, leveraging LoginRadius's robust security features ensures uninterrupted user access while fortifying your system against unauthorized access attempts.



LoginRadius supports the following types of CAPTCHAs:

  • reCAPTCHA V2: Users solve challenges like clicking on images or entering text to prove they're human.
  • reCAPTCHA V3: Operates in the background, assessing user behavior to assign a risk score without user interaction.
  • hCAPTCHA: Like reCAPTCHA, it offers bot protection with a privacy focus.
  • QQ Tencent CAPTCHA: A CAPTCHA service by Tencent commonly used in China to verify human users.

Multi-Factor Authentication (MFA):

  • LoginRadius offers multiple security features, including Multi-Factor Authentication.
  • This feature can be enabled from the Admin Console to add an additional layer of security.
  • LoginRadius provides predefined MFA types, which can be enabled further.

To understand more about LoginRadius APIs, refer to the API docs.

Gayathri Suresh

Written by Gayathri Suresh

Discover the World of a Dynamic Software Engineer: Competitive Coder, Gamer, Badminton, and Handball Player. Enjoys Novels, Embraces All-Round Development, and Passionate about Making a Difference!

LoginRadius CIAM Platform

Our Product Experts will show you the power of the LoginRadius CIAM platform, discuss use-cases, and prove out ROI for your business.

Book A Demo Today