ReachFive Identity iOS SDK
Cocoapods pods
安装
参考 公共文档 安装 SDKs 并初始化您的 ReachFive 客户端。
示例应用
除了提供库以外，我们还在“沙箱”目录中提供了一个集成了 ReachFive SDK 的简单 iOS 应用。
安装 Cocoapods。
sudo gem install cocoapods
cd Sandbox
pod install
open Sandbox.xcworkspace
pod update配置沙箱
配置您的账户
在 https://developer.apple.com/account 上，为 App ID 创建标识符。选择一个 捆绑 ID。
为了使用“沙箱”应用的所有功能，请选择“关联域”和“使用Apple ID登录”功能。
在 XCode 中连接您的账户。
在导航器区域内，选择根目录下的“沙箱”，然后在编辑区域内，在“目标”中选择“沙箱”（默认应该已选中）然后“签名与能力”。
填写您的 捆绑 ID。添加“关联域”和“使用Apple ID登录”功能。
按照以下说明配置关联域。
配置关联域
在“域名”中输入 webcredentials:domain。
该域必须与 SdkConfig 中的域相同，例如 webcredentials:integ-sandbox-squad2.reach5.dev。
如果您使用的是一个无法从公共互联网访问的私有 Web 服务器，您还可以通过在末尾添加 ?mode=<alternate mode> 来启用替代模式功能。
例如 webcredentials:integ-sandbox-squad2.reach5.dev?mode=developer
cf. 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中不存在。
在真实设备上运行Sandbox
要在设备上运行您的应用程序，并不仅限于模拟器（例如使用Passkeys），您需要启用“开发者模式”。
在iPhone、iPad上，转到设置 > 隐私 & 安全 > 开发者模式。
在Mac上，在终端运行
swcutil developer-mode -e true您可以在https://developer.reachfive.com/sdk-ios/index.html找到暴露的方法的文档。
请参阅https://developer.reachfive.com/sdk-ios/index.html以获取文档。
变更日志
请参阅变更日志以查看每个发布的描述。
许可协议
MIT © ReachFive