从 Ionic Identity Vault 迁移

Native Biometric 提供了 Ionic Identity Vault 中安全凭证库的完整替代品。它不仅提示生物识别：它保存、检查、检索和删除凭证，使用原生 Keychain 或 Keystore 保护。启用生物识别访问控制后，受保护的读取需要 Face ID、Touch ID 或 Android 生物识别才能让您的应用接收凭证。

直接使用 Native Biometric 进行令牌和凭证库流。您的应用决定何时请求受保护的读取以应用其超时和生命周期策略。如果您还需要一个广泛加密的数据库来存储凭证之外的数据，请添加 Fast SQL 或 Data Storage SQLite;这是凭证库迁移的可选项。

自动超时锁定和后台隐私屏幕是应用层策略，因此在您的应用中保留或重建它们。自定义密码和内存仅存储模式不受Native Biometric支持；如果需要它们，请使用单独的应用程序存储和加密设计。

Capgo替换一目了然

Ionic企业插件	Capgo替换	迁移指南
安全存储	@capgo/capacitor-fast-sql 或 @capgo/capacitor-data-storage-sqlite	安全存储迁移
Auth Connect	@capgo/capacitor-social-login	认证连接迁移
身份凭证库：凭证库流程	@capgo/capacitor-native-biometric — 直接替换	您当前位置

Native Biometric 的内容

• 安全凭证库： 保存、检索、检查和删除服务器或帐户的凭证。
• 生物识别门禁： getSecureCredentials 在保护凭证之前显示本机生物识别提示。
• App控制锁定策略： 在应用恢复、超时或敏感操作前，调用保护读取。
• 独立身份提示： verifyIdentity 支持iOS设备密码fallback；保护凭证读取仍为生物识别仅限。
• 访问控制选项： 选择是否生物识别注册更改会使保护凭证失效。

迁移步骤

1. 安装本机生物识别 并同步本机code。

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

2. 保存访问令牌和刷新令牌或其他凭据 启用生物识别访问控制时
3. 使用 getSecureCredentials 解锁受保护的凭据 应用恢复、无活动超时或敏感操作前
4. 在应用层中保留超时和隐私屏幕行为 自定义密码和内存模式不受Native Biometric支持;如果需要，请使用单独的应用程序存储和加密设计
5. 使用 isCredentialsSaved 和 deleteCredentials 进行用户注册、锁定状态和注销流程
6. 在首次启动时迁移存储的机密 通过从身份保管库中读取并使用Native Biometric将它们写入
7. 从您的依赖项和原生配置中移除Ionic Identity Vault。 下一步

原生生物识别入门

• Auth Connect迁移
• 从Ionic Identity Vault迁移
• 如果您正在使用

从Ionic Identity Vault迁移

Migrate from Ionic Identity Vault Keep going from Migrate from Ionic Identity Vault Section titled “Keep going from Migrate from Ionic Identity Vault” 加密 加密的实现细节 合规 合规的实现细节 Capgo 安全扫描器 Capgo 安全扫描器的产品工作流程 Capgo 安全 Capgo 安全的产品工作流程 Capgo 信任中心 Capgo 信任中心的产品工作流程