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

AAL2MigrateBlob

  • 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 AAL2MigrateBlob (
                           TDigipassBlob*   DPData,
                           TKernelParms*    CallParms,
                           aat_int32        DeriveVector,
                           aat_int32        StorageDeriveKey1,
                           aat_int32        StorageDeriveKey2,
                           aat_int32        StorageDeriveKey3,
                           aat_int32        StorageDeriveKey4);

Description

This function is used to migrate software protection keys for a given authenticator application BLOB. With a software implementation of Authentication Suite Server SDK, the authenticator application BLOBs in the database are protected with a key which is unique per record because it is derived from the Digipass serial number, the authenticator application name, and a static initial vector.

There are two ways to derive this default Authentication Suite Server SDK database protection key with kernel parameters:

  • using the derive vector (DeriveVector)
  • using the four storage derive keys (StorageDeriveKey1, StorageDeriveKey2, StorageDeriveKey3, StorageDeriveKey4).

Parameters

  Table: Parameters (AAL2MigrateBlob)
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 * CallParms I

Structure of runtime parameters to use during this function call. Contains the old values of DeriveVector and StorageDeriveKey1, 2, 3, 4.

aat_int32DeriveVectorINew derive vector to use for the authenticator application BLOB encryption. Values range from 0x00 to 0x7FFFFFFF.
aat_int32StorageDerive Key1INew storage derivation key part 1.
aat_int32StorageDerive Key2INew storage derivation key part 2.
aat_int32StorageDerive Key3INew storage derivation key part 3.
aat_int32StorageDerive Key4INew storage derivation key part 4.

Return codes

  Table: Return codes (AAL2MigrateBlob)
CodeMeaningCodeMeaning
0Success1000Function does not support EMV-CAP
412Invalid checksum1100Function not supported
413Invalid Base64 format1118

Unsupported BLOB

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