GroundRunnersは、チェーンコマンドがインターネット経由でアクセスできないオンプレミスのシステムやリモートのデータソースと相互作用することを可能にする。Java 17 は、デフォルトのGroundRunner インストール に自動的に含まれています。
カスタム証明書を使用するには、IT専門家、または組織のネットワーク設定に詳しい誰かが、証明書をシステムの証明書ストアにインポートし、Workivaのデフォルト共有ライブラリを無効にする必要があります。
要件
- カスタム証明書を使用する場合は、IT専門家に依頼することを推奨する。Workivaサポートはこのインストールをサポートすることはできません。
- サポートされているオペレーティングシステムが必要です。GroundRunnerの要件については、こちらをご覧ください。
- 一部のコネクタは、Workivaの共有ライブラリと互換性がないため、GroundRunnerのシステムJavaインストールを使用する必要があります。除外リストを参照。
カスタム証明書をインポートする
自己署名証明書または認証局が発行していない証明書を使用する場合、GroundRunnersはシステムの証明書ストアを使用する必要があります。
証明書をインポートするには
- IT管理者に連絡して、サイトのセキュリティに使用されている証明書のコピーを入手するか、ブラウザからエクスポートしてください。
- 証明書をシステムの証明書キーストアにインポートする。有効な場所は以下の通り。
有効なロケーション
以前のバージョンのGroundRunnerでは、カスタム証明書はJRE/JDKのインストール・ディレクトリにあるcacerts ファイルから読み込まれていました。この機能が変更され、カスタム証明書は以下の場所からのみ読み取れるようになった。
有効な場所
- ウィンドウズ・ルート
- 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 ❯ tree -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= /ユーザー名/.asdf/installs/java/corretto-17.0.6.10.1
そして、ウィンドウズ・マシンでは次のようになる：
SHARED_LIBRARY_OVERRIDES=java-17=C: \Program FilesJavajre-17
Note: Windowsインストールで、提供されたパスにバックスラッシュが使用されていることを確認する。
トラブルシューティング
以下の場合、GroundRunner は始動しません：
- 設定ファイルで指定されたパスのいずれかが存在しない。
- パスにはbinサブディレクトリが含まれない。
除外コネクタ
これらのコネクタは、Workivaの共有ライブラリとは互換性がないため、GroundRunnerのシステムJavaインストールを使用する必要があります：
これらのコネクタは、cacerts ファイルから読み込んだカスタム証明書を依然として使用しています。