GroundRunner 讓鏈命令能夠與無法透過網路存取的本機系統或遠端資料來源進行互動。Java 17 自動包含在您的預設 GroundRunner 安裝中。
若要使用自訂證書,IT 專業人員或熟悉組織網路設定的人員必須將證書匯入系統的證書儲存空間並停用 Workiva 的預設共用庫。
要求
- 使用自訂憑證時,建議 IT 專業人員進行。Workiva 支援將無法協助此安裝。
- 需要支援的作業系統。了解有關 GroundRunner 要求的更多資訊。
- 某些連接器與 Workiva 的共用程式庫不相容,必須使用 GroundRunner 的系統 Java 安裝。請參閱排除清單。
導入自訂證書
當使用自簽名憑證或非憑證授權單位頒發的憑證時,您的 GroundRunner 必須使用系統的憑證儲存。
導入證書:
- 請聯絡您的 IT 管理員以取得用於保護您的網站的憑證的副本,或從瀏覽器中將其匯出。
- 將憑證匯入系統的憑證金鑰庫。下面列出了有效位置。
有效地點
在先前的 GroundRunner 版本中,自訂憑證是從 JRE/JDK 安裝目錄中的 cacerts 檔案中讀取的。此功能已更改,因此只能從以下位置讀取自訂憑證。
有效地點:
- Windows-ROOT
- Windows 根本電腦
- Windows-ROOT-當前用戶
- Windows-MY
- Windows-我的目前用戶
- Windows-我的本機電腦
停用 Workiva 共享庫
在鏈中,「共享庫」是連接器正常功能所需的任何外部庫或相依性。這些共享庫由 Workiva 直接維護、更新和分發(,少數例外)。目前,Java 17 是我們唯一的共用程式庫,但將根據需要新增其他依賴項。
若要停用共用程式庫並取代您自己的自安裝程式庫,請在您的 GroundRunner.config 檔案中新增一個新的設定選項:
SHARED_LIBRARY_OVERRIDES=java-17=/path/to/java/home
此覆蓋中提供的 路徑 必須有效,並且它必須包含名為 bin 的資料夾,其中包含相關的可執行檔。但是,路徑本身不應包含 bin 目錄。
範例
考慮範例 Java 安裝的資料夾結構: ~/.asdf/installs/java/corretto-17.0.6.10.1 ❯ tree -L 1
。
├── ADDITIONAL_LICENSE_INFO
├── ASSEMBLY_EXCEPTION
├── LICENSE
] ├── README.md
├── bin
├── commitId
. ├── include
├── jmods
├── legal
├── lib
├── man
├── release
└── version.txt
您會注意到我們的檔案結構中的 bin 資料夾。重要的是,這個子目錄不包含在我們提供的路徑中。
相反,我們的 GroundRunner.config 檔案中的覆寫如下所示:
SHARED_LIBRARY_OVERRIDES=java-17=/Users/使用者名稱/.asdf/installs/java/corretto-17.0.6.10.1
在 Windows 機器上,它看起來像這樣:
SHARED_LIBRARY_OVERRIDES=java-17=C:\Program Files\Java\jre-17
注意:確保您的 Windows 安裝在提供的路徑中使用反斜線。
疑難排解
如果發生以下情況,GroundRunner 將不會啟動:
- 配置檔案中提供的任何路徑都不存在
- 路徑不包含 bin 子目錄
排除的連接器
這些連接器與 Workiva 的共用程式庫不相容,必須使用 GroundRunner 的系統 Java 安裝:
這些連接器仍然使用從 cacerts 檔案讀取的自訂憑證。