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
配置沙盒
配置您的账户
在 https://developer.apple.com/account 上,为 App ID 创建一个标识符。选择一个 捆绑 ID
。
要完全使用沙盒应用程序的功能,请选择 关联域
和 使用 Apple 登录
功能。
在 XCode 中连接您的账户。
在导航区域选择根目录下的 Sandbox
,然后在编辑区域选择 目标
中的 Sandbox
(默认选择)然后 "签名 & 功能"。
填写您的 捆绑 ID
。添加 关联域
和 使用 Apple 登录
功能。
如以下所述配置关联域。
配置关联域
在 "域" 中输入 webcredentials:domain
。
域名必须与 SdkConfig
中的相同,例如 webcredentials:integ-sandbox-squad2.reach5.dev
。
如果您使用一个无法从公共互联网访问的私有 Web 服务器,还可以通过附加 ?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
。您也可以手动指定。
配置后端
您刚才引用的客户端必须是一个具有Token Endpoint Authentication Method
在此处设置为None
的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