统一用户中心详细设计方案

统一用户中心

详细设计报告

制作人:日期：2018-01版本:

目录

1系统结构6

1.1用户中心服务系统（UCS）6

1.2用户中心管理系统（UMS）7

1.3门户系统（Portal）7

1.4业务子系统接入7

2用户中心服务系统（UCS）8

2.1用户中心服务系统安全性要求8

2.2系统帐号传递机制8

2.3登录界面8

2.4功能说明8

2.4.1单点登录9

2.4.2会话保持10

2.4.3单点退出10

2.4,4组织架构同步11

2.4.5消息推送II

2.5数据结构11

2.5.1表清单12

2.5.2T_C0MPANY公司表12

2.5.3T_DEPT部门表13

2.5.4T_EMPL员工表14

2.5.5T_USER用户表14

2.5.6T_DICTIONARY字典表14

2.5.7T_ATTACHMENT附件表15

2.5.8UC_ACCOUNT登录帐号表15

2.5.9UC_A叩业务系统表16

2.5.10UC_BUTT0N业务系统资源表16

2.5.11UC_DATA业务系统数据表16

2.5.12UC』ENU业务系统菜单表17

2.5.13UC_R0LE业务系统角色表17

2.5.14UC_R0LE_C0MPANY角色公司关联表18

2.5.15UC_ROLE_BUTTON角色资源关联表18

2.5.16UC_ROLE_DATA角色数据关联表18

2.5.17UC_ROLE_MENU角色菜单关联表18

2.5.18UC_ROLE_EMPL角色员工关联表18

2.6用户中心提供的接口19

2.6.1通用接口调用方式19

2.6.2登录20

2.6.3ticket校验20

2.6.4保持用户登录状态22

2.6.5单点退出23

2.6.6获取页面统一样式23

2.6.7检查帐号是否可用24

2.6.8用户修改密码25

2.6.9忘记密码25

2.6.10用户注册26

2.6.11用户修改27

2.6.12根据AccessToken获取用户信息28

2.6.13根据组织架构id获取用户信息28

2.6.14查询所有用户信息29

2.6.15根据用户id查询用户权限30

2.6.16根据AccessToken查询用户权限31

2.6.17获取组织机构信息32

2.7业务子系统需要实现的接口32

2.7.1用户退出通知32

2.7.2用户信息变更通知33

2.7.3组织架构信息变更通知34

3用户中心管理系统（UMS）35

3.1应用项目管理35

3.1.1基本信息管理36

3.1.2菜单管理36

3.1.3数据项管理37

3.1.4资源项管理37

3.1.5角色管理37

3.1.6角色权限管理38

3.2企业管理38

3.2.1企业列表38

3.2.2企业信息维护39

3.3部门管理39

3.3.1部门列表39

3.3.2部门编辑39

3.4供应商内部权限管理39

3.4.1角色列表39

3.4.2角色权限关联39

3.5员工管理40

3.5.1员工列表40

3.5.2员工删除40

3.5.3修改密码40

3.5.4用户锁定40

3.5.5员工编辑40

3.5.6角色授予41

4门户系统(Portal)..41

4.1用户登录41

4.1.1登录页面41

4.1.2单点登录41

4.1.3会话保持42

4.1.4单点退出42

4.2用户主页42

4.2.1主页界面42

4.2.2导航菜单42

4.3用户注册42

4.4个人信息管理43

4.5页面集成方式43

4.6消息服务集成43

5微信服务号接入43

5.1微信绑定43

5.2微信消息推送44

6业务子系统接入44

6.1操作流程44

6.2需要实现的接口45

6.2.1单点登录45

6.2.2会话保持45

6.2.3单点退出45

6.2.4组织架构、用户同步46

6.2.5菜单权限46

6.2.6数据权限46

6.2.7资源权限46

6.2.8消息通知47

6.3针对Java应用环境的封装47

6.3.1主要功能47

6.3.2过滤器配置说明47

6.3.3单机环境配置51

6.3"分布式环境配置51

1系统结构

数据层

IDAP用户数据权限软死后各种应用系统

1.1用户中心服务系统（UCS）

提供平台登录界面；

提供单点登录、单点退出、会话保持服务，并在传统CAS服务的功能上增加用户角色权

限控制；

提供第三方应用接入相关接口；

提供用户、组织机构、权限相关接口；

