一、概述
1
版本。
報表伺服器版本 | JAR包 | 功能變更 |
10.0 | - | - |
10.0.17 | - | 公有雲登入不受物理資訊限制。 |
10.0.19 | 2021-10-14 | 公有雲帳號密碼加密儲存。 |
2
應用場景。
使用者需要登入多個工程，多次匯出工程資訊十分麻煩，又不想本地搭建授權伺服器。
帆軟搭建了一個公有雲認證伺服器，客戶透過填寫認證資訊發起授權請求，傳送至公有雲認證伺服器，統一驗證授權。
3
功能簡介。
10.0.17 及之後版本的報表工程進行公有雲登入，將不受物理資訊限制，物理資訊變化不會導緻登入失敗。10.0.17 之前版本的報表工程進行公有雲登入，需要固定物理資訊，物理資訊變化會導緻登入失效。若登入失效後，請參考第四章進行解綁重新登入。
客戶報表伺服器必須與授權伺服器透過公網連通，不允許開放外網的客戶無法使用該登入方式。
需要開放的外網位址如下表格所示。
登入方式簡便易操作，基本不會發生登入失敗的情況。
使用者申請一個授權，可登入多個工程，價格按照【最大可登入量】產生波動。如果申請授權時不限制報表伺服器 IP ，可以在任意報表伺服器登入，較為靈活。
域名 | 埠 | 說明 |
443 | 公有雲認證伺服器。 | |
443 | 位址管理中心。 |
二、登入步驟
1
獲取授權檔案。
請使用合同中指定的郵箱傳送登入資訊給 FineReport 商務【business@fanruan.com】，郵件格式如下表格所示。
商務收到郵件，覈實無誤後會為使用者生成帳號和密碼，以郵件方式傳送給使用者。
清單 | 要求 | 注意事項 | |
優先聯絡 | 請提前聯絡帆軟銷售，應答相關事項並簽署合同。 | - | |
發件人 | 請使用合同中指定的郵箱。 | 如傳送登入資訊的郵箱，非合同中指定的郵箱，則不予登入。 | |
收件人 | business@fanruan.com | - | |
標題 | XXX 公司登入 FineReport 正式授權檔案 | 如傳送登入資訊時，未註明公司名稱，則不予登入。 | |
正文 | 基礎資訊 | 公司名稱：XXX 公司 專案名稱：XXX 專案 合同簽定日期：XXXX年XX月XX日。 | - |
登入方式 | 公有雲認證。 | - | |
最大可登入量 | 允許登入的工程數。 | 若不提供該選項，則預設為1 | |
報表伺服器 IP | 限制哪些報表伺服器的 IP 允許被登入 格式：192.168.100.25-192.168.100.26，192.168.0.1。 | 若不提供該選項，則表示無需對這項進行限制。 | |
帳號 | 公有雲帳號名。 | 如需指定公有雲帳號名，請在郵件中註明該項，若帳號名已被佔用則不可使用 如不指定/指定不可用公有雲帳號名，商務將為您隨機生成一個帳號。 | |
2
驗證登入。
管理者登入數據決策系統，點選【管理系統】→【登入管理】→【立即登入】，如下圖1所示。
認證方式選擇【公有雲認證】，輸入商務傳送郵件中的帳號和密碼，點選【提交認證】，認證成功。如下圖2所示。
注：JAR包在2021-10-14 及之後的工程，預設採用 RSA 對公有雲密碼進行加密儲存，若切換加密算法，同步進行密碼更新。
三、登入失敗
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 | 已達可授權數量上限。 |
四、登入遷移
傳送商務郵件時，註明了最大可登入量。伺服器數量不超過最大可登入數時，可直接使用原伺服器公有雲帳號在新伺服器登入；若超過最大可登入數，原伺服器解除綁定後，新伺服器使用原伺服器公有雲帳號登入。
管理者登入數據決策系統，點選【管理系統】→【登入管理】→【版本資訊】，點選【重新登入】→【解除綁定】，即可解除舊伺服器的綁定。
注1：原伺服器關閉超過 24 小時後，方可進行新伺服器的登入，否則仍會佔用登入數。
注2：原伺服器若不解除綁定，新伺服器使用原伺服器公有雲帳號登入時，登入失敗，提示：【已達可授權數量上限】。
