第1章 概述
本文主要介绍在与SaCa Dataviz 集成时，如何在播放页面通过url传参的方式进行系统自动登录的处理。
第2章 处理
2.1 开启功能配置
产品默认URL传参登录功能处于关闭状态，想要开启此功能需要修改config.js配置文件，路径：\dataviz-web\common\config.js，把urlLogin的值改为true。
urlLogin: false, //是否开启URL传参登录功能
默认状态下分享链接是不需要登录验证的，所以urlLogin配置不能控制分享链接。如果分享链接也需要登录验证需要开启看另一个配置：
sharePlayUrlLogin: false, //是否开启播放分享链接的传参登录功能
2.2 传递参数说明
使用URL传参登录功能，需要在正常的访问连接中加入两个参数：loginname和token，例如： 播放连接：http://localhost:63342/dataviz_web/src/q.html?b=a76822c4-ed2e-4450-bb60-68439e9b6d28&loginname=kangxi&token=HD8SJSK2J34K9J7JH5O8Y2TQ6 默认访问连接：http://localhost:63342/dataviz_web/src/index.html?loginname=kangxi&token=HD8SJSK2J34K9J7JH5O8Y2TQ6 loginname：登录账号。 token：登录令牌，用以校验登录账号是否可以合法登录。
2.3 获取登录用户接口
URL传参登录会在后台调用一个方法，该方法会根据传入的loginname和token进行登录用户的合法性验证，如果验证通过会返回对应的用户信息。该方法可以通过实现接口的方式进行替换。
2.3.1 接口说明
接口名称：com.neusoft.saca.dataviz.authentication.springsecurity.filterlogin.usertoken. TokenValidator 所在包：dataviz-security.jar
2.3.2 方法说明
//登录验证，传入的参数就是URL中传入的两个参数
public UserBO validate(String loginName, String token) throws Exception;
2.3.2.1 传入参数
| 属性 | 类型 | 是否可能为空 | 描述 |
|---|---|---|---|
| loginName | String | 是 | 用户登录账号，不能与token都为空 |
| token | String | 是 | 用户登录令牌，不能与loginName都为空 |
2.3.2.2 返回参数
| 属性 | 类型 | 是否可能为空 | 描述 |
|---|---|---|---|
| id | String | 否 | 用户ID（唯一标识） |
| name | String | 是 | 用户名称 |
| role | Integer | 否 | 系统角色:0：普通用户，1：管理员，默认为0 |
| state | Integer | 否 | 状态，-1：无效，1：有效，默认为1 |
2.3.3 配置修改
修改文件dataviz-service\WebContent\WEB-INF\conf\spring\applicationContext-security.xml中以下内容：
<beans:bean id="tokenValidator" class="com.neusoft.saca.dataviz.authentication.springsecurity.filterlogin.validate.LoginUsernamePasswordTokenValidator"></beans:bean>
把class内的完整类名替换为你自己实现的类。