提供提醒消息服务的集成，允许业务子系统存储提醒消息，以及同步业务子系统自有消

息模块中的消息

1・2用户中心管理系统(UMS)

统一用户管理

使用统一身份认证平台的所有业务应用系统的全部用户，用户身份信息支持LDAP和数

据库的同时存储。

统一角色管理

管理统一身份认证平台本身和平台中所有应用系统中需要使用到的角色信息，系统通过

用户、角色、权限机制，以及角色、用户、权限批量处理机制，极大地方便了用户的权限

分配。

统一应用管理

管理纳入统一身份认证平台的各应用系统的应用功能点和应用权限。

统一授权管理

实现用户与角色、角色与功能的对应管理，实现菜单权限、数据权限、资源权限等多种

权限分发管理。同时，实现权限策略的定制和调用，便于实现与应用流程的紧密结合。

1.3门户系统(Portal)

平台主页，按角色权限提供平台整合的所有资源的人口；

提供用户自身基本信息查看与维护功能；

服务申请审批通过之后通知用户中心服务系统

实现消息通知的接入；

实现微信账号绑定，微信消息推送；

1.4业务子系统接入

实现单点登录、单点退出、会话保持的接入；

用户信息实时或定时从用户中心服务系统同步；

实现菜单权限控制接入;

实现数据权限控制接入；

实现资源权限控制接入；

实现消息中心接入；

2用户中心服务系统（UCS）

平台SSO单点登录基于标准CAS认证流程，并优化超时验证流程，增加用户权限信息。

2・1用户中心服务系统安全性要求

用户中心服务系统可以使用HTTPS方式提供服务

业务系统与认证服务器之间接口调用采用参数密钥校验

2.2系统帐号传递机制

在用户访问应用系统之前，由统一身份认证平台生成一次性的访问Ticket票据，并将

Ticket提交给应用系统，应用系统请求统一身份认证平台验证Ticket有效性，之后返回认

证结果和用户身份信息给应用系统。应用系统根据验证结果确认用户身份，并分配用户权限。

Ticket默认有效时间5分钟，Ticket使用一次之后自动失效。

2.3登录界面

用户中心服务系统提供全平台唯一的登录界面

已经登录的用户访问登录页面将自动跳转到平台首页，不允许一个浏览器在未退出时登

录另一个账户。

2.4功能说明

2.4.1单点登录

1.用户访问业务系统

如果业务系统session或登录缓存中判断用户没有登录，则控制客户端浏览器跳转到用

户中心服务系统（UCS）的统一登录页面;

如果业务系统已经登录，则判断是否到达需要发送保持用户登录状态心跳包的时间，向

认证服务器用户状态保持接口发送消息；同时，业务服务器处理自有业务，响应用户。

2.用户在用户中心服务系统登录完毕，系统记录登录信息并将浏览器跳转到业务系统服务

器回跳页面，并带上url参数ticket票据

3.业务服务器接收ticket参数向用户中心服务系统验证ticket合法性并获取用户信息和

权限信息

4.业务系统获取到用户信息，将登录信息记录session或登录缓存，标识已经登录，并根

据返回的权限信息检验用户是否有操作权限；验证通过则执行相应业务操作

2.4.2会话保持

用户登录成功之后，被访问的业务系统需要在当前用户有访问请求时（在线状态）每间

隔一段时间（默认3分钟）向用户中心服务系统提交用户在线状态信息。保证认证服务中心

能够感知到用户当前的活动状态。

认证服务中心在一定时间（默认30分钟）内没有检测到用户的活动信息则判定用户状

态为下线。将注销用户登录状态并通知所有业务系统注销该用户的登录状态。

2.4.3单点退出

与单点登录相对应，单点退出功能可以解决“单点登录”功能在方便用户的同时留下的

安全隐患，用户在平台中主动下线或超时下线时，统一身份认证平台会向业务系统发起用户

下线通知，告知业务系统，某用户已经下线，请销毁相关Session会话。

单点退出流程

2.4.4组织架构同步

用户在门户系统注册，注册数据通过接口保存到用户中心服务系统；

全・同步

用户中心服务系统开通组织架构全量同步接口，提供给实时性要求不太高的子系统使

用；

实时增置同步

在用户注册、信息变更、服务申请状态变化、删除等操作之后用户中心服务系统主动通

知各个子系统变更的用户数据，提供给实时性要求高的子系统使用；

2.4.5消息推送

