客户身份(CIAM)
sessiontoken换取ssoticket接口
换取用户信息时先调用本接口换取sso_ticket。
# 请求说明
POST https://{your_domain}/api/v2/tenant/sso/session-token/sso-ticket
# 请求头
| 参数名 | 中文名称 | 必须 | 类型 | 示例 |
|---|---|---|---|---|
| Authorization | 授权信息 | 是 | String | Bearer {access_token} |
| content-type | 内容格式类型 | 是 | String | application/json |
# 请求示例
{
"session_token": "iJKVWQVfFvIQWffsTlSxTf02MV3dpITu",
"operating_sys_version": "windows10.1.1",
"device_ip": "192.168.1.1",
"device_fingerprint": "156aysdna213sac",
"agent": "agent:Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/89.0.4389.82 Safari/537.36"
}
1
2
3
4
5
6
7
2
3
4
5
6
7
# 请求参数
| 参数名 | 中文名称 | 必须 | 类型 | 描述 |
|---|---|---|---|---|
| session_token | 用户登录成功后返回的token | 是 | String | |
| operating_sys_version | 调用方客户端操作系统版本 | 是 | String | 例如： windows10.1.1 |
| device_ip | 调用方设备ip | 是 | String | 例如： 192.168.1.2 |
| device_fingerprint | 调用方客户端设备指纹 | 是 | String | 同一个用户调用接口时该参数的值需保持统一。 例如： 156aysdna213sac |
| agent | User-Agent信息 | 否 | String | Mozilla/5.0 (iPhone; CPU iPhone OS 13_3 like Mac OS X) |
# 返回示例
成功示例：
HTTP/1.1 200 OK
Content-Type: application/json
{
"expire": 300,
"sso_ticket": "ssoTicket-y0w1ODvy7v0000nCa91OYoj1Bzxqfesy"
}
1
2
3
4
5
6
7
2
3
4
5
6
7
# 返回参数
| 参数名 | 中文名称 | 类型 | 描述 |
|---|---|---|---|
| expire | 过期时间 | Number | |
| sso_ticket | 一次性票据 | String | 根据用户登录后的session_token换取一次性访问票据sso_ticket，sso_ticket可以换取用户信息 |