AAL2GetMessageProperties

The message properties retrieval 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 AAL2GetMessageProperties (
                                    aat_ascii      *Message,
                                    aat_int32      *MessageProtocolVersion,
                                    aat_int32      *MessageType,
                                    aat_int32      *MessageProtectionType,
                                    aat_int32      *IsMessageEncrypted,
                                    aat_int32      *IsMessageSigned,
                                    aat_ascii      *MessageSerial[11]);

Description

This function is used to obtain information on a Secure Channel message (being a request message, a response message, or an information message). In case of success, the function will indicate the following:

• Indication of the message protocol version
• Indication of the message type
• Indication of the message protection type
• Indication if the message is encrypted or not
• Indication if the message is signed (authenticity and integrity protection) or not
• Indication of the serial number referenced into the message.

Parameters

Return codes