【已下架插件文档】URL登录插件

该插件目前已下架帆软市场，本文档仅提供给历史使用了该插件的客户，帆软目前不再提供该插件的任何获取渠道。

 

1. 概述

1.1 版本

报表服务器版本	插件版本
11.0	V1.0.2

1.2 功能简介

URL登录插件 用于直接使用get请求拼接用户名，密码，保持登录，跳转 URL 四个参数，进行登录并跳转。  

注：如果开启了短信验证等，则会抛出对应的错误码，此时无法通过此插件登录。

1.3 参数简介

GET  /url/login

参数	类型	说明
fine_username	RequestParam 参数	用户名
fine_password	RequestParam 参数	密码
validity	RequestParam 参数	保存登录   -2 记住密码(默认 14 天);   -1 关闭浏览器清除;   大于 0 为具体时间，单位秒
origin	RequestParam 参数	跳转 URL   如果 origin 参数为空，则跳转到首页。

2. 示例

2.1 登录示例

工程路径 webroot，servlet 路径 decision，请求 http://localhost:8075/webroot/decision

后面拼接
/url/login?
fine_username=Alice
fine_password=123456
validity=-1
origin=跳转URL，origin 参数的内容需要使用 base64转码

2.1.1 orgin 参数为空，直接登录首页

 

http://localhost:8075/webroot/decision/url/login?fine_username=Alice&fine_password=123456&validity=-1

2.1.2 orgin 参数不为空，跳转访问 finereport.frm 模板

1）跳转的 URL 为：http://localhost:8075/webroot/decision/view/form?viewlet=demo/homepage/finereport.frm

注：若访问模板路径中包含中文，需要先对模板路径做 URLEncode 编码 ，再把整体 URL 作为 base64转码对象。

 

2）跳转 URL base64转码 后：aHR0cDovL2xvY2FsaG9zdDo4MDc1L3dlYnJvb3QvZGVjaXNpb24vdmlldy9mb3JtP3ZpZXdsZXQ9ZGVtby9ob21lcGFnZS9maW5lcmVwb3J0LmZybQ==

3）拼接后到 &origin= 后面，最终 URL 为：

http://localhost:8075/webroot/decision/url/login?fine_username=Alice&fine_password=123456&validity=-1&origin=aHR0cDovL2xvY2FsaG9zdDo4MDc1L3dlYnJvb3QvZGVjaXNpb24vdmlldy9mb3JtP3ZpZXdsZXQ9ZGVtby9ob21lcGFnZS9maW5lcmVwb3J0LmZybQ==

注：若访问模板如果提示无权限，需要注意是否开启了 模板认证

3. 注意事项

URL 登录插件与和后台单点登录插件的参数冲突，在使用 URL 登录插件时，需禁用后台单点登录插件，否则会报错：User not exist, or wrong password!，如下图所示：