--- title: "Customization schema for single-device licensing legacy" slug: "mas-5-ig-customization-schema-sdl-5-7-0" updated: 2026-07-16T15:21:42Z published: 2026-07-16T15:21:42Z canonical: "docs.onespan.com/mas-5-ig-customization-schema-sdl-5-7-0" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.onespan.com/llms.txt > Use this file to discover all available pages before exploring further. # Customization schema for single-device licensing legacy When Mobile Authenticator Studio is integrated in multi-device licensing (MDL) legacy mode, the following schema can be used to customize the mobile app. For sample code to create your customization file, see [Example: JSON customization single-device licensing legacy integration](/mobile/docs/mas-5-ig-example-customization-schema-sdl-5-7-0). Type: object ## config **Required** root > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#config) Type: object No Additional Properties ## appName **Required** root > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#config) > [appName](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#appName) Type: string #### Description Display name of the application. #### Constraints The app name can contain any character with a maximum string length of 30 characters for an Android and iOS application name. Must match regular expression: `^.{1,30}$` ## staticVector **Required** root > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#config) > [staticVector](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#staticVector) Type: string #### Description Initial static vector. #### Constraints No maximum string length. Must be hexadecimal characters. Must match regular expression: `^[0-9A-Fa-f]+$` ## ios root > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#config) > [ios](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#ios) Type: object No Additional Properties ## buildNumber **Required** root > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#config) > [ios](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#ios) > [buildNumber](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#buildnumber-ios) Type: string #### Description Number of the app build. #### Constraints Build version must only contain numeric characters (0-9). Must match regular expression: `^[0-9]+$`. Example: ```plaintext "1000" ``` ## appVersion **Required** root > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#config) > [ios](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#ios) > [appVersion](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#appversion-ios) Type: string #### Description Version of the app. #### Constraints The required format is three, period-separated, integers. The string can only contain numeric characters (0-9) and periods. Must match regular expression: `^(([0-9]+\.){1,2})?[0-9]+$` Example: ```plaintext "1.0.0" ``` ## android root > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#config) > [android](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#android) Type: object No Additional Properties ## packageName **Required** root > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#config) > [android](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#android) > [packageName](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#packagename-android) Type: string #### Description Name of the Android app package. #### Constraints Technically, the package name can be anything, but we highly recommend using a reverse domain name format (see example below). The name may contain uppercase or lowercase letters ('A' through 'Z'), numbers, and underscores ('_'). However, individual package name parts must only start with letters. Must match regular expression: `^[A-Za-z][A-Za-z0-9_]*(\.[A-Za-z0-9_]+)+[A-Za-z0-9_]$` Example: ```plaintext "com.onespan.appname" ``` ## buildNumber **Required** root > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#config) > [android](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#android) > [buildNumber](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#buildnumber-android) Type: string #### Description Number of the app build. #### Constraints Build version must only contain numeric characters (0-9). Must match regular expression: `^[0-9]+$`. Example: ```plaintext "1000" ``` ## appVersion **Required** root > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#config) > [android](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#android) > [appVersion](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#appVersion-android) Type: string #### Description Version of the app. #### Constraints The required format is three, period-separated, integers. The string can only contain numeric characters (0-9) and periods. Must match regular expression: `^(([0-9]+\.){1,2})?[0-9]+$` Example: ```plaintext "1.0.0" ``` ## features root > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#features) Type: object No Additional Properties ## protection root > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#features) > [protection](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#protection) **Type: boolean** Default: false #### Description Defines whether the app should be protected with a PIN code. ## deleteInstance root > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#features) > [deleteInstance](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#deleteinstance) Type: boolean Default: false #### Description Defines whether the feature to delete an instance should be enabled. ## renameInstance root > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#features) > [renameInstance](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#renameinstance) Type: boolean Default: false #### Description Defines whether the feature to rename an instance should be enabled. ## multiInstance root > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#features) > [multiInstance](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#multiinstance) Type: boolean Default: false #### Description Defines whether the multi-instance feature should be enabled. ## changeLanguage root > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#features) > [changeLanguage](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#changelanguage) Type: boolean Default: false #### Description Defines whether the feature to change the language from the Settings menu of the app should be enabled. ## helpUrl root > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#features) > [helpUrl](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#helpurl) Type: string #### Description The URL to display a help page. #### Constraints No constraints. Can only be used with https. Must match regular expression: `^(http|https)://.+$` ## oneTimePassword root > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#features) > [oneTimePassword](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#onetimepassword) Type: object No Additional Properties ## identifier root > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#features) > [oneTimePassword](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#onetimepassword) > [identifier](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#otp-identifier) Type: string #### Description Identifier of the action used for auto-launching the app. #### Constraints Must be unique. Must match regular expression: `^.*$` ## cryptoAppIndex **Required** root > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#features) > [oneTimePassword](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#onetimepassword) > [cryptoAppIndex](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#cryptoappindex) Type: string #### Description The crypto-app index used to generate the one-time password (OTP). #### Constraints Must be an integer from 1 to 8. Must match regular expression: `^[0-8]$` ## autoLaunch root > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#features) > [autoLaunch](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#autolaunch) Type: object No Additional Properties ## android root > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#features) > [autoLaunch](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#autolaunch) > [android](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#android-scheme-autolaunch) Type: object No Additional Properties ## scheme **Required** root > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#features) > [autoLaunch](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#autolaunch) > [android](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#android-scheme-autolaunch) > [scheme](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#android-scheme) Type: string #### Description Set the auto-launch scheme to launch the application via another app or a web browser. #### Constraints Alphanumeric string. Must match regular expression: `^[A-Za-z0-9]+$` ## ios root > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#features) > [autoLaunch](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#autolaunch) > [ios](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#ios-scheme-autolaunch) Type: object No Additional Properties ## scheme **Required** root > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#features) > [autoLaunch](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#autolaunch) > [ios](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#ios-scheme-autolaunch) > [scheme](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#ios-scheme) Type: string #### Description Set the auto-launch scheme to launch the application via another app or a web browser. #### Constraints Alphanumeric string. Must match regular expression: `^[A-Za-z0-9]+$` ## app2app root > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#features) > [autoLaunch](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#autolaunch) > [app2app](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#app2app) Type: object No Additional Properties ## android root > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#features) > [autoLaunch](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#autolaunch) > [app2app](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#app2app) > [android](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#app2app-android) Type: object No Additional Properties ## whiteListURLs **Required** root > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#features) > [autoLaunch](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#autolaunch) > [app2app](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#app2app) > [android](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#app2app-android) > [whiteListURLs](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#android-whitelisturls) Type: array of string Default: [] #### Description Contains one or more URL elements that indicate which URLs can be used for the app-to-app Secure Channel. #### Constraints No constraints. No Additional Items ## ios root >[config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#features) > [autoLaunch](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#autolaunch) > [app2app](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#app2app) > [ios](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#app2app-ios) Type: object No Additional Properties ## whiteListURLs **Required** root >[config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#features) > [autoLaunch](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#autolaunch) > [app2app](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#app2app) > [ios](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#app2app-ios) > [whiteListURLs](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#ios-whitelisturls) Type: array of string Default: [] #### Description Contains one or more URL elements that indicate which URLs can be used for the app-to-app Secure Channel. #### Constraints No constraints. No Additional Items ## identityPinning root > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#features) > [identityPinning](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#identitypinning) Type: object No Additional Properties ## domain **Required** root > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#features) > [identityPinning](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#identitypinning) > [domain](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#id-pinning-domain) Type: string #### Description The domain used for server communication. #### Constraints No constraints. Can only be used with https. Must match regular expression: `^.*$` ## keys **Required** root > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#features) > [identityPinning](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#identitypinning) > [keys](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#id-pinning-keys) Type: array #### Description Public keys. Format: SPKI-SHA256-BASE64. #### Constraints The SPKI-SHA256-BASE64 value is calculated from a public key certificate. > Must contain a minimum of 1 item. No Additional Items ## theme **Required** root > [theme](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#theme) ## `theme` Type: object No Additional Properties ## primaryColor **Required** root > [theme](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#theme) > [primaryColor](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#primary-color) ## `primaryColor` Type: object #### Description The main color of the app. #### Constraints Is followed by a 6-symbol code containing up to three 2-symbol hexadecimal elements. Each of the 2-symbol elements expresses a hexadecimal color value from 0 to 255. Must match regular expression: `^#[0-9A-Fa-f]{6}$`. Example: ```plaintext "#11AA11" ``` ## assets **Required** root > [assets](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#assets) Type: object No Additional Properties ## splashScreenBackgroundColor **Required** root > [assets](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#assets) > [splashScreenBackgroundColor](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#splashscreenbc) ## `splashScreenBackgroundColor` Type: string #### Description Background color of the splash screen. #### Constraints Is followed by a 6-symbol code containing up to three 2-symbol hexadecimal elements. Each of the 2-symbol elements expresses a hexadecimal color value from 0 to 255. Must match regular expression: `^#[0-9A-Fa-f]{6}$`. Example: ```plaintext "#11AA11" ``` ## server **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) Type: object No Additional Properties ## type **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [type](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-type) Type: constant #### Description Legacy server configuration. Needed only if a server with XML API is used (to maintain backwards compatibility). It should contain all the online actions supported by the application. All actions should contain url + method + parameters. #### Constraints Specific value: `"legacy"` ## config **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) Type: object No Additional Properties ## domain root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [domain](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-domain) Type: string #### Description Default domain name used when no domain name is provided with the user identifier during offline activation. #### Constraints No constraints. ## challengeResponse root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [challengeResponse](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#chall-resp) Type: object No Additional Properties ## type **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [challengeResponse](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#chall-resp) > [type](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#cr-type) Type: enum (of string) #### Description Type of Challenge/Response. ##### Required property, must be one of: - scan - manual ## signatureCryptoAppIndex **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [challengeResponse](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#chall-resp) > [signatureCryptoAppIndex](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#sigCrAppIndex) Type: string #### Description Index of the cryptographic application used to sign the transaction. #### Constraints Must be an integer from 1 to 8. Must match regular expression: `^[0-8]$` ## identifier root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [challengeResponse](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#chall-resp) > [identifier](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#cr-identifier) Type: string #### Description Identifier of the action used for auto-launching the app. #### Constraints Must be unique. Must match regular expression: `^.*$` ## activation **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [activation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-activation) Type: object No Additional Properties ## type **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [activation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-activation) > [type](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-activ-type) Type: constant #### Description Type of activation. Specific value: "sdl" ## identifier root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [activation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-activation) > [identifier](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-activ-identifier) Type: string #### Description Identifier of the action used for auto-launching the app. #### Constraints Must be unique. Must match regular expression: `^.*$` ## modes **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [activation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-activation) > [modes](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-activ-modes) Type: array of enum (of string) #### Description Activation mode. Can be scanning on image or manually entering activation data. > Must contain a minimum of 1 item. All items must be unique. > > All items must be unique. No Additional Items ### Each item of this array must be: --- root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [activation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-activation) > [modes](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-activ-modes) > [modes items](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#activmodes-array-items) Type: enum (of string) #### Required property, must be one of: - image - manual --- ## postActivationCryptoAppIndex **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [activation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-activation) > [postActivationCryptoAppIndex](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-pacai) Type: string #### Description The crypto-app index used to generate the post-activation signature. #### Constraints Must be an integer from 1 to 8. Must match regular expression: `^[0-8]$` ## useSerialNumber root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [activation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-activation) > [useSerialNumber](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-useSN) Type: boolean **Default: true** #### Description Indicates whether a serial number (e.g. FDM1280189) must be entered by the end user during the activation process instead of entering a serial number suffix (i.e. 1280189). ## useERC root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [activation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-activation) > [useERC](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-useERC) `useERC` Type: boolean **Default: false** #### Description Display an input field for the event reactivation counter (ERC) in the SDL offline activation process. ## binding root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [activation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-activation) > [binding](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-binding) Type: boolean **Default: true** #### Description Indicates whether the device binding feature is enabled (SDL only). The generated response will be a one-time password (OTP) (`false`) or a derivation code (`true`). ## transactionDataSigning root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [transactionDataSigning](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#-tds) **Type: object** #### Description Transaction data signing (TDS) action. **No Additional Properties** ## authenticationCryptoAppIndex **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [transactionDataSigning](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#-tds) > [authenticationCryptoAppIndex](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-acai) **Type: string** #### Description Index of the cryptographic application used for authentication that is needed to download the pending transaction list. #### Constraints Must be an integer from 1 to 8. Must match regular expression: `^[0-8]$` ## signatureCryptoAppIndex root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [transactionDataSigning](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#-tds) > [signatureCryptoAppIndex](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-scai) **Type: string** #### Description Index of the cryptographic application used to sign the transaction. #### Constraints Must be an integer from 1 to 8. Must match regular expression: `^[0-8]$` ## identifier **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [transactionDataSigning](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#-tds) > [identifier](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-id) **Type: string** #### Description Identifier of the action. #### Constraints Must be unique. Must match regular expression:`^.*$` ## config **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [transactionDataSigning](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#-tds) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config) **Type: object** **No Additional Properties** ## transactionList **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [transactionDataSigning](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#-tds) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config) > [transactionList](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config-txnlist) **Type: object** **No Additional Properties** ## url **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [transactionDataSigning](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#-tds) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config) > [transactionList](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config-txnlist) > [url](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-txnlist-url) **Type: string** #### Description URL linked to the action. #### Constraints No constraints. Can only be used with https. Must match regular expression: `^(http|https)://.+$` ## method **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [transactionDataSigning](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#-tds) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config) > [transactionList](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config-txnlist) > [method](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-txnlist-method) **Type: string** #### Description HTTP method linked to the action. #### Constraints POST or GET. Must match regular expression: `^(POST|GET)$` ## parameters **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [transactionDataSigning](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#-tds) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config) > [transactionList](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config-txnlist) > [parameters](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-txnlist-parameters) **Type: array of object** **Default: []** #### Description The payload parameters, with keys and values. #### Constraints The values might be masks. Can be an empty array. **No Additional Items** ### Each item of this array must be: --- root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [transactionDataSigning](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#-tds) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config) > [transactionList](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config-txnlist) > [parameters](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-txnlist-parameters) > [items](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-txnlist-params-items) **Type: object** **No Additional Properties** ## key **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [transactionDataSigning](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#-tds) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config) > [transactionList](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config-txnlist) > [parameters](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-txnlist-parameters) > [items](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-txnlist-params-items) > [key](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-txnlist-key) **Type: string** Must match regular expression: `^.*$` ## value **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [transactionDataSigning](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#-tds) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config) > [transactionList](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config-txnlist) > [parameters](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-txnlist-parameters) > [items](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-txnlist-params-items) > [value](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-txnlist-value) **Type: string** Must match regular expression: `^.*$` --- **Example:** ```plaintext [    {        "key": "key1",        "value": "value1"    },    {        "key": "key2",        "value": "%_SerialNumber_%"    } ] ``` ## transactionValidation **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [transactionDataSigning](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#-tds) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config) > [transactionValidation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config-txnval) **Type: object** **No Additional Properties** ## url **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [transactionDataSigning](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#-tds) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config) > [transactionValidation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config-txnval) > [url](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-txnval-url) **Type: string** #### Description URL linked to the action. #### Constraints No constraints. Can only be used with https. Must match regular expression: `^(http|https)://.+$` ## method **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [transactionDataSigning](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#-tds) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config) > [transactionValidation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config-txnval) > [method](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-txnval-method) **Type: string** #### Description HTTP method linked to the action. #### Constraints POST or GET. Must match regular expression: `^(POST|GET)$` ## parameters **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [transactionDataSigning](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#-tds) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config) > [transactionValidation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config-txnval) > [parameters](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-txnval-parameters) **Type: array of object** **Default: []** #### Description The payload parameters, with keys and values. #### Constraints The values might be masks. Can be an empty array. **No Additional Items** ### Each item of this array must be: --- root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [transactionDataSigning](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#-tds) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config) > [transactionValidation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config-txnval) > [parameters](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-txnval-parameters) > [items](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-txnval-params-items) **Type: object** **No Additional Properties** ## key **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [transactionDataSigning](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#-tds) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config) > [transactionValidation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config-txnval) > [parameters](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-txnval-parameters) > [items](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-txnval-params-items) > [key](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-txnval-key) **Type: string** Must match regular expression: `^.*$` ## value **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [transactionDataSigning](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#-tds) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config) > [transactionValidation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config-txnval) > [parameters](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-txnval-parameters) > [items](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-txnval-params-items) > [value](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-txnval-value) **Type: string** Must match regular expression: `^.*$` --- **Example:** ```plaintext [    {        "key": "key1",        "value": "value1"    },    {        "key": "key2",        "value": "%_SerialNumber_%"    } ] ``` ## transactionRejection **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [transactionDataSigning](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#-tds) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config) > [transactionRejection](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config-txrej) **Type: object** **No Additional Properties** ## url **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [transactionDataSigning](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#-tds) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config) > [transactionRejection](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config-txrej) > [url](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-txnrej-url) **Type: string** #### Description URL linked to the action. #### Constraints No constraints. Can only be used with https. Must match regular expression: `^(http|https)://.+$` ## method **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [transactionDataSigning](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#-tds) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config) > [transactionRejection](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config-txrej) > [method](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-txnrej-method) **Type: string** #### Description HTTP method linked to the action. #### Constraints POST or GET. Must match regular expression: `^(POST|GET)$` ## parameters **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [transactionDataSigning](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#-tds) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config) > [transactionRejection](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config-txrej) > [parameters](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-txnrej-parameters) **Type: array of object** **Default: []** #### Description The payload parameters, with keys and values. #### Constraints The values might be masks. Can be an empty array. **No Additional Items** ### Each item of this array must be: --- root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [transactionDataSigning](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#-tds) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config) > [transactionRejection](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config-txrej) > [parameters](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-txnrej-parameters) > [items](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-txnrej-params-items) **Type: object** **No Additional Properties** ## key **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [transactionDataSigning](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#-tds) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config) > [transactionRejection](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config-txrej) > [parameters](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-txnrej-parameters) > [items](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-txnrej-params-items) > [key](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-txnrej-key) **Type: string** Must match regular expression: `^.*$` ## value **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [transactionDataSigning](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#-tds) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config) > [transactionRejection](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-config-txrej) > [parameters](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-txnrej-parameters) > [items](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-txnrej-params-items) > [value](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#tds-txnrej-value) **Type: string** Must match regular expression: `^.*$` --- **Example:** ```plaintext [    {        "key": "key1",        "value": "value1"    },    {        "key": "key2",        "value": "%_SerialNumber_%"    } ] ``` ## responseValidation root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid) #### Description Response validation action. No Additional Properties ## All of **Requirement 1** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid) > [All of](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid-all-of) > [Requirement 1](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#rv-reqmt1) Type: object ### Conditional Subschema If the conditions in the [if](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#reqmt1-if) section are met, the conditions in the [then](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#reqmt1-then) section should also be met. Otherwise, the conditions in the [then](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#reqmt1-then) section must not be present. ## if root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid) > [All of](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid-all-of) > [Requirement 1](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#rv-reqmt1) > [if](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#reqmt1-if) Type: object ## type root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid) > [All of](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid-all-of) > [Requirement 1](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#rv-reqmt1) > [if](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#reqmt1-if) > [type](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#reqmt1-if-type) Type: enum (of string) ##### Required property, must be one of: - scanOnline - manualOnline ## then root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid) > [All of](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid-all-of) > [Requirement 1](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid-requirement-1) > [if](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#reqmt1-if) > [then](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#reqmt1-then) Type: object ## config root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid) > [All of](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid-all-of) > [Requirement 1](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid-requirement-1) > [if](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#reqmt1-if) > [then](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#reqmt1-then) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#reqmt1-then-config) Type: object ##### Required properties: validationEndpoint **Requirement 2** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid) > [All of](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid-all-of) > [Requirement 2](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#rv-reqmt2) Type: object ### Conditional Subschema If the conditions in the [if](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#reqmt2-if) section are met, the conditions in the [then](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#reqmt2-then) section should also be met. Otherwise, the conditions in the [then](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#reqmt2-then) section must not be present. ## if root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid) > [All of](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid-all-of) > [Requirement 2](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#rv-reqmt2) > [if](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#reqmt2-if) Type: object ## type root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid) > [All of](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid-all-of) > [Requirement 2](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#rv-reqmt2) > [if](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#reqmt2-if) > [type](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#reqmt2-if-type) Type: enum (of string) ##### Required property, must be one of: - manualOnline - manualOffline ## then root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid) > [All of](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid-all-of) > [Requirement 1](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid-requirement-1) > [if](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#reqmt1-if) > [then](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#reqmt2-then) Type: object ## config root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid) > [All of](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid-all-of) > [Requirement 1](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid-requirement-1) > [if](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#reqmt1-if) > [then](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#reqmt2-then) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#reqmt1-then-config) Type: object ##### Required properties: dataFields **Requirement 3** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid) > [All of](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid-all-of) > [Requirement 3](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#rv-reqmt3) Type: object ### Conditional Subschema If the conditions in the [if](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#reqmt3-if) section are met, the conditions in the [then](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#reqmt3-then) section should also be met. Otherwise, the conditions in the [then](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#reqmt3-then) section must not be present. ## if root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid) > [All of](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid-all-of) > [Requirement 3](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#rv-reqmt3) > [if](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#reqmt3-if) Type: object ## type root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid) > [All of](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid-all-of) > [Requirement 3](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#rv-reqmt3) > [if](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#reqmt3-if) > [type](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#reqmt3-if-type) Type: enum (of string) ##### Required property, must be one of: - scanOnline - scanOffline ## then root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid) > [All of](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid-all-of) > [Requirement 3](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#rv-reqmt3) > [then](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#reqmt3-then) Type: object ## config root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid) > [All of](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid-all-of) > [Requirement 3](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#rv-reqmt3) > [then](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#reqmt3-then) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#reqmt3-then-config) Type: object ## dataFields root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid) > [All of](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid-all-of) > [Requirement 3](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#rv-reqmt3) > [then](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#reqmt3-then) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#reqmt3-then-config) > [dataFields](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#reqmt3-then-config-df) Type: object ## type **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid) > [type](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#respvalid-type) Type: enum (of string) #### Description Possible values: - scanOnline - scanOffline for scan and sign - manualOnline - manualOffline for manual signing ##### Required property, must be one of: - scanOnline - scanOffline - manualOnline - manualOffline ## signatureCryptoAppIndex **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid) > [signatureCryptoAppIndex](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#respvalid-sigcryappix) Type: string #### Description Index of the cryptographic application used to sign the transaction. #### Constraints Must be an integer from 1 to 8. Must match regular expression: `^[0-8]$` ## identifier root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid) > [identifier](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#respvalid-id) Type: string #### Description Identifier of the action used for auto-launching the app. #### Constraints Must be unique. Must match regular expression: `^.*$` ## config root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#respvalid-config) Type: object No Additional Properties ## dataFields root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#respvalid-config) > [dataFields](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#respvalid-datafields) Type: array of string Default: [] #### Description The list of keys defined in the CSV file containing the names of the data fields for each language. #### Constraints Applies only for manual signing. No Additional Items ### Each item of this array must be: --- root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#respvalid-config) > [dataFields](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#respvalid-datafields) > [dataFields items](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#datafields-array-items) Type: string --- Example: ```plaintext [    "datafield1",    "datafield2",    "datafield3" ] ``` ## validationEndpoint root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#respvalid-config) > [validationEndpoint](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#respvalid-valEndpt) Type: object #### Description The configuration setting to validate the response. No Additional Properties ## url **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#respvalid-config) > [validationEndpoint](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#respvalid-valEndpt) > [url](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#valEndpt-url) Type: string #### Description URL linked to the action. #### Constraints No constraints. Can only be used with https. Must match regular expression: `^(http|https)://.+$` ## method **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#respvalid-config) > [validationEndpoint](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#respvalid-valEndpt) > [method](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#valEndpt-method) Type: string #### Description HTTP method linked to the action. #### Constraints Must be POST or GET. Must match regular expression: `^(POST|GET)$` ## parameters **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#respvalid-config) > [validationEndpoint](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#respvalid-valEndpt) > [parameters](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#valEndpt-parameters) Type: array of object Default: [] #### Description The payload parameters, with keys and values. #### Constraints The values might be masks. Can be an empty array. No Additional Items ### Each item of this array must be: --- root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#respvalid-config) > [validationEndpoint](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#respvalid-valEndpt) > [parameters](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#valEndpt-parameters) > [items](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#valEndpt-parameter-array-items) Type: object No Additional Properties ## key **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#respvalid-config) > [validationEndpoint](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#respvalid-valEndpt) > [parameters](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#valEndpt-parameters) > [items](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#valEndpt-parameter-array-items) > [key](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#valEndpt-parameters-key) Type: string Must match regular expression: `^.*$` ## value **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#server-respvalid) > [config](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#respvalid-config) > [validationEndpoint](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#respvalid-valEndpt) > [parameters](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#valEndpt-parameters) > [items](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#valEndpt-parameter-array-items) > [value](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#valEndpt-parameters-value) Type: string Must match regular expression: `^.*$` --- **Example:** ```plaintext [    {        "key": "key1",        "value": "value1"    },    {        "key": "key2",        "value": "%_SerialNumber_%"    } ] ``` ## legacy root > [legacy](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#legacy) Type: object #### Description Legacy migration values for migrating data from older versions of Mobile Authenticator Studio to version 5.0 and later. No Additional Properties ## android **Required** root > [legacy](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#legacy) > [android](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#legacy-android) Type: object No Additional Properties ## deviceIdentificationMethod root > [legacy](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#legacy) > [android](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#legacy-android) > [deviceIdentificationMethod](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#deviceidmethod) Type: string #### Description The method used to generate the platform fingerprint for the authenticator instance that is being migrated. ## deviceIdentificationMigrationEnabled root > [legacy](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#legacy) > [android](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#legacy-android) > [deviceIdentificationMigrationEnabled](/mobile/docs/mas-5-ig-customization-schema-sdl-5-7-0#deviceidmigenabled) Type: boolean Default: false #### Description Flag used to inform Mobile Authenticator Studio which method to use for fingerprint generation. Required for migrations from any version prior to 4.14.3.