GroundRunner 使链式命令能够与本地系统或无法通过互联网访问的远程数据源进行交互。
要使用自定义证书,IT 专业人员或熟悉贵组织网络设置的人员必须将证书导入到系统的证书存储中,并禁用 Workiva 的默认共享库。
要求
- 使用自定义证书时,建议咨询IT专业人员。Workiva 技术支持无法协助进行此次安装。
- 需要使用受支持的操作系统。
- 在 GroundRunner 的初始安装过程中,不会安装 Java 运行时环境 (JRE)。安装完成后,GroundRunner 开始运行,它会根据需要自动下载 JRE 来运行依赖于 Java 的命令。无需安装或管理员干预,检索到的 JRE 不会影响主机上已存在的 JRE 安装。了解更多关于 GroundRunner 的要求。
- 某些连接器与 Workiva 的共享库不兼容,必须使用 GroundRunner 的系统 Java 安装。请查看排除列表。
导入自定义证书
当使用自签名证书或非证书颁发机构颁发的证书时,您的 GroundRunner 必须使用系统的证书存储。
导入证书:
- 请联系您的 IT 管理员获取用于保护您网站的证书副本,或者从您的浏览器中导出该证书。
- 将证书导入系统证书密钥库。有效地点如下所示。
有效地点
在之前的 GroundRunner 版本中,自定义证书是从 JRE/JDK 安装目录中的 cacerts 文件读取的。此功能已更改,现在只能从以下位置读取自定义证书。
有效地点:
- Windows-ROOT
- Windows-ROOT-LOCALMACHINE
- Windows-ROOT-CURRENTUSER
- Windows-MY
- Windows-我的-当前用户
- Windows-我的本地计算机
禁用 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 ❯ tree -L 1
. ├── 附加许可信息 ├── 程序集异常 ├── 许可 ├── 自述文件.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 文件中读取的自定义证书。