DSAPPMdlAddDevice (service)

API version: 2

Availability: DIGIPASS Gateway 5.0 and later

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

The DSAPPMdlAddDevice service registers a new device that supports Secure Channel activation.

URL

https://dpgateway_host:dpgateway_port/rest/v2/provisioning /DSAPPMdlAddDevice

Request

DSAPPMdlAddDevice parameters
Parameter name Data type Description
deviceCode String

Required. The device code generated by the DSAPP SDK.
initialVector String Required. The updated initial vector used by the mobile application using the DSAPP SDK.
nonce String Required. The updated encrypted server nonce used by the mobile application using the DSAPP SDK.
registrationIdentifier String Required. The unique identifier of a user for a given activation process. It is returned by DSAPPRegister.
description String

Optional. The description of the Digipass instance being activated.

Up to 255 characters. Special characters are replaced with spaces.

Example

{
  "registrationIdentifier": "e3wfISG9",
  "nonce": "5B983EE185B954A461CEFEECEBBBF214",
  "initialVector": "43B525454EFA11CE0F5D1EBFAC5D9127",
  "deviceCode": "6887133123"
  "description": "myDigipassInstance"
}

Response

DSAPPRegister return values
Return value Description
resultCodes A JSON object that contains the return and status codes of the service.
result A JSON object that contains the generated registration activation data.

Example

{
  "resultCodes":
    {
      "returnCodeEnum": "RET_SUCCESS",
      "statusCodeEnum": "STAT_SUCCESS",
      "returnCode": 0,
      "statusCode": 0
    },
  "result":
    {
      "instanceActivationMessage": "011665337766495347390016546230343861..."
    }
}