DSAPPSRPGenerateActivationData (service) [v2]

API version: 2

Availability: DIGIPASS Gateway 5.0 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/v2/provisioning /DSAPPSRPGenerateActivationData

Request

DSAPPSRPGenerateActivationData parameters
Parameter name Data type Description
registrationIdentifier 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

{
  "registrationIdentifier": "myRegistrationID",
  "clientEvidenceMessage": "C2ADAF66D93539AD7188555ABC45B886..."
}

Response

DSAPPSRPGenerateEphemeralKey return values
Return value Description
resultCodes A JSON object that contains the return and status codes of the service.
result

A JSON object containing the generated activation data.

  • serverEvidenceMessage. Server evidence message generated by the server, for validation purposes.
  • encryptedLicenseActivationMessage. The license activation message (i.e. Activation Message 1) encrypted using the DSAPP SDK.
  • encryptedCounter. The initial vector used during the encryption of the license activation message.
  • mac. The message authentication code (MAC), which will be used to check the integrity of the encrypted license activation message.

Example

{
  "resultCodes":
    {
      "returnCodeEnum": "RET_SUCCESS",
      "statusCodeEnum": "STAT_SUCCESS",
      "returnCode": 0,
      "statusCode": 0
    },
  "result":
    {
      "serverEvidenceMessage": "F148FED2B888BFBFB4C9D84BB380B1B2...",
      "encryptedLicenseActivationMessage": "276FE50E49360E0BAC7AE0CE205...",
      "encryptedCounter": "73BD6BC4C912DAD3B4F1460FF50268D9",
      "mac": "15765B12A44DFCE58FAC322FD5BFA979..."
    }
}