Account Blocking

🔍 Definitions

The behavior is driven by the cooling.period.locking.policy which determines whether lock/block is applied at user or device level.

🧊 Cooling Period

What is a Cooling Period?

A cooling period is a system-enforced wait time applied after a set of failed authentication attempts. It is defined by default.cooling.period.list in the REL-ID configuration (e.g., 30,60,90 minutes).

If cooling period is not enabled, user is blocked immediately after retry limit.

Progressive Behavior

REL-ID supports progressive lockouts using a configurable list like 30,60,90. Here's how it works:

Cooling period behavior for different challenges

UI Responsibilities

• Disable retry actions during cooling period.
• Read and compare deviceManagementCoolingPeriodEndTimestamp:
  JavaScript

  const isCoolingActive = Date.now() < deviceManagementCoolingPeriodEndTimestamp;

• Show user message: "Too many failed attempts. Please try again at 3:30 PM."
• Do not attempt auto-retry. Wait for period to expire.

🔓 Unblocking Users Using resetBlockedUserAccount

When is it allowed?

You may call resetBlockedUserAccount() only when the SDK response hasstatusCode = 141.

Example: React Native

if (statusCode === 141) {
  RdnaClient.resetBlockedUserAccount((res) => {
    if (res.success) {
      // Proceed with login/activation
    } else {
      showMessage("Failed to unblock. Please try again.");
    }
  });
}

Do not call the reset API for any status other than 141.

🔁 API Summary