私有雲認證

1

版本。

2

應用場景。

1. 客戶的報表伺服器是部署在虛擬機上或者雲平台上的，報表伺服器的物理資訊不固定，這樣就沒有辦法綁定固定的機器資訊，所以本地機器資訊認證不再適用。

2. 這時，需要找一臺物理資訊固定的伺服器作為授權伺服器，然後把授權伺服器的機器資訊 rif 檔案發給商務，生成私有雲認證伺服器檔案【FanruanLicenseServer】，裏麪包含一個【server.exe】檔案。

3

功能簡介。

1. 報表伺服器物理資訊不固定無法進行本地機器認證時，若有一臺物理資訊固定的伺服器，可進行私有雲認證。

2. 授權伺服器（license Server 端）將這個授權的功能點、授權存取域名、授權存取埠、授權存取應用名、授權存取截止日期等資訊傳回給報表伺服器（Report Server 端）。

3. 報表伺服器（Report Server 端）做校驗，如果校驗透過，就進入正常的存取過程，如果不透過，則作為未授權伺服器。如下圖所示。

4. 授權伺服器過程是指的是提供授權功能的那個伺服器過程（需提供物理資訊），報表伺服器是指運作 FineReport 報表的某臺伺服器（無需提供物理資訊）。

4

注意事項。

1. 私有雲認證的授權伺服器，需要是一臺固定物理資訊的機器。報表工程伺服器所在機器不需要有固定不變的物理資訊。例如虛擬機環境下物理資訊可能變化，造成登入失敗，不適合被用作授權伺服器。

2. 報表伺服器即需登入的報表工程所在伺服器，需要跟授權伺服器網路互通。

3. 一個授權伺服器不允許運作兩個私有雲認證過程。

4. 授權伺服器運作的認證過程不可關閉超過 24 小時。

   
   

   若關閉時長超過 24 小時，需重作認證過程，報表伺服器需要重新進行登入操作。

   若關閉時長小於 24 小時，報表伺服器顯示登入失敗，在 2 小時內將自動重新連結上授權伺服器，登入不失效。

5. 認證伺服器卸載後，如需再次採用此機器作為授權伺服器，需重新生成 MachineInfo.rif 檔案傳送給商務重新登入。

6. 在授權個數允許的範圍內，一個授權伺服器可以給多個報表伺服器授權。

7. 叢集情況下使用私有雲認證，無需每個節點都傳送登入資訊到商務。

8. 報表伺服器遷移時，不需要重新申請授權檔案，僅需保證報表伺服器所在的機器和授權伺服器的網路可以連通即可。

9. Linux 情況下支援 i386、arm 和 amd64 位系統 。

10. 不支援透過nat訪問私有雲。

1

下載 machine 工具。

1. 點選下載 machine 工具，用於獲取授權伺服器信息檔案：Windows.zip。

2. 將壓縮包上傳至授權伺服器，並解壓。

2

匯出授權伺服器資訊。

1. 以管理者權限運作解壓生成的 machine.exe 檔案，在同目錄下自動生成 require 資料夾。

2. require 資料夾下的 MachineInfo.rif 檔案，即為匯出的授權伺服器資訊檔案。如下圖所示。

3

獲取授權檔案。

1. 請使用合同中指定的郵箱發送注冊信息給 FineReport 商務【business@fanruan.com】，郵件格式如下。

2. 商務收到郵件，核實無誤後會生成授權檔案【FanruanLicenseServer.zip】，以郵件方式發送給使用者。

3. 郵件内容如下表所示。

4

啟動授權伺服器。

1. 
   

   以管理員權限運行 bin 目錄下的 server.exe 檔案。如下圖所示。

2. 在授權伺服器上，解壓商務傳送的授權檔案壓縮包 FanruanLicenseServer.zip。

3. 以管理者權限運作 bin 目錄下的 server.exe 檔案。如下圖所示。

注1：若啟動失敗，報錯的原因是埠被佔用，那麼使用命令行啟動過程的時候，後面加參數-port 埠指定另外埠。

       範例：.server.exe -port 8088

