ReachFive Identity iOS SDK
Cocoapods pods
安装
参考 公共文档 来安装 SDK 并初始化您的 ReachFive 客户端。
示例应用程序
除了库之外,我们还在《沙盒》目录中提供了一个简单的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 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
参看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