Response

For Version 1 and Version 2.

The client gives the Authentication Agent the challenge that it gets from the Security Gateway. The Authentication Agent shows the challenge to the user. The user enters a response to the challenge.

The Authentication Agent returns the user's Response back to the client, which forwards it to the Security Gateway.

Prototype

Copy

int Response( void *context, char *challenge, char *response, int *responseLength);

Arguments

Argument	In/Out	Meaning
context	In	The context as provided by `Username`
challenge	Out	The authentication challenge string as received from the Security Management Server.
response	Out	The buffer to which the Authentication Agent's response is to be copied.
usernameLength	In Out	In - Length of the buffer allocated for `response`. Out - If username is longer than the specified length, the function should return `PLUGIN_DATA_TOO_LONG` and use this argument to indicate the number of bytes required.

Return Values

PLUGIN_OK if successful.
PLUGIN_ABORT if the client should take over the authentication.
PLUGIN_DATA_TOO_LONG if the buffer specified by response is not long enough.
PLUGIN_CANCEL if the authentication should be terminated. This should be used with discretion since Authentication Agents generally do not have enough information to determine whether the authentication should be cancelled.