AAL2GenSignature

Mis à jour le 22 Jan 2025
1 Minute à lire

Partager
Sombre
Lumière
PDF

The content is currently unavailable in French. You are viewing the default English version.

Résumé de l’article

Avez-vous trouvé ce résumé utile ?

Merci pour vos commentaires

Function prototype

aat_int32 AAL2GenSignature( 
                           TDigipassBlob*   DPData,
                           TKernelParms*    CallParms,
                           aat_ascii*       Password,
                           aat_ascii        SignedDataFields[8][20],
                           aat_int32        FieldCount,
                           aat_int32        DeferrecSignatureDate);

Description

If primary Virtual Mobile Authenticator is supported and activated for the given authenticator application BLOB, this function can be used to generate an e-signature.

Parameters

Table: Parameters (AAL2GenSignature)
Type	Name	Use	Description
TDigipassBlob *	DPData	I/O	authenticator application BLOB. Upon return from the function call, this BLOB must be rewritten to the application database to reflect changes.
TKernelParms *	CallParms	I	Structure of runtime parameters to use during this function call.
aat_ascii *	Signature	O	String of up to 17 numeric or hexadecimal characters, left-justified, null-terminated, or right-padded with spaces. This is the dynamic password generated by the library (recommended buffer size is 18 bytes).
aat_ascii *	SignedDataFields	I	Array of 8 left-justified, null-terminated, or space-padded strings of max. 20 characters. This parameter holds the 8 possible data fields that are entered into the Digipass authenticator to generate a signature. Digipass data fields are limited to 16 decimal, hexadecimal, or alphabetic characters.
aat_int32	FieldCount	I	Numeric value from 1 to 8 indicating the number of data fields to use from the aSignedDataFieldsIn array.
aat_int32	Deferred signature date	I	Must be 0 if signature is generated in online mode (OnlineSG=1 or 2). If signature is generated in offline mode with OnlineSG=0 or 3, this parameter can receive the date for the signature generation (number of elapsed seconds since January 1st 1970) or 0 (with 0, the current time is used).

Return codes

Table: Return codes (AAL2GenSignature)
Code	Meaning	Code	Meaning
0	Success	1000	Function does not support EMV-CAP
132	Unsupported token type	1103	Unlock Version 2 not supported
139	Invalid signature pointer	1104	Virtual token is not a primary token
141	Invalid field count	1116	Response check digit not allowed
148	Invalid data field pointer	1117	Challenge check digit not allowed
203	Sign error threshold reached	1118	Unsupported BLOB
207	Deferred signature not allowed with OnLineSG not Null	-101	Challenge too short
208	Application disabled	-102	Challenge too long
209	Grace period expired	-103	Challenge check digit wrong
210	Allowed use count reached	-105	Challenge minimum length not allowed
211	Virtual token not supported	-106	Challenge maximum length not allowed
412	Invalid checksum	-107	Challenge number wrong
413	Invalid Base64 format	-108	Challenge character invalid
510	Invalid Digipass data pointer	-1501	Memory allocation failed

Cet article vous a-t-il été utile ?

What's Next

AAL2GenSignatureEx

Table des matières

Function prototype
Description
Parameters
Return codes