第三方系统单点登录时的几种方法
可以通过以下五种方法之一，在第三方系统中单点登录到 Smartbi 系统。请根据实际需要，选择其中一种登录方法。
方法一：使用Smartbi浏览器端SDK登录
在第三方系统中编写 JavaScript 代码调用 Smartbi 的 浏览器端SDK 方法进行登录。具体实现请参考：使用浏览器端SDK单点登录到Smartbi。
方法二：使用LoginToken扩展包
Smartbi 服务器加载LoginToken扩展包（点击此处下载），并在第三方系统中编写Java代码，调用Smartbi的服务器端SDK方法进行登录并生成登录Token，实现单点登录。
| language | java |
|---|---|
| linenumbers | true |
1.说明
在第三方系统中编写 JS 脚本实现登录，假设目标登录页面为 http://localhost:
808018080/smartbi
"); boolean open = conn.open("admin", "manager"); //
必须以拥有系统管理员角色的用户登录，其他用户登录调用接口获取的token是null if(open){ InvokeResult result = conn.remoteInvoke("LoginTokenModule", "generateLoginToken", new Object[]{"demo"}); // 用户名 System.out.println(result.getResult());//result.getResult()就是demo用户的token conn.close(); }else{ //admin用户登录失败 System.out.println("登录失败"); } // 得到密码后需要先单点登录：可以在第三方首页中添加一个隐藏的iframe，使用这样的链接打开Smartbi的首页：http://localhost:8080/smartbi/vision/index.jsp
?user=demo&password=<上述得到的动态密码>，使得单点登录到smartbi系统。 后续在第三方系统中打开smartbi的资源即可直接打开对应URL，无需在URL中传递用户名和密码。
加载这个扩展包后，还需要修改 Smartbi config.jsp 配置界面上的“用户管理”段的信息。
- 将“加密类型”设置为：CLASS
- 将“登录验证类”设置为：smartbi.logintoken.LoginTokenAuthtication
动态密码默认60秒有效，可以在【系统选项 > 单点登录 > 单点登录超时设置】中进行配置，单位为毫秒，超过此时间则密码失效。
| 注意 |
|---|
注意：若登录不成功，请检查。 1、扩展包已正常加载？ 2、登录验证类填写正确？ 3、生成token的代码正确（必须要通过拥有系统管理员角色的用户来登录，然后再生成其他用户的登录token，不能给自己生成token并登录）。 4、并且此logintoken.ext还实现普通用户单独访问smartbi的时候使用用户原本的密码访问，集成的时候可以使用用户原本的密码也可以使用一次性密码，建议是集成的时候使用一次性密码集成访问。 |
方法三：使用Smartbi服务端SDK登录
在第三方系统中编写 JSP 页面调用 Smartbi 的服务器端 SDK 进行登录。此方式适用于“在第三方系统中打开Smartbi资源”、“在第三方系统中新建Smartbi资源”和“在第三方中打开功能模块”，而不适用于从第三方系统链接转到Smartbi。具体操作步骤如下：
- 参考开发接口中的服务端SDK方法 的使用步骤，把相关的 jar 包加载到您的 Java 项目的 classpath 中。
- 编写登录代码，调用 SDK 中的相应方法。
- 可以将得到的smartbiCookie 作为参数传入openresource.jsp等页面，必须转码后再传递，例如<a href="http://server:8080/smartbi/vision/openresource.jsp?resid=<资源ID>&smartbiCookie=<%=java.net.URLEncoder.encode(conn.getCookie(), "UTF-8")%>">
| 代码块 | ||||
|---|---|---|---|---|
| ||||
<%@ page contentType="text/html; charset=GBK" import="java.util.*,
smartbi.sdk.ClientConnector,
smartbi.sdk.service.user.UserManagerService" %>
<%
request.setCharacterEncoding("GBK");
String user ="admin";
String password = "manager";
String smartbiURL = "http://localhost:18080/smartbi/vision/";
ClientConnector conn = new ClientConnector(smartbiURL);
// 建立此连接时，就对smartbi进行了登录
boolean ret = conn.open(user, password);
if (!ret) {
%>
<script>
alert("登录失败!");
</script>
<%
} else {
%>
<script>
alert("登录成功!");
// 获取smartbi的cookie，在集成页面需要传递smartbiCookie值，以保证前后台cookie的一致性
var smartbiCookie = "<%=conn.getCookie()%>";
</script>
<%
}
%> |
| 注意 |
|---|
如果 Smartbi 是集群部署模式，则不能采用本方法进行单点登录。 原因是ClientConnector对象是在jsp页面的java代码块中初始化的，其发起对象是第三方系统服务器，而集成资源是浏览器发起的，浏览器在使用该cookie时，不能保证跟服务器一样访问到同一个节点，在没有访问到同一个节点时，其cookie是无效的。 |
方法四：在页面中使用Form登录
在第三方系统中编写 JS 脚本实现登录，假设目标登录页面为 http://localhost:18080/smartbi/vision/index.jsp，登录脚本如下所示。，效果如下。
| 面板 | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
|
2.具体操作步骤
1、编写JS脚本实现登录，核心脚本代码如下所示，surl为Smartbi登录成功后自动根据参数跳转的地址，furl是Smartbi登录失败后自动根据参数跳转的地址。
| 代码块 | ||||
|---|---|---|---|---|
| ||||
<form method="POST" id="formLogin" onsubmit="go();return false">
<p>用户：<input type="text" name="user" size="20" value="admin"></p>
<p>密码：<input type="text" name="password" size="20" value="manager"></p>
<p>登录成功后的跳转地址：<input type="text" name="surl" size="20" value="manager"></p>
<p>登录失败后的跳转地址：<input type="text" name="furl" size="20" value="manager"></p>
<p><input type="submit" value="确定" name="B1"></p>
</form>
function go() {
formLogin.action = "http://localhost:18080/smartbi/vision/login.jsp";
formLogin.user.value = "admin";
formLogin.password.value = "manager";
formLogin.surl.value = " "; // 登录成功后的跳转地址；若该地址为外部链接，需要包含协议名，如以 http:// 开头
formLogin.furl.value = " "; // 登录失败后的跳转地址
formLogin.submit();
return true;
} |
2、前端登录后，需要有相应的注销代码，核心注销代码如下。
| 代码块 | ||||
|---|---|---|---|---|
| ||||
<form method="POST" id="formLogout" onsubmit="go();return false">
<p>注销成功后的跳转地址：<input type="text" name="surl" size="20" value="manager"></p>
<p>注销失败后的跳转地址：<input type="text" name="furl" size="20" value="manager"></p>
<p><input type="submit" value="确定" name="B1"></p>
</form>
function go() {
formLogout.action = "http://localhost:18080/smartbi/vision/logout.jsp";
formLogout.surl.value = " "; // 注销成功后的跳转地址 为空时自动跳转到smartbi的index.jsp
formLogout.furl.value = " "; // 注销失败后的跳转地址 为空时自动跳转到smartbi的index.jsp
formLogout.submit();
return true;
} |
方法五：CAS单点登录
如果已有CAS服务器，要求进行CAS统一认证，可进行cas单点登录。参考“CAS单点登录”文档。
3、gif演示示例的源码请参考：在页面中使用Form登录.rar。
注意事项
- 如果不通过单点登录，那么在集成 Smartbi 资源时必须传入user、password 参数。
- 如果采用 Smartbi 的服务器端SDK方法进行单点登录，在集成资源时除了可以传递参数user、password之外，还可以单独传递参数smartbiCookie，此参数为从服务器端获取的cookie。获取此值的方法，见下面红色方框内代码。
- 如果Smartbi是集群部署模式，不能采用“方法三”进行单点登录，原因是ClientConnector对象是在jsp页面的java代码块中初始化的，其发起对象是第三方系统服务器，而集成资源是浏览器发起的，浏览器在使用该cookie时，不能保证跟服务器一样访问到同一个节点，在没有访问到同一个节点时，其cookie是无效的。
单点登录方式对比
上述提供的几种单点登录方式对比如下：
| 单点登录名称 | 方案简述 | 优点 | 缺点 | 适用系统 |
|---|---|---|---|---|
| LoginToken扩展包登录 | 在第三方系统中编写JSP 页面/Java代码调用Smartbi的服务器端SDK方法进行登录后获取Token再使用Token登录。 | token只能使用一次且60秒内有效，不会暴露用户的真实密码，支持集群，安全性高。 | 需要加载扩展包并修改登录验证类。 | 安全性要求高的系统。 |
| 页面中使用Form登录 | 在页面中提交form表单传递用户密码参数登录，并传递参数告知smartbi登录成功和失败跳转的地址。 | 集成方式简单。 | 用户名和密码暴露在前端，安全性差。 | 安全性要求不高的系统。 |
| 浏览器端SDK登录 | 通过JSLoader加载bof.usermanager.UserService的js方法登录。 | 简单方便，通用性高。 | 集成方式较麻烦，用户名和密码暴露在前端，安全性差，需要解决跨域问题。 | 安全性要求不高的系统。 |
| 服务器端 SDK登录 | 在第三方系统中编写 JSP 页面/Java代码调用 Smartbi 的服务器端 SDK获取Cookie进行登录。 | 不会暴露用户的真实密码，安全性高。 | 不支持集群部署，不支持从第三方系统链接转到Smartbi系统首页进行登录。 | 安全性要求高的系统，只适用于在第三方系统中打开和新建Smartbi资源以及在第三方中打开功能模块进行登录。 |
| CAS单点登录 | 将Smartbi接入到统一登录认证平台进行登录。 | 安全性高，多系统集成时登录方便。 | 需要加载扩展包，需要修改扩展包配置文件和登录验证类。 | 用户已有CAS服务器的情况。 |
1. 若服务端未对传入的跳转url变量进行检查和控制，则可能会有人恶意伪造假地址，从而诱导用户跳转到恶意网站上。
因此，用户通过在 Smartbi 的“高级设置”中修改以下配置项“可重定向的URL配置"，对furl以及surl的格式进行限制，跳转链接必须得符合预先设定的匹配规则。
例如，设置"equal"的值为“http://www.baidu.com”，表示当跳转链接等于符合该值时允许访问。
| 代码块 | ||||
|---|---|---|---|---|
| ||||
# 可重定向的URL配置
# 初始值（{"startWith":"","equal":""}），表示允许跳转到任意外部路径
# startWith:多个URL以','分隔，表示允许跳转到以其开头的外部路径
# equal:多个URL以','分隔，表示允许跳转到URL指定的外部路径
REDIRECTABLE_URL_CONFIGURATION={"startWith":"","equal":"http://www.baidu.com"} |
效果如下：
