本地容器认证

1.1 版本

1.2 应用场景

本地容器认证是专为私有云、虚拟服务器等无固定服务器或经常变更的服务器环境设计的授权方式。

用户通过手机扫码完成认证，无需依赖固定机器信息，适用于以下场景：

• 无固定机器信息：虚拟机、Docker 容器化部署，重启后机器信息变更，无法使用本地机器信息认证

• 报表工程部署在内网环境中，无法使用公有云认证

• 无法提供一台物理信息不变的认证服务器，无法使用私有云认证

1.3 功能简介

用户可通过手机作为媒介，进行本地容器认证。授权流程如下图所示：

1.4 注意事项

本地容器认证方式有以下注意点：

1）本地容器认证仅支持 JAR 包时间在 2021-10-30 及之后的报表工程。

2）报表工程进行本地容器认证，将不受物理信息限制，物理信息变化不会导致注册失败。

3）客户报表服务器无需额外开放外网地址，但需要有一台可以和外网环境互通的手机。

4）报表服务器重启后，是否需要重新扫码认证取决于工程版本、Lic 获取时间及工程配置类型。详见第 4 节。

5）用户申请一个 Container.lic 授权文件，只可用于注册一个报表项目，不可在 A 工程注册使用后，再用于 B 工程。

集群使用本地容器认证方式时需要注意：

1）集群注册价格按照「最大可注册量」（也就是需要的集群节点数）产生波动。

2）若集群节点数超过「最大可注册量」，则无法成功注册。

3）集群工程在注册前，请务必确保各服务器的时间一致。

4）集群所有节点全部重启后，是否需要重新扫码认证取决于工程版本、Lic 获取时间及工程配置类型。详见第 4 节。

2.1 获取授权文件

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

商务收到邮件，核实无误后会为用户生成 Container.lic 文件，以邮件方式发送给用户。

若有任何特殊情况，请在邮件中注明。

2.2 上传 lic 文件

1）管理员登录 FineReport 系统，单击「管理系统>注册管理>立即注册」。

2）认证方式选择「本地容器认证」。

3）单击「上传lic文件」，上传上一节获取的 Container.lic 文件。上传成功后会生成认证二维码。

2.3 扫描二维码

使用任意手机的浏览器或微信扫描生成的二维码，会返回一个 6 位的验证码，将该验证码填写到系统中，单击「提交认证」。

说明

• 二维码有效时间为 5 分钟，请于规定时间内完成注册流程。超过 5 分钟后，二维码会提示需要手动刷新。

• 手机扫码返回验证码之后，工程最好立刻注册，未注册成功前不要重启工程。

• 为了防止验证码暴力破解和接口高频访问，验证码输入错误次数若超过 5 次，则锁定 15 分钟。

认证成功后注册生效。

每个 Container.lic 文件，仅支持在一个 FineReport 工程中进行注册。

如需更换 FineReport 工程服务器，请先联系商务取消原服务器的注册授权，然后在新服务器上继续使用原 Container.lic 文件进行注册即可。

注：原服务器若不解除绑定，新服务器注册时将注册失败，提示：已达可授权数量上限。

工程重启后，是否需要重新扫码认证取决于工程版本、Lic 获取时间及工程配置类型。

工程重启后，若本地容器认证失效，有「注册管理」权限的管理员登录 FineReport 系统，会出现弹窗提示：由于工程重启，您的工程注册已失效，请进入注册管理重新认证。

1）单击「去认证」，跳转至「注册管理」界面。

2）单击「重新注册」，出现认证信息二维码。使用手机扫码，返回验证码。

3）输入验证码，单击「提交认证」，即可重新注册成功。

5.1 现象描述

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

5.2 失败原因

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

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

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