1. 概述
1.1 版本
| FineDataLink 版本 | 功能变动 |
|---|---|
| 1.9 | - |
| 4.0.28 | 注册失败提示优化，提供具体失败原因，帮助用户排查问题 |
1.2 应用场景
用户需要注册多个工程，多次导出工程信息十分麻烦，又不想本地搭建授权服务器。
帆软搭建了一个公有云认证服务器，客户通过填写认证信息发起授权请求，发送至公有云认证服务器，统一验证授权。
1.3 功能简介
公有云注册方式有以下几个特点：
1）FineDataLink 工程进行公有云注册，将不受物理信息限制，物理信息变化不会导致注册失败。
2）客户FineDataLink必须与授权服务器通过公网连通，不允许开放外网的客户无法使用该注册方式。
需要开放的外网地址包括：
| 域名 | 端口 | 说明 |
|---|---|---|
| https://register.fanruan.com | 443 | 公有云认证服务器 |
| https://cloud.fanruan.com | 443 | 网址管理中心 |
3）注册方式简便易操作，基本不会发生注册失败的情况。
4）用户申请一个授权，可注册多个工程，价格按照「最大可注册量」产生波动。
可以在任意FineDataLink注册，较为灵活。
1.4 注意事项
FDL 工程会每 2 小时向公有云认证服务器进行一次查询认证，若连续 12 次（即 24 小时后）认证失败，则报表工程显示注册失败，需重新进行注册操作。
4.0.28 及之后版本，将在「管理系统>注册管理」页面内以列表形式显示每次认证的失败时间和失败原因，帮助用户排查问题，如下图所示：
注：集群环境下，每个节点的失败原因可能不同，将显示每个节点的失败原因。
2. 注册步骤
2.1 获取授权文件
请使用合同中指定的邮箱发送注册信息给 FineDataLink 商务business@fanruan.com，邮件格式如下：
商务收到邮件，核实无误后会为用户生成账号和密码，以邮件方式发送给用户。
注：若有任何特殊情况，请在邮件中注明。
| 清单 | 要求 | 注意事项 | |
|---|---|---|---|
| 优先联系 | 请提前联系帆软销售，确认相关事项并签署合同 | - | |
| 发件人 | 请使用合同中指定的邮箱 | 如发送注册信息的邮箱，非合同中指定的邮箱，则不予注册 | |
| 收件人 | business@fanruan.com | - | |
| 标题 | XXX 公司注册 FineDataLink 正式授权文件 | 如发送注册信息时，未注明公司名称，则不予注册 | |
| 正文 | 基础信息 | 公司名称：XXX 公司 项目名称：XXX 项目 合同签定日期：XXXX年XX月XX日 | - |
| 注册方式 | 公有云认证 | - | |
| 最大可注册量 | 允许注册的工程数 | 若不提供该选项，则默认为1 | |
| 账号 | 公有云账号名 | 如需指定公有云账号名，请在邮件中注明该项，若账号名已被占用则不可使用 如不指定/指定不可用公有云账号名，商务将为您随机生成一个账号 | |
2.2 验证注册
管理员登录FineDataLink，点击「管理系统>注册管理>立即注册」，如下图所示：
认证方式选择「公有云认证」，输入商务发送邮件中的账号和密码，点击「提交认证」，认证成功。如下图所示：
默认采用 RSA 对公有云密码进行加密存储，若切换加密算法，同步进行密码更新。
3. 注册失败
4.0.28 之前版本，若注册失败，页面将出现提示弹窗：认证失败，请重新认证。
4.0.28 及之后版本，注册失败提示信息优化，若注册失败，页面将弹窗提示具体失败原因，用户可根据提示信息进行排查。
3.1 单机环境注册失败
若注册失败，页面将弹窗提示具体失败原因，点击「详细信息」按钮，即可查看具体失败原因或问题排查方案，如下图所示：
点击「返回」回到注册管理页面，「注册信息」处会显示注册失败和失败原因，点击「查看错误详情」即可查看具体失败原因或问题排查方案，如下图所示：
3.2 集群环境注册失败
若注册失败，不同节点的注册失败原因可能不同，页面将弹窗提示每个节点的具体失败原因，点击「详细信息」按钮，即可查看具体失败原因或问题排查方案，如下图所示：
点击「返回」回到注册管理页面，「注册信息」处会以列表形式显示每个节点的失败原因，点击「查看错误详情」即可查看对应的失败原因或问题排查方案，如下图所示：
3.3 失败原因
注册失败原因汇总如下，用户可根据具体失败原因或错误详情中提示的排查方案进行排查。
注1：除以下外失败原因外，其他统一报错：证书内容不正确。
注2：一次注册过程中有多个失败原因时，仅展示第一次失败的原因。
| 错误码 | 错误名 | 含义 |
|---|---|---|
| 10000 | JSON_PARSER_ERROR | 数据格式不正确 |
| 10001 | PARAM_INPUT_ERROR | 您输入的参数有误 |
| 20000 | DO_NOT_NEED_DEACTIVATE | 该机器未授权无需解除绑定（解除绑定的时候出现该提示，说明这台机器因未授权无需解除绑定） |
| 20001 | MYSQL_UPDATE_ERROR | 更新 MYSQL 数据库出错 |
| 20002 | REDIS_UPDATE_ERROR | 往 REDIS 数据库里插入数据出错 |
| 30000 | LICENSE_EXPIRED | 证书已过期 |
| 30001 | REPORT_VERSION_ERROR | 版本不匹配 |
| 30002 | ACCOUNT_STATUS_ERROR | 账户状态不正常 |
| 30003 | LICENSE_IP_ERROR | IP 不在允许的范围之内 |
| 30004 | LICENSE_DOMAIN_ERROR | 域名不在允许的范围之内 |
| 30005 | LICENSE_APPNAME_ERROR | 应用名不在允许的范围之内 |
| 30006 | ACCOUNT_INPUT_ERROR | 该账户和密码并未被授权 |
| 30007 | REGISTER_OUT_OF_LIMIT | 已达可授权数量上限 |
| - | 工程服务器与云注册服务器连接失败 | - |
4. 注册迁移
发送商务邮件时，注明了最大可注册量。
1）服务器数量不超过最大可注册数时，可直接使用原服务器公有云账号在新服务器注册。
2）若超过最大可注册数，原服务器解除绑定后，新服务器使用原服务器公有云账号注册。
管理员登录FineDataLink，点击「管理系统>注册管理>版本信息」，点击「重新注册>解除绑定」，即可解除旧服务器的绑定。如下图所示：
注1：原服务器关闭超过 24 小时后，方可进行新服务器的注册，否则仍会占用注册数。
注2：原服务器若不解除绑定，新服务器使用原服务器公有云账号注册时，注册失败，提示：已达可授权数量上限。
