GroundRunners 可讓連鎖指令與內部系統或無法透過網際網路存取的遠端資料來源互動。
要使用自訂憑證,IT 專業人員或熟悉貴機構網路設定的人員必須將憑證匯入系統的憑證存放區,並停用 Workiva 的預設共用程式庫。
要求
- 使用自訂證書時,建議由 IT 專業人員協助。Workiva 支援將無法協助此安裝。
- 需要支援的作業系統。
- 在初始化安裝 GroundRunner 時,GroundRunner 並未安裝 Java Runtime Environment (JRE)。 設定完成且 GroundRunner 執行後,它會自動下載所需的 JRE,以執行從屬 (參照) Java 的命令。不需要安裝或管理員介入,且擷取的 JRE 不會影響主機上已有的 JRE 安裝。 進一步了解 GroundRunner 的更多資訊。
- 某些連接器與 Workiva 的共用程式庫不相容,必須使用 GroundRunner 的系統 Java 安裝。請參閱排除清單。
匯入自訂證書
當使用自簽憑證或非由憑證授權機構簽發的憑證時,您的 GroundRunners 必須使用系統的憑證存放區。
要匯入證書
- 聯絡您的 IT 管理員,取得用於保護網站的憑證副本,或從瀏覽器匯出。
- 將憑證匯入系統的憑證核心。有效位置如下。
有效位置
在以前的 GroundRunner 版本中,自訂憑證是從 JRE/JDK 安裝目錄中的cacerts 檔案讀取。此功能已變更,自訂憑證只能從下列位置讀取。
有效位置:
- Windows-ROOT
- Windows-ROOT-LOCALMACHINE
- Windows-ROOT-CURRENTUSER
- Windows-MY
- Windows-MY-CURRENTUSER
- Windows-MY-LOCALMACHINE
停用 Workiva 共用程式庫
在鏈中,「共享庫 」是連接器正常功能所需的任何外部庫或相依性。這些共用程式庫由 Workiva 直接維護、更新與散佈 (,少數例外)。目前,Java 21 是我們唯一的共用函式庫,但必要時可能會增加額外的相依性。
若要停用共用函式庫,並以您自己安裝的函式庫取代,請在GroundRunner.config 檔案中加入新的設定選項:
SHARED_LIBRARY_OVERRIDES=java-21=/path/to/java21/home,java-24=/path/to/java24/home此覆寫提供的路徑 必須有效,且必須包含一個名為bin 的資料夾,其中包含相關的可執行檔案。但是,路徑本身不應該包含 bin 目錄。
範例
考慮 Java 安裝範例的資料夾結構:~/.asdf/installs/java/corretto-21.0.6.10.1 樹 -L 1
.├── ADDITIONAL_LICENSE_INFO ├── ASSEMBLY_EXCEPTION ├─ LICENSE ├─ README.md ├─ bin ├─ commitId.txt ├─ conf ├─ include ├─ jmods ├─ legal ├─ lib ├─ man ├─ release └── version.txt .您會注意到檔案結構中的 bin 資料夾。重要的是,這個子目錄並未包含在我們提供的路徑中。
取而代之,我們的 GroundRunner.config 檔案中的覆寫如下:
SHARED_LIBRARY_OVERRIDES=java-21=/Users/username/.asdf/installs/java/corretto-21.0.6.10.1在 Windows 機器上,它會看起來像這樣:
SHARED_LIBRARY_OVERRIDES=java-21=C:\Program Files\Java\jre-21附註: 請確定您的 Windows 安裝在提供者路徑中使用了反斜線。
疑難排解
如果出現下列情況,GroundRunner 將不會啟動:
- 設定檔中提供的任何路徑不存在
- 路徑不包含bin子目錄
排除的連接器
這些連線器與 Workiva 的共用程式庫不相容,必須使用 GroundRunner 的系統 Java 安裝:
這些連線器仍使用從cacerts 檔案讀取的自訂憑證。