- 23 Oct 2024
- 4 Minutes to read
- DarkLight
- PDF
Common
- Updated on 23 Oct 2024
- 4 Minutes to read
- DarkLight
- PDF
<Applications>
<View title="Applications">
<Fields>
<Field id="DataField1"name="Data Field 1" comment="Enter the first data field value." />
<Field id="DataField2"name="Data Field 2" comment"Enter the second data field value." />
<Field id="DataField3"name="Data Field 3" comment="Enter the third data field value." />
<Field id="DataField4"name="Data Field 4" comment="Enter the fourth data field value." />
<Field id="DataField5"name="Data Field 5" comment="Enter the fifth data field value." />
<Field id="DataField6"name="Data Field 6" comment="Enter the sixth data field value." />
<Field id="DataField7"name="Data Field 7" comment="Enter the seventh data field value." />
<Field id="DataField8"name="Data Field 8" comment="Enter the eighth data field value." />
</Fields>
<Labels>
<Label id="ClipboardCopyHostCode"
value="Server response copied to clipboard" />
<Label id="ClipboardCopyResponse" value="Response copied to clipboard" />
<Label id="ResultHostCode" value="Server response:" />
<Label id="ResultRemainingTime"
value="Remaining time" />
<Label id="ResultResponse"
value="Generated response:" />
<Label id="InternalValidationWaitMessage" value="Validating the OTP, please wait..." />
<Label id ="BiometricFingerprintRecognitionDescriptionMessage" value="Please authenticate using fingerprint recognition to protect your DIGIPASS" /
> <Label id ="BiometricFingerprintRecognitionFallbackDescriptionMessage" value="Please authenticate using your DIGIPASS password" />
<Label id ="BiometricFaceRecognitionDescriptionMessage" value="Please authenticate using face recognition to protect your DIGIPASS" />
<Label id ="BiometricFaceRecognitionFallbackDescriptionMessage" value="Please authenticate using your DIGIPASS password" />
</Labels/>
<Dynamics>
<Dynamic id="ResultHostCode"class="generated" />
<Dynamic id="ResultResponse"class="generated" />
</Dynamics>
<Buttons>
<Button id="Action"value="Go Online!" />
<Button id="Fallback"value="Fallback" />
</Buttons>
<Errors>
<Error id="DataField1TooShort" value="The minimal length for first data field is %_ MinLength_%." />
<Error id="DataField2TooShort" value="The minimal length for second data field is %_ MinLength_%." />
<Error id="DataField3TooShort" value="The minimal length for third data field is %_ MinLength_%." />
<Error id="DataField4TooShort" value="The minimal length for fourth data field is %_ MinLength_%." />
<Error id="DataField5TooShort" value="The minimal length for fifth data field is %_ MinLength_%." />
<Error id="DataField6TooShort" value="The minimal length for sixth data field is %_ MinLength_%." />
<Error id="DataField7TooShort" value="The minimal length for seventh data field is %_ MinLength_%." />
<Error id="DataField8TooShort"
value="The minimal length for eighth data field is %_ MinLength_%." />
<Error id="DataFieldsCharactersInvalid"value="One of the data fields contains invalid characters." />
<Error id="DataFieldsNotContiguous"value="One of the data fields is empty between two non empty data fields." />
<Error id="ImageInvalid"value="The flashed image is invalid." />
<Error id ="BiometricFaceRecognitionAuthenticationFailed" value="Biometric authentication failed" />
<Error id ="BiometricFingerprintRecognitionAuthenticationFailed" value="Biometric authentication failed" />
</Errors>
</View>
<ActionsListlaunchAtStartup="ro">
<Action .../>
<TransactionDataSigningAction.../>
<SecureChannelAction .../>
<Separator .../>
<TextSeparator .../>
<OfflineHelp .../>
</ActionsList>
</Applications>
Applications: This element is used to configure the common parts of the Mobile Authenticator Studio applications.
Applications > ActionsList: This element is mandatory.
launchAtStartup="ro": The launchAtStartup attribute allows defining which action will be launched at the startup of Mobile Authenticator Studio. Any kind of action is eligible as a target of the Launch at Startup feature, except the TDS action. This attribute is optional. The Launch at Startup feature is disabled by default. Instead, Actions List will be displayed.
Applications > ActionsList > Action: For more information, see Action.
Applications > ActionsList > TransactionDataSigningAction: For more information, see Transaction Data Signing.
Applications > ActionsList > SecureChannelAction: For more information, see Secure Channel action.
Applications > ActionsList > Separator: For more information, see Separator.
Applications > ActionsList > TextSeparator: For more information, see Text separator.
Applications > ActionsList > OfflineHelp: For more information, see Offline Help.
You need to define at least one action.
Graphical customization
Figure 4: Applications screen
Applications > View: This element defines the appearance of the Mobile Authenticator Studio applications.
title: The default value is Applications.
The data in the View element defines the default values (e.g. label, background, error messages) that will be applied to the action elements (Action, TransactionDataSigningAction, SecureChannelAction, TextSeparator, and OfflineHelp). It can be very useful to avoid redundant text.
Applications > View > Fields > Field:
id="DataField1" to id="DataField8": These are the fields to enter data field values 1 to 8.
Applications > View > Labels > Label:
id="ClipboardCopyHostCode": This message is displayed when the user copies the generated host code. It is displayed on Android devices only.
id="ClipboardCopyResponse": This message is displayed when the user copies the generated response. It is displayed on Android devices only.
id="ResultHostCode": This is the label of the generated host code.
id="ResultRemainingTime": This is the label indicating the remaining time before screen timeout.
id="ResultResponse": This is the label of the generated response.
id="InternalValidationMessage": This is the wait message which is displayed while internally validating the OTP.
id="BiometricFingerprintRecognitionDescriptionMessage": This is the label of the biometric protection message for fingerprint recognition.
id="BiometricFingerprintRecognitionFallbackDescriptionMessage": This is the label of the password protection message for fingerprint recognition fallback.
id="BiometricFaceRecognitionDescriptionMessage": This is the label of the biometric protection message for face recognition.
id="BiometricFaceRecognitionFallbackDescriptionMessage": This is the label of the password protection message for face recognition fallback.
Biometric protection is only available for:
iPhone devices with an iOS version later than 12.0, and Touch ID, or Face ID.
Samsung devices with Android 5.0 Lollipop (API level 21) or above, all devices from Android 6.0 (API level 23) with fingerprint support.
Applications > View > Dynamics > Dynamic:
id="ResultHostCode": Can be used to customize the rendering of the generated host code.
id="ResultResponse": Can be used to customize the rendering of the generated response.
Applications > View > Buttons > Button:
id="Action": The default value is Go Online!.
id="Fallback": This is the button indicating on the biometric recognition popup if allowPasswordFallbackis enabled. The default value is Fallback.
Applications > View > Errors > Error:
id="DataField1TooShort" to id="DataField8TooShort": The minimum length for the data field is %_MinLength_%.
The %_MinLength_% mask is used by Mobile Authenticator Studio to replace the minimum length of the data field in the error message.
id="DataFieldsCharactersInvalid": One of the data fields contains invalid characters.
id="DataFieldsNotContiguous": One of the data fields is empty between two non-empty data fields.
id="ImageInvalid": The flashed image is invalid.
id="BiometricFingerprintRecognitionAuthenticationFailed": The biometric authentication failed.
id="BiometricFaceRecognitionAuthenticationFailed": The biometric authentication failed.