跳转到正文

iOS 配置

GitHub

在 iOS 上,只有当 App 和网站关联到同一个 Relying Party 域名时,Passkey 才能正常工作。

添加插件配置并运行后 bunx cap sync,插件会修补生成的 iOS 宿主项目,你无需再手动编辑:

  • 添加 webcredentials: 已配置域名的 associated domains 条目
  • wires CODE_SIGN_ENTITLEMENTS 当生成的 App target 尚未指向 entitlements 文件时

您必须在 apple-app-site-association 依赖方域名上发布:

https://signin.example.com/.well-known/apple-app-site-association

示例:

{
"webcredentials": {
"apps": ["ABCDE12345.app.capgo.passkey.example"]
}
}
  1. 设置 origin 以及 domains 中的 plugins.CapacitorPasskey 中的 capacitor.config.*.
  2. 运行 bunx cap sync.
  3. 确认您的 Apple Team ID 和 App Bundle ID,然后构建 TEAMID.bundleId 关联文件的值。
  4. 托管 apple-app-site-association 使用 HTTP 200 并且没有 .json 扩展。
  5. 请确保后端使用的 relying-party ID 与关联域名一致。
  • 网站文件必须由你用作 relying-party ID 的那个 passkey 域名提供。
  • 在 iOS 17.4 及更高版本上,插件使用浏览器风格的 client-data API,让配置的 HTTPS origin 体现在 clientDataJSON.
  • 该插件可以在 sync 期间修补原生项目文件,但无法在你的域名上创建或托管网站关联文件。

如果你正在使用 iOS 配置 用来规划身份验证和账户流程,并将它与 使用 @capgo/capacitor-passkey 在“使用 @capgo/capacitor-passkey”中了解原生能力, @capgo/capacitor-social-login 在 @capgo/capacitor-social-login 中查看实现细节, @capgo/capacitor-passkey 有关 @capgo/capacitor-passkey 的实现细节, @capgo/capacitor-native-biometric 以及 @capgo/capacitor-native-biometric 中的实现细节, 双因素认证 有关双重身份验证的实现细节。