Function prototype
aat_int32 AAL2GenChangeStaticPasswordCmd(
aat_byte *Cmd,
aat_int32 *CmdSize,
TDigipassBlob *DPData,
TKernelParms *CallParms,
aat_ascii *NewStaticPassword1,
aat_ascii *NewStaticPassword2);
Description
This function creates a command that directs the HSM to change the static password using the given data and to return a result in the form of a reply.
The Digipass static PIN management on the HSM is identical to the functionality available with the Authentication Suite Server SDK Software Digipass Management Service. For information on the associated functions, refer to the Authentication Suite Server SDK C-C++ Programmer's Guide.
This function must be used with the post-HSM API AAL2ProcChangeStaticPasswordRpl.
Parameters
Table: Parameters (AAL2GenChangeStaticPasswordCmd) | Type | Name | Use | Description |
|---|
| aat_byte * | Cmd | O | Up to 306 bytes that serialize the CHANGE STATIC PASSWORD command type and the input data to the change static password function on the HSM: - Command type - 2 bytes
- An authenticator application BLOB - 192 bytes
- Runtime parameters - 80 bytes
- New static password - up to 8 characters
- New static password confirmation - up to 8 characters
Plus 16 bytes for Authentication Suite Server SDK internal use. |
| aat_int32 * | CmdSize | I/O | On entry, this parameter contains the size of the Cmd buffer.On exit, this parameter contains the length of the Cmd message. |
| TDigipassBlob * | DPData | I | The authenticator application BLOB. |
| TKernelParms * | CallParms | I | Structure of runtime parameters to use during this function call. |
| aat_ascii * | NewStaticPassword1 | I | First entry of the password change trial. Up to 8 printable ASCII-EBCDIC invariant characters. Must be null-terminated. For a list of the characters that can be used for the new static password, refer to the Authentication Suite Server SDK C-C++ Programmer's Guide, Section "Supported new static password charset". |
| aat_ascii * | NewStaticPassword2 | I | Second entry confirmation of the password change trial. Must be identical to NewStaticPassword1. |
Return codes
Table: Return codes (AAL2GenChangeStaticPasswordCmd) | Code | Meaning | Code | Meaning |
|---|
| 0 | Success | 590 | Invalid command pointer |
| 130 | Invalid response pointer | 706 | Invalid data buffer pointer |
| 412 | Invalid checksum (software) | 1000 | Function does not support EMV-CAP |
| 413 | Invalid Base64 format | 1018 | Invalid TLV item pointer |
| 510 | Invalid Digipass data pointer | 1025 | Data buffer too small |