973 B
973 B
iOS Biometric / Device Lock Setup
To enable and test device biometric authentication on iOS:
- Ensure the Info.plist contains a Face ID usage description (
NSFaceIDUsageDescription). This project already adds a default string. - Install CocoaPods and native deps:
cd ios
bundle install # (if you use Bundler)
bundle exec pod install
- Open the workspace in Xcode (
ios/authenticationsdk.xcworkspace) and build to a device or simulator. For Face ID testing use a simulator with Face ID enabled or a device with Face ID configured. - The app uses
react-native-keychainto prompt for biometrics / device passcode; no additional Xcode entitlements are required beyond the Info.plist usage string.
If biometrics are not available, the Keychain prompt can fall back to the device passcode when configured.
Testing notes:
- Simulator: Device > Face ID > Enrolled to simulate Face ID responses.
- Device: Make sure Face ID / Touch ID is configured in Settings.