从 Ionic Identity Vault 迁移

Native Biometric 是 Ionic Identity Vault 中安全凭证库部分的完整替代方案。它不仅用于生物识别提示，还能利用原生 Keychain 或 Keystore 保护来保存、检查、检索和删除凭证。启用生物识别访问控制后，受保护的读取操作要求先通过 Face ID、Touch ID 或 Android 生物识别验证，应用才能获取凭证。

直接使用 Native Biometric 处理 token 和凭证库流程。由您的应用决定何时请求受保护的读取，以应用其超时和生命周期策略。如果您还需要一个用于凭证之外数据的广泛加密数据库，请添加 快速 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 凭据保险库流程	@capgo/capacitor-native-biometric — 直接替换	当前位置

Native Biometric 的功能范围

• 安全凭据库： 保存、获取、检查和删除服务器或账户的凭据。
• 生物识别解锁： getSecureCredentials 在读取受保护凭据前显示原生生物识别 prompt。
• 应用控制的锁定策略： 在应用恢复、超时后或执行敏感操作前调用受保护的读取。
• 独立的身份验证 prompt： verifyIdentity 在 iOS 上支持设备密码回退；受保护的凭据读取仍仅限生物识别。
• 访问控制选项： 选择生物识别录入变更是否会使受保护凭据失效。

迁移步骤

1. 安装 Native Biometric 并同步原生 code。

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

2. 保存 access token、refresh token 或其他凭据 并启用生物识别访问控制。
3. 使用 getSecureCredentials 以解锁受保护的凭据 当应用恢复、非活动超时或执行敏感操作前。
4. 在应用层保留超时和隐私屏幕行为。 Native Biometric 不支持自定义密码和仅内存模式；如有需要，请使用独立的应用存储和加密设计。
5. 使用 isCredentialsSaved 以及 deleteCredentials 用于 onboarding、锁定状态和登出流程。
6. 在首次启动时迁移存储的密钥 通过从 Identity Vault 读取并使用 Native Biometric 写入。
7. 移除 Ionic Identity Vault 从你的依赖项和原生配置中移除。

后续步骤

• Native Biometric 入门
• Secure Storage 迁移
• Auth Connect 迁移

继续阅读：从 Ionic Identity Vault 迁移

如果你正在使用 从 Ionic Identity Vault 迁移 来规划安全与合规，请结合 加密 了解 Encryption 的实现细节， 合规性 了解合规部分的实现细节， Capgo 安全扫描器 了解 Capgo Security Scanner 的产品工作流， Capgo 安全 用于 Capgo 安全的产品工作流，以及 Capgo 信任中心 用于 Capgo 信任中心的产品工作流。