ionic-biometric-auth

生物识别认证

使用设备的生物识别传感器（Face ID、Touch ID、指纹）验证用户身份，可用于应用锁、敏感功能门控，或在会话超时后进行二次验证。

何时查阅

• 设置 + 权限 + 用法：setup-and-usage.md

硬性规则

• ✅ 生物识别用于向设备验证用户身份，而非向后端验证。不要将成功的生物识别提示视为后端会话——它只是本地的在场证明。请配合使用服务器签发的令牌／会话。
• ✅ 对于“应用锁”，请在 @capacitor/preferences 中存储一个标志，并据此限制路由导航。
• ✅ 当生物识别失败或不可用时，请提供使用密码／口令的备用方案。
• ❌ 不要在此插件中使用生物识别来直接“解密”存储的机密——若要使用真正由安全隔区支持的密钥存储，请使用基于 iOS Keychain / Android Keystore 的安全存储插件（例如 capacitor-secure-storage-plugin，或当前维护中的社区软件包——采用前请在 npm 上确认）。
• ❌ 不要在每次 API 调用时都提示进行生物识别——这既令人厌烦，也不符合生物识别的用途。请在应用启动时或恢复运行后，经过可配置的超时时间再进行验证。

库

npm install @aparajita/capacitor-biometric-auth
npx cap sync

替代插件：@capgo/capacitor-native-biometric 也广泛使用。选定一个并保持一致——它们的 API 类似，但默认设置不同。