register (service)

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

API version: 1

Availability: DIGIPASS Gateway 4.1 and later

Authentication: None.

The register service performs a provisioning registration operation using Digipass Software Advanced Provisioning Protocol (DSAPP) Version 1.

URL

https://dpgateway_host:dpgateway_port/register

Request

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

register parameters
Parameter name Data type Description
StaticPassword String Required. The static password of the user.
UserID String Required. The user name and domain (RFC5322), i.e. username@domain.

Example

POST https://192.0.2.1:11080/[email protected]&StaticPassword=myPassword

Response

The service returns an XML response message containing the result.

Example (Success)

<?xml version="1.0"?>
<DP4Mobile retCode="0"
  registrationIdentifier="e3wfISG9"
  activationPassword="Tb048aX1"
  credentialsMessage="88D998CD6B8FE3989CB6E342854DEA4C" />

Example (Failure)

<?xml version="1.0"?>
<DP4Mobile retCode="–2" message="The static password was incorrect" />