iOS设置

在 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"]
  }
}

检查清单

1. 设置 origin 和 domains 在 plugins.CapacitorPasskey 在 capacitor.config.*.
2. 运行 bunx cap sync.
3. 确认您的 Apple Team ID 和应用程序包 ID，然后构建关联文件的 TEAMID.bundleId 值
4. 主机 apple-app-site-association 使用 HTTP 200 和没有 .json 扩展
5. 确保您的后端使用的依赖方 ID 与关联域名匹配。

注意事项

• 网站文件必须从您在依赖方 ID 中使用的准确 Passkey 域名中提供。
• 从 iOS 17.4 开始，插件使用浏览器风格的客户端数据 API，因此配置的 HTTPS 源将反映在 clientDataJSON.
• 插件可以在同步时修补本机项目文件，但无法创建或托管网站关联文件于您的域名。

继续 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的实现细节， 双因素认证 为双因素认证的实现细节。