Documentation Index

Fetch the complete documentation index at: https://docs.onespan.com/llms.txt

Use this file to discover all available pages before exploring further.

cancelAuthUser (Service) [v2]

Prev Next

API version: 2

Availability: DIGIPASS Gateway 5.0 and later

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

The cancelAuthUser service cancels a pending push and login authentication. The respective authentication is identified by a challenge key previously received via push notification.

URL

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

Request

cancelAuthUser parameters

Parameter name

Data type

Description

challengeKey

String

Required. The challenge key received via push notification, which identifies the authentication request. Must be encrypted as a secure channel information message (using the Digipass SDK).

serialNumber

String

Required. The unique identifier of the authenticator instance. This is the concatenation of the authenticator serial number and the sequence number, separated by a dash.

Example

{
  "serialNumber": "VDS1000000-1",
  "challengeKey": "D2602CE39F8CC50398CD40F41924702C..."
}

Response

cancelAuthUser return values

Return value

Description

resultCodes

A JSON object that contains the return and status codes of the service.

Example

{
  "resultCodes":
    {
      "returnCodeEnum": "RET_SUCCESS",
      "statusCodeEnum": "STAT_SUCCESS",
      "returnCode": 0,
      "statusCode": 0
    }
}