自动检测登录
准备工作
原理介绍
自动检测同一设备上关联应用的登录态,本质上就是建立起一个 deviceId (设备 ID) 与 Authing 服务器之间的 session 连接。
当某个用户在某个应用上登录后,调用 Authing 接口创建一个 deviceId 与 Authing 服务器之间的 session,这样用户在同一设备的其他应用登录的时候,就能检测到此 session 的存在,从而跳过登录步骤,实现自动登录。
假设你有三个 App: App 1、App2 和 App3,只要有其中一个 App 和 Authing 服务器建立了 session 关系,就可以检测到 session。
开始接入
获取设备 ID
请在测试时务必验证自己在不同的 App 内获取到的 deviceId 是一致的!
iOS
iOS 设备的设备 ID 可以通过 identifierForVendor 获取,同一个 vendor 的应用获取到的设备 ID 是一样的。
什么情况下属于同一个 vendor?
从 App Store 下载的应用,基于在 App Store 登记的应用信息判断。
非 App Store 下载的应用
iOS 6 及之前,bundle id 的前两部分一致的应用属于同一 vendor,如 com.example.app1和 com.example.app2 为同一 vendor。com.example.app1.xxx 和 com.example.app2.xxx 也属于同一 vendor。
iOS 7 及之后,bundle id 的除了最后一部分的其余部分一致的应用属于同一 vendor,如 com.example.app1和 com.example.app2 为同一 vendor。但是 com.example.app1.xxx 和 com.example.app2.xxx 不属于同一 vendor。
如果你的应用不属于同一 vendor,建议使用 ASIdentifierManager。
Swift 5 代码示例:
OC 代码示例:
Android
Android 设备可通过 ANDROID_ID 获取:
Java 代码示例:
Kotlin 代码示例:
创建 session
POST
https://core.authing.cn/oauth/sso/mobile/createSession
此接口用于在一个移动应用客户端内创建一个 session ,且用户需处于登录状态,在请求头中加上 authorization 请求头携带用户 token。
Headers
Name | Type | Description |
---|---|---|
authorization | string | 登录用户的 token |
content-type | string | application/json |
Request Body
Name | Type | Description |
---|---|---|
appId | string | 移动应用 ID,任意字符串,请确保在你的应用内保持唯一。 |
deviceId | string | 设备 ID |
userPoolId | string | 用户池 ID |
Swift 代码示例:
查询 session
GET
https://core.authing.cn/oauth/sso/mobile/trackSession
此接口用于在移动应用客户端内查询 session,不需要用户处于登录态。
Headers
Name | Type | Description |
---|---|---|
content-type | string | application/json |
Request Body
Name | Type | Description |
---|---|---|
deviceId | string | 设备 ID |
userPoolId | string | 用户池 ID |
Authing trackSession 返回的数据支持两种形式(你可以在 Authing 控制台基础配置 - 基础设置 页面进行修改):
直接返回完整用户信息,包含 token
返回昵称头像(用于展示目的)以及用于换取用户信息的 ticket(默认方式)
推荐使用第二种方式,因为第一种方式存在安全风险,存在第三方非法批量模拟设备 ID 查询 session 的可能。使用 ticket 要求你在后端使用用户池密钥换取用户信息(详情见下文),保证了用户信息不会被非法获取。
如果你采用第二种方式,可以在前端展示用户昵称和头像,如下图所示:
使用 ticket 换取用户信息
POST
https://core.authing.cn/oauth/sso/mobile/exchangeUserInfoWithTicket
使用 ticket 换取用户信息,此接口需要用户池密钥,请在后端调用!
Headers
Name | Type | Description |
---|---|---|
content-type | string | application/json |
Request Body
Name | Type | Description |
---|---|---|
ticket | string | trackSession 获取的 ticket |
secret | string | 用户池密钥 |
userPoolId | string | 用户池 ID |
销毁 session
POST
https://core.authing.cn/oauth/sso/mobile/destorySession
此接口用于在一个移动应用客户端内销毁一个 session ,且用户需处于登录状态,在请求头中加上 authorization 请求头携带用户 token。由于存在多个应用,所以默认情况下只会销毁制定 App 的 session(trackSession 只要还有一个 App 有 session 就会查询到 session),如果你想清除所有 App 的 session,可以设置 destoryAll 为 true。
Headers
Name | Type | Description |
---|---|---|
authorization | string | 登录用户的 token |
content-type | string | application/json |
Request Body
Name | Type | Description |
---|---|---|
destoryAll | boolean | 是否销毁同一设备上所有 App 的 session,默认为 false |
appId | string | 移动应用 ID,任意字符串,请确保在你的应用内保持唯一。 |
deviceId | string | 设备 ID |
userPoolId | string | 用户池 ID |
你应该在每次用户退出登录以及删除 App 的时候调用此接口。
Last updated