portal平台系统对接规范

  • 格式:doc
  • 大小:51.00 KB
  • 文档页数:4

portal平台系统对接规范
一、概述
与portal集成需要3个步骤
1、将子系统用户信息同步到LDAP数据库上(参见:二、同步用户)
2、子系统上安装获取和接受CAS服务器验证信息的插件(参见:三、安装插件)
3、修改子系统原登录方式,以获得自动登录的效果(参见:四、用户登录)
下面分别对3个步骤地需求作详细说明
二、同步用户
1、需要同步的数据,字段和类型的要求
用户名:
描述:用户在子系统中的唯一标识,即用作登录名的字符串
类型:字符串,英文字符和数字,大小写不敏感
用户昵称:
描述:用户在子系统界面中展示的中文自设名称,只作为显示
类型:字符串,中文字符、英文字符和文字,大小写不敏感
说明:如系统中没有此功能,则与用户名相同
密码:
描述:用户名登录时使用的密码,密码是使用子系统的唯一限制(不是指用户组、角色等的权限控制)
类型:字符串,英文字符和数字,大小写敏感
说明:密码由LDAP数据库进行加密,所以在插入LDAP数据库时需插入明文2、插入LDAP时的要求
(1)要求以下数据库参数可以用配置文件灵活改动,而不用修改程序
数据库连接字符串形如:ldap://127.0.0.1:10389/ 也可根据不同编程语言API具体要求
数据库IP:LDAP数据库所在的IP地址
数据库端口:数据库所使用的端口
数据库管理员DN:形如:uid=admin,ou=system
数据库管理员密码:字符串,英文字符和数字,大小写敏感
同步数据所存放的域名:字符串,形如:dc=oa,dc=tj-chengtou,dc=com(是域名 的分解形式),要求对域名等级无限制,即二级域名如: 和三级域名如: 都能识别
(2)插入到LDAP数据库时用户所属的objectclass (对象类型)
objectclass=top,objectclass=inetOrgPerson,objectclass=organizationalPerson
(3)插入到LDAP数据库时子系统数据所属的字段类型
cn=用户名,sn=用户昵称(用于即时通讯工具),uid=用户名,userpassword=密码
3、
三、安装插件
1、安装插件要达到的效果
(1)用户直接登录子系统时,可显示子系统界面,但不提供登录功能,点击登录后或直
接调用CAS客户端插件的请求链接,然后由CAS插件与服务器进行验证
(2)用户登录portal后,跳转到子系统,由portal调用子系统的CAS客户端插件请求
链接
(3)用户登出子系统后,在完成子系统内部的注销任务后,跳转到CAS登出链接
2、安装插件需要的配置
遵照CAS的规范配置
CAS服务器登录链接:形如:https://:8443/cas-web/login
CAS服务器处理代理:形如:https://:8443/cas-web/proxyValidate
(以上两个参数为CAS客户端插件在初次登录和请求验证时所要请求的链接)
CAS登出连接:形如:https://:8443/cas-web/logout
(以上一个参数为子系统用户登出时请求的链接)
子系统服务连接:形如::8000/hzoa/login.jsp 该连接负责接收CAS客户端插件解析出来的用户session
(以上一个参数为子系统在请求CAS服务器时需要传递的参数,参数名为”
service”,在CAS规范和实例中有明示)
3、
四、用户登录
1、用户直接登录。

因为由子系统跳转到CAS服务器,此时CAS服务器验证并暂存的是子系统的用户,在子系统请求验证时传递给子系统的用户名是,用户在CAS服务器提交的子系统的用户名,所以子系统获得用户名后可以直接登录
2、用户先登录portal,再跳转到子系统。

因为用户已经在登录portal时,在CAS服务器先验证过了,此时CAS服务器暂存的是portal系统内的用户名,所以子系统在请求验证时获得的是portal系统内的用户名,需要子系统获得用户名后到LDAP数据库查询出相对应的子系统用户名,然后进行登录
3、区分用户。

为了区分子系统用户名和portal系统用户名,在CAS服务器传回的用户名中加入了标示系统的后缀,如portal系统中的用户admin,portal系统的服务域名为,则,用户名的格式为admin@ ;又如oa 子系统内的用户admin ,oa子系统的服务域名为 ,则,用户名的格式为admin@ ;依次类推
4、映射信息。

LDAP库中存放的用户映射信息,存放在portal用户信息的“l”字段中(不是数字“1”,是字母“L”的小写),由于有多个系统集成,该字段在获取时(根据不同语言实现可能有所不同),可能取到的形式为多个对象,每一个对象存放一个系统的映射信息,遵循下面的字符串格式:如:cn=admin#dc=oa,dc=tj-chengtou,dc=com 。

其含义为:cn=子系统中对应的用户名#dc=…子系统的域名分解
五、流程图示
图例
1红色字及箭头为portal系统流程;2蓝色为资金子系统单独登录流程;3绿色为由portal进入资金自系统流程
4混合色为不同流程的公共步骤;5每条流程都作了说明,按数字编号顺序流转;6说明中,portal用户均以黑色“用户名”字样出现,资金系统用户均以黑色“子系统用户名”出现
六、。