Centrum wsparcia Workiva

GroundRunners umożliwia komendom łańcuchowym interakcję z systemami lokalnymi lub zdalnymi źródłami danych, które w innym przypadku nie byłyby dostępne przez Internet. 

Aby użyć niestandardowego certyfikatu, specjalista IT lub inna osoba zaznajomiona z ustawieniami sieciowymi Twojej organizacji musi zaimportować certyfikat do magazynu certyfikatów systemu i wyłączyć domyślne biblioteki współdzielone Workiva.

Wymagania

• W przypadku korzystania z certyfikatu niestandardowego zalecane jest skorzystanie z pomocy specjalisty IT. Pomoc techniczna Workiva nie będzie w stanie pomóc w tej instalacji.
• Wymagany jest obsługiwany system operacyjny.
• Środowisko Java Runtime Environment (JRE) nie jest instalowane wraz z GroundRunner podczas początkowej instalacji GroundRunner. Po zakończeniu konfiguracji i uruchomieniu GroundRunner automatycznie pobierze środowisko JRE potrzebne do uruchamiania poleceń zależnych od języka Java. Nie jest wymagana instalacja ani interwencja administratora, a pobrane JRE nie wpłynie na istniejące instalacje JRE, jeśli istnieją na hoście. Dowiedz się więcej o wymaganiach GroundRunner.
• Niektóre konektory nie są kompatybilne ze współdzielonymi bibliotekami Workiva i muszą korzystać z instalacji Java systemu GroundRunner. Zobacz listę wykluczeń.

Zaimportuj certyfikat niestandardowy

W przypadku korzystania z samodzielnie podpisanego certyfikatu lub certyfikatu, który nie został wydany przez urząd certyfikacji, GroundRunners musi korzystać z magazynu certyfikatów systemu.

Aby zaimportować certyfikat:

1. Skontaktuj się z administratorem IT, aby uzyskać kopię certyfikatu używanego do zabezpieczenia witryny lub wyeksportuj go z przeglądarki.
2. Zaimportuj certyfikat do magazynu kluczy certyfikatów systemu. Ważne lokalizacje są wymienione poniżej.

Ważne lokalizacje

W poprzednich wersjach GroundRunner niestandardowe certyfikaty były odczytywane z pliku cacerts w katalogu instalacyjnym JRE/JDK. Funkcjonalność ta została zmieniona w taki sposób, że certyfikaty niestandardowe mogą być odczytywane tylko z następujących lokalizacji.

Wyłącz biblioteki współdzielone Workiva

W łańcuchach "współdzielona biblioteka" to dowolna zewnętrzna biblioteka lub zależność wymagana do prawidłowego działania łącznika. Te współdzielone biblioteki są utrzymywane, aktualizowane i dystrybuowane bezpośrednio przez Workiva (z kilkoma wyjątkami). W tej chwili Java 21 jest naszą jedyną współdzieloną biblioteką, ale w razie potrzeby mogą zostać dodane dodatkowe zależności.

Aby wyłączyć współdzielone biblioteki i zastąpić je własnymi, dodaj nową opcję konfiguracji do pliku GroundRunner.config:

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

Ścieżka podana w tym nadpisaniu musi być prawidłowa i musi zawierać folder o nazwie bin, który zawiera odpowiednie pliki wykonywalne. Jednak sama ścieżka nie powinna zawierać katalogu bin.

Przykład

Rozważ strukturę folderów przykładowej instalacji Java: ~/.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

Zauważysz folder bin w naszej strukturze plików. Co ważne, podkatalog ten nie jest zawarty w podanej przez nas ścieżce.

Zamiast tego, nadpisanie w naszym pliku GroundRunner.config wygląda następująco:

 SHARED_LIBRARY_OVERRIDES=java-21=/Users/username/.asdf/installs/java/corretto-21.0.6.10.1

Na komputerze z systemem Windows wyglądałoby to mniej więcej tak:

SHARED_LIBRARY_OVERRIDES=java-21=C:\Program Files\Java\jre-21

Uwaga: Upewnij się, że instalacja systemu Windows używa odwrotnych ukośników w podanej ścieżce.

Rozwiązywanie problemów

GroundRunner nie uruchomi się, jeśli:

• Żadna ze ścieżek podanych w twoim pliku konfiguracyjnym nie istnieje
• Ścieżki nie zawierają podkatalogu bin

Wyłączone złącza

Konektory te nie są kompatybilne ze współdzielonymi bibliotekami Workiva i muszą korzystać z instalacji Java systemu GroundRunner:

• Oracle Essbase
• Oracle Hyperion Financial Management (HFM)

Te łączniki nadal używają niestandardowych certyfikatów odczytanych z pliku cacerts.

Uwaga: Gdy "obsługiwane" konektory są wykonywane na tym samym GroundRunnerze co wykluczony konektor, obsługiwane konektory będą nadal domyślnie korzystać ze współdzielonych bibliotek Workiva. Możesz to zastąpić, konfigurując opcję SHARED_LIBRARY_OVERRIDES opisaną szczegółowo w tym artykule.