Example: JSON customization single-device licensing legacy integration

Prev Next

You can use the following JSON sample and replace the anonymized data with your production data to create your customization file for upload in the Mobile Authenticator Studio Portal. For information how to build and customize the app, see the Mobile Authenticator Studio Portal documentation.

{
  "config": {
    "appName": "My app",
    "staticVector": "<static_vector>",
    "android": {
      "packageName": "com.onespan.mas",
      "buildNumber": "50200",
      "appVersion": "5.2.0"
    },
    "ios": {
      "buildNumber": "50200",
      "appVersion": "5.2.0"
    },
    "features": {
      "protection": false,
      "deleteInstance": false,
      "renameInstance": false,
      "multiInstance": false,
      "changeLanguage": false,
      "helpUrl": "https://www.example.com/help",
      "oneTimePassword": {
        "identifier": "ro",
        "cryptoAppIndex": "3"
      },
      "autoLaunch": {
        "android": {
          "scheme": "digipass"
        },
        "ios": {
          "scheme": "digipass"
        }
      },
      "identityPinning": {
        "domain": "example.com",
        "keys": [
          "<key>"
        ]
      }
    }
  },
  "theme": {
    "primaryColor": "#111111"
  },
  "assets": {
    "splashScreenBackgroundColor": "#FFFFFF"
  },
  "server": {
    "type": "legacy",
    "config": {
      "challengeResponse": {
        "type": "scan",
        "signatureCryptoAppIndex": "4",
        "identifier": "challengeResponse"
      },
      "activation": {
        "type": "sdl",
        "identifier": "offlineActivation",
        "modes": [
          "image",
          "manual"
        ],
        "postActivationCryptoAppIndex": "4",
        "useSerialNumber": false,
        "useERC": true,
        "binding": true
      },
      "transactionDataSigning": {
          "authenticationCryptoAppIndex": "1",
          "signatureCryptoAppIndex": "3",
          "identifier": "tds",
          "config": {
            "transactionList": {
              "url": "https://example.com/api",
              "method": "POST",
              "parameters": [
                {
                  "key": "action",
                  "value": "transactionsList"
                },
                {
                  "key": "serialNumber",
                  "value": "%_SerialNumber_%"
                },
                {
                  "key": "otp",
                  "value": "%_OTP_%"
                }
              ]
            },
            "transactionValidation": {
              "url": "https://example.com/api",
              "method": "POST",
              "parameters": [
                {
                  "key": "action",
                  "value": "transactionValidation"
                },
                {
                  "key": "serialNumber",
                  "value": "%_SerialNumber_%"
                },
                {
                  "key": "transactionIdentifier",
                  "value": "%_TransactionIdentifier_%"
                },
                {
                  "key": "signature",
                  "value": "%_OTP_%"
                }
              ]
            },
            "transactionRejection": {
              "url": "https://example.com/api",
              "method": "POST",
              "parameters": [
                {
                  "key": "action",
                  "value": "transactionRejection"
                },
                {
                  "key": "serialNumber",
                  "value": "%_SerialNumber_%"
                },
                {
                  "key": "transactionIdentifier",
                  "value": "%_TransactionIdentifier_%"
                }
              ]
            }
          }
      },
      "responseValidation": {
        "type": "scanOnline",
        "signatureCryptoAppIndex": "3",
        "identifier": "responseValidation",
        "config": {
          "validationEndpoint": {
            "url": "https://example.com/api",
            "method": "POST",
            "parameters": [
              {
                "key": "action",
                "value": "internalValidationXMLSG"
              },
              {
                "key": "serialNumber",
                "value": "%_SerialNumber_%"
              },
              {
                "key": "cryptoAppIndex",
                "value": "3"
              },
              {
                "key": "dtf1",
                "value": "%_DTF1_%"
              },
              {
                "key": "dtf2",
                "value": "%_DTF2_%"
              },
              {
                "key": "dtf3",
                "value": "%_DTF3_%"
              },
              {
                "key": "dtf4",
                "value": "%_DTF4_%"
              },
              {
                "key": "dtf5",
                "value": "%_DTF5_%"
              },
              {
                "key": "dtf6",
                "value": "%_DTF6_%"
              },
              {
                "key": "dtf7",
                "value": "%_DTF7_%"
              },
              {
                "key": "dtf8",
                "value": "%_DTF8_%"
              },
              {
                "key": "signature",
                "value": "%_OTP_%"
              }
            ]
          }
        }
      }
    }
  },
  "legacy": {
    "android": {
      "deviceIdentificationMethod": "",
      "deviceIdentificationMigrationEnabled": true
    }
  }
}