加密锁认证

1.1 版本

1.2 应用场景

出于安全考虑，很多公司不能随便透露服务器的 MAC 地址。

本地机器信息认证需要绑定物理信息，公有云认证需要连接外网，私有云认证需要提供一台物理信息不变的认证服务器。

此时，用户可选择加密锁注册，无需提供服务器的 MAC 地址，通过绑定 FineBI 工程名称即可实现授权。

1.3 功能简介

帆软商务针对工程的应用名称生成对应的加密锁（类似 U 盘），只有当服务器上 FineBI 应用名称与加密锁匹配，且服务器插着 USB 接口的加密锁时，注册才会生效。

注1：加密锁认证不支持集群。

注2：加密锁认证不支持 Mac。

注3：加密锁要一直插在服务器上，一旦拔掉，注册就会失效。

2.1 获取加密锁

2.1.1 确认工程名

打开 BI 工程所在服务器%BI_HOME%\webapps\目录，确认工程名，默认为webroot。

用户可在注册前根据自身需要修改工程名，注册后将无法修改。服务器上的工程应用名必须与注册时使用的应用名相同。

注：此工程名的修改可能会影响模板的超链等设置，请谨慎修改。

2.1.2 给商务发送邮件

请使用合同中指定的邮箱发送注册信息给 FineBI 商务business@fanruan.com，邮件格式如下： 

FineBI 商务生成对应的加密锁后，会邮寄给用户，用户获得 USB 接口的加密锁后即可按照下文进行注册验证。

2.2 安装驱动

在寄送的光盘中找到 drivers.zip 文件：drivers.rar

将文件上传至 FineBI 工程服务器，解压后，点击 InstWiz3.exe 程序，安装加密锁驱动程序，如下图所示：

2.3 插入加密锁

在 FineBI 工程服务器 USB 接口插入加密锁，查看设备管理器，正常如下图所示：

注：加密锁要一直插在服务器上，一旦拔掉，注册就会失效。

2.4 放置 EL.dll 库文件

在寄送的光盘中找到EL文件.zip文件：ET文件.rar

解压后，将 JDK 对应版本的 EL.dll 文件上传至 FineBI 工程服务器\%tomcat_home%\bin目录下面，或C:\Windows\System32目录下。

注：使用的 EL.dll 库文件需要与服务器上的 JDK 一致。

• 如果 JDK 为 64 位，则需配 64 位的 EL.dll 文件。（在 EL 文件压缩包的 Windows 64 目录下面）

• 如果 JDK 为 32 位，则需配 32 位的 EL.dll 文件（在 EL 文件压缩包的 Windows 32 目录下面）

       查看 JDK 多少位：按快捷键 Win+R，在运行内输入 cmd，回车，输入 java -version，可以看到 JDK 的位数。

2.5 重启 Web 服务器

重启 Web 服务器。

2.5 开启加密锁认证

管理员登录决策系统，点击「管理系统>注册管理>版本信息」，认证方式选择「加密锁认证」，点击「检测加密锁」，如下图所示：

注册成功如下图所示：

3.1 获取加密锁

3.1.1 确认工程名

打开 BI 工程所在服务器%BI_HOME%\webapps\目录，确认工程名，默认为webroot。

用户可在注册前根据自身需要修改工程名，注册后将无法修改。服务器上的工程应用名必须与注册时使用的应用名相同。

注：此工程名的修改可能会影响模板的超链等设置，请谨慎修改。

3.1.2 给商务发送邮件

请使用合同中指定的邮箱发送注册信息给 FineBI 商务business@fanruan.com，邮件格式如下： 

FineBI 商务生成对应的加密锁后，会邮寄给用户，用户获得 USB 接口的加密锁后即可按照下文进行注册验证。

3.2 插入加密锁

在 FineBI 工程服务器 USB 接口插入加密锁，Linux 系统在硬件上能够检测到加密锁，不需要安装加密锁驱动。

注：加密锁要一直插在服务器上，一旦拔掉，注册就会失效。

Linux 下，用 lsusb 命令，可以查看是否有多一个 USB 设备（拔插一下），如下图所示：

3.3 放置 libEL.so 库文件和 JAR 包

在寄送的光盘中找到 EL文件.zip 文件：ET文件.rar

解压后，将 JDK 对应版本的 libEL.so 文件上传至 FineBI 工程服务器\usr\lib或\usr\lib64目录下面。

注：EL.dll 库文件需要与 JDK 的一致。

• 如果 JDK 为 64 位，则需配64位的 libEL.so 文件（在 EL 文件压缩包的 Linux 64 目录下面）。

• 如果 JDK 为 32位，则需配 32 位的 libEL.so 文件（在 EL 文件压缩包的 Linux 32 目录下面）。

3.4 重启 Web 服务器

重启 Web 应用服务器，以 Tomcat 为例：

关闭服务器：./shutdown.sh

查找进程：ps -ef|grep tomcat

杀死进程：kill -9 进程号

重启服务器：./startup.sh

注1：Linux 系统中必须以最高权限用户 root 启动，不然权限不够，无法注册成功。

注2：2019-12-05及之后版本的 JAR 包可正常使用 shutdown 完全清理所有进程。

3.5 开启加密锁认证

管理员登录决策系统，点击「管理系统>注册管理>版本信息」，认证方式选择「加密锁认证」，点击「检测加密锁」，如下图所示：

注册成功如下图所示：

4.1 现象描述

若注册失败，页面将出现提示弹窗，如下图所示：

4.2 失败原因

点击详细信息即可查看注册失败的原因，根据具体失败原因进行排查。

注：除上述外失败原因外，其他统一报错：证书内容不正确。

       有多个失败原因时，平台中会全部显示出来。

购买付费插件点击 插件的授权注册，只是把绑定类型修改为加密狗，下方再填写上加密狗序列号即可，如下图所示：

加密狗序列号在注册页面查看，如下图所示：