Files
AuthenticationSdk/docs/IOS_BIOMETRICS.md

22 lines
973 B
Markdown

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:
```sh
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-keychain` to 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.