This function is used to import a authenticator application BLOB (DPData parameter) describing an instance of one authenticator application and to retrieve other characteristics. Its serial number and application name are returned in Serial_No. The physical Digipass device type is returned in DigipassType, and the authentication mode to be used with this authenticator application is returned in AuthMode.
The calling application passes DataRecord that is read from the CINIT_A.DGP file, and indicates the binary or Base64 BLOB format using the CHandle->DataModel property.
Parameters
Table: Parameters (AAL2CINIT_Process)
Type
Name
Use
Description
TCinitHandle *
CHandle
I
Pointer to the handle used during the CINIT_A.DGP file import operation initialized by AAL2CINIT_APrepare. The calling program must indicate which DataModel is requested for DPData.
TKernelParms *
CallParms
I
Structure of runtime parameters to use during this function call.
aat_ascii *
DataRecord
I
64-byte CINIT_A.DGP file data record. This record describes a authenticator application, and its first character is 1.
aat_ascii *
Serial_No
O
String of 22 characters, composed of the 10-digit Digipass device serial number concatenated with its 12-digit application name. This represents a logical instance of a Digipass cryptographic application with its unique secrets and parameters. It may be used as a search key to access your Digipass database (recommended buffer size is 23 bytes).
aat_ascii *
DIGIPASSType
O
String of 5 characters. Gives the physical Digipass device type. It may be used for information purposes, or to determine which flashing pattern protocol to use to send data through the device's optical interface, if any.
Possible values:
DP300
DP500
(Recommended buffer size is 6 bytes.)
aat_ascii *
AuthMode
O
String of 2 characters. Defines the authenticator application authentication mode.
Possible value:
RO: Response-Only
(Recommended buffer size is 3 bytes.)
TDigipassBlob *
DPData
O
authenticator application BLOB. Upon return from the function call, this BLOB must be rewritten to the application database to reflect changes.
Return codes
Table: Return codes (AAL2DPXCINIT_Process)
Code
Meaning
Code
Meaning
0
Success
511
Invalid serial number pointer
506
Invalid CINIT handle pointer
512
Invalid AuthMode pointer
508
Invalid header record
513
Invalid data record
509
Invalid CINI data pointer
515
Invalid Digipass type pointer
510
Invalid Digipass data pointer
Cet article vous a-t-il été utile ?
Merci pour vos commentaires! Notre équipe vous répondra
