非容器化本機容器認證

本文僅用於指導非維運平台部署的工程註冊。

維運平台部署的FineBI工程，請透過維運平台進行註冊。詳情請參見：註冊新專案 。

1.1 版本

1.2 應用場景

本地容器認證是專為私有云、虛擬伺服器等無固定伺服器或經常變更的伺服器環境設計的授權方式，適用於以下場景：

• 無固定機器資訊：虛擬機、docker容器化部署，重啟之後機器資訊就會變更。無法使用本地機器資訊認證。

• 報表工程部署在內網環境中，無法使用公有云認證。

• 無法提供一臺物理資訊不變的認證伺服器，無法使用私有云認證。

1.3 功能簡介

使用者可透過手機作為媒介，進行本地容器認證。授權流程如下圖所示：

1.4 注意事項

本地容器認證方式有以下注意點：

1）FineBI工程進行本地容器認證，將不受物理資訊限制，物理資訊變化不會導致註冊失敗。

2）客戶FineBI工程無需額外開放外網位址，但需要有一臺可以和外網環境互通的手機。

3）FineBI工程重啟後，需要重新認證。無需重新上傳 Container.lic 檔案，只需重新掃瞄QRCODE填寫檢驗碼。請參見2.3節。

4）使用者申請一個授權，只可註冊一個FineBI工程。

叢集使用本地容器認證方式時需要注意：

1）叢集註冊價格按照「最大可註冊量」（也就是需要的叢集節點數）產生波動。

2）若叢集節點數超過「最大可註冊量」，則無法成功註冊。

3）叢集工程在註冊前，請務必確定各伺服器的時間一致。

4）若叢集所有節點全部重啟，FineBI工程需要重新認證。無需重新上傳 Container.lic 檔案，只需重新掃瞄QRCODE填寫檢驗碼。請參見2.3節。

2.1 獲取版本資訊

管理者登入FineBI系統，點選「管理系統>註冊管理>版本資訊」，查看版本資訊 。

請將此頁面完整截圖留存，下文獲取授權時需要使用 。

2.2 獲取授權檔案

請使用合同中指定的郵箱傳送註冊資訊給 FineReport 商務business@fanruan.com，郵件格式如下： 

商務收到郵件，覈實無誤後會為使用者生成 Container.lic 檔案，以郵件方式傳送給使用者。

注：若有任何特殊情況，請在郵件中註明。

2.3 上傳 lic 檔案

管理者登入數據決策系統，點選「管理系統>註冊管理>立即註冊」，如下圖所示：

認證方式選擇「本地容器認證」，點選「上傳lic檔案」，上傳商務傳送郵件中的 Container.lic 檔案。

上傳成功後會生成認證QRCODE。如下圖所示：

2.4 掃瞄QRCODE

使用手機瀏覽器/微信掃瞄生成的QRCODE，會傳回一個 6 位的檢驗碼，將該檢驗碼填寫到系統中，點選「提交認證」。如下圖所示：

注1：QRCODE有效時間為 5 分鐘，請於規定時間內完成註冊流程。超過5分鐘後，QRCODE會提示需要手動重新整理。

注2：手機掃碼傳回檢驗碼之後，工程最好立刻註冊，未註冊成功前不要重啟工程。

注3：為了防止檢驗碼暴力破解和API高頻存取，檢驗碼輸入錯誤次數若超過5次，則鎖定 15 分鐘。

認證成功後註冊生效。如下圖所示：

商務傳送的 Container.lic 檔案，僅支援在一個報表工程中進行註冊。

如需更換報表工程伺服器，請聯絡商務取消原伺服器的註冊授權，新伺服器方可使用商務傳送的 Container.lic 檔案進行註冊。

注：原伺服器若不解除綁定，新伺服器註冊時，註冊失敗，提示：已達可授權數量上限。

工程重啟後，本地容器認證失效，需要重新掃瞄QRCODE進行再註冊。為防止管理者遺忘，6.0.14及之後版本新增強提醒功能。

1）工程重啟後，有「註冊管理」權限的管理者登入數據決策系統，出現彈窗提示：由於工程重啟，您的工程註冊已失效，請進入註冊管理重新認證。

2）點選「去認證」按鈕，跳轉至「註冊管理」介面。

3）點選「重新註冊」按鈕，出現認證資訊QRCODE。使用手機掃碼，傳回檢驗碼。

4）輸入該檢驗碼，點選「提交認證」，即可重新註冊成功。

4.1 現象描述

若註冊失敗，頁面將出現提示彈窗，如下圖所示：

4.2 失敗原因

點選詳細資訊即可查看註冊失敗的原因，根據具體失敗原因進行排查。

注：除上述外失敗原因外，其他統一報錯：憑證內容不正確。

       有多個失敗原因時，平台中會全部顯示出來。