Scenario: Authentication
Support: full-sdk auth-sdk
During the Push Notification authentication workflow (push and login), the mobile application must fetch the secure challenge with the getPreparedSecureChallenge command. The command requires the previously received challenge key to continue with the authentication process.
Only one application is allowed to retrieve the secure challenge for the given challenge key.
Parameters
Table: getPreparedSecureChallenge input parameters | Parameter name | Data type | Description |
|---|
| componentType | String | Required. Specifies the component for which the secure challenge is to be retrieved. |
| serialNumber | String | Required. Serial number of the authenticator used for the authentication process. |
| challengeKey | String | Required. The retrieved challenge key used to refer to the challenge generated during push and login. |
Table: getPreparedSecureChallenge output parameters | Parameter name | Data type | Description |
|---|
| status | CommandStatusResponse | Required. The error stack, if applicable, which indicates that the command has not completed successfully. This also includes the result and status codes returned by the command. |
| result | GetPreparedSecureChallengeResult | Required. The output field for this command, returning information about the upgrade procedure as a Secure Channel message. |
GetPreparedSecureChallengeResult (Data type)
Table: getPreparedSecureChallengeResult (Data type) | Parameter name | Data type | Description |
|---|
| RequestMessage | hexBinary | Required. The challenge as a Secure Channel message containing the retrieved challenge key used to refer to the challenge generated during push and login. |
Example
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Header/>
<soapenv:Body>
<aut:getPreparedSecureChallenge xmlns:prov="http://www.vasco.com/IdentikeyServer/IdentikeyTypes/Authentication">
<componentType>Push Notification Client</componentType>
<serialNumber>12345678</serialNumber>
<challengeKey>02fa56b3</challengeKey>
</aut:getPreparedSecureChallenge>
</soapenv:Body>
</soapenv:Envelope>