ReachFive Identity iOS SDK
Cocoapods pods
安装
请参阅公开文档安装SDK,并初始化您的ReachFive客户端。
演示应用程序
除了在《沙盒》目录中提供的库外,我们还提供了一款简单的iOS应用程序,其中集成了ReachFive SDKs。
安装 Cocoapods。
sudo gem install cocoapods
cd Sandbox
pod install
open Sandbox.xcworkspace
pod update
配置沙盒
配置您的账户
在 https://developer.apple.com/account 上,为应用ID创建一个标识符。选择 包标识符
。
为了获得沙盒应用的完整功能,选择 关联域名
和 使用Apple ID登录
功能。
在XCode中连接您的账户。
在导航区域,选择根目录下的 沙盒
,然后在编辑区域,在 目标
中选择 沙盒
(默认应该已选择)然后 "签名和功能"。
填写您的 包标识符
。添加 关联域名
和 使用Apple ID登录
功能。
按照以下说明配置关联域名。
配置关联域名
在“域名”中输入 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
。您也可以手动指定。
配置您的后端
您引用的客户端必须是一个具有 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