第三方跳转登录云眸普教对接规范

功能描述

本接口提供第三方跳转登录云眸普教对接规范及示例。

本节内容需结合基础服务-用户管理(旧)使用。

接口说明： signature生成规则

第一步，设所有发送的数据为集合M，将集合M内非signature外的非空参数(值为空的参数不参与签名)按照参数名ASCII码从小到大排序（字典序），使用URL键值对的格式（即key1=value1&key2=value2…）拼接成字符串str1。

第二步，在str1最后拼接上登陆码authCode(用户管理-获取登陆码接口获取接口返回值)得到str2字符串，并对str2进行HmacSHA256运算，再将得到的字符串所有字符转换为大写，得到值为signature。

实现示例

	参数	例子
平台提供的参数	userName	ym1369142575711
平台提供的参数	authCode	5380b411f4ea4388b631ee9972a0f5d4
业务参数	ts	1587016281031
需要生成的参数	signature

         step1: 排序后拼接的字符串:ts=1587016281031&userName=ym1369142575711
         step2: 加上登陆码后的字符串:  ts=1587016281031&userName=ym1369142575711&authCode=5380b411f4ea4388b631ee9972a0f5d4
         step3: signature=HmacSHA256(step2的字符串,authCode)后转大写,最终生成的signature值为86F67E13426B7BD66A554E23D6DAF2291C04DA9806A4F9EE69D046A0A3D2C0EE
         step4:请求地址:https://edu.hik-cloud.com/?userName=ym1369142575711&ts=1587016281031&signature=86F67E13426B7BD66A554E23D6DAF2291C04DA9806A4F9EE69D046A0A3D2C0EE
         
         注意：登陆码有效期为1小时，且同一登陆码生成的跳转url，只能成功跳转一次；跳转链接的有效期是30分钟；跳转登录之后无操作30分钟后，认证信息失效。

请求参数

Query 参数

userName

string

必需

用户名（添加用户接口的返回值）

示例值:

{userName}

string

必需

时间戳（第三方生成）

示例值:

{ts}

signature

string

必需

通过签名生成算法生成（见下方）

示例值:

{signature}

schoolId

string

可选

示例值:

{schoolId}

Header 参数

Authorization

string

可选

默认值:

Bearer {{access_token}}

第三方跳转登录云眸普教对接规范

功能描述#

实现示例#

请求参数

返回响应

功能描述

实现示例