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

功能描述

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

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

signature生成规则

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

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

实现示例

	参数	例子
平台提供的参数	userId	499e861ec1254e8ca399dfb9e837a988
平台提供的参数	authCode	1d73e6a6a5bb4e90aa2e8ca52a2515c4
业务参数	ts	1616985134200
需要生成的参数	signature

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

请求参数

Query 参数

userId

string

必需

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

示例值:

{userId}

string

必需

时间戳（第三方生成）

示例值:

{ts}

signature

string

必需

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

示例值:

{signature}

schoolId

string

学校ID

可选

示例值:

{schoolId}

Header 参数

Authorization

string

可选

默认值:

Bearer {{access_token}}

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

功能描述#

实现示例#

请求参数

返回响应

功能描述

实现示例