注2：2021-10-13 及之後獲取的 server.exe檔案，支援啟動認證伺服器的時候指定語言，預設簡體中文，額外提供英文。

       啟動命令範例：.server.exe -port 8088 -language en

5

設定服務開機自啟動。

1. 授權伺服器上的運作的可執行檔案不能關閉，即 Windows下server.exe不能關閉。如果 Server 關掉，重新開啟是未登入的，需要重新執行 2.4 節操作。

2. 下載 SrvanyUI 服務管理工具：SrvanyUI_1.0.rar，解壓後，運作【SrvanyUI_1.0.exe】檔案並安裝 SrvanyUI。

3. 開啟 SrvanyUI 軟體，選擇【檔案】→【增加】，新增【自建服務】。

4. 服務名稱為【私有雲授權伺服器】，內部標識為【PrivateServer】，過程路徑選擇上文的【\FanruanLicenseServer\bin\server.exe】檔案，啟動方式為【自動】。如下圖一所示。

5. 點選確定運作即可，如下圖二所示。

注：設定成功後，服務會開機自啟，若需要更換私有雲，需要先把之前的停止。

6

報表伺服器驗證授權。

1. 報表工程部署在報表伺服器上，管理者登入數據決策系統，點選【管理系統】→【登入資訊】→【版本資訊】，點選【立即登入】。認證方式選擇【私有雲認證】，伺服器位址填寫上面授權伺服器顯示的 IP 和監聽埠，例如【https://172.16.63.131:8081】，點選【提交認證】，如下圖一所示。

2. 認證成功後，如下圖二所示。

注1：若提供了授權伺服器域名，則填寫授權伺服器域名，若未提供授權伺服器域名，則填寫 IP 。

注2：請確定報表伺服器可以存取授權伺服器。

注3：這裏的最大連結數表示同時能有幾個工程向授權伺服器申請授權登入。

注4：若認證失敗，檢查防火牆設定，開放對應埠或者關閉防火牆。

1

下載 machine 工具。

1. 點選下載 machine 工具，用於獲取授權伺服器資訊檔案。

注：一般情況下，64 位的 Linux 用 amd64，32 位的 Linux 用 i386。

      極少情況下（當物理機器使用的是 RISC 精簡指令集，低功耗 CPU）才使用 arm，具體跟使用硬體有關。

2

匯出授權伺服器信息。

1. 以 Linux_amd64 為例：

2. 將壓縮包上傳至授權伺服器，解壓生成 machine.file 檔案：【unzip linux_amd64.zip】。

3. 為 machine.file 檔案添加權限：【chmod 777 machine】。

4. 運行 machine.file 檔案，自動生成授權伺服器信息檔案，即 require 目錄下的 MachineInfo.rif 檔案：【./machine】。

注：本節操作必須要使用管理者帳號進行，否則會導緻啟動授權過程報錯，機器碼不匹配。

3

獲取授權檔案。

1. 請使用合同中指定的郵箱傳送登入資訊給 FineReport 商務【business@fanruan.com】，郵件格式如下。

2. 商務收到郵件，核實無誤後會生成授權檔案【FanruanLicenseServer.zip】，以郵件方式傳送給使用者。

3. 郵件内容如下表所示。

4

啟動授權伺服器。

1. 在授權伺服器上，解壓商務發送的授權檔案壓縮包 FanruanLicenseServer.zip。【unzip FanruanLicenseServer.zip】。

2. 解壓完成後，以管理員權限運行 bin 目錄下的 server。【nohup ./server &】。

3. 啟動認證伺服器成功。

注：如果是工具連結（xshell），在使用 nohup ./bin/server &命令行後，使用 exit 跳出登入。

      重新登入後可使用 ps -ef|grep server 命令查看是否運作在後臺，若成功運作則表示私有雲後臺啟動成功，僅要伺服器不關機則會一直運作 。

注：2021-10-13 及之後獲取的 server.exe 檔案，支援啟動認證伺服器的時候指定語言，預設簡體中文，額外提供英文。

       啟動命令範例：【./server -language en】。

5

報表伺服器驗證授權。

1. 報表工程部署在報表伺服器上，管理者登入數據決策系統，點選【管理系統】→【登入資訊】→【版本資訊】，點選【立即登入】。

