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 は似ていますが、デフォルト設定が異なります。