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