- 1、本文档共10页,可阅读全部内容。
- 2、原创力文档(book118)网站文档一经付费(服务费),不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
- 3、本站所有内容均由合作方或网友上传,本站不对文档的完整性、权威性及其观点立场正确性做任何保证或承诺!文档内容仅供研究参考,付费前请自行鉴别。如您付费,意味着您自己接受本站规则且自行承担风险,本站不退款、不进行额外附加服务;查看《如何避免下载的几个坑》。如果您已付费下载过本站文档,您可以点击 这里二次下载。
- 4、如文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“版权申诉”(推荐),也可以打举报电话:400-050-0827(电话支持时间:9:00-18:30)。
查看更多
附件4:
国家虚拟仿真实验教学项目技术接口规范
(2018版)
一、技术接口说明
服务 “国家虚拟仿真实验教学项目共享平台 (实验空间)”
(以下简称:实验空间)的用户与学校实验教学项目的用户管理
系统之间的身份自动识别,避免二次登录。识别后的用户在学校
实验教学项目上的相关数据,将自动回传到国家虚拟仿真实验教
学项目共享平台,支撑数据统计和监测。
数据接口方式分两种,分别是:用户验证令牌方式和验证接
口方式。基于C/S架构的应用只能选择验证接口方式。
本文中所有Host站点统一为:。
技术接口实现路径如下图所示。
— 7 —
二、用户身份识别规范
当用户登录“实验空间”后点击【我要做实验】时(如下图),
“实验空间”会以参数形式提供Token。
链接组 成样例 :实验 平 台的 URL?token, 例 如 :
/biology/vrlab/co2/?token AAABZK
ECn4ABAAAAAAABhqM%3D.fKf3J5DN6Ym0Fo3I5CJYdzQMR0iwEz7QnQ
Iit2Mfl6v03jpEJ%2Fr4FMRFqh5kN4yw.tqIPoyvkHe2MGOXMimE9O5
54Lo6AbBCQkZlsqQI4XRQ%3D
实验空间用户验证时使用XJWT标准,此标准基于JSON Web
Token (JWT)开发。XJWT 包含三个参数:header, payload,
signature,因此生成token就要先获得这三个参数。
(一)用户验证令牌token。
token 的组成结构:based64(raw header) +. + base64(raw
payload)+.+base64(raw signature)
8
— —
token组成参数header, payload, signature说明如下:
1.header。
组成结构:[expiry:long][type:byte][issuer id:long]
参数说明:
项目 说明
expiry 过期时间,UTC 以毫秒为单位,二进制8byte,Big
endian。
type 类别,值为二进制,必填。1- JSON, 2-SYS. 0-保留
Issuerid 由“实验空间”分配给各实验平台的唯一编号,二进
制8 byte,Big endian。
2.payload。
payload 是64bytes的整数倍。其组成结构:aes256(random
long+body +aespadding,aeskey)。其中:aes256是AES256加密
算法;random long是随机的8 byte数字;aespadding是自定
义的字符串,为补足64 bytes的整数倍;aes key 由“实验空
间”生成分配给各实验教学项目。body 为UTF8 编码的JSON 格
式字符串,格式如下表:
项目 说明
id 用户id。
un 用户username
dis 用户姓名显示
3.signature。
组成结构:base64(HmacSHA256(based64(raw header) +. +
— 9 —
base64(rawpayload),secret key))
其中:raw header 是上述中生成的header;rawpayload 是上
述中生成的payload;secretkey 是生成aeskey 的密码,由“实验
空间”提供。
4.
文档评论(0)