2. 認證方式選擇【私有雲認證】，伺服器位址填寫上面授權伺服器顯示的 IP 和監聽埠，例如【https://172.16.63.131:8081】，點選【提交認證】。

3. 認證成功。
   

注1：若提供了授權伺服器域名，則填寫授權伺服器域名，若未提供授權伺服器域名，則填寫 IP 。

注2：請確定報表伺服器可以存取授權伺服器。

注3：這裏的最大連結數表示同時能有幾個工程向授權伺服器申請授權登入。

注4：若認證失敗，檢查防火牆設定，開放對應埠或者關閉防火牆。

1

下載 machine 工具。

1. 點選下載 machine 工具，用於獲取授權伺服器資訊檔案：Mac.zip。

2

匯出授權伺服器資訊。

1. 將壓縮包上傳至授權伺服器，解壓生成 machine.file 檔案：【unzip Mac.zip】。

2. 為 machine.file 檔案新增權限：【chmod 777 machine】。

3. 運作 machine.file 檔案，自動生成授權伺服器資訊檔案，即 require 目錄下的 MachineInfo.rif 檔案：【./machine】。

3

獲取授權檔案。

1. 請使用合同中指定的郵箱傳送登入資訊給 FineReport 商務【business@fanruan.com】，郵件格式如下。

2. 商務收到郵件，核實無誤後會生成授權檔案【FanruanLicenseServer.zip】，以郵件方式傳送給使用者。

3. 郵件内容如下表所示。

4

啟動授權伺服器。

1. 在授權伺服器上，解壓商務發送的授權檔案壓縮包 FanruanLicenseServer.zip。

2. 以管理員權限運行 bin 目錄下的 server 。

注：授權伺服器上運行的可執行檔案不要關閉，即 Mac 下 server 不能關閉。

注：2021-10-13 及之後獲取的 server.exe 檔案，支援啟動認證伺服器的時候指定語言，預設簡體中文，額外提供英文。

       啟動命令範例：./server -language en

5

報表伺服器驗證授權。

1. 報表工程部署在報表伺服器上，管理員登錄數據決策系統，點擊【管理系統】→【注冊信息】→【版本信息】，點擊【立即注冊】。

2. 認證方式選擇【私有雲認證]，伺服器地址填寫上面授權伺服器顯示的 IP 和監聽端口，例如https://172.16.63.131:8081，點擊【提交認證】。

3. 認證成功。
   

注1：若提供了授權伺服器域名，則填寫授權伺服器域名，若未提供授權伺服器域名，則填寫 IP 。

注2：請确保報表伺服器可以訪問授權伺服器。

注3：這裏的最大連接數表示同時能有幾個工程向授權伺服器申請授權注冊。

注4：若認證失敗，檢查防火牆設定，開放對應端口或者關閉防火牆。

1

現象描述。

1. 若登入失敗，頁面將出現提示彈窗，如下圖所示。

2

失敗原因。

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

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

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

1

銷毀授權。

1. 首先，銷毀當前認證伺服器。以管理員身份進入 bin 目錄，再運行。

2. 在 Windows 中，開啟 cmd，切換到 bin 目錄下，運行命令如下所示：【.\server.exe -destroy】。

3. 在 Mac 和 Linux中，運行命令如下所示：【./server -destroy】。
   

2

獲得銷毀證據檔案。

1. 執行銷毀命令後，會銷毀當前的伺服器認證允許，並生成一個銷毀資訊的證據檔案。

注：在 Windows 中，有時候會報錯，得在與 bin 同級目錄建一個叫 uninstall 的資料夾，卸載檔案會在這個資料夾裏面出現。

3

重新注冊。

1. 客戶透過郵件發送給商務下面兩個檔案：【receipt.fr 】檔案和按照申請認證伺服器的步驟，重新生成【MachineInfo.rif】。

2. 商務收到【receipt.fr】檔案，驗證完成确認銷毀後，再給客戶發送新的認證伺服器檔案。

注：銷毀授權伺服器後，若重啟報表伺服器則立即注冊失敗；若未重啟報表伺服器則在約 24 小時後注冊失敗。