Graphical customization
  • 23 Oct 2024
  • 3 Minutes to read
  • Dark
    Light
  • PDF

Graphical customization

  • Dark
    Light
  • PDF

Article summary

  • Action > OutputData: This element defines the graphical behavior of the action.

    • displayed: Indicates whether the generated response is displayed. This attribute is mandatory. The default value is false.

    • timeout:Defines the timeout in seconds after which the screen displaying the generated response is hidden. This attribute is optional. The default value is 60.

    • centered: Used to specify if the result must be centered or top-aligned. The default value is false.

      The system does not offer a scrollbar in centered mode. The page view may, however, be truncated if the content to be displayed is larger than the available screen size.

    • responsePattern: Can be used to apply a display pattern to the generated response. This attribute is optional. The default value is No formatting.

    • hostCodePattern: Can be used to apply a display pattern to the generated host code. This attribute is optional. The default value is No formatting.

    • displaySerialNumber: Can be used to display the serial number of the authenticator instance used to generate the response.

  • Action > OutputData > URL: This element defines the medium used to send the authenticator response. The following options are available:

    • HTTP request

      <URLvalue="http://MY_DOMAIN_NAME/.../">

    • Phone call using post-dial IVR

      <URLvalue="tel://0001123246564..."/>

    • Third-party application through an auto-launch scheme (Android and iOS)

      <URLvalue="scheme://..."/>

    The OutputData URL element includes an optional attribute, internalValidation, which allows sending an authenticator response to a server in an HTTP(s) request without having to open an external web browser. If this optional attribute is set to false, the request will be performed by opening an external web browser and the Mobile Authenticator Studio application will be exited.

    • internalValidation: Enables internal HTTP functionality. This attribute is optional. The default value is false.

Masks for action output data URL lists the masks for the action output data URL.

Masks for action output data URL

Mask

Value

%_SerialNumber_%

This is the serial number. This mask is optional.

%_SequenceNumber_%

This is the sequence number used during multi-device activation. This mask is optional.

%_RegistrationIdentifier_%

This is the identifier used during activation. This mask is optional.

%_UserIdentifier_%

This is the user identifier. This mask is optional.

%_OTP_%

This is the generated response. This mask is optional.

%_Challenge_%

This is the challenge used for Challenge/Response-based cryptographic applications. This mask is optional.

%_DTF1_% to %_DTF8_%

These are data fields 1 to 8. These masks are optional.

%_Version_%

This is the Mobile Authenticator Studio version. This mask is optional.

%_DeviceIdentifier_%

This is the unique identifier of the device, 64 hexadecimal characters. This mask is optional.

%_RootingStatus_%

This is the status indicating if the device is rooted. Possible values are true or false.

  • Action> View: This element defines the graphical rendering of the applications screen.

    • title: This attribute defines the title as displayed on the applications screen.

  • Action > View > MenuItem:

    • value: This element defines the name of the application in the menu.

    By default, the Action > View element uses all the common values defined in the Applications > View element. Any of these values can be overwritten by defining new values in one or more Action > View elements.

As indicated in the tip, it is possible to define some of the View elements like Label. Below you will find some examples of the definable elements. For the full list, see Common.

  • Action > 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.


Was this article helpful?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.
ESC

Ozzy, our interactive help assistant