getPreparedSecureChallenge (Service) [v2]

API version: 2

Availability: DIGIPASS Gateway 5.0 and later

Authentication: Basic HTTP authentication using the front-end API key.

The getPreparedSecureChallenge service retrieves a prepared authentication request. The respective authentication request is identified by a challenge key previously received via push notification.

Only one application is allowed to retrieve the authentication request. The challenge key is consumed by the first application retrieving the secure challenge message, subsequent attempts to retrieve it will fail with status code STAT_NOT_FOUND.

Depending on the user’s choice the mobile application can either complete the authentication request (see authUser (service) [v2]) or cancel it (see cancelAuthUser (service) [v2]).

URL

https://dpgateway_host:dpgateway_port/rest/v2/authentication/push /getPreparedSecureChallenge

Request

Example

{
  "serialNumber": "VDS1000000-1",
  "challengeKey": "1234567890",
}

Response

Example

{
  "resultCodes":
    {
      "returnCodeEnum": "RET_SUCCESS",
      "statusCodeEnum": "STAT_SUCCESS",
      "returnCode": 0,
      "statusCode": 0
    },
  "result":
    {
      "requestMessage": "2EAA8300F254C137B35237560CCBFE98..."
    }
}