Portail de support Workiva

Les GroundRunners permettent aux chaînes de commandement d'interagir avec des systèmes sur site ou des sources de données distantes qui ne sont pas accessibles par l'internet. 

Pour utiliser un certificat personnalisé, un professionnel de l'informatique ou une personne connaissant les paramètres du réseau de votre entreprise doit importer le certificat dans le magasin de certificats de votre système et désactiver les bibliothèques partagées par défaut de Workiva.

Exigences

• Il est recommandé de faire appel à un professionnel de l'informatique lors de l'utilisation d'un certificat personnalisé. Le service d'assistance de Workiva ne sera pas en mesure de vous aider pour cette installation.
• Un système d'exploitation compatible est nécessaire.
• Un environnement d’exécution Java (JRE) n’est pas installé avec le GroundRunner lors de l’installation initiale du GroundRunner. Une fois l’installation terminée et le GroundRunner en marche, il téléchargera automatiquement un JRE si nécessaire pour exécuter les commandes qui dépendent de Java. Aucune installation ou intervention de l’administrateur n’est nécessaire, et le JRE récupéré n’affectera pas les installations JRE existantes si elles existent sur l’hôte. En savoir plus sur les exigences de GroundRunner.
• Certains connecteurs ne sont pas compatibles avec les bibliothèques partagées de Workiva et doivent utiliser l'installation Java du système GroundRunner. Voir la liste des exclusions.

Importer le certificat personnalisé

Lors de l'utilisation d'un certificat auto-signé ou non émis par une autorité de certification, vos GroundRunners doivent utiliser le magasin de certificats du système.

Pour importer un certificat :

1. Contactez votre administrateur informatique pour obtenir une copie du certificat utilisé pour sécuriser votre site, ou exportez-le depuis votre navigateur.
2. Importer le certificat dans la base de données des certificats du système. Les lieux valables sont énumérés ci-dessous.

Emplacements valables

Dans les versions précédentes de GroundRunner, les certificats personnalisés étaient lus à partir du fichier cacerts dans le répertoire d'installation JRE/JDK. Cette fonctionnalité a été modifiée de sorte que les certificats personnalisés ne peuvent être lus qu'à partir des emplacements suivants.

Désactiver les bibliothèques partagées de Workiva

Dans les chaînes, une "bibliothèque partagée" est une bibliothèque externe ou une dépendance nécessaire au bon fonctionnement d'un connecteur. Ces bibliothèques partagées sont maintenues, mises à jour et distribuées directement par Workiva (à quelques exceptions près). À l’heure actuelle, Java 21 est notre seule bibliothèque partagée, mais d’autres dépendances peuvent être ajoutées si nécessaire.

Pour désactiver les bibliothèques partagées et leur substituer votre propre bibliothèque, ajoutez une nouvelle option de configuration à votre fichier GroundRunner.config:

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

Le chemin fourni dans cette dérogation doit être valide et doit contenir un dossier nommé bin qui contient les exécutables appropriés. Cependant, le chemin lui-même ne doit pas inclure le répertoire bin.

Exemple

Considérez la structure de dossier d’un exemple d’installation 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

Vous remarquerez le dossier bin dans notre structure de fichiers. Il est important de noter que ce sous-répertoire n'est pas inclus dans le chemin d'accès que nous avons fourni.

Au lieu de cela, l'override dans notre fichier GroundRunner.config ressemble à ceci :

 SHARED_LIBRARY_OVERRIDES=java-21=/Users/username/.asdf/installs/java/corretto-21,0.6,10.1

Sur une machine Windows, il ressemblerait à quelque chose comme ceci :

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

Note : Assurez-vous que votre installation Windows utilise des barres obliques inverses dans le chemin fourni.

Dépannage

Le GroundRunner ne démarre pas si :

• L'un des chemins fournis dans votre fichier de configuration n'existe pas.
• Les chemins ne contiennent pas de sous-répertoire bin

Connecteurs exclus

Ces connecteurs ne sont pas compatibles avec les bibliothèques partagées de Workiva et doivent utiliser l'installation Java du système GroundRunner :

• Oracle Essbase
• Oracle Hyperion Financial Management (HFM)

Ces connecteurs utilisent toujours des certificats personnalisés lus à partir du fichier cacerts.

Note: Lorsque des connecteurs "supportés" sont exécutés sur le même GroundRunner qu'un connecteur exclu, les connecteurs supportés utiliseront toujours les bibliothèques partagées de Workiva par défaut. Vous pouvez passer outre en configurant l'option SHARED_LIBRARY_OVERRIDES détaillée dans cet article.