监听消息服务器中的消息数据,将各个子系统通过消息中心发出的通知消息推送给绑定

的微信账号。

2.5数据结构

2.5.1表清单

名称注释

T_COMPANY公司表

T_DEPT部门表

T_EMPL员工信息

T_USER用户信息

T_DICTIONARY字典表

T_ATTACHMENT附件表

UC_ACCOUNT登录账号表

UJAPP业务系统

UC_BUTTON资源表

UC_DATA数据表

UC_MENU菜单表

UC_ROLE角色表

UC_ROLE^COMPANY角色公司关联表

UC_ROLE_BUTTON角色资源关联表

UC_ROLE_DATA角色数据关联表

UC_ROLE_EMPL角色员工关联表

UC_ROLE_MENU角色菜单关联表

2.5.2T_COMPANY公司表

名称类型主键外键必填注释

COMPANY.IDvarchar(50)TRUETRUE公司id

PARENT.IDvarchar(50)父id

COMPANY_NAMEvarohar(200)公司名称

COMPANY_CODEvarchar(200)公司编码

CREATE_TIMEdatetime创建时间

ZIP_CODEvarchar(50)公司邮编

ADDRESSvarchar(200)公司地址

EMAILvarchar(50)公司邮箱

WEB_SITEvarchar(200)公司网址

FAXvarchar(50)传真

TELvarchar(50)企业电话

BANKvarchar(100)开户银行

BANK_ACCOUNTvarchar(50)银行账户

LEGAL_NAMEvarchar(50)公司法人姓名

LEGAL_TELvarchar(50)公司法人联系方式

2.5.3T.DEPT部门表

名称类型主键外键必填注释

DEPT.IDvarchar(50)TRUETRUE部门id

PARENT,IDvarchar(50)上级部门id

COMPANY,IDvarchar(50)TRUE公司id

DEPT.NAMEvarchar(200)部门名称

CREATE_TIMEdatetime创建时间

DEPT_CODEvarchar(200)部门编号

TELvarchar(50)电话

FAXvarchar(50)传真

ZIP一CODEvarchar(50)邮编

ADDRESSvarchar(500)地址

2.5.4T_EMPL员工表

名称类型主键外键必填注释

EMPL_IDvarchar(50)TRUETRUE用户id

USER_IDvarchar(50)TRUE用户id

COMPANY^IDvarchar(50)TRUE公司id

DEPT_IDvarchar(50)TRUE部门id

CREATE.TIMEdatetime创建时间

EMPL_CODEvarchar(50)员工编号

EMPL_POSITIONvarchar(50)员工职位

ENTRY_TIMEdatetime入职时间

2.5.5T_USER用户表

名称类型主键外键必填注释

USER-IDvarchar(50)TRUETRUE用户id

ACCOUNT.IDvarchar(50)TRUE账号id

USER_NAMEvarchar(100)姓名

CREATE_TIMEdatetime创建时间

SEXnumeric(1,0)性别（1：男,0：女）

EMAILvarchar(50)邮箱

MOBILEvarchar(50)手机号

1DCARDvarchar(50)身份证

2.5.6T_DICTI0NARY字典表

名称类型主键外键必填注释

DICTIONARY_IDvarchar(50)TRUETRUE字典id

DICT_CODEvarchar(50)字典编码

PARENT_CODEvarchar(50)父编码

DICT,NAMEvarchar(100)名称

DICT_DESCvarchar(500)说明

2.5.7T_ATTACHMENT附件表

名称类型主健外键必填注释

FILE_IDvarchar(50)TRUETRUE附件id

GROUP,IDvarchar(50)附件组id

FILE_PATHvarchar(500)附件路径

FILE_NAMEvarchar(500)附件文件名

FILE_SIZEnumeric(10,0)附件大小

CREATE_TIMEdatetime创建时间

CREATE一USERvarchar(50)创建者

RECORD_TABLEvarchar(100)主记录所属表

2.5.8UC_ACCOUNT登录帐号表

名称类型主键外键必填注释

ACCOUNT,IDvarchar(50)TRUETRUE账号id

ACCOUNT_NAMEvarchar(50)登录名

ACCOUNT_PASSWORDvarchar(200)密码

IS_ENABLEnuinsric(1,0)是否可用（0：不可用.1：可用）

CREATE_TIMEdatetime创建时间

OPEN.IDvarchar(50)

IS_PLATnurreric(1,0)是否平台用户

