Example: JSON customization for multi-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": true,
      "renameInstance": false,
      "multiInstance": false,
      "changeLanguage": true,
      "helpUrl": "https://www.example.com/help",
      "oneTimePassword": {
        "identifier": "otpIdentifier",
        "cryptoAppIndex": "3"
      },
      "autoLaunch": {
        "android": {
          "scheme": "digipass"
        },
        "ios": {
          "scheme": "digipass"
        },
        "app2app": {
          "android": {
            "whiteListURLs": [
              "https://example.com/x-success",
              "https://example.com/x-error",
              "https://example.com/x-cancel"
            ]
          },
          "ios": {
            "whiteListURLs": [
              "https://example.com/x-success",
              "https://example.com/x-error",
              "https://example.com/x-cancel"
            ]
          }
        }
      },
      "identityPinning": {
        "domain": "example.com",
        "keys": [
          "<key>"
        ]
      }
    }
  },
  "theme": {
    "primaryColor": "#111111"
  },
  "assets": {
    "splashScreenBackgroundColor": "#FFFFFF"
  },
  "server": {
    "type": "legacy",
    "config": {
      "activation": {
        "type": "mdl",
        "identifier": "offlineActivation",
        "modes": [
          "image"
        ],
        "postActivationCryptoAppIndex": "4"
      },
      "notificationRegistration": {
        "url": "https://example.com/api",
        "method": "POST",
        "parameters": [
          {
            "key": "action",
            "value": "notificationRegistration"
          },
          {
            "key": "serialNumber",
            "value": "%_SerialNumber_%"
          },
          {
            "key": "sequenceNumber",
            "value": "%_SequenceNumber_%"
          },
          {
            "key": "vascoNotificationIdentifier",
            "value": "%_VascoNotificationIdentifier_%"
          }
        ]
      },
      "secureChannelTransactionDataSigning": [
        {
          "type": "push",
          "authenticationCryptoAppIndex": "1",
          "identifier": "notif_tds",
          "config": {
            "transactionList": {
              "url": "https://example.com/api",
              "method": "POST",
              "parameters": [
                {
                  "key": "action",
                  "value": "secureChannelTransactionsList"
                },
                {
                  "key": "serialNumber",
                  "value": "%_SerialNumber_%"
                },
                {
                  "key": "otp",
                  "value": "%_OTP_%"
                }
              ]
            },
            "transactionValidation": {
              "url": "https://example.com/api",
              "method": "POST",
              "parameters": [
                {
                  "key": "action",
                  "value": "secureChannelTransactionValidation"
                },
                {
                  "key": "serialNumber",
                  "value": "%_SerialNumber_%"
                },
                {
                  "key": "transactionIdentifier",
                  "value": "%_TransactionIdentifier_%"
                },
                {
                  "key": "signature",
                  "value": "%_OTP_%"
                }
              ]
            },
            "transactionRejection": {
              "url": "https://example.com/api",
              "method": "POST",
              "parameters": [
                {
                  "key": "action",
                  "value": "secureChannelTransactionRejection"
                },
                {
                  "key": "serialNumber",
                  "value": "%_SerialNumber_%"
                },
                {
                  "key": "transactionIdentifier",
                  "value": "%_TransactionIdentifier_%"
                }
              ]
            }
          }
        },
        {
          "type": "manual",
          "authenticationCryptoAppIndex": "1",
          "identifier": "tds",
          "config": {
            "transactionList": {
              "url": "https://example.com/api",
              "method": "POST",
              "parameters": [
                {
                  "key": "action",
                  "value": "secureChannelTransactionsList"
                },
                {
                  "key": "serialNumber",
                  "value": "%_SerialNumber_%"
                },
                {
                  "key": "otp",
                  "value": "%_OTP_%"
                }
              ]
            },
            "transactionValidation": {
              "url": "https://example.com/api",
              "method": "POST",
              "parameters": [
                {
                  "key": "action",
                  "value": "secureChannelTransactionValidation"
                },
                {
                  "key": "serialNumber",
                  "value": "%_SerialNumber_%"
                },
                {
                  "key": "transactionIdentifier",
                  "value": "%_TransactionIdentifier_%"
                },
                {
                  "key": "signature",
                  "value": "%_OTP_%"
                }
              ]
            },
            "transactionRejection": {
              "url": "https://example.com/api",
              "method": "POST",
              "parameters": [
                {
                  "key": "action",
                  "value": "secureChannelTransactionRejection"
                },
                {
                  "key": "serialNumber",
                  "value": "%_SerialNumber_%"
                },
                {
                  "key": "transactionIdentifier",
                  "value": "%_TransactionIdentifier_%"
                }
              ]
            }
          }
        }
      ],
      "secureChannelValidation": {
        "type": "scanOnline",
        "config": {
          "validationEndpoint": {
            "url": "https://example.com/api",
            "method": "POST",
            "parameters": [
              {
                "key": "action",
                "value": "internalValidationSecureChannelTransaction"
              },
              {
                "key": "serialNumber",
                "value": "%_SerialNumber_%"
              },
              {
                "key": "secureChannelMessage",
                "value": "%_SecureChannelMessage_%"
              },
              {
                "key": "otp",
                "value": "%_OTP_%"
              }
            ]
          }
        }
      },
      "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_%"
              }
            ]
          }
        }
      },
      "challengeResponse": {
        "type": "manual",
        "signatureCryptoAppIndex": "2",
        "identifier": "challengeResponse"
      }
    }
  },
  "legacy": {
    "android": {
      "deviceIdentificationMethod": "",
      "deviceIdentificationMigrationEnabled": true
    }
  }
}