httpSetSecondaryAuthSuccess()

The function is used to check for secondary authentification and implement a login delay.

Synopsis

int httpSetSecondaryAuthSuccess(int idx, <string|bool success);

Parameter

Parameter Description
idx The connection index.
success Determines if the login is delayed or not.

Return value

The function returns 0 on success, otherwise -1 for false.

Error

Wrong or missing arguments.

Description

The function is used in a httpConnect() callback to report a successful or unsuccessful addtional authentication in CTRL to the HTTP server. The result is either a delay for the next login (for success = false) or a reset of the connection. However, the connection itself will stay active and has to be closed separately. The login delay is valid for every connection attempt coming from the same IP address as that connection. The delay will be incremented in steps until a valid connection (with success = true) is made (Steps: 1, 2, 4, 8, 16, 32 and 60 seconds).

Assignment

CTRL Plugin

Availability

CTRL