IS_SUPPnunvsric(1,0)是否是供应商用户

IS_BUYnunvsric(1,0)是否是采购商用户

ACC0UNT.TELvarchar(50)

ACC0UNT_EMAILvarchar(50)

2.5.9UC_APP业务系统表

名称类型主键外键必填注释

APP_IDvarchar(50)TRUETRUE业务系统id

APP_NAMEvarchar(200)业务系统名称

SECRET_KEYvarchar(200)接入密钥

APP_L0G0varchar(200)首页展示logo图片

INDEX_URLvarchar(200)首负地址

USER_N0TIFY_URLvarchar(200)用户信息变更通知地址

DEPT_NOTIFY_URLvarchar(200)组织信息变更通知地址

L0G0UT_N0TIFY_URLvarchar(200)单点退出通知地址

2.5.10UC_BUTT0N业务系统资源表

名称类型主键外键必填注释

BUTTON,IDvarchar(50)TRUETRUE资源id

APP_IDvarchar(50)TRUE子系统id

BUTTON_CODEvarchar(100)资源编码

BUTTON_NAMEvarchar(200)资源名称

BUTTON_CLASSvarchar(200)资源分类

ORDER_NUMnumeric(10,0)序号

2.5.11UC_DATA业务系统数据表

名称类型主键外键必填注释

DATA,IDvarchar(50)TRUETRUE

APP_IDvarchar(50)TRUE子系统id

DATA一CODEvarchar(100)数据编码

DATA_NAMEvarchar(200)数据名称

DATA_CLASSvarchar(200)数据分类

DATA_EXPRESSIONvarchar(2000)数据sql

ORDER_NUMnumeric(10,0)序号

2.5.12UC.MENU业务系统菜单表

名称类型主键外键必填注释

MENU,IDvarchar(50)TRUETRUE

APP_IDvarchar(50)TRUETRUE子系统id

PARENT.IDvarchar(50)TRUE父id

MENU.NAMEvarchar(100)菜单名称

MENU_ICONvarchar(100)图标

MENU_URLvarchar(200)地址

ORDER_NUMnuirwric(2,0)排序

2.5.13UC_ROLE业务系统角色表

名称类型主键外键必填注释

ROLE_IDvarchar(50)TRUETRUE角色id

APP_IDvarchar(50)TRUETRUE子系统id

COMPANY.IDvarchar(50)TRUE创建公司id

ROLENAMEvarchar(100)角色名称

2.5.14UC_ROLE_COMPANY角色公司关联表

名称类型主键外键必填注释

ROLE_IDvarchar(50)TRUETRUETRUE角色id

COMPANY.IDvarchar(50)TRUETRUETRUE公司id

2.5.15UC_ROLE_BUTTON角色资源关联表

名称类型主键外键必填注释

BUTTON,IDvarchar(50)TRUETRUETRUE资源id

ROLE.IDvarchar(50)TRUETRUETRUE角色id

2.5.16UC_R0LE_DATA角色数据关联表

名称类型主键外键必填注释

DATA_IDvarchar(50)TRUETRUETRUE数据id

ROLE_IDvarchar(50)TRUETRUETRUE角色id

2.5.17UC_R0LE_MENU角色菜单关联表

名称类型主键外键必填注释

MENU_IDvarchar(50)TRUETRUETRUE菜单id

ROLE_IDvarchar(50)TRUETRUETRUE角色id

2.5.18UC_ROLE_EMPL角色员工关联表

名称类型主键外键必填注释

ROLE_IDvarchar(50)TRUETRUETRUE角色id

EMPL_IDvarchar(50)TRUETRUETRUE员工id

IS_GRANTnumeric(1)TRUE是否允许授予

2・6用户中心提供的接口

2.6.1通用接口调用方式

通信协议

HTTPPOST

请求格式

appIication/x-www-form-urIencoded

响应格式

appIication/json

公用请求参数

序号名称必填类型说明

加密验证参数

使用平台给业务系统分配的接口密钥secretKey与当

1secretString

前时间（yyyyMMddHHmiss格式）拼接之后使月AES加

密，使用十六进制编码得到的字符串

响应结构

序号名称类型说明

1retCodeString返回消息码

2messageString返回消息描述

JSON数据对象：下列所有接口返回数据都在此字段下（无数据返回时，

3resultcSON

无此字段）

公用响应编码

编码说明

000000成功

