AAL2VerifyDeviceCode

The device code validation functionality is only applicable to hardware or software Digipass authenticators compliant with the multi-device two-step activation (in the context of multi-device licensing). For more information, refer to the Authentication Suite Server SDK Product Guide.

Function prototype

aat_int32 AAL2VerifyDeviceCode (
                                TDigipassBlob   *DPMAData,
                                TKernelParms    *CallParms,
                                aat_ascii       *Challenge,
                                aat_ascii       *DeviceCode,
                                aat_ascii       *DeviceID,
                                aat_int32       *DeviceIDLength,
                                aat_int32       *pDeviceType);

Description

This function verifies the device code provided by the Digipass device using the master activation application data. It also extracts in case of SUCCESS:

• Digipass device ID
• Digipass device type

It is only applicable to hardware or software Digipass authenticators compliant with the multi-device two-step activation (in the context of multi-device licensing). For more information, refer to the Authentication Suite Server SDK Product Guide.

If a challenge has been used to generate the Activation Message 1 (AALGenMessageActivation1) received by the Digipass device, the same challenge is necessary to validate the device code.

If challenge is not used, the kernel parameter CheckChallenge has to be set to 0 to disable the challenge checking.

Score-based Digipass

For Digipass devices that integrate the score-based algorithm, Authentication Suite Server SDK performs a score-based authentication to validate the device code. This allows retrieving the Digipass scoring value. Once Authentication Suite Server SDK has successfully validated the device code, it returns either SUCCESS or SUCCESS with the relevant scoring warning code. See the list of return codes in Table: Return codes (AAL2VerifyDeviceCode) for more details.

Parameters

Return codes