ForgeRock iOS SDK可以快速将ForgeRock身份平台集成到您的iOS应用程序中。
使用SDK利用ForgeRock身份平台中的智能身份验证,通过回调轻松遍历身份验证树的每个阶段。
- ForgeRock身份平台
- 访问管理(AM)6.5.2+
- iOS 12及以上
- Xcode
- Swift 5.x或Objective-C
- CocoaPods或Swift包管理器(可选)
如果您想安装最新版本,请在Podfile
中使用以下pods安装FR iOS SDK模块(s)。
pod 'FRAuth' // Authentication module for Access Manager
pod 'FRUI' // UI SDK demonstrates FRAuth SDK functionalities
pod 'FRProximity' // Add-on for FRAuth's Device Profile feature related to location, and BLE
pod 'FRAuthenticator' // Authenticator module that generates HOTP, TOTP, and Push registration/authentication
pod 'FRGoogleSignIn' // Social Login module for Google Sign In
pod 'FRFacebookSignIn' // Social Login module for Facebook Login
pod 'FRDeviceBinding' // Add-on for Device Binding feature
pod 'PingProtect' // Add-on for Ping Protect feature
- ForgeRock iOS SDK从3.0.0及以上版本可通过Swift包管理器获取。任何较旧版本(2.2.0以下)仅可通过CocoaPods获取。
FRGoogleSignIn
模块目前不可在Swift包管理器中获取;请改用CocoaPods来集成FRGoogleSignIn
模块。
- 在Xcode菜单中,选择
文件
->Swift Packages
->添加Dependency...
- 选择要集成ForgeRock iOS SDK的项目
- 输入仓库名称:
https://github.com/ForgeRock/forgerock-ios-sdk
- 选择要集成到项目的模块(s)
要尝试ForgeRock iOS SDK示例,请按以下步骤操作
- 按文档中所述设置访问管理(AM)
- 克隆此仓库
git clone https://github.com/ForgeRock/forgerock-ios-sdk.git
- 在Xcode中打开
SampleApps/QuickstartExample/Quickstart.xcodeproj
文件。 - 打开
/Quickstart/FRAuthConfig.plist
并编辑值以匹配您的AM实例。 - 确保活动方案是 "Quickstart",然后单击运行按钮。
ForgeRock提供以下示例,以帮助展示SDK功能
-
Swift示例 -
/FRExample/
此Swift应用程序示例演示了如何使用
FRUser
自动用户界面支持和不支持,对AM实例进行身份验证。其他功能包括
- OAuth 2.0访问令牌
- 注销
- 收集设备信息
- 获取当前用户详细信息
- 越狱检测
在
/FRexampleObjC/FRexampleObjC/Configs/FRAuthConfig.plist
文件中配置您的AM实例设置,以使用此示例应用程序。 -
Objective-C示例 -
/FRexampleObjC/
此Objective-C应用程序示例演示了如何使用
FRUser
自动用户界面支持和不支持,对AM实例进行身份验证。其他功能包括
- 注销
- 收集设备信息
- 获取当前用户详细信息
- 越狱检测
在
/FRExample/FRExample/Configs/FRAuthConfig.plist
文件中配置您的AM实例设置,以使用此示例应用程序。 -
认证器应用程序示例 -
/FRAuthenticatorExample/
此认证器样本应用程序演示了基于HMAC和时间的一次性密码以及使用ForgeRock访问管理器的推送注册和认证。
SDK文档在 BackStage 上提供,包括以下主题
- 介绍SDK功能
- 为使用SDK准备AM
- API参考文档
如果您遇到任何问题,请确保先查看我们的 故障排除 页面。
当您需要我们的帮助时,可以提出支持请求;以下是一些合适提出工单的例子(但不仅限于此)
您可以使用 BackStage 提出工单,这是我们的客户支持门户,为您提供一站式访问ForgeRock服务的入口。
BackStage显示所有当前打开的支持工单,并允许您通过点击 新建工单 提出新工单。
如果您想为此项目做出贡献,您可以分叉存储库,将其克隆到您的计算机上并开始。
ForgeRock在此提供此代码,不承担任何形式的保证,范围以法律允许的最大程度为准。ForgeRock不保证或保证此代码的使用、数据的准确性、及时性或完整性,以及与此代码相关联的任何数据或信息的准确性,ForgeRock在此明确放弃所有明示、暗示或法定保证,包括但不限于适用性、特定用途的适用性和非侵权保证。ForgeRock不对此代码的任何使用、实施或配置引起的任何责任负有责任,包括但不限于任何商业用途的使用。关于代码使用的任何诉讼仅能在ForgeRock居住或主要业务所在的法院提起,并受该司法管辖权的法律约束,不包括其冲突法条款。
本项目采用MIT许可证 - 详细信息请参阅LICENSE文件
©版权所有 2024 ForgeRock AS. 版权所有