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

AAL2ProcGenSignatureRpl

  • 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 AAL2ProcGenSignatureRpl(
                                  aat_byte          *InReply,
                                  aat_int32          ReplySize,
                                  TDigipassBlob     *DPData,
                                  aat_ascii         *Signature,
                                  aat_ascii         *ReturnHostCode,
                                  aat_int32         *ReturnHostCodeLen);

Description

This function processes a reply from the HSM to a command generated with AAL2GenGenSignatureCmd.

Parameters

  Table: Parameters (AAL2ProcGenSignatureRpl)
TypeNameUseDescription
aat_byte *InReplyI

Up to 256 bytes that contain the GENERATE PASSWORD command type and the output data from the generate password function on the HSM:

  • Command type - 2 bytes
  • An authenticator application BLOB - 192 bytes
  • Return code - 4 bytes
  • Signature - up to 17 characters
  • Confirmation code length - 4 bytes
  • Confirmation code - up to 17 characters

Plus 20 bytes for Authentication Suite Server SDK internal use.

aat_int32ReplySizeIThe length of the InReply message.
TDigipassBlob *DPDataO

authenticator application BLOB. Upon return from the function call, this BLOB must be rewritten to the application database to reflect changes.

aat_ascii *SignatureOString of up to 17 numeric or hexadecimal characters, left-justified, null-terminated, or right-padded with spaces. This is the e-signature generated by the library.
aat_ascii *ReturnHostCodeO

String 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 for this signature.

aat_int32 *ReturnHostCodeLenO

Pointer to a long integer that in input contains the size of the ReturnHostCodeOut buffer, and in output contains the real length of the generated return host code. Leave NULL if not required.

Return codes

  Table: Return codes (AAL2ProcGenSignatureRpl)
CodeMeaningCodeMeaning
0Success1009Total length does not match TLV object lengths
130Invalid response pointer1018Invalid TLV item pointer
131Missing required challenge1019Missing mandatory TLV item
202Sign error threshold reached1025Data buffer too small
208Application disabled1103Unlock Version 2 not supported
209Grace period expired1104Virtual token is not a primary token
210Allowed use count reached1116Response check digit not allowed
211Virtual token not supported1117Challenge check digit not allowed
272Invalid wrapped key1118Unsupported BLOB
412Invalid checksum (software)-101Challenge too short
413Invalid Base64 format-102Challenge too long
414Invalid checksum (HSM)-103Challenge check digit wrong
510Invalid Digipass data pointer-105Challenge minimum length not allowed
701Invalid input buffer pointer-106Challenge maximum length not allowed
910Invalid HSM command in reply-107Challenge number wrong
912HSM invalid BLOB status-108Challenge character invalid
913Invalid HSM key property-1501Memory allocation failed
951Invalid HSM key type for HSM decryption  

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