Fingerprint and Face ID simulation

The authentication simulation options in the device control panel lets you simulate fingerprint and Face ID authentications on mobile devices.

About fingerprint and Face ID authentication

Fingerprints and Face IDs are often used for security authentication on mobile devices. Apps may utilize these authentications to secure sensitive features such as sign-on, payments, and so forth. If the device you are testing is not physically available, you will be unable to authenticate with a fingerprint or Face ID during your test. This feature simulates the entering of a fingerprint or a face ID on the device’s screen.

When you run an app that prompts you for authentication, the Simulation Authentication dialog box opens, and you can select an authentication result: Success, Failure, or Cancel.

Note: Fingerprint authentication simulation is supported on both Android and iOS devices. Face ID is only supported for iOS.

Back to top

Prepare for simulation

To prepare for authentication simulation:

  1. If you are doing a fingerprint simulation on Android, make sure you have enabled fingerprint authentication on the device, in the device's settings.
  2. Create a packaged version of the app that utilizes the authentication.
  3. Upload the packaged app to your mobile lab.

Back to top

Authentication results and reasons

When your app requires fingerprint or Face ID authentication, the Simulation Authentication dialog box opens. This dialog box lets you select an authentication result: Success, Failure, or Cancel.

For Failure and Cancel, you specify a reason for the result.

Failure

  • Too many failed attempts
  • Authentication was not recognized
  • No authentication method was registered (iOS only)
  • Finger moving too fast (Android only)
  • Fingerprint sensor is dirty (Android only)

Cancel:

  • Canceled by the user (on Android, OS version 8.1 or higher is required)
  • Canceled by the system

Back to top

Tips and Guidelines

  • When working with fingerprint simulation, the fingerprint authentication dialog box may not trigger on certain Samsung Note devices, due to the unique location of the touch sensor.

    To check if there is a touch sensor on your device, run the Android SDK's custom application call isHardwareDetected(). If a touch sensor is present, and the Fingerprint Authentication dialog box is not triggered, this indicates that the device is not supported. Instead, you will be prompted for a password.

    The touch sensor on Samsung Note 4 devices is not detected through the Android SDK API call isHardwareDetected. If your custom app requires isHardwareDetected=true in order to trigger fingerprint authentication, the fingerprint authentication will not be triggered and the Fingerprint Simulation dialog box will not open in the remote view.

  • Fingerprint and Face ID authentication is implemented by developers in different ways. As a result, the behavior of apps may vary when you set the response to Failure.