非容器化工程本地容器认证

本文仅用于指导非运维平台部署的工程注册。

运维平台部署的FineBI工程，请通过运维平台进行注册。详情请参见：注册新项目

1.1 版本

1.2 应用场景

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

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

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

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

1.3 功能简介

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

1.4 注意事项

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

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

2）客户FineBI工程无需额外开放外网地址，但需要有一台可以和外网环境互通的手机。

3）FineBI工程重启后，需要重新认证。无需重新上传 Container.lic 文件，只需重新扫描二维码填写验证码。请参见2.3节。

4）用户申请一个授权，只可注册一个FineBI工程。

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

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

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

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

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

2.1 获取授权文件

支持两种获取方式：

1）自助注册：

通过在线自助注册平台，无需等待，自动即刻生成授权文件进行使用

仅支持FineBI6.0/FineReport11.0工程，不支持FineDataLink工程，不支持FR&BI集成工程，不支持FineBI6.1工程

本文不赘述，详情请参见：在线自助获取注册文件

2）商务协助：发送邮件给帆软商务，协助生成授权文件，支持任意帆软工程。

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

商务收到邮件，核实无误后会为用户生成账号和密码，以邮件方式发送给用户。

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

2.2 上传 lic 文件

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

认证方式选择「本地容器认证」，点击「上传lic文件」，上传商务发送邮件中的 Container.lic 文件。

上传成功后会生成认证二维码。如下图所示：

2.3 扫描二维码

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

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

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

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

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

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

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

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

工程重启后，本地容器认证失效，需要重新扫描二维码进行再注册。为防止管理员遗忘，6.0.14及之后版本新增强提醒功能。

1）工程重启后，有「注册管理」权限的管理员登录数据决策系统，出现弹窗提示：由于工程重启，您的工程注册已失效，请进入注册管理重新认证。

2）点击「去认证」按钮，跳转至「注册管理」界面。

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

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

4.1 现象描述

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

4.2 失败原因

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

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

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