addDevice (Service)
- 26 Sep 2024
- 1 Minute to read
- Print
- DarkLight
- PDF
addDevice (Service)
- Updated on 26 Sep 2024
- 1 Minute to read
- Print
- DarkLight
- PDF
Article summary
Did you find this summary helpful?
Thank you for your feedback
This command is deprecated! Use MdlAddDevice (service) [v2] instead!
API version: 1
Availability: DIGIPASS Gateway 4.1 and later
Authentication: None.
The addDevice service registers a new device that supports Secure Channel activation. It retrieves Activation Message 2 (instance).
URL
https://dpgateway_host:dpgateway_port/addDevice
Request
Parameters to the service are passed via the URI query component.
addDevice parameters | ||
Parameter name | Data type | Description |
|---|---|---|
registrationID | String | Required. The unique identifier of a user for a given activation process. |
deviceCode | String | Required. The device code generated by the mobile application using the Digipass SDK. This is needed for validation and derivation purposes. |
Example
POST https://192.0.2.1:11080/addDevice?registrationID=vxcJRl7O&deviceCode=1234567890
Response
addDevice return values | |
Return value | Description |
|---|---|
message | A JSON value that contains the status message in case of an error. |
returnCode | The return code provided by OneSpan Authentication Server. 0 is returned in case of success. |
instanceActivationMessage | The instance activation message (i.e. Activation Message 2). |
Example
{
"returnCode": 0,
"instanceActivationMessage": "AA82DD554C7A39356FC033203A9F7EB6..."
}Was this article helpful?