Skip to main content

Biometrics

Test Face ID / Touch ID / Optic ID availability and run an authentication check.

Overview​

Biometrics lets you confirm whether biometric authentication is available on your device and, if so, trigger a real authentication attempt using the system prompt.

Biometrics: type/status plus an Authenticate button and a diagnostic log.
Example: Face ID detected and not yet authenticated.

Table Of Contents​

Main Sections​

Biometrics is a single scrolling screen with:

  • A hero card showing the detected biometric type and current status.
  • An Authenticate button.
  • A metrics section (Biometric Type and Authentication Status).
  • A Diagnostic Log that records events and errors.

Authenticate​

Tap Authenticate to trigger the system authentication prompt. The result updates the status and adds a log entry.

Status And Metrics​

You'll see:

  • Biometric Type: Face ID, Touch ID, Optic ID (visionOS), or None.
  • Authentication Status: the current state of the last attempt.

Diagnostic Log​

The log records important events, such as:

  • Biometric type detected
  • Authentication started
  • Authentication result (success/failure/canceled)
  • Errors and lockout states

Use Clear to remove the log history.

Common Status States​

Depending on device configuration and user actions, the tool can show states like:

  • Not Authenticated
  • Success
  • Failed
  • Not Available
  • Not Enrolled
  • Lockout
  • Canceled by User / System
  • Fallback
  • Unknown

Notes And Limitations​

  • Apps cannot access biometric data itself; they can only request an authentication evaluation.
  • Availability and error states are controlled by the OS (for example, lockout after too many failed attempts).
Last updated on by Rogerio Hirooka