DSAPPSRPGenerateActivationData (Service) [v1]

Prev Next

This command is deprecated! Use DSAPPSRPGenerateActivationData (service) [v2] instead!

API version: 1

Availability: DIGIPASS Gateway 4.1 and later

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

The DSAPPSRPGenerateActivationData service generates either standard online activation data or an Activation Message 1 for multi-device licensing (MDL) and encrypt it using Digipass Software Advanced Provisioning Protocol-Secure Remote Password (DSAPP-SRP) session keys.

URL

https://dpgateway_host:dpgateway_port/rest/activation /DSAPPSRPGenerateActivationData

Request

DSAPPSRPGenerateActivationData parameters

Parameter name

Data type

Description

registrationID

String

Required. The unique identifier of a user for a given activation process.

clientEvidenceMessage

String

Required. The client evidence message generated by the mobile application using the DSAPP SDK, for validation purposes.

Example

{
  "registrationID": "myRegistrationID",
  "clientEvidenceMessage": "BCD6E385FDE54C9D5C1C7523035C12A6..."
}

Response

DSAPPSRPGenerateActivationData return values

Return value

Data type

Description

errorCode

Integer

The return code provided by OneSpan Authentication Server. 0 is returned in case of success.

errorMessage

String

The error message provided by OneSpan Authentication Server. STAT_SUCCESS is returned in case of success.

serverEvidenceMessage

String

This is the server evidence message that is generated by the server for validation purposes.

encryptedLicenseActivationMessage

String

The license activation message (i.e. Activation Message 1) encrypted using the DSAPP SDK.

encryptedCounter

String

The initial vector used during the encryption of the license activation message.

mac

String

The message authentication code (MAC), which will be used to check the integrity of the encrypted license activation message.

Example

{
  "errorCode": 0,
  "errorMessage": "STAT_SUCCESS",
  "serverEvidenceMessage": "E38CCA22F307A15DB94C3639256975C3...",
  "encryptedLicenseActivationMessage": "DBBD11F7F779D2619DEBFD14F98658...",
  "encryptedCounter": "0FC645CEF184D753",
  "mac": "F3142357A58534F8A37C7C8F243CE354..."
}