公共管理门户体系用户信息同步接口集成尺度

日期>2019-08-04 16:01:59  点击数:

 

 

 

 

 

 

 

 

 

 

 

 

江西省教育厅公共管理门户体系

用户同步接口集成尺度

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

东软集团股份有限公司

总页数

正文

附录

生效日期

2019-08-04

体例

 

同意

 

变更经验

版本

光阴

内容描述

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

1         文档说明

1.1     功效描述

本文档重要描述了江西省教育厅公共管理门户体系对外供给的用户信息同步接口尺度。

1.2     业务术语

术语

描述

第三方体系

集成到教育厅管理门户实现单点登录的体系

TokenId

第三方体系从管理门户体系获得用户信息的票据

单点登录

用户只必要登录一次就可以或许或许访问统统互相信任的应用体系

用户唯一标识

第三方体系和门户体系标识用户唯一性编码

 

 

1.3     应用场景

第三体系集成到江西省教育厅公共管理门户体系后,为了能判定单点登录的用户是否正当,用户信息必要和公共管理门户体系对峙同等,应用场景流程如下:

   

第三方体系颠末过程tokenId拿到用户信息之后,可以或许颠末过程判断用户的唯一标识是否在本体系有用,若有用则用户单点登录胜利,进入体系。

2         业务描述

用户信息同步是第三方体系和公共管理门户体系之间停止用户信息同享,实现单点登录的基础。体系单点登录集成后,第三方体系必要实现如下工作能力实现单点登录认证:

1、第一次全量用户信息同步,颠末过程excle文件格式导入(导入门户体系用户数据)、导出 (导出用户信息给门户体系)

2、开拓用户信息实时同步接口并联调颠末过程,门户体系用户信息能实时同步到体系。

3、单点登录认证测试胜利。

门户体系中的用户信息同步包含三种情势:

2.1     文件数据同步

适用于接入门户体系第一次批量用户数据同步,包含如下两种范例:

1、教育厅公共管理门户体系把信息中央已受权的用户信息导出天生exlce文档给第三方体系,第三方体系停止入库处理。

2、第三方体系把已集成体系的全量用户信息以excle文件格式导出供给给门户体系停止入库。

第三方体系导出文件格式如下

?  门户体系在导入第三方体系用户信息时,必要增长一列第三方体系名称,确保导入的用户信息和第三方体系对应上。

门户体系导出文件格式如下

   

?  第三方体系可以或许或许根据门户体系供给的字段停止有抉择的入库,但是用户唯一标识字段一定要入库。

?  门户体系导出用户后体系会停止更新,增长第三方体系的权限标识

2.2     实时同步接口

门户体系中用户信息停止新增、修改、删除操纵时,必要颠末过程实时接口同步到第三方接入体系,包含如下两种办法:

1、体系管理员停止用户新增、修改、删除操纵时,门户体系会触发用户信息实时同步接口,把用户信息同步到对应体系。

2、用户自己注册及修改信息时不触发同步,管理员审核颠末过程之后,门户体系才会触发用户信息实时同步接口。

3         用户信息实时同步接口尺度

3.1     接口说明

江西省教育厅门户体系添加用户胜利后并实时同步到具有权限的第三方体系,实现门户体系与第三方体系之间用户数据的同步。

接口名称

JxEduUserSyncService

接口地址

http://IP:PORT/JxEduUserSyncService

接口协定

Webservice    RESTful

 

   

接口地址必要第三方接入体系开拓实现用户信息实时同步接口后,按照如下格式供给:

接口地址:http://IP:PORT/JxEduUserSyncService

此中:IP:PORT为实际的IP+端口号, JxEduUserSyncService为同一的接口名称。

3.2     HTTP请求头设置设备摆设

体系调用该接口请求URL:注意开拓的web service接口支撑POST调用。

HTTP Header:

POST JxEduUserSyncService HTTP/1.1

Host: 10.4.124.17:8080

Accept: */*

Content-Type: application/JSON

3.3     RESQUEST布局

参数:String JSON

返回值:JSON

序列号


 
 

属性

描述

范例长度

备注

1

userNo

用户唯一标识

VARCHAR(50)

非空,两个别系间用户关联的唯一标识。

2

nameEntity

用户姓名

VARCHAR(64)

非空

3

passwordEntity

登录体系密码

VARCHAR(64)

如果长度为0或许为null,说明该用户密码不必要修改,则不用修改

4

nameSpellingEntity

姓名全拼

VARCHAR(64)

姓名全拼

5

emailEntity

邮箱

VARCHAR(64)

用户邮箱

6

phoneEntity

手机

VARCHAR(32)

手机号

7

telNoEntity

固定电话

VARCHAR(32)

固定电话

8

institutional

构造机构

VARCHAR(100)

构造布局以半角逗号分割

9

institutionalId

构造接口编码

VARCHAR(16)

构造布局ID以半角逗号分割

10

Sexy

性别

VARCHAR(2)

男或女

11

operKind

操纵范例

VARCHAR(1)

1:增;2:删除;3:修改,如果体系传值为3,存在用户则修改,不存在则新增

12

CreateTime

天生光阴

DATE

格式:yyyy-mm-ddhh:mm:ss

13

ModifyTime

修改光阴

DATE

格式:yyyy-mm-ddhh:mm:ss

14

ifStop

是否停用

VARCHAR(1)

0:未停用;1:已停用

15

loginEntity

登录名

VARCHAR(64)

登录体系账号

 

Requset参数格式:

{

"INSTITUTIONALID":"360000020000",

"SEXY":"male",

"MODIFYTIME":"2017-05-2211:38:41",

"CREATETIME":"2016-03-18 11:24:14",

"PASSWORDENTITY":"18170095445",

"OPERKIND":"3",

"LOGINENTITY":"***",

"NAMEENTITY":"***",

"TELNOENTITY":"079186765183",

"IFSTOP":"0",

"USERNO":"235298",

"NAMESPELLINGENTITY":"***",

"EMAILENTITY":"oom",

"INSTITUTIONAL":"教育考试院",

"PHONEENTITY":"18170095445"

}

注意点:拼串时,统统字段均为大写。

3.4     RESPONE布局

序列号


 
 

属性

描述

范例长度

备注

1

UserNo

用户唯一标识

VARCHAR(50)

非空,两个别系间用户关联的唯一标识。

2

nameEntity

用户名

VARCHAR(64)

用户中文姓名

3

STYPE

业务操纵结果

VARCHAR(10)

S:代表胜利;E:代表失败

4

SMESSAGE

业务返回结果说明

VARCHAR(512)

胜利或许失败

Respone返回信息格式:

{

     ”USERNO”:”201980”,

      “NAMEENTITY”:”王军岭”,

      “STYPE” :”S”,

      “SMESSAGE”:”SUCCESS”

}

友情链接:节能消费领跑信息网  装修第一网  论文发表网  重庆商务网  电工之家网  文山民族新闻网  蓝夸克发型网  中国研修培训新闻  志趣  华人新闻信息网