AAL2GenSignatureEx
  • 22 Jan 2025
  • 1 Minute à lire
  • Sombre
    Lumière
  • PDF

AAL2GenSignatureEx

  • Sombre
    Lumière
  • PDF

The content is currently unavailable in French. You are viewing the default English version.
Résumé de l’article

Function prototype

aat_int32 AAL2GenSignatureEx( 
                             TDigipassBlob*   DPData,
                             TKernelParms*    CallParms,
                             aat_ascii*       Password,
                             aat_ascii        SignedDataFields[8][20],
                             aat_int32        FieldCount,
                             aat_ascii*       ConfirmationCode,
                             aat_int32*       ConfirmationCodeLength);

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. It is an extension of AAL2GenSignature, with the additional feature of integrating the confirmation code.

Parameters 

  Table: Parameters (AAL2GenSignatureEx)
TypeNameUseDescription
TDigipassBlob *DPDataI/Oauthenticator application BLOB. Upon return from the function call, this BLOB must be rewritten to the application database to reflect changes.
TKernelParms *CallParmsIStructure of runtime parameters to use during this function call.
aat_ascii *SignatureO

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 *SignedDataFieldsI

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_int32FieldCountINumeric value from 1 to 8 indicating the number of data fields to use from the aSignedDataFieldsIn array.
aat_int32Deferred signature dateI
  • 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).
aat_ascii *Confirmation codeOString of up to 17 numeric or hexadecimal characters, left-justified, null-terminated, or right-padded with spaces. This is the confirmation code generated by Authentication Suite Server SDK (recommended buffer size is 18 bytes).
aat_int32 *Confirmation CodeLengthOPointer to a long integer that indicates the length of the generated confirmation code.

Return codes

  Table: Return codes (AAL2GenSignatureEx)
CodeMeaningCodeMeaning
0Success1000Function does not support EMV-CAP
132Unsupported token type1103Unlock Version 2 not supported
139Invalid signature pointer1104Virtual token is not a primary token
141Invalid field count1116Response check digit not allowed
148Invalid data field pointer1117Challenge check digit not allowed
203Sign error threshold reached1118Unsupported BLOB
207Deferred signature not allowed with OnLineSG not Null-101Challenge too short
208Application disabled-102Challenge too long
209Grace period expired-103Challenge check digit wrong
210Allowed use count reached-105Challenge minimum length not allowed
211Virtual token not supported-106Challenge maximum length not allowed
412Invalid checksum-107Challenge number wrong
413Invalid Base64 format-108Challenge character invalid
510Invalid Digipass data pointer-1501Memory allocation failed

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

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.
ESC

Ozzy, facilitant la découverte de connaissances grâce à l’intelligence conversationnelle