--- title: "Customization schema for Digipass Gateway integration of Mobile Authenticator Studio" slug: "mas-5-ig-customization-schema-digipass-gateway-5-8-0" updated: 2026-11-05T09:53:30Z published: 2026-11-05T09:53:30Z canonical: "docs.onespan.com/mas-5-ig-customization-schema-digipass-gateway-5-8-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 Digipass Gateway integration of Mobile Authenticator Studio When Mobile Authenticator Studio is integrated with Digipass Gateway, the following schema can be used to customize the mobile app. For sample code to create your customization file, see [Example: JSON customization for integration with Digipass Gateway](/mobile/docs/mas-5-ig-example-customization-schema-dpgw-5-8-0). Type: object ## config **Required** root > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#config) Type: object No Additional Properties ## appName **Required** root > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#config) > [appName](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-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-digipass-gateway-5-8-0#config) > [staticVector](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-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]+$` ## android root > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#config) > [android](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#android) Type: object No Additional Properties ## packageName **Required** root > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#config) > [android](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#android) > [packageName](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-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-digipass-gateway-5-8-0#config) > [android](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#android) > [buildNumber](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-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-digipass-gateway-5-8-0#config) > [android](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#android) > [appVersion](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-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" ``` ## ios root > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#config) > [ios](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#ios) Type: object No Additional Properties ## buildNumber **Required** root > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#config) > [ios](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#ios) > [buildNumber](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-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-digipass-gateway-5-8-0#config) > [ios](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#ios) > [appVersion](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-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" ``` ## features root > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#features) Type: object No Additional Properties ## protection root > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#features) > [protection](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-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-digipass-gateway-5-8-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#features) > [deleteInstance](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-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-digipass-gateway-5-8-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#features) > [renameInstance](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-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-digipass-gateway-5-8-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#features) > [multiInstance](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-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-digipass-gateway-5-8-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#features) > [changeLanguage](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-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-digipass-gateway-5-8-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#features) > [helpUrl](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-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-digipass-gateway-5-8-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#features) > [oneTimePassword](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#onetimepassword) Type: object No Additional Properties ## identifier root > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#features) > [oneTimePassword](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#onetimepassword) > [identifier](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-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-digipass-gateway-5-8-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#features) > [oneTimePassword](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#onetimepassword) > [cryptoAppIndex](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-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-digipass-gateway-5-8-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#features) > [autoLaunch](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#autolaunch) ### autoLaunch Type: object No Additional Properties ## android root > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#features) > [autoLaunch](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#autolaunch) > [android](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#android-scheme-autolaunch) ### Android Scheme `autoLaunch` Type: object No Additional Properties ## scheme **Required** root > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#features) > [autoLaunch](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#autolaunch) > [android](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#android-scheme-autolaunch) > [scheme](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-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-digipass-gateway-5-8-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#features) > [autoLaunch](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#autolaunch) > [ios](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#ios-scheme-autolaunch) Type: object No Additional Properties ## scheme **Required** root > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#features) > [autoLaunch](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#autolaunch) > [ios](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#ios-scheme-autolaunch) > [scheme](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-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-digipass-gateway-5-8-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#features) > [autoLaunch](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#autolaunch) > [app2app](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#app2app) Type: object No Additional Properties ## android root > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#features) > [autoLaunch](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#autolaunch) > [app2app](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#app2app) > [android](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#app2app-android) Type: object No Additional Properties ## whiteListURLs **Required** root > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#features) > [autoLaunch](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#autolaunch) > [app2app](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#app2app) > [android](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#app2app-android) > [whiteListURLs](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-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-digipass-gateway-5-8-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#features) > [autoLaunch](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#autolaunch) > [app2app](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#app2app) > [ios](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#app2app-ios) Type: object No Additional Properties ## whiteListURLs **Required** root >[config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#features) > [autoLaunch](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#autolaunch) > [app2app](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#app2app) > [ios](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#app2app-ios) > [whiteListURLs](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-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-digipass-gateway-5-8-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#features) > [identityPinning](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#identitypinning) Type: object No Additional Properties ## domain **Required** root > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#features) > [identityPinning](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#identitypinning) > [domain](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-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-digipass-gateway-5-8-0#config) > [features](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#features) > [identityPinning](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#identitypinning) > [keys](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-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-digipass-gateway-5-8-0#theme) Type: object No Additional Properties ## primaryColor **Required** root > [theme](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#theme) > [primaryColor](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#primary-color) 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-digipass-gateway-5-8-0#assets) Type: object No Additional Properties ## splashScreenBackgroundColor **Required** root > [assets](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#assets) > [splashScreenBackgroundColor](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#splashscreenbc) Type: string #### Description Background color of the splash screen. #### Constraints Is followed by a 6-symbol code consisting of 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-digipass-gateway-5-8-0#server) Type: object #### Description The Digipass Gateway configuration settings. Only required if Digipass Gateway is used as server No Additional Properties ## type **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server) > [type](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-type) Type: constant #### Constraints Specific value: `"gateway"` ## config **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-config) Type: object No Additional Properties ## notifications root > [server](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-config) > [notifications](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-notifications) Type: boolean Default: true #### Description Used to enable or disable notifications when `server` `type` is `server`. ## secureChannelValidationScan root > [server](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-config) > [secureChannelValidationScan](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#sc-validation-scan) Type: boolean Default: false #### Description Used to enable or disable the Secure Channel validation scan when `server` `type` is `server`. ## domain root > [server](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-config) > [domain](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-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-digipass-gateway-5-8-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-config) > [challengeResponse](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#chall-resp) Type: object No Additional Properties ## type **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-config) > [challengeResponse](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#chall-resp) > [type](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#cr-type) Type: enum (of string) #### Description Type of Challenge/Response. #### Constraints Must be either `scan` or `manual`. ## signatureCryptoAppIndex **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-config) > [challengeResponse](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#chall-resp) > [signatureCryptoAppIndex](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-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-digipass-gateway-5-8-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-config) > [challengeResponse](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#chall-resp) > [identifier](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-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-digipass-gateway-5-8-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-config) > [activation](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-activation) Type: object No Additional Properties ## type **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-config) > [activation](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-activation) > [type](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-activ-type) Type: constant #### Description Type of activation. Specific value: "mdl" ## identifier root > [server](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-config) > [activation](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-activation) > [identifier](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-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-digipass-gateway-5-8-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-config) > [activation](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-activation) > [modes](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-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. No Additional Items ### Each item of this array must be: --- root > [server](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-config) > [activation](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-activation) > [modes](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-activ-modes) > [modes items](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-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-digipass-gateway-5-8-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-config) > [activation](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-activation) > [postActivationCryptoAppIndex](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-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]$` ## url **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-config) > [url](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-url) Type: string #### Description REST V2 Base URL of Digipass Gateway. > For an integration with OneSpan Cloud Authentication, the URL(s) must not contain “/rest/v2”. #### Constraints No constraints. Can only be used with https. Must match regular expression: `^(http|https)://.+$` Example: ```plaintext "://rest/v2" ``` ## apiKey **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-config) > [apiKey](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-apikey) Type: string #### Description The API key of Digipass Gateway. #### Constraints String of alphanumeric and special characters. Must match regular expression: `^[A-Za-z0-9?\#\$\!\=/]+$` ## secureChannelValidation root > [server](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-config) > [secureChannelValidation](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-sc-validation) Type: object No Additional Properties ## type **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-config) > [secureChannelValidation](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-sc-validation) > [type](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-scvalidation-type) Type: enum (of string) #### Description Possible value: scanOffline (for both scan and sign). ##### Required properties: - scanOffline ## responseValidation root > [server](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid) #### Description Response validation action (scanOffline) No Additional Properties ## All of **Requirement 1** root > [server](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid) > [All of](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid-all-of) > [Requirement 1](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid-requirement-1) Type: object ### Conditional Subschema If the conditions in the [if](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#reqmt1-if) section are met, the conditions in the [then](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#reqmt1-then) section should also be met. Otherwise, the conditions in the [then](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#reqmt1-then) section must not be present. ## if root > [server](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid) > [All of](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid-all-of) > [Requirement 1](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid-requirement-1) > [if](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#reqmt1-if) Type: object ## type root > [server](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid) > [All of](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid-all-of) > [Requirement 1](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid-requirement-1) > [if](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#reqmt1-if) > [type](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#reqmt1-if-type) Type: enum (of string) ##### Required properties: manualOffline ## then root > [server](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid) > [All of](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid-all-of) > [Requirement 1](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid-requirement-1) > [then](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#reqmt1-then) Type: object ## config root > [server](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid) > [All of](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid-all-of) > [Requirement 1](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid-requirement-1) > [then](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#reqmt1-then) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#reqmt1-then-config) Type: object ##### Required properties: dataFields **Requirement 2** root > [server](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid) > [All of](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid-all-of) > [Requirement 2](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid-requirement-2) Type: object ### Conditional Subschema If the conditions in the [if](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#reqmt2-if) section are met, the conditions in the [then](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#reqmt2-then) section should also be met. Otherwise, the conditions in the [then](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#reqmt2-then) section must not be present. ## if root > [server](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid) > [All of](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid-all-of) > [Requirement 2](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid-requirement-2) > [if](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#reqmt2-if) Type: object ## type root > [server](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid) > [All of](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid-all-of) > [Requirement 2](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid-requirement-2) > [if](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#reqmt2-if) > [type](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#reqmt2-type) Type: enum (of string) ##### Required properties: scanOffline ## then root > [server](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid) > [All of](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid-all-of) > [Requirement 2](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid-requirement-2) > [then](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#reqmt2-then) Type: object ## config root > [server](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid) > [All of](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid-all-of) > [Requirement 2](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid-requirement-2) > [then >](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#reqmt2-then) [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#reqmt2-then-config) Type: object ## dataFields root > [server](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid) > [All of](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid-all-of) > [Requirement 2](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid-requirement-2) > [then](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#reqmt2-then) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#reqmt2-then-config) > [dataFields](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#reqmt2-datafields) Type: object ## type **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid) > [type](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#respvalid-type) Type: enum (of string) #### Description Possible values: - scanOffline for scan and sign - manualOffline for manual signing ##### Required property, must be one of: - scanOffline - manualOffline ## signatureCryptoAppIndex **Required** root > [server](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid) > [signatureCryptoAppIndex](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-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-digipass-gateway-5-8-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid) > [identifier](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-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-digipass-gateway-5-8-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#respvalid-config) Type: object No Additional Properties ## dataFields root > [server](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#respvalid-config) > [dataFields](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-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-digipass-gateway-5-8-0#server) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-config) > [responseValidation](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#server-respvalid) > [config](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#respvalid-config) > [dataFields](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#respvalid-datafields) > [dataFields items](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#datafields-array-items) Type: string --- Example: ```plaintext [    "datafield1",    "datafield2",    "datafield3" ] ``` ## legacy root > [legacy](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-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-digipass-gateway-5-8-0#legacy) > [android](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#legacy-android) Type: object No Additional Properties ## deviceIdentificationMethod root > [legacy](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#legacy) > [android](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#legacy-android) > [deviceIdentificationMethod](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-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-digipass-gateway-5-8-0#legacy) > [android](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-0#legacy-android) > [deviceIdentificationMigrationEnabled](/mobile/docs/mas-5-ig-customization-schema-digipass-gateway-5-8-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.