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:原伺服器若不解除綁定,新伺服器使用原伺服器公有雲帳號註冊時,註冊失敗,提示:已達可授權數量上限。



