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..."
}
}