Function prototype
aat_int32 AAL2GenSyncTokenAndHostCmd(
aat_byte *Cmd,
aat_int32 *CmdSize,
TDigipassBlob *DPData,
TKernelParms *CallParms,
aat_ascii *aResponseIn,
aat_ascii *aChallengeIn,
aat_ascii *aResponse2In,
aat_ascii *aChallenge2In);
Description
This function creates a command that directs the HSM to synchronize the HSM and the Digipass authenticator using the given data, and to return a result in the form of a reply.
The Digipass token and host synchronization 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 AAL2ProcSyncTokenAndHostRpl.
Parameters
Table: Parameters (AAL2GenSyncTokenAndHostCmd) | Type | Name | Use | Description |
|---|
| aat_byte * | Cmd | O | Up to 422 bytes that serialize the SYNC TOKEN AND HOST command type and the input data to the synchronize token and host function on the HSM: - Command type - 2 bytes
- An authenticator application BLOB - 192 bytes
- Runtime parameters - 80 bytes
- Password 1 - up to 41 characters
- Challenge 1 - up to 17 characters
- Password 2 - up to 41 characters
- Challenge 2 - up to 17 characters
- Host time - 4 bytes
Plus 28 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 | authenticator application BLOB. |
| TKernelParms * | CallParms | I | Structure of runtime parameters to use during this function call. |
| aat_ascii * | aResponse In | I | String of up to 17+24 numeric or hexadecimal characters, left-justified, null-terminated or right-padded with spaces. This is the first dynamic password generated by the Digipass authenticator. |
| aat_ascii * | aChallenge In | I | String of up to 17 numeric characters, left-justified, null-terminated, or right-padded with spaces. This parameter holds the challenge that was proposed to the user to generate CodeToVerify. If no challenge was generated, this parameter should be NULL. |
| aat_ascii * | aResponse2 In | I | String of up to 17+24 numeric or hexadecimal characters, left-justified, null-terminated or right-padded with spaces. This is the second dynamic password generated by the Digipass authenticator. |
| aat_ascii * | aChallenge2 In | I | String of up to 17 numeric characters, left-justified, null-terminated, or right-padded with spaces. This parameter holds the challenge that was proposed to the user to generate CodeToVerify. If no challenge was generated, this parameter should be NULL. |
Return codes
Table: Return codes (AAL2GenSyncTokenAndHostCmd) | 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 |