本機容器認證

1.1 版本

1.2 應用場景

本機容器認證是專為私有雲、虛擬伺服器等無固定伺服器或經常變更的伺服器環境設計的授權方式。

使用者透過手機掃碼完成認證，無需依賴固定機器資訊，適用於以下場景：

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

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

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

1.3 功能簡介

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

1.4 注意事項

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

1）本地容器認證僅支援 JAR 包時間在 2021-10-30 及之後的報表工程。

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

3）客戶報表伺服器無需額外開放外網位址，但需要有一臺可以和外網環境互通的手機。

4）報表伺服器重啟後，是否需要重新掃碼認證取決於工程版本、Lic 獲取時間及工程配置類型。詳見第 4 節 。

5）使用者申請一個 license 授權檔案，只可用於註冊一個報表專案，不可在 A 工程註冊使用後，再用於 B 工程 。

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

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

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

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

4）叢集所有節點全部重啟後，是否需要重新掃碼認證取決於工程版本、Lic 獲取時間及工程配置類型。詳見第 4 節 。

2.1 獲取授權檔案

1）发送商务邮件

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

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

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

2）确认 license 文件名

收到商务返回的 license 文件后，请先根据文件名确认是否符合你的注册需求。

license 文件命名规则：FanRuan_产品名版本号_认证类型_授权类型_生成日期.lic

示例：FanRuan_FR11.5&BI6.1_LocalContainer_Offical_20250106.lic

2.2 上傳 lic 檔案

1）管理者登入 FineReport 系統，按「管理系統>註冊管理>立即註冊」 。

2）認證方式選擇「本機容器認證」 。

3）按「上傳lic檔案」，上傳上一節獲取的 license 檔案。上傳成功後會生成認證QRCODE 。

2.3 掃描QRCODE

使用任意手機的瀏覽器或微信掃描生成的QRCODE，會傳回一個 6 位的檢驗碼，將該檢驗碼填寫到系統中，按「提交認證」 。

說明

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

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

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

認證成功後註冊生效 。

每個 license 檔案，僅支援在一個 FineReport 工程中進行註冊 。

如需更换 FineReport 工程服务器，请先使用合同中指定的邮箱发送注册迁移申请邮件给 FineReport 商务 business@fanruan.com，邮件格式如下：

若有任何特殊情况，请在邮件中注明。

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

工程重啟後，是否需要重新掃碼認證取決於工程版本、Lic 獲取時間及工程配置類型。

工程重啟後，若本機容器認證失效，有「註冊管理」權限的管理者登入 FineReport 系統，會出現彈窗提示：由於工程重啟，您的工程註冊已失效，請進入註冊管理重新認證。

1）按「去認證」，跳轉至「註冊管理」介面。

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

3）輸入檢驗碼，按「提交認證」，即可重新註冊成功。

5.1 現象描述

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

5.2 失敗原因

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

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

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