历史版本6 :后台单点登录插件 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

1.1 版本

报表服务器版本后台单点登录插件
功能变动
11.0V1.0.0
-
V1.1.0

  • 新增 ssoToken 超时设置功能，开启后，ssoToken 将在达到「系统管理>登录>登录超时时间」后过期

  • 通过选择「用户名加密」按钮和「示例接口」按钮，切换用户名加密和不加密这两种方式

11.0.4V1.1.1

  • URL 重定向

  • 用户不存在报错时，提供跳转登录页的入口

1.2 功能简介

  • 安装后台单点登录插件，即可实现后台单点，无需复杂代码，操作简单。

  • 可对用户名进行加密，提高安全性。

2. 插件介绍编辑

2.1 插件下载

后台单点登录插件下载请点击：后台单点登录插件

设计器插件安装方法请参见：设计器插件管理 

服务器安装插件方法请参见：服务器插件管理 

2.2 页面介绍

插件安装后，超管进入平台，点击「管理系统>系统管理」，出现集成后台单点登录页面。如下图所示：

注：只有超管可见配置页面。

3.png

3. 操作步骤编辑

3.1 方案一：用户名不加密

1）插件安装成功后，选择「示例接口>保存」。如下图所示：

注：插件 V1.0.0 版本，忽略该步骤。

4.png

2）访问http://ip:端口号/工程名/decision?fine_username=用户名，「用户名」为任意平台已存在且可用的用户名。如下图所示：

6.png

3.2 方案二：用户名加密

注：该方案不再支持访问http://ip:端口号/工程名/decision?fine_username=用户名实现后台单点登录，支持的访问路径请参见本文 3.2.5 节。

3.2.1 生成 RSA Key

插件 V1.1.0 版本安装后，Public Key 自动生成。如下图所示：

注：插件 V1.0.0 版本，需要点击「生成RSA Key」按钮。

2.png

需注意以下几点：

  • 只支持生成默认的 key ，不支持自定义。

  • 生成 Public Key 后，点击「生成 RSA Key」，可重新生成且覆盖之前的 Key 。

  • 生成的 key 只支持 aes 传输加密，安装 base64 插件无效，也不支持国密。

3.2.2 用户名加密

将生成的 RSA KEY 和用户名放到用户自己的加密代码中，对用户名进行加密。

1）此处用 加密网站 进行加密，实际用户建议使用自己加密代码进行加密。

2）加密步骤如下图所示：

28.png

3.2.3 用户名解密

将加密后的用户名，输入到「解密测试」中，若能成功解密出用户名，代表加解密的流程是正确的。如下图所示：

9.png

3.2.4 用户名转码

加密后的用户名需要转码才能嵌入 URL 中，用户可使用encodeURIComponent对加密用户名进行转码。

本文示例使用 转码网站 进行转码，如下图所示：

29.png

3.2.5 效果查看

访问链接：http://ip:port/工程名/decision?ssoToken=xxx（编码后的结果），实现用户名加密的后台单点登录。如下图所示：

12.png

3.2.6 ssoToken 超时设置

V1.1.0 版本新增该功能，默认不开启。开启后，ssoToken 将在达到「系统管理>登录>登录超时时间」后过期。

V1.0.0 版本对用户名进行 rsa 加密，V1.1.0 版本对下面这个 JSON 字符串进行 rsa 加密，其中 username 为用户名，issueTime 为当前毫秒时间戳。

{
  "username": "1",
  "issueTime": 1638434945973
}

若用户使用 后台单点登录RSA示例代码 实现的单点登录，开启「ssoToken 超时设置」功能后，需要修改代码接口，如果不修改，ssoToken 无法成功单点登录。代码接口请参见：后台单点登录RSA示例代码 的 2.2.2 节内容。

如果使用的 ssoToken 超时，将报错：登录超时，请重新登录。如下图所示：

1641351372358216.png