iOS 配置

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

插件处理的内容

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

• 添加 webcredentials: 配置域名的关联域名 (associated domains) 条目
• 连线 CODE_SIGN_ENTITLEMENTS 当生成的 App target 尚未指向 entitlements 文件时

仍需自行托管的内容

您必须发布 apple-app-site-association 在 Relying-party 域名上：

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.
• 插件可以在同步期间修改原生项目文件，但无法在您的域名上创建或托管网站关联文件。

从 iOS Setup 继续

如果你正在使用 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 中的实现细节， 双因素认证 有关双重身份验证的实现细节。