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

AAL2ChangeEncryptedStaticPassword

  • 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 AAL2ChangeEncryptedStaticPassword (
                                             TDigipassBlob*   DPData,
                                             TKernelParms*    CallParms,
                                             aat_ascii*       Challenge,
                                             aat_ascii*       CESPR);

Description

This function is used with a Digipass authenticator that can use encrypted static passwords (e.g. Digipass 110). It utilizes an operating mode compliant only with the software authenticator Digipass 110 and will not work with hardware authenticators, as for example Digipass GO 1. Thus, administrators can provide a new static password in an encrypted format on a mandatory basis. As this function is critical, only an authenticated user should be able use it.

Unlike AAL2ChangeStaticPassword, AAL2ChangeEncryptedStaticPassword does not contain the new static password as clear-text parameter. The new static password is encrypted in the change-encrypted-static-password request.

For a list of the characters that can be used for the new static password, see Supported new static password charset.

Parameters

 Table: Parameters (AAL2ChangeEncryptedStaticPassword)
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_ascii *ChallengeI

String of 16 numeric characters, left-justified, null-terminated or right-padded with spaces. This parameter holds the challenge that was proposed to the user to generate the CESPR. This parameter is mandatory.

aat_ascii *CESPRI16 hexadecimal characters, left-justified, null-terminated or right-padded with spaces. This parameter is the change-encrypted-static-password request generated by the Digipass 110 applet.

Return codes

 Table: Return codes (AAL2ChangeEncryptedStaticPassword)
CodeMeaningCodeMeaning
0Success809Encrypted static password not supported
131Missing required challenge1000Function does not support EMV-CAP
166Missing required CESPR1103Unlock Version 2 not supported
167Input data corrupted (challenge or CESPR))1118

Unsupported BLOBBLOB

169CESPR character invalid-101Challenge too short
412Invalid checksum software-102Challenge too long
413Invalid Base64 format-151CESPR too short
510Invalid Digipass data pointer-152CESPR too long
803New encrypted static password too short-1501Memory allocation failed
804New encrypted static password too long  

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