统一用户及权限管理.doc

文件编号：统一用户及权限管理平台解决方案及设计报告版本号 0.9拟制人 王应喜 日期 2006年6月 审核人_ 日期_批准人_ 日期_统一用户及权限管理设计报告目录第一章引言11.1编写目的11.2背景11.3定义11.4参考资料1第二章统一权限管理解决方案22.1需求分析22.2系统架构22.3系统技术路线4第三章统一用户及授权管理系统设计43.1组织机构管理43.2用户管理43.3应用系统管理、应用系统权限配置管理43.4角色管理43.5角色权限分配43.6用户权限(角色)分配43.7用户登录日志管理功4第四章对外接口设计54.1概述54.2接口详细描述54.2.1获取用户完整信息54.2.2获取用户拥有的功能模块的完整信息64.2.3获取用户拥有的一级功能模块74.2.4获取用户拥有的某一一级功能模块下的所有子功能模块84.2.5获取用户拥有的某一末级功能模块的操作列表94.2.6判断用户是否拥有的某一末级功能模块的某一操作权限104.2.7获取某一功能模块的ACL尚需进一步研究104.2.8获取某一模块的数据级权限规划规则尚需进一步研究11重庆南华中天信息技术有限公司第 2 页2019-1-4统一用户及权限管理解决方案1 引言1.1 编写目的编写此文的目的从总体上描述企业统一用户及授权管理的解决方案以及统一用户及授权管理系统的功能设计、对外接口设计、数据库设计，并为下一阶段的详细设计以及系统编码、测试提供依据。本文档读者对象：用户、项目经理、系统分析员、软件文档管理员、质量管理人员，软件开发人员、软件测试人员等。此文档和附加参考资料作为系统进行设计与测试的基础性文档。1.2 背景随着信息化的发展，企业的应用不断的增加，而企业的应用行使多样化，既有传统的C/S模式应用，又有基于internet的B/S应用；既有基于Windows平台的.net应用，又有基于J2ee架构的应用。企业在进行信息化建设过程中，在没有实现同以用户及授权管理之前，各个系统的用户独立，且用户授权不能集中管理，这给企业信息化的系统管理员和操作用户带来很多不便。鉴于此，本文提出基于统一用户及授权管理解决方案。1.3 定义列出本文件中用到的专门术语的定义和外文首字母组词的原词组。1、SSO：Single Sign On，单点登录1.4 参考资料2 统一用户及权限管理平台解决方案2.1 需求分析统一用户权限管理主要解决的问题：1、 提供用户注册用户通过网上注册。2、 提供统一的用户管理和授权管理(应用程序)权限控制，只实现功能权限控制，而不实现数据(范围)权限控制，主要由于各个业务的数据访问规则很难归纳为标准的访问规则。而功能从权限的控制包括：l 不做权限控制的功能，即不登陆就可操作，如：对外新闻、公告查询l 公共功能：用户只要登陆就可操作的功能，如：内部新闻、内部公告查询l 需权控制的功能：只有当用户拥有该功能的权限才能操作的功能3、 提供统一的用户及权限认证接口提供的统一的用户及权限认证接口同时满足C/S和B/S应用的用户认证和权限控制的需求；且对于B/S应用，既满足基于windows平台的.net应用，也满足与基于J2ee架构的应用。4、 提供统一的数据访问接口统一用户及权限管理平台提供各类数据访问接口，如：获取操作人员的信息、获取机构信息、获取系统功能信息等。5、 系统具有较好的扩展性和灵活性组织机构、用户的属性要求可以进行适当的增加，以满足各个不同企业的统一权限管理的需要。统一权限管理，既满足与单个应用授权，也满足所有应用集中授权。统一权限管理既满足一个机构集中授权，也满足多机构逐级受权。在统一授权管理中，每个应用权限控制的粒度不一致，有的应用或模块控制得较粗，有的控制得较精确，如：对于数据的维护只是一个“数据维护”权限粗的控制，也可以控制到“数据新增”、“数据修改”和“数据删除”权限的精确控制上。/以下由沈伟补充6、 系统的单点登录（包括跨系统的应用调用）7、 权限模型配置（包括模块与部分可通用的数据权限；数据权限做到什么程度需思考）。对于第2点中细节描述部分，则形成需建成独立服务模式，而非源程序加载模式。此需求需讨论。建议：对SSO项目进行继承。组织机构管 理应用系统权限配置应用系统管 理用 户管 理角 色管 理角色权限分 配用户权限角色分配统一用户、授权管理系统身份认证接口权限认证接口数据访问接口认证、服务组织机构信息、用户信息、应用系统信息、应用系统权限(功能)配置信息、角色信息、角色(已分配)权限信息、用户(已分配)权限信息、用户登录日志信息认证中心数据库用户登陆管 理OA系统。应急指挥系统邮件系统应用系统认证、服务接口图：统一用户及权限管理平台架构用户注册系 统2.2 系统架构如图所示，统一用户及权限管理平台系统功能由四部分组成：1、 用户注册系统用户注册系统提供用户网上注册。2、 统一用户及授权管理系用系统该系统主要由应用系统的系统管人员使用。系统提供组织机构管理、用户管理、应用系统管理、应用系统权限(功能)配置管理、角色管理、角色权限分配、用户权限(角色)分配、用户登录管理功能。3、 认证与服务认证服务提供应用系统身份认证接口、权限认证接口、数据访问接口。应用系统同过调用身份认证接口实现用户身份认证；调用实现对用户权限认证；通过调用数据接口读取如用户信息、组织机构信息等数据。4、 认证中心数据库认证中心数数据库负责存储统一用户及权限管理的数据。2.2.1 统一用户、权限管理数据流程图统一用户、授权管理(数据增、删、改维护)其它系统认证信息认证中心数据库门户认证信息邮件系统邮件帐户信息图：统一用户、权限管理数据流程图从以上图中可知，在进行统一用户、授权管理时，一方面对认证中心的用户信息、权限分配数据进行维护，另一方面，根据需要，可以对门户系统(如Liferay Portal、IBM Websphere Portal)中的相关的用户、权限分配信息进行同步更新，以及对邮件系统中的邮件帐户信息进行同步更新，以及对其它系统的认证信息进行同步更新。通过以上方案，既满足了统一用户和授权管理，同时，又解决了门户系统、邮件系统等的用户管理、授权和认证问题。避开了去了解甚至重新构造门户系统、邮件系统等中的用户认证、权限认证问题。2.2.2 新建应用、门户的身份认证、权限认证机制用户应用请求门户请求认证中心数据库门户认证信息门户单点登录认证中心统一用户信息数据库用户认证接口统一权限认证接口门户权限认证接口门户权限认证服务统一用户权限管理认证服务 门户权限的认证由门户服务器提供的认证服务完成。 新的应用系统建设，其用户、权限是基于统一的用户、权限管理平台建设，用户身份认证、权限认证由我们提供的统一用户权限管理的认证服务完成。2.2.3 老的应用系统的认证机制老的应用系统的用户认证、权限认证仍然由老系统完成。若老的应用系统整合到门户，首先通过门户认证，然后再通过老的系统的用户、权限认证。具体如下：用户从门户应用请求门户单点登录认证中心统一用户信息数据库统一用户认证接口原系统登录原系统认证信息原系统用户认证接口系统请求原系统权限认证接口认证中心与老系统认证映射据库图：老系统用户、权限认证机制2.2.4 关于邮件系统的用户认证问题邮件系统的用户认证仍然由邮件系统提供的认证服务完成，只是，若需要进行统邮件系统的账户时，在对认证中心的用户进行维护时，对邮件系统的帐户信息(主要是用户名和口令)进行同步更新。2.3 主要技术路线l 统一用户和权限管理系统该系统采用jsp+struts+hibernate的J2ee架构。J2ee WEB中间件采用TOMCAT。l 认证接口提供给应用系统的接口以webservice方式提供，实现方法采用一般的javabean实现。l 数据库在本方案中，数据库系统采用mysql数据库。3 用户注册系统设计此部分主要是想用户网上注册功能。4 统一用户及授权管理系统设计统一用户及授权管理系统主要实现的功能包括：l 组织机构及用户管理l 应用系统及功能管理l 角色管理l 角色权限分配l 用户权限分配l 用户登录日志管理系统主界面如下：4.1 组织机构及用户管理1、 功能描述采用树形结构对机构及人员进行维护管理。具体包括：1) 机构的维护l 机构新增l 机构删除l 机构修改2) 人员的维护l 人员新增l 人员删除l 人员修改l 人员口令修改l 注册用户审查l 帐户开通/停止3) 用户授权l 用户角色授权4) 用户权限查询l 用户拥有的角色查询l 用户拥有的权限查询2、 界面样式4.2 角色管理对角色的维护管理，包括角色的新增、修改、删除。4.3 角色权限分配4.4 用户权限(角色)分配4.5 登录(在线)用户管理提供在线用户查询和注销在线用户功能。4.6 辅助功能4.6.1 系统操作管理实现操作日志的查询和导出。4.6.2 用户登录日志管理实现对用户历史登录日志的查询和导出。4.6.3 系统代码表管理代码类别维护代码维护4.7 应用系统及功能管理此部分功能一般只提供给开发应用开发上维护。主要实现应用系统目录维护和系统功能维护。5 认证与服务接口设计5.1 概述企业的信息化建设通常是要建设多个应用系统，多个应用系统共用一套组织机构及权限管理子系统。组织机构中包括不同业务部门、不同行政级别的人员，不仅组织机构非常庞大，并且各个组织单元之间的关系错综复杂。为方便组织机构管理工作和授权管理工作的顺利进行，在组织机构及权限管理部分实行“逐级授权”的策略，将组织机构及权限管理子系统建设成为一个独立的Web应用，各个行政级别的系统系统管理员都可以登录到Web服务器上，进行组织机构和权限的管理和维护工作。由于这是一个多应用系统，各个业务系统对权限分配的结果都有各自不同的展现方式，为使各个应用系统能够将组织机构管理和权限分配的结果实实在在的应用到各个业务系统中，组织机构及权限管理子系统向各个业务系统提供了统一的应用程序接口。接口以WEBSERVICE形式提供，为方便各个业务系统操作，接口的返回值以XML格式为主。各个业务系统根据权限管理子系统的返回值可以自行决定如何展现权限分配的结果。5.2 接口详细描述统一用户及权限管理平台以WEBSERVICE形式提供对外接口，返回信息以XML形式提供，接口如下：5.2.1 判断用户是否合法类名称OrgManager函数名称功能描述：根据用户登录名、口令判断用户是否为合法用户调用语法：参数描述：参数标识 参数名称 数据类型 输入/输出 userID 用户ID号 String 输入返回值说明：备注：5.2.2 用户注销类名称OrgManager函数名称功能描述：根据用户登录名注销登录用户调用语法：参数描述：参数标识 参数名称 数据类型 输入/输出 userID 用户ID号 String 输入返回值说明：备注：5.2.3 用户修改密码类名称OrgManager函数名称功能描述：用户修登录名注销登录用户调用语法：参数描述：参数标识 参数名称 数据类型 输入/输出 userID 用户ID号 String 输入返回值说明：备注：5.2.4 获取用户登录信息类名称OrgManager函数名称功能描述：根据用户登录名或用户ID号获取用户登录信息调用语法：参数描述：参数标识 参数名称 数据类型 输入/输出 userID 用户ID号 String 输入返回值说明：备注： 5.2.5 获取组织机构信息类名称OrgManager函数名称功能描述：根据用户登录名或用户ID号获取用户登录信息调用语法：参数描述：参数标识 参数名称 数据类型 输入/输出 userID 用户ID号 String 输入返回值说明：备注： 5.2.6 获取用户完整信息类名称OrgManager函数名称getUserInfo功能描述：根据用户ID号获取用户完整信息调用语法：String getUserInfo (String userID) throws AppException,RemoteException参数描述：参数标识 参数名称 数据类型 输入/输出 userID 用户ID号 String 输入返回值说明：存在相应的结果信息时，返回值格式如下：xxxxxxxx xxxxxxxxxxxxxxxxxxxxxxxx没有相应的结果信息时返回空字符串”。备注： 5.2.7 获取用户拥有的功能模块的完整信息类名称PrivilegeManager函数名称getModulesOfUser功能描述：根据用户ID号获取用户拥有的功能模块的完整信息调用语法：String getModulesOfUser (String userID) throws AppException,RemoteException参数描述：参数标识 参数名称 数据类型 输入/输出 userID 用户ID号 String 输入返回值：存在相应的结果信息时，返回值格式如下：没有相应的结果信息时返回空字符串”。备注： 5.2.8 获取用户拥有的一级功能模块类名称PrivilegeManager函数名称getRootModulesOfUser (String userID)功能描述：根据用户ID号获取用户拥有的一级功能模块调用语法：String getRootModulesOfUser (String userID) throws AppException,RemoteException参数描述：参数标识 参数名称 数据类型 输入/输出 userID 用户ID号 String 输入返回值：存在相应的结果信息时，返回值格式如下：没有相应的结果信息时返回空字符串”。备注： 5.2.9 获取用户拥有的某一一级功能模块下的所有子功能模块类名称PrivilegeManager函数名称getRootModulesOfUser (String userID)功能描述：根据用户ID号、一级功能模块ID，获取用户拥有的某一一级功能模块下的所有子功能模块调用语法：String getChildModulesUnderOneRootOfUser (String userID,String applicationID,String rootModuleID)throws AppException,RemoteException参数描述：参数标识 参数名称 数据类型 输入/输出 userID 用户ID号 String 输入applicationID 应用ID号 String 输入rootModuleID 一级功能模块ID号 String 输入返回值：存在相应的结果信息时，返回值格式如下：没有相应的结果信息时返回空字符串”。备注：5.2.10 获取用户拥有的某一末级功能模块的操作列表类名称PrivilegeManager函数名称getOperationsInOneEndModuleOfUser功能描述：根据用户ID号、应用ID、末级功能模块ID，获取用户拥有的某一末级功能模块中的所有操作调用语法：String getOperationsInOneEndModuleOfUser (String userID,String applicationID,String endModuleID)throws AppException,RemoteException参数描述：参数标识 参数名称 数据类型 输入/输出 userID 用户ID号 String 输入applicationID 应用ID号 String 输入endModuleID 末级功能模块ID号 String 输入返回值：存在相应的结果信息时，返回值格式如下： 没有相应的结果信息时返回空字符串”。备注： 5.2.11 判断用户是否拥有的某一末级功能模块的某一操作权限类名称PrivilegeManager函数名称isHaveOperationInOneEndModule功能描述：根据用户ID号、应用ID、末级功能模块ID、操作名称，判断用户是否拥有的某一末级功能模块的某一操作权限调用语法：boolean isHaveOperationInOneEndModule (String userID,String applicationID,String endModuleID,String operationName)throws AppException,RemoteException参数描述：参数标识 参数名称 数据类型 输入/输出 userID 用户ID号 String 输入applicationID 应用ID号 String 输入endModuleID 末级功能模块ID号 String 输入operationName 操作名称 String 输入返回值：-true 拥有-false 没有备注：5.2.12 获取某一功能模块的ACL尚需进一步研究类名称PrivilegeManager函数名称getAclOfModule功能描述： 根据模块ID号获取属主应用、同类应用、其它应用对当前模块的操作权限。调用语法：String getModuleACL (String moduleID)throws AppException,RemoteException参数描述：参数标识 参数名称 数据类型 输入/输出 moduleID 模块ID号 String 输入返回值：String型模块ACL属性，ACL属性由三位数据组成，第一位代表属主应用的权限，第二位代表同类应用的权限，第三位代表其他应用的权限。每一位有四个枚举值：0：没有权限1：查询权限2：修改权限3：查询、修改权限备注：5.2.13 获取某一模块的数据级权限规划规则尚需进一步研究类名称PrivilegeManager函数名称getDataAuthRuleOfModule功能描述：根据模块ID，用户ID获取当前操作员能够在当前模块上操作哪些行政区划内的数据。调用语法：String getDataAuthRuleOfModule (String moduleID，String userID)throws AppException,RemoteException参数描述：参数标识 参数名称 数据类型 输入/输出 moduleID 模块ID号 String 输入userID 用户ID号 String 输入返回值：存在相应的结果信息时，返回值格式如下：123456222222没有相应的结果信息时返回空字符串”。备注： 重庆南华中天信息技术有限公司第 2 页 共 38 页2019-1-46 数据库设计说明：数据库的对象(包括数据库表名、字段名、索引等所有数据库中的对象)的名称全部以小写命名。6.1 机构信息系统编号：ZT_YHQXGL系统名称：统一用户权限管理更新频率：存储编码：ORG_UNIT存储名称：组织机构信息存储容量：101500序号字段名字段含义类型NOT NULL说明1UNIT_ID机构标识VARCHAR2(32)YPK系统生成2UNIT_NAME机构名称VARCHAR2(32)Y3UNIT_DESC描述信息VARCHAR2(255)4UNIT_OWNERED_UNIT上级机构VARCHAR2(32)在系统中创建该机构的机构的标识5UNIT_DISTRICT行政区划VARCHAR2(30)值如：重庆市、重庆市江北区、值取自AA10表7UNIT_TYPE机构类型VARCHAR2(8)8UNIT_ORGID组织机构编码VARCHAR2(32)要求管理员手工输入9UNIT_LEVEL机构级别VARCHAR2(8)1：市级2：区级3：街道级UNIT_LINKMAN联系人VARCHAR2(10)UNIT_TELEPHONE联系电话VARCHAR2(20)UNIT_ADDRESS地址VARCHAR2(50)UNIT_POSTALCODE邮政编码VARCHAR2(6)UNIT_BANK_CODE银行行号VARCHAR2(40)UNIT_BANK_NAME户名VARCHAR2(50)UNIT_BANK_ACCOUNT银行帐号VARCHAR2(40)6.2 用户信息系统名：ZT_YHQXGL系统名称：统一用户权限管理更新频率：存储编码：app_user存储名称：用户信息存储容量：序号字段名字段含义类型NOT NULL说明1USER_ID用户标识VARCHAR2(32)YPK系统生成2USER_ACCOUNT用户帐号(用户名)VARCHAR2(32)Y唯一3USER_PWD用户密码VARCHAR2(32)加密存储4USER_NAME姓名VARCHAR2(32)5Is_individual_account是否个人账户VARCHAR2(1)0-否/1-是6Id_card_no身份证号码VARCHAR2(20)7User_type_code人员类别代码VARCHAR2(32)8Certificate_type_code其它证件类别代码VARCHAR2(32)9Certificate_no其它证件号码VARCHAR2(32)10UNIT_ID人员所属机构IDVARCHAR2(32)FKUNIT_ID-ORG_UNIT.UNIT_ID11Headship_code职务代码VARCHAR2(32)12USER_EMAIL电子信箱VARCHAR2(32)13USER_TELEPHONE电话VARCHAR2(15)14USER_DESC备注说明VARCHAR2(255)17USER_CREATEDBYUNIT创建机构VARCHAR2(32)18account_status帐户状态VARCHAR2(1)0-账户未开通/停止1-开通/有效19Valid_tmie帐户有效期timestamp20Reg_time注册时间timestamp21Reg_ipaddr用户注册IP地址VARCHAR2(32)22Auditing_time审核时间timestamp23Auditing_person审核人VARCHAR2(10)24Auditing_result审核结论Auditing0-无效1-有效25Disqualification_cause审核未通过原因VARCHAR2(255)说明：1 Is_individual_account(是否个人账户):0- 否：当不为个人账户时，即允许多个人同时使用（登录）1- 是(缺省)：允许多个人同时使用（登录）2 当对注册用户审核时，审核通过，则账户自动开通3 若账户有效期到期，则账户自动“停止”，此功能实现由系统自动完成。6.3 角色信息系统编号：ZT_YHQXGL系统名称：统一用户权限管理更新频率：存储编码：ORG_ROLE存储名称：角色信息存储容量：10001500序号字段名字段含义类型NOT NULL说明1ROLE_ID角色标识VARCHAR2(32)YPK系统生成2ROLE_NAME角色名称VARCHAR2(32)Y唯一3User_type_code人员类别代码VARCHAR2(32)4Org_type_code机构类别代码VARCHAR2(32)5ROLE_DESC角色描述VARCHAR2(255)说明：6.4 机构类别-角色信息系统编号：ZT_YHQXGL系统名称：统一用户权限管理更新频率：存储编码：org_type_role存储名称：角色用户（机构）映射信息存储容量：10001500序号字段名字段含义类型NOT NULL说明1org_type_role_id机构类别-角色ID号VARCHAR2(32)Ypk系统产生2org_type_code机构类别代码VARCHAR2(32)YfK用户标识3ROLE_ID角色标识VARCHAR2(32)YfK角色标识6.5 机构类别-角色信息系统编号：ZT_YHQXGL系统名称：统一用户权限管理更新频率：存储编码：org_type_role存储名称：角色用户（机构）映射信息存储容量：10001500序号字段名字段含义类型NOT NULL说明1Unit_role_id机构-角色ID号VARCHAR2(32)Ypk系统产生2unit_ID机构ID号VARCHAR2(32)YfK用户标识3ROLE_ID角色标识VARCHAR2(32)YfK角色标识6.6 人员类别-角色信息系统编号：ZT_YHQXGL系统名称：统一用户权限管理更新频率：存储编码：user_type_role存储名称：角色用户（机构）映射信息存储容量：10001500序号字段名字段含义类型NOT NULL说明1User_type_role_id用户类别-角色ID号VARCHAR2(32)Ypk系统产生2USER_type_code用户类别代码VARCHAR2(32)YfK用户标识3ROLE_ID角色标识VARCHAR2(32)YfK角色标识6.7 用户-角色信息系统编号：ZT_YHQXGL系统名称：统一用户权限管理更新频率：存储编码：user_ROLE存储名称：角色用户（机构）映射信息存储容量：10001500序号字段名字段含义类型NOT NULL说明1User_role_id用户-角色ID号VARCHAR2(32)Ypk系统产生2USER_ID角色名称VARCHAR2(32)YfK用户标识3ROLE_ID角色标识VARCHAR2(32)YfK角色标识6.8 应用系统信息系统编号：ZT_YHQXGL系统名称：统一用户权限管理更新频率：存储编码：application存储名称：菜单信息存储容量：550序号字段名字段含义类型NOT NULL说明1App_id应用系统ID号VARCHAR2(32)YPK系统产生2App_no应用系统编号VARCHAR2(32)Y手工录入，必须唯一3App_name应用系统(标题)名称VARCHAR2(50)Y手工录入，必须唯一4App_location应用系统的入口地址VARCHAR2(255)5App_type应用系统类型VARCHAR2(1)Y0-门户1-新建应用2-老系统6.9 系统功能(菜单)信息系统编号：ZT_YHQXGL系统名称：统一用户权限管理更新频率：存储编码：application存储名称：菜单信息存储容量：550序号字段名字段含义类型NOT NULL说明1APP_MENU_ID系统功能ID系统产生2appid应用系统IDVARCHAR2(32)YAPP_ID-app.appid3NAME名称VARCHAR2(32)Y手工录入，必须保证整个系统内唯一4TITLE标题VARCHAR2(32)Y5PARENT父菜单名称VARCHAR2(32)6TARGET显示区域VARCHAR2(32)当菜单为叶子菜单时，指定主界面显示区域7LOCATION主体界面URLVARCHAR2(255)7CHIEF默认显示NUMBER(1)1：默认显示0：不默认显示8IMAGE图片VARCHAR2(255)菜单标题前的图片9ALTIMAGEVARCHAR2(255)10DESCRIPTION描述VARCHAR2(255)11ORDERID显示顺序NUMBER(3)12TYPE类型VARCHAR2(8)当该记录为操作时有效13BUSITYPE业务类型VARCHAR2(32)实际编码10位。编码规则和角色业务类型必须对应14FUNCTYPE功能类型VARCHAR2(32)0：功能分组；1：信息查询2：业务办理15authenticationtype认证类别Char(1)0-不控制1-控制功能9-公共功能 说明：Authentication_type(认证类别):0-不控制，用户不需等路即可访问1-授权功能，需要授权才能访问的功能2-公共模块，用户等路即可访问的功能6.10 角色-功能信息系统编号：ZT_YHQXGL系统名称：统一用户权限管理更新频率：存储编码：EAP_MENU_ROLE_MAP存储名称：菜单角色映射信息存储容量：序号字段名字段含义类型NOT NULL说明1MENUNAME菜单名VARCHAR2(64)YPK菜单唯一标识2ROLE_ID角色ID号VARCHAR2(64)YPK角色标识36.11 代码类别系统编号：ZT_YHQXGL系统名称：统一用户权限管理更新频率：存储编码：ORG_ROLE存储名称：角色信息存储容量：10001500序号字段名字段含义类型NOT NULL说明1Code_type_no代码类别编号2Code_type代码类别(名称)3Code_rule(层次)编码规则4Fixed_length是否固定长度5fill_in_char