Login
    Contenu x
    AAL2DPXGetTokenBlobs
    • 22 Jan 2025
    • 3 Minutes à lire
    • Sombre
      Lumière
    • PDF
    Contenu

    AAL2DPXGetTokenBlobs

    • Mis à jour le 22 Jan 2025
    • 3 Minutes à lire
    • 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 AAL2DPXGetTokenBlobs(
                               DPXHandle*        dpx_Handle
                               TKernelParms*     CallParms,
                               aat_int16*        Appl_count,
                               aat_ascii         Serial_Appli[8][23],
                               aat_ascii*        DIGIPASSType,
                               aat_ascii         AuthMode[8][2],
                               TDigipassBlob*    DPData[8]);

    Description

    This function is used to import all the application BLOBs of one Digipass authenticator in a single call (each application BLOB is stored in the DPData array parameter).

    The name of each application is concatenated with the Digipass serial number, and returned in the Serial_Appli array. In the same way, the authentication mode to use for each authenticator application is returned in the AuthMode array. The physical Digipass device type is returned in DIGIPASSType.

    The number of authenticator application BLOBs requested/returned is described in the application count. If the dpx_Handle contains more than one Digipass authenticator, AAL2DPXGetTokenBlobs must be called several times to import all Digipass authenticators.

    AAL2DPXGetTokenBlobs returns 107 when the last Digipass authenticator has been imported.

    OneSpan recommends using the new function AAL2DPXGetTokenBlobsEx2 rather than AAL2DPXGetTokenBlobs.

    Parameters 

      Table: Parameters (AAL2DPXGetTokenBlobs)
    TypeNameUseDescription
    TDPXHandle *dpx_HandleI/OPointer to the handle used during the DPX file import operation. This block must be the one initialized by the AAL2DPXInit function.
    TKernelParms *CallParmsIStructure of runtime parameters to use during this function call.
    aat_int16 *Appl_countO

    Number of applications requested to be returned for a single Digipass device. On function exit, it holds the number of applications actually returned.

    Points to a short integer where the function returns the number of applications found.

    aat_ascii [8][23]Serial_AppliOSet of up to eight 22-character strings, each composed of the 10-digit Digipass device serial number concatenated with its 12-digit application name. Each array entry represents the logical instance of a Digipass cryptographic application with its unique secrets and parameters.
    aat_ascii *DIGIPASSTypeO

    String of 5 characters. Gives the physical Digipass device type. It may be used for information purposes, or to determine which flashing pattern protocol to use to send data through the device's optical interface, if any.

    Possible values:

    • AKII
    • AUTCD
    • DP100
    • DP300
    • DP500
    • DP600
    • DP700
    • etc.

    (Recommended buffer size is 6 bytes)

    aat_ascii [8][2]AuthModeO

    Set of up to eight 2-character strings. Defines each returned authenticator applicationauthentication mode.

    RO: Response-Only

    CR: Challenge/Response

    SG: Signature

    MM: Multi-Mode

    UL: Unlock V2 dedicated application

    Signature mode devices may also be used for Challenge/Response authentication if they are programmed to accept a single input data field.

    TDigipassBlob [8]DPDataO

    Up to 8 authenticator application BLOBs. Upon return from the function call, these BLOBs must be written to the application database.

    Return codes

      Table: Return Codes (AAL2DPXGetTokenBlobs)
    CodeMeaningCodeMeaning
    100Success-1500Cannot allocate memory
    107Success – end of file reached-1501Handle pointer is null
    -10Error null pointer-1502Handle context is pointer null
    -11Error bad argument-1503Handle key is pointer null
    -12Error DPX clear failed-1504Invalid handle context eyecatcher
    -13Error DES calculation-1505Invalid handle key eyecatcher
    -22Error file rewind failed-1506Invalid selected application
    -23Error file not open-1507Selected application pointer is null
    -24Error file not closed-1508InitKey pointer is null
    -30Error fatal error-1509File name pointer is null
    -31Error file has errors-1510Invalid selected application
    -32Error too many errors-1514Application count pointer is null
    -33Error too much info-1515Digipass type pointer is null
    -40Error void text-1516Authentication mode pointer is null
    -41Error truncated text-1517Digipass data pointer is null
    -42Error no DF records-1525Unlock mixed versions in same DPX
    -43Error unexpected record-1526Invalid unlock challenge length in DPX
    -44Error bad record type-1527Invalid unlock code type in DPX
    -45Error unexpected content-1528Invalid unlock code length in DPX
    -46Error line exhausted-1530EMV HSM DPX not supported
    -47Error missing quotes-1531EMV SSM DPX not supported
    -48Error missing field name-1543Function does not support this DPX
    -49Error bad field name-1547Invalid GM/T 0004-2012 application
    -50Error bad field type-1548Invalid time step for GM/T 0004-2012 algorithm
    -51Error field size-1549Invalid unlock type for AES HSM encryption
    -52Error line size-1550Invalid application key type for AES HSM encryption
    -100Error DH file content-2000Error t300 sernumber
    -101Error DH date content-2001Error t300 fabsecret
    -102Error DH version content-2002Error t300 unl64key
    -103Error DH created by content-2003Error t300 codeword
    -200Error DC HSH content-2004Error t300 des64key
    -201Error DC DEL content-2005Error t300 tdes64key
    -202Error HSH value-2006Error t300 offset
    -203Error DEL value-2007Error t300 ivright
    -300Error DF field name-2008Error t300 ivleft
    -301Error DF descriptor-2009Error t300 root
    -400Error DA record-2010Error t300 today
    -401Error DA field-2011Error t300 tomorrow
    -500Error Digipass field value-2012Error t300 daycut
    -501Error Digipass descriptor-2020Error t500 sernumber
    -502Error Digipass unknown descriptor-2021Error t500 fabsecret
    -503Error Digipass record redefinition-2022Error t500 ipin
    -504Error Digipass record overflow-2023Error t500 codeword
    -800Error CT field type-2024Error t500 des64key
    -801Error CT name redefinition-2040Error t700 sernumber
    -802Error CT field length-2041Error t700 fabsecret
    -803Error CT field name-2042Error t700 unl64key
    -804Error CT too many entries-2043Error t700 codeword
    -900Error DE DEF records content-2044Error t700 des64key
    -901Error DE data records content-2045Error t700 tdes64key
    -902Error DE tokens content  
    Cet article vous a-t-il été utile ?
    What's Next
    Change password!
    Changing your password will log you out immediately. Use the new password to log back in.
    Change profile
    Success!
    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.
    Logout
    ESC

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