跳过内容

iOS设置

GitHub

在 iOS 上,passkey 只有在应用程序与网站的依赖方域名相同时才会工作。

在添加插件配置并运行后 bunx cap sync,插件会修补生成的iOS主机项目,使您不必手动编辑它:

  • 添加 webcredentials: 相关域名条目
  • 连接 CODE_SIGN_ENTITLEMENTS 当生成的应用目标尚未指向一个特权文件时

您仍需要托管

标题:您仍需要托管

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

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

示例:

{
"webcredentials": {
"apps": ["ABCDE12345.app.capgo.passkey.example"]
}
}

[Checklist]

[Checklist]
  1. [Set] origin [and] domains [in] plugins.CapacitorPasskey [in] capacitor.config.*.
  2. [Run] bunx cap sync.
  3. 确认 Apple Team ID 和应用程序包 ID, 然后构建关联文件的值。 TEAMID.bundleId [Host]
  4. [Host] apple-app-site-association [with HTTP] 200 [and no] .json 扩展程序。
  5. 确保您的后端使用的依赖方 ID 与关联域匹配。
  • 必须将网站文件从您用作依赖方 ID 的精确 Passkey 域中服务。
  • 从 iOS 17.4 开始,新版本的插件使用浏览器风格的客户端数据 API,因此配置的 HTTPS 源将反映在 clientDataJSON.
  • 该插件可以在同步时修补本机项目文件,但无法创建或托管网站关联文件于您的域上。

继续从 iOS 设置

标题:继续从 iOS 设置

如果您正在使用 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的实现细节, 和 双因素认证 为双因素认证的实现细节。