PUT /api/lunasa/user/config/login

PUT /api/lunasa/user/config/login

Update user login related configuration.

User Privileges

Users with the following role privileges can perform this command:

• admin

Parameters

detectionWindowSeconds

Interval(in seconds) within which login infringements would be observed. Resets on a successful login.

Use: Required

JSON Schema:

   Object
   type: integer
   format: uint32
   minimum: 60
   maximum: 86400
   default: 900

lockoutDurationSeconds

Interval for which an account would be locked if max failed login attempts reached.

Use: Required

JSON Schema:

   Object
   type: integer
   format: uint32
   minimum: 60
   maximum: 86400
   default: 600

maxFailedAttempts

Maximum number of bad login attempts allowed.

Use: Required

JSON Schema:

   Object
   type: integer
   format: uint32
   minimum: 0
   default: 3

The following table shows defined values for parameters.

Parameter	Range	Default Value
maxFailedAttempts	0 - NA	3
lockoutDurationSeconds	60 - 86400	600
detectionWindowSeconds	60 - 86400	900

Responses

204

Sucess

400

FRAMEWORK_BAD_REQUEST

Returned when the input data does not conform to the required validation schema.

500

APPLIANCE_USER_FAILED_TO_UPDATE_LOGIN_CONFIG

Failed to update the login configuration.

Example Request

   PUT
   https://1.2.3.4:8443/api/lunasa/user/config/login
   {
        "detectionWindowSeconds": 500,
        "lockoutDurationSeconds": 400,
        "maxFailedAttempts": 5
   }

Example Result

{
}