推荐使用 iOS Guard SDK 接入。它包含本 SDK 全部内容,并且提供了大量本 SDK 不具备的功能。本 SDK 只作为向下兼容进行维护
- Authing Swift SDK 仅支持以终端用户(End User)的身份进行请求,提供了登录、注册、登出、管理用户资料、获取授权资源等所有管理用户的方法。目前不支持管理员(Administrator)身份的相关方法。
- SDK 的更新日志,可参阅 Release Notes
下载地址
条目 | 说明 |
---|---|
支持版本 | - Swift 5.0 + - Xcode 11 + - iOS 10+ |
Platform | - iOS - osx - tvos - watchos |
仓库地址 | https://github.com/jiananMars/SwiftyAuthing.git |
- 在 Package.swift 文件中加入如下 dependencies 代码:
dependencies: [
.package(url: "https://github.com/jiananMars/SwiftyAuthing.git", .upToNextMajor(from: "4.0.0"))
]
- 进入工程根目录,打开 SwiftyAuthingExample.xcodeproj ,等待 Swift Package 下载完成
- 从 GitHub 获取 SDK 的源代码
- 将源代码中 SwiftyAuthing 目录导入 App 项目,并选中 Copy items if needed
注:需要添加依赖库: Apollo 和 Alamofire
在 AppDelegate 的 - application: didFinishLaunchingWithOptions: 中添加初始化代码:
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
// AuthenticationClient.initSDK(userPoolId: <#用户池 ID#>)
// AuthenticationClient.initSDK(userPoolId: <#用户池 ID#>, appId: <#App ID#>, domain: <#domain#>)
AuthenticationClient.initSDK(userPoolId: <#用户池 ID#>, appId: <#App ID#>)
return true
}
私有化部署需要修改 config 目录下 Config.Swift 文件中的 domainDefault 和 domain 两个参数值。
public static let domainDefault = "https://xxx.com"
public static var domain = "https://xxx.com"
用户认证模块:
使用邮箱注册,邮箱不区分大小写且用户池内唯一。此接口不要求用户对邮箱进行验证,用户注册之后 emailVerified 字段会为 false 。如果你希望邮箱未验证的用户不能进行登录,可以在用户池的设置 - 安全信息 中开启禁止未验证邮箱的用户登录选项。
email
邮箱password
密码RegisterProfile
用户资料forceLogin
是否走遍完整的登录的,会触发登录前后的 pipeline 函数以及登录事件 webhook ,同时该用户的累计登录次数会加 1 。默认为 false 。generateToken
是否为该用户生成 token,不会触发登录后的完整流程,用户的累计登录次数不会加 1。默认为 false 。clientIp
客户端真实 IP,如果你在服务器端调用此接口,请务必将此参数设置为终端用户的真实 IP。context
请求上下文,这里设置的context
可以在 pipeline 的 context 中获取到。
AuthenticationClient.shared.registerByEmail(email: <#邮箱#>, password: <#密码#>, completion: {result in })
- 参阅 用户字段释义
使用用户名注册,用户名区分大小写且用户池内唯一。
username
用户名password
密码RegisterProfile
用户资料forceLogin
是否走遍完整的登录的,会触发登录前后的 pipeline 函数以及登录事件 webhook ,同时该用户的累计登录次数会加 1 。默认为 false 。generateToken
是否为该用户生成 token,不会触发登录后的完整流程,用户的累计登录次数不会加 1。默认为 false 。clientIp
客户端真实 IP,如果你在服务器端调用此接口,请务必将此参数设置为终端用户的真实 IP。context
请求上下文,这里设置的context
可以在 pipeline 的 context 中获取到。
AuthenticationClient.shared.registerByUsername(username: <#用户名#>, password: <#密码#>, completion:{result in })
- 参阅 用户字段释义
使用手机号注册,初始密码为可选参数。发送短信的接口参阅 sendSmsCode
code
短信验证码phone
手机号- password 初始密码
RegisterProfile
用户资料forceLogin
是否走遍完整的登录的,会触发登录前后的 pipeline 函数以及登录事件 webhook ,同时该用户的累计登录次数会加 1 。默认为 false 。generateToken
是否为该用户生成 token,不会触发登录后的完整流程,用户的累计登录次数不会加 1。默认为 false 。clientIp
客户端真实 IP,如果你在服务器端调用此接口,请务必将此参数设置为终端用户的真实 IP。context
请求上下文,这里设置的context
可以在 pipeline 的 context 中获取到。
AuthenticationClient.shared.registerByPhoneCode(phone: <#手机号#>, code: <#验证码#>, password: <#初始密码#>, completion:{ result in })
- 参阅 用户字段释义
使用邮箱登录,该接口默认不会限制未验证的邮箱进行登录,如果你希望邮箱未验证的用户不能进行登录,可以在用户池的设置 - 安全信息 中开启禁止未验证邮箱的用户登录选项。
如果你的用户池开启了登录失败检测,当同一 IP 下登录多次失败的时候会要求用户输入图形验证码(ErrorCode : 2000)。
email
邮箱password
密码autoRegister
是否自动注册。如果检测到用户不存在,会根据登录账密自动创建一个账号。captchaCode
图形验证码clientIp
客户端真实 IP,如果你在服务器端调用此接口,请务必将此参数设置为终端用户的真实 IP。context
请求上下文,这里设置的context
可以在 pipeline 的 context 中获取到。
AuthenticationClient.shared.loginByEmail(email: <#邮箱#>, password: <#密码#>, completion:{ result in })
- 参阅 用户字段释义
使用用户名登录。如果你的用户池开启了登录失败检测,当同一 IP 下登录多次失败的时候会要求用户输入图形验证码(ErrorCode : 2000)。
username
用户名password
密码autoRegister
是否自动注册。如果检测到用户不存在,会根据登录账密自动创建一个账号。captchaCode
图形验证码clientIp
客户端真实 IP,如果你在服务器端调用此接口,请务必将此参数设置为终端用户的真实 IP。context
请求上下文,这里设置的context
可以在 pipeline 的 context 中获取到。
AuthenticationClient.shared.loginByUsername(username: <#用户名#>, password: <#密码#>, completion:{ result in })
- 参阅 用户字段释义
使用手机号验证码登录。你需要先使用 sendSmsCode 方法发送短信验证码。
phone
手机号code
短信验证码,你可以通过 sendSmsCode 方法发送短信验证码。clientIp
客户端真实 IP,如果你在服务器端调用此接口,请务必将此参数设置为终端用户的真实 IP。context
请求上下文,这里设置的context
可以在 pipeline 的 context 中获取到。
AuthenticationClient.shared.loginByPhoneCode(phone: <#手机号#>, code: <#验证码#>, completion:{ result in })
- 参阅 用户字段释义
如果用户绑定了手机号且设置了密码,可以使用手机号 + 密码的方式登录。如果你的用户池开启了登录失败检测,当同一 IP 下登录多次失败的时候会要求用户输入图形验证码(ErrorCode : 2000)。
phone
手机号password
密码captchaCode
图形验证码clientIp
客户端真实 IP,如果你在服务器端调用此接口,请务必将此参数设置为终端用户的真实 IP。context
请求上下文,这里设置的context
可以在 pipeline 的 context 中获取到。
AuthenticationClient.shared.loginByPhonePassword(phone: <#手机号#>, password: <#密码#>,, completion:{ result in })
- 参阅 用户字段释义
如果用户开启了子账号登录,可以使用子账号登录。如果你的用户池开启了登录失败检测,当同一 IP 下登录多次失败的时候会要求用户输入图形验证码(ErrorCode : 2000)。
username
用户名password
密码captchaCode
图形验证码clientIp
客户端真实 IP,如果你在服务器端调用此接口,请务必将此参数设置为终端用户的真实 IP。
AuthenticationClient.shared.loginBySubAccount(username: <#用户名#>, password: <#密码#>, completion: { (result) in }
- 参阅 用户字段释义
使用 LDAP 身份源的账号密码登录。如果此账号第一次登录,将会将其用户信息导入到用户池的用户目录中;之后再次登录,将会根据获取到的最新的账号资料更新此账号的用户信息。 点此查看连接 LDAP 身份源文档。
username
用户名password
密码
AuthenticationClient.shared.loginByLdap(username: <#用户名#>, password: <#密码#>) { (result) in }
- 参阅 用户字段释义
使用 AD 域的账号登录。如果此账号第一次登录,将会将其用户信息导入到用户池的用户目录中;之后再次登录,将会根据获取到的最新的账号资料更新此账号的用户信息。 点此查看连接 Active Directory 身份源文档。
username
用户名password
密码
AuthenticationClient.shared.loginByAD(username: <#用户名#>, password: <#密码#>) { (result) in }
- 参阅 用户字段释义
获取当前登录用户的用户信息,需要 AuthenticationClient 当前处于已登录状态。你可以通过两种方式设置 AuthenticationClient 的登录状态:
AuthenticationClient.shared.getCurrentUser(completion: { result in })
- 参阅 用户字段释义
用于用户退出登录。
- 清空该用户在当前应用下的 session 会话信息。
- 将用户当前的
id_token
标记为已失效,使用此id_token
将调用 Authing 接口无法获取到相关数据。
AuthenticationClient.shared.logout(completion:{ result in })
获取当前用户的自定义数据列表,需要 AuthenticationClient 当前处于已登录状态。
AuthenticationClient.shared.listUdv(completion:{ result in })
添加用户自定义数据,需要 AuthenticationClient 当前处于已登录状态。
key
自定义数据的 Keyvalue
自定义数据的 Value
AuthenticationClient.shared.setUdv(key: <#Key#>, value: <#Value#>, completion: { (result) in })
AuthenticationClient.shared.listOrg(completion: { result in })
送短信验证码, 目前仅支持国内手机号;该接口有接口频率限制,请勿频繁请求。
phone
手机号
AuthenticationClient.shared.sendSmsCode(phone: <#手机号#>, completion: { result in })
主动发送邮件给用户,目前支持的 4 类邮件包含:重置密码邮件、验证邮箱邮件、修改邮箱验证码邮件、MFA 验证邮件。同时你可以自定义邮件模版和配置第三方邮件服务商。
email
邮箱scene
发送场景,可选值包含:- RESET_PASSWORD: 发送重置密码邮件,邮件中包含验证码;
- VERIFY_EMAIL: 发送验证邮箱的邮件;
- CHANGE_EMAIL: 发送修改邮箱邮件,邮件中包含验证码;
- MFA_VERIFY: 发送 MFA 验证邮件。
AuthenticationClient.shared.sendEmail(email: <#邮箱#>, scene: <#scene#>, completion: { result in })
获取用户的所有自定义数据。你需要先在用户池定义用户自定义数据元信息。
AuthenticationClient.shared.listUdv(completion:{ result in })
key
自定义字段的 key
AuthenticationClient.shared.removeUdv(key: <#key#>, completion:{ result in })
AuthenticationClient.shared.checkLoginStatus(token: <#token#>, completion:{ result in })
通过短信验证码重置密码,你可以通过 sendSmsCode 方法发送短信验证码。
phone
手机号code
验证码newPassword
新的密码
AuthenticationClient.shared.resetPasswordByPhoneCode(phone: <#手机号#>, code: <#验证码#>, newPassword: <#新的密码#>, completion: { (result) in })
通过邮件验证码重置密码,你需要先调用 sendEmail 接口发送重置密码邮件(场景值为
RESET_PASSWORD
)。
email
邮箱code
验证码newPassword
新的密码
AuthenticationClient.shared.resetPasswordByEmailCode(email: <#邮箱#>, code: <#验证码#>, newPassword: <#新的密码#>, completion:{ (result) in })
修改用户资料,此接口不能用于修改手机号、邮箱、密码,如果需要请调用 updatePhone、updateEmail、updatePassword 接口。
username
用户名nickname
昵称photo
头像company
公司browser
浏览器device
设备lastIP
最近登录的 IPname
NamegivenName
Given NamefamilyName
Family Nameformatted
详细地址middleName
Middle Nameprofile
Profile UrlpreferredUsername
Preferred Namewebsite
个人网站gender
性别, M(Man) 表示男性、F(Female) 表示女性、未知表示 U(Unknown)birthdate
生日zoneinfo
时区locale
语言address
地址streetAddress
街道地址locality
region
地域postalCode
邮编city
城市province
省份country
国家
AuthenticationClient.shared.updateProfile(email: <#邮箱#>, completion: { (result) in })
newPassword
新密码
AuthenticationClient.shared.updatePassword(newPassword: <#新密码#>, completion:{ (result) in })
用户初次绑定手机号,如果需要修改手机号请使用 updatePhone 方法。如果该手机号已被绑定,将会绑定失败。发送验证码请使用 sendSmsCode 方法。
phone
手机号phoneCode
短信验证码,你可以通过 sendSmsCode 方法发送短信验证码
AuthenticationClient.shared.bindPhone(phone: <#手机号#>, phoneCode: <#验证码#>, completion: { (result) in })
用户解绑手机号,如果用户没有绑定其他登录方式(邮箱、社会化登录账号),将无法解绑手机号,会提示错误。
AuthenticationClient.shared.unbindPhone(completion: { (result) in })
更新用户手机号,和修改邮箱一样,默认情况下,如果用户当前已经绑定了手机号,需要同时验证原有手机号(目前账号绑定的手机号)和当前邮箱(将要绑定的手机号)。 也就是说,用户 A 当前绑定的手机号为 15888888888,想修改为 15899999999,那么就需要同时验证这两个手机号。 开发者也可以选择不开启 “验证原有手机号“ ,可以在 {{$localeConfig.brandName}} 控制台的设置目录下的安全信息模块进行关闭。
用户首次绑定手机号请使用 bindPhone 接口。
phone
新手机号phoneCode
新手机号的验证码oldPhone
旧手机号oldPhoneCode
旧手机号的验证码
AuthenticationClient.shared.updatePhone(phone: <#手机号#>, phoneCode: <#验证码#>, oldPhone: <#旧手机号#>, oldPhoneCode: <#旧验证码#>, completion: { result in })
用于用户初次绑定邮箱,需检验邮箱验证码。如果需要修改邮箱请使用 updateEmail 方法。如果该邮箱已被绑定,将会绑定失败。发送邮件验证码请使用 sendEmail 方法。
email
邮箱emailCode
邮件验证码,可通过 sendEmail 方法获得,EmailScene 为 CHANGE_EMAIL
AuthenticationClient.shared.bindEmail(email: <#邮箱#>, emailCode: <#验证码#>, completion: { (result) in })
用户解绑手机号,如果用户没有绑定其他登录方式(手机号、社会化登录账号),将无法解绑邮箱,会提示错误。
AuthenticationClient.shared.unbindEmail(completion: { (result) in })
如果用户已经绑定了邮箱,默认情况下,需要同时验证原有邮箱(目前账号绑定的邮箱)和当前邮箱(将要绑定的邮箱)。也就是说,用户 A 当前绑定的邮箱为 [email protected],想修改为 [email protected],那么就需要同时验证这两个邮箱。 开发者也可以选择不开启 “验证原有邮箱“ ,可以在 {{$localeConfig.brandName}} 控制台的设置目录下的安全信息模块进行关闭。
用户首次绑定邮箱请使用 bindEmail 接口。
email
新邮箱emailCode
新邮箱的验证码oldEmail
旧邮箱oldEmailCode
旧邮箱的验证码
AuthenticationClient.shared.updateEmail(email: <#邮箱#>, emailCode: <#验证码#>, oldEmail: <#旧邮箱#>, oldEmailCode: <#旧邮箱验证码#>, completion: { result in })
刷新当前用户 Token,调用此接口要求先登录。
AuthenticationClient.shared.refreshToken(completion:{ result in })
primaryUserToken
主账号用户的id_token
;provider
你可以在此查看支持的所有社会化登录类型。
AuthenticationClient.shared.socialUnLink(primaryUserToken: <#id_token#>, completion: { (result) in })
检查密码强度,点此查看详情。
判断密码是否符合密码强度要求。{{$localeConfig.brandName}} 中密码强度等级分为以下几种:
- 任意非空字符串;
- 至少 6 位字符;
- 至少 6 位字符,且须包含英文、数字与符号中的两种;
- 至少 6 位字符,且密码中须包含英文、数字与符号。
password
密码
AuthenticationClient.shared.checkPasswordStrength(password: <#密码#>, completion: { (result) in })
password
需要计算的密码(明文格式),必须为String
类型。
AuthenticationClient.shared.computedPasswordSecurityLevel(proclaimedPassword: <#密码#>, completion: { (result) in })
page
分页序号, 默认为1
。limit
每页返回的个数, 默认为10
。
AuthenticationClient.shared.listApplications(page: <#page#>, limit: <#limit#>, completion: { (result) in })
用户被授权的所有资源里面包括从角色、分组、组织机构继承的资源。
AuthenticationClient.shared.listAuthorizedResources(completion: { (result) in })
Authing 目前共支持微信扫码、微信网页授权、微信小程序、微信移动应用、GitHub、Google、微博、钉钉、QQ、支付宝移动端、企业微信内部应用扫码登录、企业微信第三方服务商扫码登录、企业微信第三方服务商网页授权登录等 10 余种社会化登录方式。
Authing Swift 版本目前只支持 Authing H5 Guard 托管,微信和支付宝登录。
- Fork it
- Create your feature branch (git checkout -b my-new-feature)
- Commit your changes (git commit -am 'Add some feature')
- Push to the branch (git push origin my-new-feature)
- Create new Pull Request
Join us on forum: #authing-chat