“单点登录接口开发文档”的版本间的差异

来自成绩云帮助中心
跳转至： 导航、 搜索
（→‎单点登录）
（→‎单点登录）
 
（未显示2个用户的4个中间版本）
第14行： 第14行：
 
;<span style="font-size:15px;">接口说明</span>
 
;<span style="font-size:15px;">接口说明</span>
 
请求方式：<code>GET</code>  <br/>
 
请求方式：<code>GET</code>  <br/>
−
PC版登录URL：'''[serverBaseUrl]'''/school-users/api/pclogin'''[platform]'''?orgId='''[orgId]'''&role='''[role]'''&name='''[name]'''&grade='''[grade]'''&class='''[class]'''&timestamp='''[timestamp]'''&sign='''[sign]'''<br/>
+
PC版登录URL：'''[serverBaseUrl]'''/school-users/api/pclogin?platform='''[platform]'''&orgId='''[orgId]'''&role='''[role]'''&name='''[name]'''&grade='''[grade]'''&class='''[class]'''&timestamp='''[timestamp]'''&sign='''[sign]'''<br/>
−
移动版登录URL：'''[serverBaseUrl]'''/school-users/api/mlogin'''[platform]'''?orgId='''[orgId]'''&role='''[role]'''&name='''[name]'''&grade='''[grade]'''&class='''[class]'''&timestamp='''[timestamp]'''&sign='''[sign]'''<br/>
+
移动版登录URL：'''[serverBaseUrl]'''/school-users/api/mlogin?platform='''[platform]'''&orgId='''[orgId]'''&role='''[role]'''&name='''[name]'''&grade='''[grade]'''&class='''[class]'''&timestamp='''[timestamp]'''&sign='''[sign]'''<br/>
 
URL参数说明:<br/>
 
URL参数说明:<br/>
 
{| class="wikitable"
 
{| class="wikitable"
第42行： 第42行：
 
|string
 
|string
 
|是
 
|是
−
|用户姓名。对于管理员，双方要约定创建这样的账号。对于有重名的教师，需要双方约定传一个别名，例如“张老师”、“张老师2”。学生通过年级和班别值来区分重名的情况。
+
|用户姓名。对于管理员，双方要约定创建这样的账号。对于有重名的教师，把教师的手机号后2位追加到姓名后，例如“张老师86”、“张老师33”。学生通过年级和班别值来区分重名的情况。
 
|-
 
|-
 
|grade
 
|grade
第57行： 第57行：
 
|int
 
|int
 
|是
 
|是
−
|时间戳（Unixtime），有效时长600秒
+
|以'''“秒”'''为单位的时间戳（Unixtime），有效时长7200秒
 
|-
 
|-
 
|sign
 
|sign

2022年3月9日 (三) 11:36的最后版本

前言

本文档针对只做单点登录、不做数据同步的平台而编写。

接入知未产品单点登录的平台需要先联系知未科技研发，获取2个基本参数：平台ID[platform]，平台密钥[key]。这两个参数也可以反过来向知未科技提供。

对接新学校的时候，双方约定[orgId]，在各自平台创建好学校。

部署好系统后会确定[serverBaseUrl]。

单点登录

第三方平台按如下方式构造知未产品（例如“成绩分析”）的入口链接：

接口说明

请求方式：GET
PC版登录URL：[serverBaseUrl]/school-users/api/pclogin?platform=[platform]&orgId=[orgId]&role=[role]&name=[name]&grade=[grade]&class=[class]&timestamp=[timestamp]&sign=[sign]
移动版登录URL：[serverBaseUrl]/school-users/api/mlogin?platform=[platform]&orgId=[orgId]&role=[role]&name=[name]&grade=[grade]&class=[class]&timestamp=[timestamp]&sign=[sign]
URL参数说明:

参数 类型 是否必填 描述
platform string 是 平台ID
orgId string 是 学校ID
role string 是 角色名称：管理员、教师或学生
name string 是 用户姓名。对于管理员，双方要约定创建这样的账号。对于有重名的教师，把教师的手机号后2位追加到姓名后，例如“张老师86”、“张老师33”。学生通过年级和班别值来区分重名的情况。
grade string 对于学生是，其它角色否 年级
class string 对于学生是，其它角色否 班别
timestamp int 是 以“秒”为单位的时间戳（Unixtime），有效时长7200秒
sign string 是 签名

签名参数sign生成说明

第一步：对传入的参数按照键名排序
第二步：使用URL键值对的格式（即key1=value1&key2=value2…）拼接成字符串stringA
第三步：在stringA最后拼接上“&key=[平台密钥]”得到stringSignTemp字符串，并对stringSignTemp进行MD5运算
第四步：得到最终请求字符串sign

PHP签名算法示例:

// $key 平台密钥
function sign($data, $key) {
  ksort($data);                                   // 正向排序
  $key_str = urldecode(http_build_query($data));  // 连接字符串
  $key_str .= '&key=' . $key;                     // 拼接key
  return md5($key_str);
}

$data = array(
   'platform' => 'testPlatform',
   'orgId' => 'testSchool',
   'role' => '教师',
   'name' => '李老师',
   'timestamp' => 1639017000,
);
$sign = sign($data, $key);

注意：timestamp的有效时间为7200秒，超过该时长请求无效，以降低受到重放攻击的风险。

取自“https://chengjiyun.com/wiki/index.php?title=单点登录接口开发文档&oldid=1770”