AAL2UnlockICSF

Function prototype (aal2sdk.h)

aat_int32 AAL2UnlockICSF (
                      TDigipassBlob*   DPBlob,
                      TKernelParms*    CallParms,
                      aat_ascii*       aStorageKeyNameIn,
                      aat_ascii*       aInitialVectorIn,
                      aat_ascii*       aRandomNumberIn,
                      aat_ascii*       aUnlockCode);

Description

If a user's Digipass authenticator is locked because of wrong PIN entries, the Digipass administrator will be able to unlock the Digipass authenticator using this function. It obtains the initialized unlock information of the user's Digipass authenticator from the authenticator application BLOB and performs the unlock code calculation.

This function generates an unlock code that the user enters in their Digipass authenticator in response to the currently displayed random number.

Parameters

The memory management of the output parameters must be performed by the calling function.

COBOL calling convention

Entry point: AA2ULKIC
02   W-BLOB              PIC X(248).
02   W-KERNELPARMS.
     03   W-PARMCOUNT    PIC 9(8) USAGE BINARY.
     03   W-PARM01       PIC 9(8) USAGE BINARY.
     . . .
     03   W-PARM19       PIC 9(8) USAGE BINARY.
02   W-RANDOM-NBR        PIC X(9).
02   W-UNLOCK-CODE       PIC X(9).
02   W-STORAGEKEY        PIC X(65).
02   W-INITVECTOR        PIC X(17).
02   W-RETURN            PIC S9(8) USAGE BINARY.
02   W-API-NAME          PIC X(8) VALUE 'AA2ULKIC'.
. . .
     CALL W-API-NAME USING
           BY REFERENCE W-BLOB
           BY REFERENCE W-KERNELPARMS
           BY REFERENCE W-STORAGEKEY
           BY REFERENCE W-INITVECTOR
           BY REFERENCE RANDOM-NBR
           BY REFERENCE UNLOCK-CODE
           RETURNING W-RETURN

Return codes