Workiva Support Center

GroundRunners ermöglichen die Interaktion von Kettenbefehlen mit Systemen vor Ort oder mit entfernten Datenquellen, die sonst nicht über das Internet zugänglich sind. 

Um ein benutzerdefiniertes Zertifikat zu verwenden, muss ein IT-Experte oder eine andere Person, die mit den Netzwerkeinstellungen Ihres Unternehmens vertraut ist, das Zertifikat in den Zertifikatspeicher Ihres Systems importieren und die standardmäßigen gemeinsamen Bibliotheken von Workiva deaktivieren.

Anforderungen

• Bei der Verwendung eines benutzerdefinierten Zertifikats wird ein IT-Fachmann empfohlen. Der Workiva Support kann bei dieser Installation nicht helfen.
• Ein unterstütztes Betriebssystem ist erforderlich.
• Eine Java-Laufzeitumgebung (JRE) wird bei der Erstinstallation des GroundRunners nicht mit installiert. Nachdem die Einrichtung abgeschlossen ist und der GroundRunner läuft, lädt er bei Bedarf automatisch eine JRE herunter, um Befehle auszuführen, die von Java abhängig sind. Eine Installation oder ein Eingriff des Administrators ist nicht erforderlich und die abgerufene JRE hat keine Auswirkungen auf bestehende JRE-Installationen, sofern diese auf dem Host vorhanden sind. Erfahren Sie mehr über die GroundRunner Anforderungen.
• Einige Konnektoren sind nicht mit Workiva's Shared Libraries kompatibel und müssen die GroundRunner's System Java Installation verwenden. Siehe die Ausschlussliste.

Importieren Sie das benutzerdefinierte Zertifikat

Wenn Sie ein selbstsigniertes Zertifikat oder ein nicht von einer Zertifizierungsstelle ausgestelltes Zertifikat verwenden, müssen Ihre GroundRunner den Zertifikatspeicher des Systems nutzen.

So importieren Sie ein Zertifikat:

1. Wenden Sie sich an Ihren IT-Administrator, um eine Kopie des Zertifikats zu erhalten, das zur Sicherung Ihrer Website verwendet wird, oder exportieren Sie es aus Ihrem Browser.
2. Importieren Sie das Zertifikat in den Zertifikats-Keystore des Systems. Die gültigen Standorte sind unten aufgeführt.

Gültige Standorte

In früheren GroundRunner-Versionen wurden benutzerdefinierte Zertifikate aus der Datei cacerts im JRE/JDK-Installationsverzeichnis gelesen. Diese Funktionalität wurde so geändert, dass benutzerdefinierte Zertifikate nur noch von den folgenden Orten gelesen werden können.

Deaktivieren Sie die gemeinsamen Bibliotheken von Workiva

Innerhalb von Ketten ist eine "gemeinsam genutzte Bibliothek" jede externe Bibliothek oder Abhängigkeit, die für die ordnungsgemäße Funktion eines Verbinders erforderlich ist. Diese gemeinsam genutzten Bibliotheken werden direkt von Workiva gepflegt, aktualisiert und verteilt (mit einigen Ausnahmen). Zur Zeit ist Java 21 unsere einzige gemeinsam genutzte Bibliothek, aber weitere Abhängigkeiten können bei Bedarf hinzugefügt werden.

Um gemeinsam genutzte Bibliotheken zu deaktivieren und Ihre eigene, selbst installierte Bibliothek zu ersetzen, fügen Sie eine neue Konfigurationsoption zu Ihrer GroundRunner.config Datei hinzu:

SHARED_LIBRARY_OVERRIDES=java-21=/path/to/java21/home,java-24=/path/to/java24/home

Der in dieser Überschreibung angegebene Pfad muss gültig sein und einen Ordner namens bin enthalten, der die entsprechenden ausführbaren Dateien enthält. Der Pfad selbst sollte jedoch nicht das Verzeichnis bin enthalten.

Beispiel

Betrachten Sie die Ordnerstruktur einer Java-Beispielinstallation: ~/.asdf/installs/java/corretto-21.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

Sie werden den Ordner bin in unserer Dateistruktur bemerken. Wichtig ist, dass dieses Unterverzeichnis nicht in unserem angegebenen Pfad enthalten ist.

Stattdessen sieht die Überschreibung in unserer Datei GroundRunner.config wie folgt aus:

 SHARED_LIBRARY_OVERRIDES=java-21=/Benutzer/Benutzername/.asdf/installs/java/corretto-21.0.6.10.1

Auf einem Windows-Rechner würde das in etwa so aussehen:

SHARED_LIBRARY_OVERRIDES=java-21=C:\Programmdateien\Java\jre-21

Hinweis: Stellen Sie sicher, dass Ihre Windows-Installation Backslashes im angegebenen Pfad verwendet.

Fehlerbehebung

Der GroundRunner lässt sich nicht starten, wenn:

• Einer der in Ihrer Konfigurationsdatei angegebenen Pfade existiert nicht
• Die Pfade enthalten keine bin Unterverzeichnisse

Ausgeschlossene Anschlüsse

Diese Konnektoren sind nicht kompatibel mit Workiva's Shared Libraries und müssen die GroundRunner's System Java Installation verwenden:

• Oracle Essbase
• Oracle Hyperion Financial Management (HFM)

Diese Konnektoren verwenden weiterhin benutzerdefinierte Zertifikate, die aus der Datei cacerts gelesen werden.

Hinweis: Wenn "unterstützte" Konnektoren auf demselben GroundRunner wie ein ausgeschlossener Konnektor ausgeführt werden, verwenden die unterstützten Konnektoren weiterhin standardmäßig die gemeinsamen Bibliotheken von Workiva. Sie können dies außer Kraft setzen, indem Sie die Option SHARED_LIBRARY_OVERRIDES konfigurieren, wie in diesem Artikel beschrieben.