Test Biometric Authentication on mobile devices with XCUITest framework

Simulate Touch ID, fingerprint, and Face ID authentication on supported real devices during your test sessions.

The majority of mobile devices today support biometric hardware sensors to authenticate device owner’s identity. BrowserStack enables you to test biometric authentication such as touch ID or fingerprint sensor and face ID on a BrowserStack mobile device with XCUITest framework.

Supported devices and apps

Enable biometric authentication

Use BrowserStack parameter enableBiometric and set it to true in the REST API request to enable Biometric Authentication functionality for your XCUITest test session.

This ensures your app undergoes Sensor Instrumentation, which is a process using which BrowserStack supports the app’s interaction with biometric mobile sensors on BrowserStack real devices.

curl -u "YOUR_USERNAME:YOUR_ACCESS_KEY" \
-X POST "https://api-cloud.browserstack.com/app-automate/xcuitest/v2/build" \
-d '{
"enableBiometric": "true",
"app": "bs://j3c874f21852ba57957a3fdc33f47514288c4ba4", 
"testSuite": "<test_suite_url>", 
"devices": ["iPhone 11-13"]}' \
-H "Content-Type: application/json"

Test biometric authentication after enabling it

When you trigger the Biometric Authentication test workflow in your app, the below BrowserStack prompt shows up. You can click Pass or Fail to succeed or fail the authentication respectively.

Frequently asked questions

Need help?

If you have any queries, get in touch with us.

Related topics

• Manage your uploaded app or test suite using our upload app REST API and upload test suite REST API.

• Use the get app API endpoint and list test suites API endpoint to list your recently uploaded apps and test suites.

• Delete your uploaded app or test suite using the delete app API endpoint and delete test suite API endpoint.