instanceActivation (service)

This command is deprecated! Use DSAPPMdlAddDevice (service) instead!

API version: 1

Availability: DIGIPASS Gateway 4.1 and later

Authentication: None.

The instanceActivation registers a new device that supports Secure Channel activation. It retrieves Activation Message 2 (instance).

URL

https://dpgateway_host:dpgateway_port/instanceActivation

Request

Parameters to the service are passed via the URI query component.

instanceActivation parameters
Parameter name Data type Description
DeviceCode String Required. The device code generated by the mobile application using the Digipass SDK. This is needed for validation and derivation purposes.
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.

Example

POST https://192.0.2.1:11080/instanceActivation?RegistrationIdentifier=e3wfISG9&DeviceCode=6887133123&InitialVector=43B525454EFA11CE0F5D1EBFAC5D9127&Nonce=5B983EE185B954A461CEFEECEBBBF214

Response

The service returns an XML response message containing the result.

instanceActivation return values
Return value Data type Description
//DP4Mobile/@retCode Integer The return code of the operation.
//DP4Mobile/@message String The error message in case of an error.
//InstanceActivation/ @instanceActivationMessage String The instance activation message (i.e. Activation Message 2).

Example

<?xml version="1.0"?>

<DP4Mobile retCode="0">
  <InstanceActivation instanceActivationMessage="82A53BF7E525012E2488BA51E9E33655..." />
</DP4Mobile>