国家虚拟仿真实验教学项目技术接口规范（2018版）.PDF

附件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 的密码，由“实验 空间”提供。