本地容器认证

1.1 版本

1.2 应用场景

本地容器认证是专为私有云、虚拟服务器等无固定服务器或经常变更的服务器环境设计的授权方式，适用于以下场景：

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

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

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

1.3 功能简介

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

1.4 注意事项

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

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

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

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

4）报表服务器重启后，需要重新认证。无需重新上传 Container.lic 文件，只需重新扫描二维码填写验证码。请参见2.3节。

5）用户申请一个授权，只可注册一个报表工程。

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

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

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

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

4）若集群所有节点全部重启，报表工程需要重新认证。无需重新上传 Container.lic 文件，只需重新扫描二维码填写验证码。请参见2.3节。

2.1 获取授权文件

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

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

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

2.2 上传 lic 文件

管理员登录数据决策系统，点击「管理系统>注册管理>立即注册」，如下图所示：

认证方式选择「本地容器认证」，点击「上传lic文件」，上传商务发送邮件中的 Container.lic 文件。上传成功后会生成认证二维码。如下图所示：

2.3 扫描二维码

使用手机浏览器/微信扫描生成的二维码，会返回一个 6 位的验证码，将该验证码填写到系统中，点击「提交认证」。如下图所示：

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

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

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

认证成功后注册生效。如下图所示：

商务发送的 Container.lic 文件，仅支持在一个报表工程中进行注册。

如需更换报表工程服务器，请联系商务取消原服务器的注册授权，新服务器方可使用商务发送的 Container.lic 文件进行注册。

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

4.1 现象描述

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

4.2 失败原因

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

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

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