页面历史

1. 概述

1.1. 功能介绍

用于第三方系统集成Smartbi中单点登录加密传输用户信息，安全系数更高，不会暴露用户的真实密码。

1.2. 原理

第三方系统使用密钥对用户登录信息进行DES加密来形成token，当客户端发起的请求携带有令牌登录参数以及目标跳转地址时，Smartbi服务器拦截到请求后，对token信息进行解析和校验，如果成功解析出用户信息并校验成功，则将用户设置为登录状态，再重定向到对应地址，后续访问其他地址无须重新登录。可用于第三方系统集成Smartbi中单点登录加密传输用户信息，安全系数更高，不会暴露用户的真实密码。

1.3. 名词释义

token：token是客户端使用密钥加密用户登录信息形成的一串字符串，以作客户端进行请求的一个令牌。

2. 功能详解

2.1. 令牌登录配置

相关配置都在 Smartbi 访问Smartbi的Config配置界面 (地址为 http://IP:PORT/smartbi/vision/config.jsp配置界面上的“令牌登录”)，配置令牌登录的信息：密钥、超时时间等

• 密钥：用来解密token信息，客户端需要用密钥来进行加密用户信息。密钥没有设置或为空字符串时，表示不支持令牌登录这种方式。密钥最小长度是8，当密钥大于8位时，实际上也只有前8位有效；

• 令牌超时时间：token有效时间，服务器解析请求时间戳 减去 token的生成的时间戳 大于 超时设置时，则代表token已超时，不能进行登录；

• 需要校验密码：设置token中是否要包含密码，使用密码来进行登录。如果该项设置为是，则在校验token信息时，解析出密码，再使用账号密码登录；如果该项设置为否，则直接将用户设置为登录状态。

2.2. 

生成令牌Token

Token的结构如下：的结构参考如下：

{

	"timestamp"：时间戳

username：用户名

password：可选，用户密码

}

,
	"username"："用户名",
	"password"："可选，用户密码"
}

使用“smartbi-DESUtil.jar”的工具类的encrypt方法来加密token来获得令牌，其中加密类是：DESCryption

该类提供加密、解密方法：

2.3. 使用token登录

链接格式：http://ip:port/smartbi/vision/loginByToken?smartbiToken=用户信息加密串&targetPath=目标跳转链接及其参数

常用集成界面示例：

• Web端首页：

http://localhost:8080/smartbi/vision/loginByToken?smartbiToken=54f296bd4649...&targetPath=index.jsp

• Web端集成资源：

http://localhost:8080/smartbi/vision/loginByToken?smartbiToken=54f296bd4649...&targetPath=openresource.jsp%3Fresid%3DI2c94ea86298cbe6c01298cfd9ba900fa.jsp?resid=I2c94ea86298cbe6c01298cfd9ba900fa

http://localhost:8080/smartbi/vision/loginByToken?smartbiToken=54f296bd4649...&targetPath=openmodule.jsp?id=Analysis&showbanner=false

http://localhost:8080/smartbi/vision/loginByToken?smartbiToken=54f296bd4649...&targetPath=createresource.jsp?restype=VISUAL

• 移动端首页：

http://localhost:8080/smartbi/vision/loginByToken?smartbiToken=54f296bd4649b0d41c35..&targetPath=mobileX%2FindexmobileX/index

• 移动端集成资源：

http://localhost:8080/smartbi/vision/loginByToken?smartbiToken=54f296bd4649b0d41....&targetPath=mobileX%2Freport%3Fresid%3DI2c94ea86298cbe6c01298cfd9ba900fa=mobileX/report?resid=I2c94ea86298cbe6c01298cfd9ba900fa

4. 示例

web项目使用令牌登录集成Smartbi：使用令牌登录示例.zip