Authentication Verification Hook

The secAuthenticateResponse Authentication Verification hook is a user-supplied function that is called by the server-side RPC module on receipt of an authentication challenge response for connections waiting for such a response.

The secAuthenticateResponse function has the following format.

int JOMAPI secAuthenticateResponse(const DskParam *pChallenge,
                                   const DskParam *pResponse);

The Jade RPC module is responsible for calling the Authentication Verification hook for connections waiting for a challenge response when the response is received. The hook is passed both the original challenge for each connection and the received response parameter. If the verification hook returns a non-zero result, the connection is dropped immediately.

Using the input parameters, your user routine must verify that the response is the correct one for the original challenge. If the response is invalid, the routine should return a non-zero result.

The secAuthenticateResponse Authentication Response hook returns the values listed in the following table.

Value	Description
0	The response was successful
Non-zero	The response failed