AAL2GenGenMessageActivation2Cmd

Function Prototype

aat_int32 AAL2GenGenMessageActivation2Cmd(
                                         aat_byte        *Cmd,
                                         aat_int32       *CmdSize,
                                         TDigipassBlob   *DPMAData,
                                         aat_ascii       *PKBlob,
                                         TKernelParms    *CallParms,
                                         aat_ascii       *StorageKeyName,
                                         aat_ascii       *aStorageKeyNameIn,
                                         aat_ascii       *aIVIn,
                                         aat_ascii       *StaticVector,
                                         aat_ascii       *MessageVector,
                                         aat_ascii       *DeviceID);

Description

This function creates a command that directs the HSM to generate the Activation Message 2 and the Digipass instance using the given data, and to return a result in the form of a reply. This Activation Message 2 allows activating a Digipass instance of a license in the device.

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.

The payload key BLOB must be used with this function only if the Secure Channel feature has been ordered (configured by OneSpan at the time of order). No payload key BLOB must be used (parameter NULL or empty string) if the Secure Channel feature has not been ordered.

The Activation Message 2 and Digipass instance generation on the HSM is identical to the functionality available with the Authentication Suite Server SDK Software Digipass Multi-Device Activation Service. For information on the associated functions, refer to the Authentication Suite Server SDK C-C++ Programmer's Guide.

This function must be used with the post-HSM API AAL2ProcGenMessageActivation2Rpl.

Parameters

Return codes