> For the complete documentation index, see [llms.txt](https://docs.qyrus.com/device-farm/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.qyrus.com/device-farm/biometrics.md).

# Biometric Bypass Feature for Real Devices

## 1. Introduction

The **Biometric Bypass** feature provides a seamless mechanism to bypass biometric authentication prompts—including fingerprint (Touch ID / Android BiometricPrompt) and facial recognition (Face ID)—during manual, automated, and AI-driven testing on real iOS and Android devices. This feature allows QA teams to automate and manually test secure login, checkout, and authorization workflows without requiring physical user biometrics on remote hardware.

***

### Benefits of Biometric Bypass:

* **Testing Acceleration**: Eliminates blocking authentication modals that prevent automated scripts or manual testers from reaching downstream app features.
* **Repeatable Regression Testing**: Run end-to-end regression suites repeatedly without manual biometric intervention.
* **Simulating Success & Fallback Scenarios**: Test both successful biometric authorizations and passcode fallback paths.

***

## 2. Enabling Biometric Bypass

You can utilize Biometric Bypass using two methods:

### Method A: Enable During Session Setup

1. When starting a manual or Object Spy session, choose your target device and uploaded application binary.
2. Toggle the **`Biometrics (Beta)`** switch on the session setup card.
3. Click **“Start Session”**. The session launches with biometric mocking automatically initialized for that application.

![Biometrics Session Start](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-db9b20f7d96c4496e00509c1a6aeca1fb3ba6645%2FEnable-biometrics-session.png?alt=media)

***

### Method B: Dynamic Trigger During an Active Session

1. If your application triggers a biometric prompt mid-test, locate the **Biometrics (Fingerprint)** icon on the device control bar.
2. Click the button to dispatch an instantaneous simulated biometric success event to the running app.

***

## App Behavior Demonstration

> #### The illustration below demonstrates app behavior first without biometric bypass enabled (prompt remains active) and then with the biometric bypass flag enabled (authenticates immediately):

![Biometrics Flow](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-b521fb82a405890ca64088ead75fde45fd044740%2Fbiometrics.gif?alt=media)

***

## Compatibility & Requirements

* **Application Build:** Requires an instrumentable debug/staging build (`.apk`, `.ipa`, or `.aab`) signed for testing.
* **OS Support:** Supported across physical Android devices and iOS devices (iOS 14 through iOS 16; iOS 17+ support depends on application build entitlement configurations).

***