This function processes a reply from the HSM to a Activation Message 2 generation command which has been generated with AAL2GenGenMessageActivation2Cmd.
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 serializes an important amount of data. The InReply buffer must be allocated with a sufficient size. For more information about the allocation of the Cmd and InReply buffers, refer to Cmd and InReply buffers allocation.
A string of up to 2195 bytes that contain the GENERATE MESSAGE ACTIVATION2 command type and the output data from the Generate Message Activation2 function on the HSM:
An authenticator application BLOB - 192 bytes (x1 to 8)
Activation Message 2 - 109 characters
Activation Message 2 Length - 4 bytes
Return code - 4 bytes
Plus 128 bytes for Authentication Suite Server SDK internal use.
aat_int32
ReplySize
I
The length of the InReply message.
TDigipassBlob
DPMAData
O
Digipass master activation application BLOB of the Digipass serial number license that will be used for the activation. Upon return from the function call, this BLOB must be rewritten to the application database to reflect changes.
aat_int32 *
pSeqNum
O
Contains in output the sequence number of the generated Digipass instance (from 1 to 99).
aat_ascii[6]
TokenType
O
An output string of 5+1 characters, null-terminated. It contains the Digipass type name given to the Digipass instance. Will return a Digipass type of the form TYPxx with xx representing the device type coded on two decimal digits e.g. TYP07.
aat_int16 *
Appl_count
O
Number of Digipass applications returned. Points to a short integer where the function returns the number of applications found.
aat_ascii[8][23]
Serial_Appli
O
Set of up to 8 x 22+1 character strings, null-terminated, each composed of the 10-character license serial number concatenated with the 12-character application name. Each array entry represents the logical instance of a Digipass cryptographic application with its unique secrets and parameters. The application name part will end with the sequence number coded on two decimal digits e.g. APPL1 03.
aat_ascii[8][3]
AuthMode
O
Set of up to 8 x 2+1 character strings, null-terminated. Defines each returned authenticator application authentication mode.
RO: Response-Only
CR: Challenge/Response
SG: Signature
MM: Multi-Mode
UL: Unlock V2
Signature-mode devices may also be used for Challenge/Response authentication if they are programmed to accept a single input data field.
TDigipassBlob[8]
DPData
O
Up to 8 authenticator application BLOBs of the Digipass instance. Upon return from the function call, these BLOBs must be written to the application database.
aat_ascii *
Activation2Message
O
String of up to 124+1 hexadecimal characters, null-terminated. It contains the Activation Message 2 which is necessary during the activation process to provision the Digipass keys and the payload key to the Digipass device.
aat_int32 *
Activation2MessageLength
I/O
In input, this parameter must indicate the size of the allocated buffer for the Activation2Message parameter (recommended 125 bytes). In output, this parameter indicates the length of the Activation2Message string (without the null-terminated character).
