Ionic Identity Vaultからの移行

Native Biometric は、Ionic Identity Vault のセキュアなクレデンシャル保管庫部分を完全に置き換えます。生体認証を求めるだけでなく、ネイティブの Keychain または Keystore 保護により、クレデンシャルの保存、検証、取得、削除を行います。生体認証アクセス制御を有効にすると、保護された読み取りでは、アプリがクレデンシャルを受け取る前に Face ID、Touch ID、または Android の生体認証が必要です。

トークンやクレデンシャル保管庫のフローには、Native Biometric を直接使用してください。アプリがタイムアウトとライフサイクルポリシーを適用するため、保護された読み取りをいつリクエストするかはアプリ側で決めます。クレデンシャル以外のデータ向けに、より広範な暗号化データベースも必要な場合は、追加で 高速なSQL または SQLiteによるデータストレージを使用できます。これはクレデンシャル保管庫への移行では任意です。

自動タイムアウトロックやバックグラウンドのプライバシースクリーンはアプリケーション層のポリシーなので、アプリ内で維持または再作成してください。カスタムパスコードモードとメモリ専用保管庫モードは Native Biometric ではサポートされていません。必要な場合は、別途アプリケーションストレージと暗号化の設計を行ってください。

Capgo の置き換え一覧

Ionic エンタープライズプラグイン	Capgo の代替手段	移行ガイド
セキュアストレージ	@capgo/capacitor-fast-sql または @capgo/capacitor-data-storage-sqlite	Secure Storageの移行
認証連携	@capgo/capacitor-social-login	Auth Connect への移行
Identity Vault の credential-vault フロー	@capgo/capacitor-native-biometric — 直接置き換え	現在地

Native Biometric の対象範囲

• セキュアな credential vault: サーバーやアカウントの credential を保存、取得、確認、削除します。
• 生体認証によるロック解除: getSecureCredentials 保護された credential を読み取る前に、ネイティブの生体認証プロンプトを表示します。
• アプリ制御のロックポリシー: アプリの再開時、タイムアウト後、または機密操作の前に保護された読み取りを呼び出します。
• 個別の ID プロンプト: verifyIdentity iOS ではデバイスパスコードのフォールバックをサポート。保護されたクレデンシャルの読み取りは生体認証のみ。
• アクセス制御の選択肢: 生体認証の登録変更で保護されたクレデンシャルを無効にするかどうかを選択。

移行ステップ

1. Native Biometric をインストール を行い、ネイティブの code を同期します。

npm install @capgo/capacitor-native-biometric
npx cap sync

2. アクセス/リフレッシュトークンやその他のクレデンシャルを保存 生体認証アクセス制御を有効にした状態で。
3. 使用する getSecureCredentials 保護された認証情報をロック解除するために アプリの再開時、無操作タイムアウト後、または機密性の高い操作の前に行います。
4. タイムアウトやプライバシー画面の挙動は、アプリ層で管理してください。 Native Biometricはカスタムパスコードモードとメモリのみのモードをサポートしていません。必要な場合は、アプリのストレージと暗号化を別途設計してください。
5. 使用する isCredentialsSaved と deleteCredentials オンボーディング、ロック状態、ログアウトの各フローに。
6. 初回起動時に保存されたシークレットを移行する Identity Vaultから読み取り、Native Biometricで書き込むことで実現します。
7. Ionic Identity Vaultを削除する 依存関係とネイティブ設定から削除します。

次のステップ

• Native Biometric をはじめる
• Secure Storageの移行
• Auth Connect への移行

Ionic Identity Vault からの移行を続ける

使用している場合 Ionic Identity Vaultからの移行 セキュリティとコンプライアンスを計画するには、これを以下と連携させてください 暗号化 暗号化の実装詳細について コンプライアンス コンプライアンスの実装詳細について Capgo セキュリティスキャナー Capgo Security Scanner のプロダクトワークフローについて Capgo のセキュリティ Capgo Security のプロダクトワークフロー向け、および Capgo トラストセンター Capgo Trust Center のプロダクトワークフロー向け。