700000接口令牌无效

800000accessToken无效，没有相关用户信息

900000异常

2.6.2登录

功能说明

接入方控制客户端浏览:器跳转登录页面进行登录操作

发起方

客户端浏览器

请求方式

浏览器跳转

请求地址

/sso/

请求参数

叁数名类型说明

backur1String登录完成之后的回跳地，URLEncoder(utf-8)编码

响应

参数名类型说明

ticketString获取用户信息的凭证,一分钟过期，一次有效

请求示例

2.6.3ticket校验

功能说明

业务系统向用户中心服务系统校验登录ticket是否可用，并获取用户信息

发起方

业务服务器

接口地址

/sso/

请求参数

*号名称必填类型说明

1ticketYString用户登录之后浏览器回跳地址中的ticket参数

2appldNString业务系统Id

3secretYString加密验证参数

4onIySeIfRoIeNBoolean是否仅自有系统的权限列表

响应

序号名称类型说明

1accesstokenString用户接口令牌，服务端调用接口时使用

2userObject用户信息

useridString用户id

userNameString用户姓名

userTypeInteger用户类型，员工、供应商

companyIdString公司id

deptIdString部门id

servicesObject[]申请的服务数组

服务编号

服务名

服务状态（1：待审核，2:审核拒绝，3：审核通过）

appsObject[]业务系统列表

业务系统id

角色数组，包含菜单权限，数据权限，资源权限

角色名

角色编码

菜单权限编号列表

数据权限列表

数据编码

数据SQL片段或表达式语句

资源权限编号列表

响应码表

编码说明

000000成功

800000ticket校验失败

900000服务端异常

2.6.4保持用户登录状态

功能说明

保持用户登录状态

发起方

PORTAL.各个接入单点登录的子系统

接口地址

/sso/

请求参数

序号名称必填类型说明

1accessTokenYString用户接口令牌

2secretYString加密验证参数

响应码表

编码说明

000000成功

2.6.5单点退出

功能说明

退出登录

发起方

PORTALx各个接入单点登录的子系统

接口地址

/sso/

请求参数

序号名称必填类型说明

1accessTokenYString用户接口令牌

2secretYString加密验证参数

响应码表

编码说明

000000成功

2.6.6获取页面统一样式

功能说明

获取统一的页面头、尾、菜单等HTML代码段

发起方

子系统

接口地址

/portal/

请求参数

序号名称必填类型说明

1accessTokenNString用户接口令牌，不填则表示未登录

2secretYString加密验证参数

响应

序号名称类型说明

1headString头部信息

2menuString菜单信息

3footObject底部信息

响应码表

编码说明

000000成功

2.6.7检查帐号是否可用

功能说明

PORTAL方账号注册时验证账号可用性

发起方

PORTAL

接口地址

/api/account/

请求参数

序号名称必填类型说明

1accountYString账号

2secretYString加密验证参数

响应码表

编码说明

000000成功

100000账号被占用

200000账号不符合规范

2.6.8用户修改密码

功能说明

用户修改密码

发起方

PORTAL

接口地址

/api/account/

请求参数

序号名称必填类型说明

1accessTokenYString用户接口令牌

2secretYString加密验证参数

响应码表

编码说明

000000成功

100000修改失败,原始密码错误

200000新密码不符合规范

2.6.9忘记密码

功能说明

通过邮箱找回密码

发起方

PORTAL

接口地址

/api/account/

请求参数

*号名称必填类型说明

1accountYString账号

2codeYString图形验证码

响应码表

编码说明

000000成功

100000账号不存在

200000用户邮件地址无效，邮件发送失败

2.6.10用户注册

功能说明

用户注册

发起方

PORTAL

接口地址

/api/user/

请求参数

序号名称必填类型说明

1secretYString加密验证参数

2accountYString用户名

3passwordYString登录密码

4nameYstring客户真实姓名

5genderNstring性别

6userTypeYInteger用户类别

7deptIdYstring所属部门id

8birthdayNstring生日

9telnoNString手机号码

响应码表

编码说明

000000成功

100000用户名冲突

200000密码不符合规范

2.6.11用户修改

功能说明

用户信息修改

发起方

PORTAL

接口地址

/api/user/

请求参数

序号名称必填类型说明

1secretYString加密验证参数

2accessTokenYString用户接口令牌

3nameYstring客户真实姓名

4genderNstring性别

5userTypeY