历史版本5 :前台单点登录接口 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 描述编辑

实际情况中,企业不会只有一个报表平台,多个不同的平台,或者相关的平台,如果每个平台登录都需要进行一次用户认证,对使用者而言非常麻烦。因此大的企业往往有统一的用户认证,用户用一个账号可以同时登陆所有系统,甚至是使用域用户管理,这个时候就需要使用到单点登录,即在登陆系统的同时也登陆报表(即将输入的用户名密码也发送到报表服务进行认证),从而访问报表时不需要再次登录。
FR报表系统实现单点登录有3中方式:iframe方式ajax方式表单提交方式
注:ajax登陆方式支持7.0.4及以上版本。
不论是哪一种登陆方式,FR报表系统都为用户提供了统一的接口,接口如下:
  1. http://localhost:8075/WebReport/ReportServer?op=fs_load&cmd=sso&fr_username=XX&fr_password=XX  
注:8.0中关于用户名和密码的参数,全部统一为fr_username和fr_password
注:该接口不仅可用来做单点登录,也可用作自定义登录界面。
不同的登录方式使用接口进行单点登录的实现方式是不一样的,以下我们根据不同的登录方式详细介绍。

2. ajax方式编辑

ajax登录方式支持跨域,相对于iframe方式来说,ajax的身份验证是异步验证,同时对于验证超时做了处理,具体用法可查看ajax跨域异步单点登录
  1. jQuery.ajax({  
  2.      url:"http://localhost:8075/WebReport/ReportServer?op=fs_load&cmd=sso",//单点登录的报表服务器  
  3.      dataType:"jsonp",//跨域采用jsonp方式  
  4.      data:{"fr_username":username,"fr_password":password},  
  5.      jsonp:"callback",  
  6.      timeout:5000,//超时时间(单位:毫秒)  
  7.      success:function(data) {  
  8.             if (data.status === "success") {  
  9.                   //登录成功     
  10.             } else if (data.status === "fail"){  
  11.                  //登录失败(用户名或密码错误)  
  12.             }  
  13.      },  
  14.      error:function(){  
  15.            // 登录失败(超时或服务器其他错误)  
  16.      }  
  17. });  

3. iframe方式编辑

iframe方式单点登录的接口为:
FR.servletURL + "?op=fs_load&cm=sso&fr_username=XX&fr_password=XX",具体用法可查看iframe跨域单点登陆
  1. var scr = document.createElement("iframe");      //创建iframe      
  2.  scr.src = " http://localhost:8075/WebReport/ReportServer?op=fs_load&cm=sso&fr_username=" + username + "&fr_password=" + password;   //将报表验证用户名密码的地址指向此iframe        
  3.  if (scr.attachEvent){       //判断是否为ie浏览器    
  4.              scr.attachEvent("onload", function(){                    //如果为ie浏览器则页面加载完成后立即执行    
  5.         window.location=" http://localhost:8075/WebReport/ReportServer?op=fs"; //直接跳转到数据决策系统  
  6.              });    
  7.           } else {    
  8.              scr.onload = function(){              //其他浏览器则重新加载onload事件    
  9.               window.location=" http://localhost:8075/WebReport/ReportServer?op=fs"; //直接跳转到数据决策系统    
  10.              };    
  11.        }    
  12.        
  13.    document.getElementsByTagName("head")[0].appendChild(scr);   //将iframe标签嵌入到head中      

4. 表单提交方式编辑

报表权限验证时直接使用action触发url进行验证,url的验证地址与iframe的验证地址相同,具体可查看表单action提交登陆

5. iframe方式和ajax方式的区别编辑

iframe方式和ajax方式均可以实现跨域单点登录,ajax可以实现异步的单点登录,并且可对报表系统验证的结果进行处理,如登录超时,但是iframe不可以异步处理,并且在进行报表验证的时候,无法对验证的结果进行处理。