1. 问题描述
OA系统与报表系统集成,将报表绑定在OA系统的节点上,对于OA系统中想实现对FineReport的单点登录,用户需要在OA的登录界面中将用户名和密码传入到报表的认证地址进行认证,若OA系统和报表系统不是部署在同一台服务器上,在进行登录时进行跨域,那么要如何通过ajax实现OA系统和报表系统的跨域登录呢?
2. 实现思路
在平台系统单点登录中介绍了3种单点登录的方式,iframe方式、ajax方式以及表单提交,其中iframe方式和ajax方式两种登陆方式均可实现单点登录的跨域,下面简单介绍ajax单点登录的使用方法,iframe单点登录方式请查看iframe跨域单点登录 ajax登录方式天然支持跨域,故在OA系统的登录界面中直接通过ajax将用户名密码发送到报表服务器进行后台验证,则可解决跨域单点登录问题。
3. 示例
通过简化的OA登录页面说明ajax的实现步骤。
3.1 ajax实现步骤
用户输入用户名密码后点击提交或登录按钮时,触发doSubmit()方法,该方法中实现登录事件并且通过ajax将用户名密码发送到报表系统进行验证,并且在验证成功时,触发html中的表单提交事件,实现登录成功页面的跳转,实现报表认证代码如下:
注:由于使用了ajax,需要引入jquery.js,并且因为编码的问题,要对输入的用户名和密码进行cjkEncode编码,需要引入finereport.js,而FR的finereport.js中包含了jquery.js,所以只需要在head标签中引入finereport.js即可,无需再引入jquery.js,如下:
另:如果在win8下单点登录异常,在ajax传递用户名密码的时候转码一下即可,比如说password:encodeURIComponent(passwrod)。
也可以自己写cjkEncode函数,实现方法见编码转换文档。 另:如果登录页面所在工程不是FineReport的工程,则无法引入finereport.js,所以只能手动引入jquery.js,如果需要编码,再自定义cjkEncode函数,示例中就是直接引入jquery.js,且没有进行编码转换。
3.2 完整代码
将上述ajax单点登录的提交事件放到原来OA系统登录页面中,是指点击登录按钮时,触发该事件,修改后即可以实现跨域单点异步登录的代码如下:
说明:用户名密码表单中使用button来触发doSubmit(),您只要将doSubmit()方法加入到您的OA的登录页面中即可,为了简化操作,上面的完整代码没有跳转到指定页面,而是跳转到op=fs页面。
4. 注销用户
当注销项目用户时,同时也希望注销报表用户名的session,这时可在点击退出按钮时的同时也可以实现FR报表的退出登录:
5. 安全性
报表通过url传用户名和密码进行验证,传到报表服务器是以session的方式保存,防止被人中途拦截会导致系统泄密,可以对登录进来的密码进行加密,可参考文档权限之密码加密;或者使用https证书,让请求在传输过程中加密,配置方法也很简单,修改下服务器的配置文件就行了。这种方式还存在一个证书合法性问题,用自己生成的证书,客户端在访问报表中浏览器会显示证书非法警告,所以需要去购买合法证书。目前国内最便宜的证书一年是一千多元。