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.
Type: object
config Required
root > config
Type: object
No Additional Properties
staticVector Required
root > config > 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
Type: object
No Additional Properties
packageName Required
root > config > android > packageName
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:
"com.onespan.appname"buildNumber Required
root > config > android > buildNumber
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:
"1000"appVersion Required
root > config > android > appVersion
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:
"1.0.0"ios
Type: object
No Additional Properties
buildNumber Required
root > config > ios > buildNumber
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:
"1000"appVersion Required
root > config > ios > appVersion
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:
"1.0.0"features
Type: object
No Additional Properties
protection
root > config > features > protection
Type: boolean Default: false
Description
Defines whether the app should be protected with a PIN code.
deleteInstance
root > config > features > deleteInstance
Type: boolean Default: false
Description
Defines whether the feature to delete an instance should be enabled.
renameInstance
root > config > features > renameInstance
Type: boolean Default: false
Description
Defines whether the feature to rename an instance should be enabled.
multiInstance
root > config > features > multiInstance
Type: boolean Default: false
Description
Defines whether the multi-instance feature should be enabled.
changeLanguage
root > config > features > changeLanguage
Type: boolean Default: false
Description
Defines whether the feature to change the language from the Settings menu of the app should be enabled.
oneTimePassword
root > config > features > oneTimePassword
Type: object
No Additional Properties
identifier
root > config > features > oneTimePassword > 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 > features > oneTimePassword > 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 > features > autoLaunch
autoLaunch
Type: object
No Additional Properties
android
root > config > features > autoLaunch > android
Android Scheme autoLaunch
Type: object
No Additional Properties
scheme Required
root > config > features > autoLaunch > 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 > features > autoLaunch > ios
Type: object
No Additional Properties
scheme Required
root > config > features > autoLaunch > 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 > features > autoLaunch > app2app
Type: object
No Additional Properties
android
root > config > features > autoLaunch > app2app > android
Type: object
No Additional Properties
whiteListURLs Required
root > config > features > autoLaunch > app2app > 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 > features > autoLaunch > app2app > ios
Type: object
No Additional Properties
whiteListURLs Required
root >config > features > autoLaunch > app2app > 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 > features > identityPinning
Type: object
No Additional Properties
domain Required
root > config > features > identityPinning > 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 > features > identityPinning > 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
Type: object
No Additional Properties
primaryColor Required
root > theme > 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:
"#11AA11"assets Required
root > assets
Type: object
No Additional Properties
splashScreenBackgroundColor Required
root > assets > splashScreenBackgroundColor
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:
"#11AA11"server Required
root > server
Type: object
Description
The Digipass Gateway configuration settings. Only required if Digipass Gateway is used as server
No Additional Properties
config Required
Type: object
No Additional Properties
notifications
root > server > config > notifications
Type: boolean Default: true
Description
Used to enable or disable notifications when server type is server.
secureChannelValidationScan
root > server > config > secureChannelValidationScan
Type: boolean Default: false
Description
Used to enable or disable the Secure Channel validation scan when server type is server.
challengeResponse
root > server > config > challengeResponse
Type: object
No Additional Properties
type Required
root > server > config > challengeResponse > type
Type: enum (of string)
Description
Type of Challenge/Response.
Constraints
Must be either scan or manual.
signatureCryptoAppIndex Required
root > server > config > challengeResponse > signatureCryptoAppIndex
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 > config > challengeResponse > 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 > config > activation
Type: object
No Additional Properties
type Required
root > server > config > activation > type
Type: constant
Description
Type of activation.
Specific value: "mdl"
identifier
root > server > config > activation > 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 > config > activation > 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 > config > activation > modes > modes items
Type: enum (of string)
Required property, must be one of:
image
manual
postActivationCryptoAppIndex Required
root > server > config > activation > postActivationCryptoAppIndex
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
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:
"<dpgateway_host>:<dpgateway_port>/<context_path>/rest/v2"secureChannelValidation
root > server > config > secureChannelValidation
Type: object
No Additional Properties
type Required
root > server > config > secureChannelValidation > type
Type: enum (of string)
Description
Possible value: scanOffline (for both scan and sign).
Required properties:
scanOffline
responseValidation
root > server > config > responseValidation
Description
Response validation action (scanOffline)
No Additional Properties
All of
root > server > config > responseValidation > All of > Requirement 1
Type: object
Conditional Subschema
If the conditions in the if section are met, the conditions in the then section should also be met. Otherwise, the conditions in the then section must not be present.
if
root > server > config > responseValidation > All of > Requirement 1 > if
Type: object
type
root > server > config > responseValidation > All of > Requirement 1 > if > type
Type: enum (of string)
Required properties:
manualOffline
then
root > server > config > responseValidation > All of > Requirement 1 > then
Type: object
config
root > server > config > responseValidation > All of > Requirement 1 > then > config
Type: object
Required properties:
dataFields
root > server > config > responseValidation > All of > Requirement 2
Type: object
Conditional Subschema
If the conditions in the if section are met, the conditions in the then section should also be met. Otherwise, the conditions in the then section must not be present.
if
root > server > config > responseValidation > All of > Requirement 2 > if
Type: object
type
root > server > config > responseValidation > All of > Requirement 2 > if > type
Type: enum (of string)
Required properties:
scanOffline
then
root > server > config > responseValidation > All of > Requirement 2 > then
Type: object
config
root > server > config > responseValidation > All of > Requirement 2 > then > config
Type: object
dataFields
root > server > config > responseValidation > All of > Requirement 2 > then > config > dataFields
Type: object
type Required
root > server > config > responseValidation > 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 > config > responseValidation > signatureCryptoAppIndex
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 > config > responseValidation > identifier
Type: string
Description
Identifier of the action used for auto-launching the app.
Constraints
Must be unique.
Must match regular expression: ^.*$
config
root > server > config > responseValidation > config
Type: object
No Additional Properties
dataFields
root > server > config > responseValidation > config > 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 > config > responseValidation > config > dataFields > dataFields items
Type: string
Example:
[
"datafield1",
"datafield2",
"datafield3"
]legacy
root > 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
Type: object
No Additional Properties
deviceIdentificationMethod
root > legacy > android > deviceIdentificationMethod
Type: string
Description
The method used to generate the platform fingerprint for the authenticator instance that is being migrated.
deviceIdentificationMigrationEnabled
root > legacy > android > deviceIdentificationMigrationEnabled
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.