1. 概述
1.1 版本
| 报表服务器版本 | 功能变更 |
|---|---|
| 11.0 | - |
| 11.0.20 | 工程重启后，新增重新注册强提醒 |
1.2 应用场景
本地容器认证是专为私有云、虚拟服务器等无固定服务器或经常变更的服务器环境设计的授权方式，适用于以下场景：
无固定机器信息：虚拟机、docker容器化部署，重启之后机器信息就会变更。无法使用本地机器信息认证。
报表工程部署在内网环境中，无法使用公有云认证。
无法提供一台物理信息不变的认证服务器，无法使用私有云认证。
1.3 功能简介
用户可通过手机作为媒介，进行本地容器认证。授权流程如下图所示：
1.4 注意事项
本地容器认证方式有以下注意点：
1）本地容器认证仅支持 JAR 包时间在 2021-10-30 及之后的报表工程。
2）报表工程进行本地容器认证，将不受物理信息限制，物理信息变化不会导致注册失败。
3）客户报表服务器无需额外开放外网地址，但需要有一台可以和外网环境互通的手机。
4）报表服务器重启后，需要重新认证。无需重新上传 Container.lic 文件，只需重新扫描二维码填写验证码。请参见2.3节。
5）用户申请一个 Container.lic 授权文件，只可用于注册一个报表项目，不可在A工程注册使用后，再用于B工程。
集群使用本地容器认证方式时需要注意：
1）集群注册价格按照「最大可注册量」（也就是需要的集群节点数）产生波动。
2）若集群节点数超过「最大可注册量」，则无法成功注册。
3）集群工程在注册前，请务必确保各服务器的时间一致。
4）若集群所有节点全部重启，报表工程需要重新认证。无需重新上传 Container.lic 文件，只需重新扫描二维码填写验证码。请参见2.3节。
2. 注册步骤
2.1 获取授权文件
支持两种获取方式：
1）自助注册（推荐）：通过在线自助注册平台，无需等待，自动即刻生成授权文件进行使用，但不支持FineReport&FineBI集成的工程。
2）商务协助：发送邮件给帆软商务，协助生成授权文件，支持任意帆软工程，但需要耐心等待。
2.1.1 自助注册（推荐）
详情请参见：产品正式注册
1）请提前联系帆软销售，确认相关事项并签署合同，并达成回款要求。
2）请使用指定账号登录帆软通行证，并完成企业认证。
3）请在「服务平台-产品注册」页面，选择对应合同，确认注册功能点，进行自助注册，并获取授权文件Container.lic
| 说明 | |
|---|---|
| 0 准备步骤 | 达成自助注册前提： 1）请提前联系帆软销售，确认相关事项并签署合同 2）请确保达成合同约定的回款要求 3）请使用合同约定的指定账号登录帆软通行证 4）请完成企业认证 |
| 1 自助注册入口 | 访问「产品注册」页面 |
| 2 选择合同 | 选择合同，点击「立即注册」 如已注册数达到注册总数，将无法进行在线注册
|
| 3 功能点确认 | 确认已授权功能点与帆软产品合同中注明的功能点一致
|
| 4 进行自助注册 | 1）选择注册方式：本地容器注册 2）输入项目名称：为便于贵司授权有问题时查询、维护，请输入项目名称，例如：XX公司XX项目、XX地区XX项目 3）输入注册工程数：即集群工程节点个数，单机输入1，不可大于剩余可注册工程数
|
| 5 完成注册 | 点击「立即注册」，可获取授权文件Container.lic，点击下载到本地
|
2.1.2 商务协助
请使用合同中指定的邮箱发送注册信息给 FineReport 商务business@fanruan.com，邮件格式如下：
商务收到邮件，核实无误后会为用户生成 Container.lic 文件，以邮件方式发送给用户。
注：若有任何特殊情况，请在邮件中注明。
| 清单 | 要求 | 注意事项 | |
|---|---|---|---|
| 优先联系 | 请提前联系帆软销售，确认相关事项并签署合同 | - | |
| 发件人 | 请使用合同中指定的邮箱 | 如发送注册信息的邮箱，非合同中指定的邮箱，则不予注册 | |
| 收件人 | business@fanruan.com | - | |
| 标题 | XXX 公司注册 FineReport 正式授权文件 | 如发送注册信息时，未注明公司名称，则不予注册 | |
| 正文 | 基础信息 | 公司名称：XXX 公司 项目名称：XXX 项目 合同签定日期：XXXX年XX月XX日 | - |
| 注册方式 | 本地容器认证 | - | |
| 最大可注册量 | 集群工程节点个数 | 若不提供该选项，则默认为1 单机情况下无需提供该项 | |
| 工程版本 | 请精确到工程小版本和JAR包信息 在「管理系统-注册管理-版本信息」中可查看 | - | |
2.2 上传 lic 文件
管理员登录数据决策系统，点击「管理系统>注册管理>立即注册」，如下图所示：
认证方式选择「本地容器认证」，点击「上传lic文件」，上传上一节获取的 Container.lic 文件。上传成功后会生成认证二维码。如下图所示：
2.3 扫描二维码
使用任意手机的浏览器/微信扫描生成的二维码，会返回一个 6 位的验证码，将该验证码填写到系统中，点击「提交认证」。如下图所示：
注1：二维码有效时间为 5 分钟，请于规定时间内完成注册流程。超过5分钟后，二维码会提示需要手动刷新。
注2：手机扫码返回验证码之后，工程最好立刻注册，未注册成功前不要重启工程。
注3：为了防止验证码暴力破解和接口高频访问，验证码输入错误次数若超过5次，则锁定 15 分钟。
认证成功后注册生效。如下图所示：
3. 注册迁移
每个 Container.lic 文件，仅支持在一个报表工程中进行注册 。
如需更换报表工程服务器，请先联系商务取消原服务器的注册授权，然后在新服务器上继续使用原 Container.lic 文件进行注册即可 。
注：原服务器若不解除绑定，新服务器注册时，注册失败，提示：已达可授权数量上限 。
4. 重启工程再注册
工程重启后，本地容器认证失效，需要重新扫描二维码进行再注册。为防止管理员遗忘，11.0.20 及之后版本新增强提醒功能。
1）工程重启后，有「注册管理」权限的管理员登录数据决策系统，出现弹窗提示：由于工程重启，您的工程注册已失效，请进入注册管理重新认证。
2）点击「去认证」按钮，跳转至「注册管理」界面。
3）点击「重新注册」按钮，出现认证信息二维码。使用手机扫码，返回验证码。
4）输入该验证码，点击「提交认证」，即可重新注册成功。
