AAL2ProcMessageResponse

The request message generation functionality is applicable:

• To hardware or software Digipass authenticators compliant with the multi-device two-step activation (in the context of multi-device licensing) and if the Secure Channel feature has been ordered (configured by OneSpan at the time of order).
• To hardware Digipass authenticators based on the single-device licensing model and able to perform operations based on the Secure Channel protocol.

For more information, refer to the Authentication Suite Server SDK Product Guide.

Function prototype

aat_int32 AAL2ProcMessageResponse (
                                   aat_ascii       *PKBlob,
                                   TKernelParms    *CallParms,
                                   aat_ascii       *ResponseMessage,
                                   aat_ascii       *RequestMessage,
                                   aat_ascii       *ResponseBody,
                                   aat_int32       *ResponseBodyLength);

Description

This function is used to extract a clear response body from a response message, using the payload key embedded into the payload key BLOB.

The payload key BLOB, mandatory only if the response message is protected (encrypted and/or signed) must be mandatorily the one corresponding to the Digipass serial number of the client device that generated the response message.

For Digipass client devices supporting the two-way Secure Channel, the response message will be sent back by the device as a reply to a request message.

Response message processing is only applicable to hardware and software Digipass compliant with the Secure Channel protocol.

If the response message was correctly processed and contains a Secure Channel request error that is detected by the device, the return code is dependent on the Secure Channel request error code byte (return code = offset + code byte with offset = 5000).). See the list of return codes in Table: Return codes (AAL2ProcMessageResponse) for more details.

Parameters

Return codes