AAL2GetStateDataBlock (function)
  • 23 Jan 2025
  • 1 Minute à lire
  • Sombre
    Lumière
  • PDF

AAL2GetStateDataBlock (function)

  • 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 AAL2GetStateDataBlock (
    TDigipassBlob*  DPData,
    TKernelParms*   CallParms,
    aat_byte*       bStateDataBlock,
    aat_int32*      StateDataBlockLength);

Description

This function generates a state data block from an authenticator application BLOB.

The buffer for StateDataBlock must be allocated by the client prior to the function call. It is returned as a byte string in the following format:

  • Serial number on 22 ASCII characters
  • Data block size on 4 bytes
  • Data block version on 2 bytes
  • Token status on 1 byte
  • Static PIN length on 1 byte
  • OTP length on 1 byte
  • OTP format on 1 byte
  • Codeword on 4 bytes
  • LastTimeUsed value on 4 bytes
  • LastTimeShift Value on 4 bytes
  • Error counter on 4 bytes
  • Use counter on 4 bytes
  • Static PIN delta on 8 bytes
  • CRC on 4 bytes

The allocated buffer size for bStateDataBlock must be 64 bytes.

Parameters

  Table: Parameters (AAL2GetStateDataBlock)
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_byte*bStateDataBlockOData string of 64 bytes containing the last authenticator status.
aat_int32*StateDataBlockLengthI/OLength of the allocated state data block.

Return codes

  Table: Return codes (AAL2GetStateDataBlock)
CodeMeaning
0Success
132Unsupported token type. Only time- or event-based authenticators are supported.
154State data block size too small
155Invalid time window
159Invalid state data block pointer
510Invalid Digipass data pointer
578Invalid BLOB status
1103Unlock Version 2 not supported

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