1. 概述编辑
1.1 版本
报表服务器版本 |
---|
11.0 |
1.2 应用场景
本地容器认证是专为私有云、虚拟服务器等无固定服务器或经常变更的服务器环境设计的授权方式,适用于以下场景:
无固定机器信息:虚拟机、docker容器化部署,重启之后机器信息就会变更。无法使用本地机器信息认证。
报表工程部署在内网环境中,无法使用公有云认证。
无法提供一台物理信息不变的认证服务器,无法使用私有云认证。
1.3 功能简介
用户可通过手机作为媒介,进行本地容器认证。授权流程如下图所示:
本地容器认证方式有以下几个特点:
1)报表工程进行本地容器认证,将不受物理信息限制,物理信息变化不会导致注册失败。
2)客户报表服务器无需额外开放外网地址,但需要有一台可以和外网环境互通的手机。
3)报表服务器重启后,需要重新认证。无需重新上传 Container.lic 文件,只需重新扫描二维码填写验证码。
4)用户申请一个授权,可注册多个工程,价格按照「最大可注册量」产生波动。
5)集群工程在注册前,请务必确保各服务器的时间一致。
2. 注册步骤编辑
2.1 获取授权文件
请使用合同中指定的邮箱发送注册信息给 FineReport 商务business@fanruan.com,邮件格式如下:
商务收到邮件,核实无误后会为用户生成 Container.lic 文件,以邮件方式发送给用户。
清单 | 要求 | 注意事项 | |
---|---|---|---|
优先联系 | 请提前联系帆软销售,确认相关事项并签署合同 | - | |
发件人 | 请使用合同中指定的邮箱 | 如发送注册信息的邮箱,非合同中指定的邮箱,则不予注册 | |
收件人 | business@fanruan.com | - | |
标题 | XXX 公司注册 FineReport 正式授权文件 | 如发送注册信息时,未注明公司名称,则不予注册 | |
正文 | 基础信息 | 公司名称:XXX 公司 项目名称:XXX 项目 合同签定日期:XXXX年XX月XX日 | - |
注册方式 | 本地容器认证 | - | |
最大可注册量 | 允许注册的工程数 | 若不提供该选项,则默认为1 |
2.2 上传 lic 文件
管理员登录数据决策系统,点击「管理系统>注册管理>立即注册」,如下图所示:
认证方式选择「本地容器认证」,点击「上传lic文件」,上传商务发送邮件中的 Container.lic 文件。上传成功后会生成认证二维码。如下图所示:
使用手机浏览器/微信扫描生成的二维码,会返回一个 6 位的验证码,将该验证码填写到系统中,点击「提交认证」。如下图所示:
注1:二维码有效时间为 5 分钟,请于规定时间内完成注册流程。
注2:手机扫码返回验证码之后,工程最好立刻注册,未注册成功前不要重启工程。因为扫码时clusterStartTime就会写进云中心数据库,此时工程如果重启,那么finedb中的clusterStartTime和云中心的clusterStartTime就不一致了,就无法注册成功,需要手动解绑。
注3:为了防止验证码暴力破解和接口高频访问,验证码输入错误次数若超过5次,则锁定 15 分钟。
认证成功后注册生效。如下图所示:
3. 取消注册编辑
1)进入%FR_HOME%/webroot/WEB-INF/resources 目录下,删除「Container.lic」文件,如下图所示:
2)重启报表服务器。
4. 注册迁移编辑
发送商务邮件时,注明了最大可注册量。
1)服务器数量不超过最大可注册数时,可直接使用商务发送的 Container.lic 文件在新服务器注册。
2)若超过最大可注册数,需要先参考第三章取消原服务器的注册授权,新服务器方可使用商务发送的 Container.lic 文件进行注册。
注:原服务器若不解除绑定,新服务器使用原服务器公有云账号注册时,注册失败,提示:已达可授权数量上限。
5. 注册失败编辑
5.1 现象描述
若注册失败,页面将出现提示弹窗,如下图所示:
5.2 失败原因
点击详细信息即可查看注册失败的原因,根据具体失败原因进行排查。
失败原因 | 具体提示 |
---|---|
证书已过期 | 过期时间:2019-02-22 |
版本不匹配 | 认证应用版本:9.0 本地应用版本:10.0 |
MAC 地址不匹配 | 认证 MAC 地址:xxx 本地 MAC 地址:xxx |
机器码不匹配 | 认证机器码:xxx 本地机器码:xxx |
应用名不匹配 | 认证应用名:xxx 本地应用名:xxx |
已达可授权数量上限 | 证书已被同服务器上其他工程使用 |
工程内容不匹配 | 认证工程内容:xxx 本地工程内容:xx |
注:除上述外失败原因外,其他统一报错:证书内容不正确。
有多个失败原因时,平台中会全部显示出来。