适用对象1. 概述编辑
1.1 版本
| 报表服务器版本 |
|---|
| 11.0 |
1.2 应用场景
出于安全考虑，很多公司不能随便透露服务器的 MAC 地址。
本地机器信息认证需要绑定物理信息，公有云认证需要连接外网，私有云认证需要提供一台物理信息不变的认证服务器。
此时，用户可选择加密锁注册，无需提供服务器的 MAC 地址，通过绑定 FineReport 工程名称即可实现授权。
1.3 功能简介
帆软商务针对工程的应用名称生成对应的加密锁（类似 U 盘），只有当服务器上报表应用名称与加密锁匹配，且服务器插着 USB 接口的加密锁时，注册才会生效。
注1：加密锁认证不支持集群，不支持Mac，不支持运维平台部署的项目
注2：加密锁要一直插在服务器上，一旦拔掉，注册就会失效。
2. Windows 系统注册方法编辑
2.1 获取授权文件
请使用合同中指定的邮箱发送注册信息给 FineReport 商务business@fanruan.com，邮件格式如下：
商务收到邮件，核实无误后会生成对应的加密锁后，以快递方式邮寄 USB 接口的加密锁给用户。
注：若有任何特殊情况，请在邮件中注明。
| 清单 | 内容 | 注意事项 |
|---|---|---|
| 优先联系 | 请提前联系帆软销售，确认相关事项并签署合同 | - |
| 发件人 | 请使用合同中指定的邮箱 | 如发送注册信息的邮箱，非合同中指定的邮箱，则不予注册 |
| 收件人 | business@fanruan.com | - |
| 标题 | XXX 公司注册 FineReport 正式授权文件 | 如发送注册信息时，未注明公司名称，则不予注册 |
| 正文 | 公司名称：XXX 公司 项目名称：XXX 项目 合同签定日期：XXXX年XX月XX日 注册方式：加密锁认证 报表工程名：默认为webroot 收货地址：包括收货地址、签收人姓名、电话 | 其他并发数、用户数等信息，将按照签订的合同进行注册 |
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 获取授权文件
请使用合同中指定的邮箱发送注册信息给 FineReport 商务business@fanruan.com，邮件格式如下：
商务收到邮件，核实无误后会生成对应的加密锁后，以快递方式邮寄 USB 接口的加密锁给用户。
注：若有任何特殊情况，请在邮件中注明。
| 清单 | 内容 | 注意事项 |
|---|---|---|
| 优先联系 | 请提前联系帆软销售，确认相关事项并签署合同 | - |
| 发件人 | 请使用合同中指定的邮箱 | 如发送注册信息的邮箱，非合同中指定的邮箱，则不予注册 |
| 收件人 | business@fanruan.com | - |
| 标题 | XXX 公司注册 FineReport 正式授权文件 | 如发送注册信息时，未注明公司名称，则不予注册 |
| 正文 | 公司名称：XXX 公司 项目名称：XXX 项目 合同签定日期：XXXX年XX月XX日 注册方式：加密锁认证 报表工程名：默认为webroot 收货地址：包括收货地址、签收人姓名、电话 | 其他并发数、用户数等信息，将按照签订的合同进行注册 |
FineReport 商务生成对应的加密锁后，会邮寄给用户，用户获得 USB 接口的加密锁后即可按照下文进行注册验证。
3.2 插入加密锁
在报表工程服务器 USB 接口插入加密锁，Linux 系统在硬件上能够检测到加密锁，不需要安装加密锁驱动。
注：加密锁要一直插在服务器上，一旦拔掉，注册就会失效。
Linux 下，用 lsusb 命令，可以查看是否有多一个 USB 设备（拔插一下），如下图所示：
3.3 放置 libEL.so 库文件
在寄送的光盘中找到 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. 插件授权注册编辑
购买付费插件点击 插件的授权注册，只是把绑定类型修改为加密狗，下方再填写上加密狗序列号即可，如下图所示：
加密狗序列号在注册页面查看，如下图所示：
6. 认证迁移编辑
每个加密锁仅支持在一个帆软工程中进行注册。如需迁移授权，请按照以下步骤进行。
6.1 联系技术支持获取临时授权
由于加密锁一旦拔下，授权就会失效，而加密锁来回邮寄又需要一段时间。
因此请在执行下文步骤前，先联系帆软技术支持获取临时授权和认证方法。
6.2 邮寄原加密锁并申请新加密锁
1）获取帆软商务收件地址
原加密锁需要寄回帆软，商务回收后方可生成新加密锁设备寄出。
请使用合同中指定的邮箱发送邮件给 FineReport 商务business@fanruan.com。
邮件标题：加密锁认证迁移，获取收货信息
邮件正文：请包含以下信息，以及您觉得有必要说明的其他任何特殊情况
公司名称：XXX 公司 项目名称：XXX 项目 合同签定日期：XXXX年XX月XX日 诉求： 我司需进行加密锁认证迁移，请帆软商务提供收件地址、收件人、手机号等信息，用于接收原工程加密锁 |
2）邮寄原加密锁
帆软商务在接收到上文邮件后，会以邮件形式告知帆软收件地址、收件人、手机号等信息。
请将原加密锁寄还帆软，并记录下快递编号等信息。
3）发送新加密锁申请邮件
请使用合同中指定的邮箱发送邮件给 FineReport 商务business@fanruan.com。
邮件标题：原加密锁已邮寄，提交新认证申请
邮件正文：请包含以下信息，以及您觉得有必要说明的其他任何特殊情况
公司名称：XXX 公司 项目名称：XXX 项目 合同签定日期：XXXX年XX月XX日 注册方式：加密锁认证迁移 原加密锁快递信息：快递厂商，快递编号，发出日期 新工程名：默认为webroot 收货地址：包括收货地址、签收人姓名、电话 |
6.3 使用新加密锁注册
商务收到原加密锁，核实无误后，会为用户生成新加密锁，以快递方式发送给用户。
用户再按照第二/三章的步骤进行注册即可。