1. 概述
1.1 版本
| 报表服务器版本 |
|---|
| 11.0 |
1.2 应用场景
出于安全考虑，很多公司不能随便透露服务器的 MAC 地址。
本地机器信息认证需要绑定物理信息，公有云认证需要连接外网，私有云认证需要提供一台物理信息不变的认证服务器。
此时，用户可选择加密锁注册，无需提供服务器的 MAC 地址，通过绑定 FineReport 工程名称即可实现授权。
1.3 功能简介
帆软商务针对工程的应用名称生成对应的加密锁（类似 U 盘），只有当服务器上报表应用名称与加密锁匹配，且服务器插着 USB 接口的加密锁时，注册才会生效。
注1：加密锁认证不支持集群。
注2：加密锁认证不支持 Mac。
注3：加密锁要一直插在服务器上，一旦拔掉，注册就会失效。
2. Windows 系统注册方法
2.1 获取授权文件
支持两种获取方式：
1）自助注册（推荐）：通过在线自助注册平台，无需等待，自动即刻生成授权文件进行使用，但不支持FineReport&FineBI集成的工程。
2）商务协助：发送邮件给帆软商务，协助生成授权文件，支持任意帆软工程，但需要耐心等待。
2.1.1 自助注册（推荐）
详情请参见：产品正式注册
1）请提前联系帆软销售，确认相关事项并签署合同，并达成回款要求。
2）请使用指定账号登录帆软通行证，并完成企业认证。
3）请在「服务平台-工程注册」页面，选择对应合同，确认注册功能点，进行自助注册。
4）生成对应的加密锁后，帆软会邮寄 USB 接口的加密锁给用户。
| 说明 | |
|---|---|
| 0 准备步骤 | 达成自助注册前提： 1）请提前联系帆软销售，确认相关事项并签署合同 2）请确保达成合同约定的回款要求 3）请使用合同约定的指定账号登录帆软通行证 4）请完成企业认证 |
| 1 自助注册入口 | 访问「产品注册」页面 |
| 2 选择合同 | 选择合同，点击「立即注册」 如已注册数达到注册总数，将无法进行在线注册
|
| 3 功能点确认 | 确认已授权功能点与帆软产品合同中注明的功能点一致
|
| 4 进行自助注册 | 1）选择注册方式：加密锁注册 2）输入项目名称：为便于贵司授权有问题时查询、维护，请输入项目名称，例如：XX公司XX项目、XX地区XX项目 3）输入收件信息：即 USB 接口的加密锁接收地址，包括收件人、手机号、收件地址。
|
| 5 完成注册 | 点击「立即注册」，帆软商务会尽快制作加密锁，并通过快递发出 快递发出后，可在授权信息界面查看快递单号，追踪进度。
|
2.1.2 商务协助
请使用合同中指定的邮箱发送注册信息给 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 获取授权文件
支持两种获取方式：
1）自助注册（推荐）：通过在线自助注册平台，无需等待，自动即刻生成授权文件进行使用，但不支持FineReport&FineBI集成的工程。
2）商务协助：发送邮件给帆软商务，协助生成授权文件，支持任意帆软工程，但需要耐心等待。
3.1.1 自助注册（推荐）
详情请参见：产品正式注册
1）请提前联系帆软销售，确认相关事项并签署合同，并达成回款要求。
2）请使用指定账号登录帆软通行证，并完成企业认证。
3）请在「服务平台-工程注册」页面，选择对应合同，确认注册功能点，进行自助注册。
4）生成对应的加密锁后，帆软会邮寄 USB 接口的加密锁给用户。
| 说明 | |
|---|---|
| 0 准备步骤 | 达成自助注册前提： 1）请提前联系帆软销售，确认相关事项并签署合同 2）请确保达成合同约定的回款要求 3）请使用合同约定的指定账号登录帆软通行证 4）请完成企业认证 |
| 1 自助注册入口 | 访问「产品注册」页面 |
| 2 选择合同 | 选择合同，点击「立即注册」 如已注册数达到注册总数，将无法进行在线注册
|
| 3 功能点确认 | 确认已授权功能点与帆软产品合同中注明的功能点一致
|
| 4 进行自助注册 | 1）选择注册方式：加密锁注册 2）输入项目名称：为便于贵司授权有问题时查询、维护，请输入项目名称，例如：XX公司XX项目、XX地区XX项目 3）输入收件信息：即 USB 接口的加密锁接收地址，包括收件人、手机号、收件地址。
|
| 5 完成注册 | 点击「立即注册」，帆软商务会尽快制作加密锁，并通过快递发出 快递发出后，可在授权信息界面查看快递单号，追踪进度。
|
3.1.2 商务协助
请使用合同中指定的邮箱发送注册信息给 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 使用新加密锁注册
商务收到原加密锁，核实无误后，会为用户生成新加密锁，以快递方式发送给用户。
用户再按照第二/三章的步骤进行注册即可。
