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

    AAL2DPXGetToken

    • 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 AAL2DPXGetToken(TDPXHandle*         dpx_Handle,
                          TKernelParms*       CallParms,
                          aat_ascii*          Select_appl_name,
                          aat_ascii*          Serial_Appli,
                          aat_ascii*          DIGIPASSType,
                          aat_ascii*          AuthMode,
                          TDigipassBlob*      DPData);

    Description

    This function is used to import a authenticator application BLOB (DPData parameter) describing an instance of one authenticator application and to retrieve other characteristics: its serial number and application name returned in Serial_Appli. The physical Digipass device type is returned in DIGIPASSType, and the authentication mode to be used with this authenticator application is returned in AuthMode.

    Among the available applications, only the one indicated in the Select_appl_name argument will be imported. If the dpx_Handle contains more than one Digipass authenticator, AAL2DPXGetToken must be called several times to import all Digipass authenticators.

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

    OneSpan recommends using the new function AAL2DPXGetTokenBLOBsEx2 rather than AAL2DPXGetToken.

    Parameters

      Table: Parameters (AAL2DPXGetToken)
    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_ascii * Select_appl_nameI

    String of up to 12 characters, right-padded with spaces. This parameter holds the application name to use as an import selection filter. It must be one of the application names returned by AAL2DPXInit.

    aat_ascii *Serial_AppliOString of 22 characters composed of the 10-digit Digipass device serial number concatenated with its 12-digit application name. This represents a logical instance of a Digipass cryptographic application with its unique secrets and parameters. It may be used as a search key to access your Digipass database (recommended buffer size is 23 bytes).
    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 for sending 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 *AuthModeO

    String of 2 characters. Defines the authenticator application authentication mode.

    Possible modes:

    • 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. (Recommended buffer size is 3 bytes).
    TDigipassBlob *DPDataO

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

    Return codes

      Table: Return codes (AAL2DPXGetToken)
    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-1514Serial number 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-2000

    Error 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