GroundRunners 使连锁命令能够与内部系统或无法通过互联网访问的远程数据源进行交互。Java 17 会自动包含在默认的GroundRunner 安装 中。
要使用自定义证书,IT 专业人员或熟悉贵组织网络设置的人员必须将证书导入系统的证书存储区,并禁用 Workiva 的默认共享库。
要求
- 使用自定义证书时,建议使用 IT 专业人员。Workiva 支持部门无法协助安装。
- 需要支持的操作系统。了解有关 GroundRunner 要求的更多信息。
- 某些连接器与 Workiva 的共享库不兼容,必须使用 GroundRunner 的系统 Java 安装。请参见排除列表。
导入自定义证书
使用自签名证书或非证书颁发机构颁发的证书时,GroundRunners 必须使用系统的证书存储。
导入证书:
- 请联系您的 IT 管理员,获取用于保护网站安全的证书副本,或从浏览器中导出证书。
- 将证书导入系统的证书密钥库。有效地点如下。
有效地点
在以前的 GroundRunner 版本中,自定义证书是从 JRE/JDK 安装目录中的cacerts 文件读取的。该功能已更改,因此只能从以下位置读取自定义证书。
有效地点:
- 视窗-ROOT
- Windows-ROOT-LOCALMACHINE
- Windows-ROOT-CURRENTUSER
- 视窗-MY
- Windows-MY-CURRENTUSER
- Windows-MY-LOCALMACHINE
禁用 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 棵树 -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-17= /Users/username/.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 文件读取的自定义证书。