ReachFive Identity iOS SDK
Cocoapods pods
安装
请参考 公共文档 来安装 SDK 并初始化您的 ReachFive 客户端。
演示应用
除了库之外,我们还在 Sandbox
目录中提供了一个简单的 iOS 应用程序,该应用程序集成了 ReachFive SDK。
安装 Cocoapods。
sudo gem install cocoapods
cd Sandbox
pod install
open Sandbox.xcworkspace
pod update
配置 Sandbox
配置您的帐户
在 https://developer.apple.com/account 上,为 App ID 创建一个标识符。选择一个 捆绑 ID
。
为了使用 Sandbox 应用程序的全部功能,请选择 关联域名
和 使用 Apple 登录
功能。
在 Xcode 中连接您的帐户。
在导航区域,选择根目录下的 Sandbox
,然后在编辑区域,在 目标
下选择 Sandbox
(默认应选中),然后选择 "签名和功能"。
填写您的 捆绑 ID
。添加 关联域名
和 使用 Apple 登录
功能。
按照以下说明配置关联域名。
配置关联域名
在域名中输入 webcredentials:domain
。
该域名必须与 SdkConfig
中的域名相同,例如 webcredentials:integ-sandbox-squad2.reach5.dev
。
如果您使用的是无法从公共互联网访问的私有网络服务器,您也可以通过添加 ?mode=<alternate mode>
启用备用模式功能。
例如,webcredentials:integ-sandbox-squad2.reach5.dev?mode=developer
。
参看 https://developer.apple.com/documentation/xcode/supporting-associated-domains
连接到您的后端
您还需要在SDK中设置 ReachFive 客户端配置,如下所示
SdkConfig(
domain: "my-reachfive-url",
clientId: "my-reachfive-client-id"
)
例如
SdkConfig(
domain: "integ-sandbox-squad2.reach5.dev",
clientId: "zhU43aRKZtzps551nvOM"
)
默认情况下,URL模式遵循以下模式: reachfive-${clientId}://callback
。您也可以手动指定它。
配置您的后端
您刚刚引用的客户端必须是一个具有 None
下 Token Endpoint Authentication Method
的 First-party client
。
您必须在 Allowed Callback URLs
中注册该方案。
您还应强制执行PKCE并启用刷新令牌。
如果您想使用Passkeys,必须在您的账户上激活 Webauthn
功能,并将您的域名添加到 Allowed Origins
中,如下所示: https://integ-sandbox-squad2.reach5.dev
。
注意这里 https://
而在 SdkConfig
中没有。
在真机上运行沙盒
要使用Passkeys等在真机上运行您的应用程序(而不只是在模拟器上),您需要启用“开发者模式”。
在iPhone,iPad上,转到设置 > 隐私和安全 > 开发者模式。
在Mac上,在终端运行
swcutil developer-mode -e true
文档
您可以在以下链接找到暴露在https://developer.reachfive.com/sdk-ios/index.html上的方法的文档。
更新日志
请参阅更新日志以查看每个版本的描述。
许可
MIT © ReachFive