Ionic Identity Vaultからの移行

Native Biometricは、Ionic Identity Vaultのセキュアなクレデンシャル・ヴォルト機能を完全に代替します。単に生体認証をプロンプトするだけでなく、ネイティブのKeychainやKeystoreによる保護下で、クレデンシャルの保存、確認、取得、削除を行います。生体認証によるアクセス制御を有効にすると、アプリがクレデンシャルを受け取る前に、Face ID、Touch ID、またはAndroidの生体認証による保護された読み取りが必要になります。

トークンやクレデンシャル・ヴォルトのフローには、Native Biometricを直接使用してください。アプリ側で保護された読み取りをリクエストするタイミングを決定し、タイムアウトやライフサイクル・ポリシーを適用します。クレデンシャル以外のデータを扱うための広範な暗号化データベースも必要な場合は、以下を追加してください： 高速なSQL または SQLiteデータストレージこれはクレデンシャル・ヴォルトの移行においてオプションです。

自動タイムアウトロックやバックグラウンドでのプライバシー画面はアプリケーション層のポリシーであるため、アプリ内でこれらを維持または再実装する必要があります。Native Biometricはカスタムパスコードやメモリ限定のヴォルトモードには対応していません。これらが必要な場合は、別途アプリケーションのストレージおよび暗号化設計を行ってください。

Capgo の置き換え一覧

Ionic Enterprise プラグイン	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の機能範囲

• セキュアな認証情報保管庫: サーバーやアカウント用の認証情報の保存、取得、確認、削除が可能です。
• 生体認証によるロック解除: getSecureCredentials 保護された認証情報を読み取る前に、ネイティブの生体認証プロンプトを表示します。
• アプリ制御のロックポリシー: アプリの復帰時、タイムアウト後、または機密性の高い操作の直前に、保護された読み取りを実行できます。
• 独立した認証プロンプト: 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 セキュリティスキャナーの製品ワークフローについては： Capgo セキュリティ Capgo Security でのプロダクトワークフロー向け、および Capgo Trust Center Capgo Trust Center でのプロダクトワークフロー向け。