1. 概述
1.1 版本
| 报表服务器版本 | JAR 包版本 |
|---|---|
| 10.0 | 2018-12-27 |
1.2 应用场景
出于安全考虑，很多公司不能随便透露服务器的 MAC 地址。
本地机器信息认证需要绑定物理信息，公有云认证需要连接外网，私有云认证需要提供一台物理信息不变的认证服务器。
此时，用户可选择加密锁注册，无需提供服务器的 MAC 地址，通过绑定 FineReport 工程名称即可实现授权。
1.3 功能简介
帆软商务针对工程的应用名称生成对应的加密锁（类似 U 盘），只有当服务器上报表应用名称与加密锁匹配，且服务器插着 USB 接口的加密锁时，注册才会生效。
注1：加密锁认证不支持集群。
注2：加密锁认证不支持 Mac。
注3：加密锁要一直插在服务器上，一旦拔掉，注册就会失效。
2. Windows 系统注册方法
2.1 获取加密锁
2.1.1 确认工程名
打开报表工程所在服务器%FR_HOME%\webapps\目录，确认报表 Web 工程名，默认为webroot。
用户可在注册前根据自身需要修改工程名，注册后将无法修改。服务器上的报表应用名必须与注册时使用的应用名相同。
注：此工程名的修改可能会影响模板的超链等设置，请谨慎修改。
2.1.2 给商务发送邮件
请使用合同中指定的邮箱发送注册信息给 FineReport 商务business@fanruan.com，邮件格式如下：
注：若有任何特殊情况，请在邮件中注明。
| 清单 | 内容 | 注意事项 |
|---|---|---|
| 优先联系 | 请提前联系帆软销售，确认相关事项并签署合同 | - |
| 发件人 | 请使用合同中指定的邮箱 | 如发送注册信息的邮箱，非合同中指定的邮箱，则不予注册 |
| 收件人 | business@fanruan.com | - |
| 标题 | XXX 公司注册 FineReport 正式授权文件 | 如发送注册信息时，未注明公司名称，则不予注册 |
| 正文 | 公司名称：XXX 公司 项目名称：XXX 项目 合同签定日期：XXXX年XX月XX日 注册方式：加密锁认证 报表工程名：默认为webroot 收货地址：包括收货地址、签收人姓名、电话 | 其他并发数、用户数等信息，将按照签订的合同进行注册 |
FineReport 商务生成对应的加密锁后，会邮寄给用户，用户获得 USB 接口的加密锁后即可按照下文进行注册验证。
2.2 安装驱动
在寄送的光盘中找到 drivers.zip 文件：drivers.rar
将文件上传至报表工程服务器，解压后，点击 InstWiz3.exe 程序，安装加密锁驱动程序，如下图所示：
2.3 插入加密锁
在报表工程服务器 USB 接口插入加密锁，查看设备管理器，正常如下图所示：
注：加密锁要一直插在服务器上，一旦拔掉，注册就会失效。
2.4 放置 EL.dll 库文件
在寄送的光盘中找到EL文件.zip文件：ET文件.rar
解压后，将 JDK 对应版本的 EL.dll 文件上传至报表工程服务器\%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.6 开启加密锁认证
管理员登录决策系统，点击「管理系统>注册管理>版本信息」，认证方式选择「加密锁认证」，点击「检测加密锁」，如下图所示：
注册成功如下图所示：
3. Linux 系统注册方法
3.1 获取加密锁
3.1.1 确认工程名
打开报表工程所在服务器%FR_HOME%\webapps\目录，确认报表 Web 工程名，默认为webroot。
用户可在注册前根据自身需要修改工程名，注册后将无法修改。服务器上的报表应用名必须与注册时使用的应用名相同。
注：此工程名的修改可能会影响模板的超链等设置，请谨慎修改。
3.1.2 给商务发送邮件
请使用合同中指定的邮箱发送注册信息给 FineReport 商务business@fanruan.com，邮件格式如下：
注：若有任何特殊情况，请在邮件中注明。
| 清单 | 内容 | 注意事项 |
|---|---|---|
| 优先联系 | 请提前联系帆软销售，确认相关事项并签署合同 | - |
| 发件人 | 请使用合同中指定的邮箱 | 如发送注册信息的邮箱，非合同中指定的邮箱，则不予注册 |
| 收件人 | business@fanruan.com | - |
| 标题 | XXX 公司注册 FineReport 正式授权文件 | 如发送注册信息时，未注明公司名称，则不予注册 |
| 正文 | 公司名称：XXX 公司 项目名称：XXX 项目 合同签定日期：XXXX年XX月XX日 注册方式：加密锁认证 报表工程名：默认为webroot 收货地址：包括收货地址、签收人姓名、电话 | 其他并发数、用户数等信息，将按照签订的合同进行注册 |
FineReport 商务生成对应的加密锁后，会邮寄给用户，用户获得 USB 接口的加密锁后即可按照下文进行注册验证。
3.2 插入加密锁
在报表工程服务器 USB 接口插入加密锁，Linux 系统在硬件上能够检测到加密锁，不需要安装加密锁驱动。
注：加密锁要一直插在服务器上，一旦拔掉，注册就会失效。
Linux 下，用 lsusb 命令，可以查看是否有多一个 USB 设备（拔插一下），如下图所示：
3.3 放置 libEL.so 库文件和 JAR 包
在寄送的光盘中找到 EL文件.zip 文件：ET文件.rar
解压后，将 JDK 对应版本的 libEL.so 文件上传至报表工程服务器\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
注：Linux 系统中必须以最高权限用户 root 启动，不然权限不够，无法注册成功。
3.5 开启加密锁认证
管理员登录决策系统，点击「管理系统>注册管理>版本信息」，认证方式选择「加密锁认证」，点击「检测加密锁」，如下图所示：
注册成功如下图所示：
4. 注册失败
4.1 现象描述
若注册失败，页面将出现提示弹窗，如下图所示：
4.2 失败原因
点击详细信息即可查看注册失败的原因，根据具体失败原因进行排查。
| 失败原因 | 具体提示 |
|---|---|
| 加密锁序列号不匹配 | 认证加密锁序列号：xxx 本地加密锁序列号：xxx |
注：除上述外失败原因外，其他统一报错：证书内容不正确。
有多个失败原因时，平台中会全部显示出来。
5. 插件授权注册
购买付费插件点击 插件的授权注册，只是把绑定类型修改为加密狗，下方再填写上加密狗序列号即可，如下图所示：
加密狗序列号在注册页面查看，如下图所示：