Los GroundRunners permiten a los comandos en cadena interactuar con sistemas locales o fuentes de datos remotas a las que, de otro modo, no se podría acceder a través de Internet. Java 17 se incluye automáticamente con la instalación por defecto de GroundRunner.
Para utilizar un certificado personalizado, un profesional de TI o alguien familiarizado con la configuración de red de su organización debe importar el certificado al almacén de certificados de su sistema y desactivar las bibliotecas compartidas predeterminadas de Workiva.
Requisitos
- Se recomienda recurrir a un profesional informático cuando se utilice un certificado personalizado. Workiva Support no podrá ayudarle con esta instalación.
- Se requiere un sistema operativo compatible. Más información sobre los requisitos de GroundRunner.
- Algunos conectores no son compatibles con las librerías compartidas de Workiva y deben utilizar la instalación Java del sistema GroundRunner. Consulte la lista de exclusión.
Importar el certificado personalizado
Cuando se utiliza un certificado autofirmado o uno no emitido por la Autoridad de Certificación, su GroundRunners debe utilizar el almacén de certificados del sistema.
Para importar un certificado:
- Póngase en contacto con su administrador informático para obtener una copia del certificado utilizado para proteger su sitio, o expórtelo desde su navegador.
- Importe el certificado al almacén de claves de certificados del sistema. A continuación se enumeran los lugares válidos.
Lugares válidos
En versiones anteriores de GroundRunner, los certificados personalizados se leían del archivo cacerts en el directorio de instalación de JRE/JDK. Esta funcionalidad ha cambiado para que los certificados personalizados sólo puedan leerse desde las siguientes ubicaciones.
Lugares válidos:
- Windows-ROOT
- Windows-ROOT-LOCALMACHINE
- Windows-ROOT-CURRENTUSER
- Windows-MY
- Windows-MY-CURRENTUSER
- Windows-MY-LOCALMACHINE
Desactivar las bibliotecas compartidas de Workiva
Dentro de las cadenas, una "biblioteca compartida" es cualquier biblioteca o dependencia externa necesaria para el correcto funcionamiento de un conector. Estas bibliotecas compartidas son mantenidas, actualizadas y distribuidas directamente por Workiva (con algunas excepciones). En este momento, Java 17 es nuestra única biblioteca compartida, pero se añadirán dependencias adicionales cuando sea necesario.
Para desactivar las bibliotecas compartidas y sustituirlas por su propia biblioteca autoinstalada, añada una nueva opción de configuración a su archivo GroundRunner.config:
SHARED_LIBRARY_OVERRIDES=java-17=/ruta/a/java/home
La ruta proporcionada en esta anulación debe ser válida, y debe contener una carpeta denominada bin que contenga los ejecutables pertinentes. Sin embargo, la ruta en sí no debe incluir el directorio bin.
Ejemplo
Considere la estructura de carpetas de una instalación de Java de ejemplo: ~/.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
Notarás la carpeta bin en nuestra estructura de archivos. Es importante destacar que este subdirectorio no está incluido en nuestra ruta proporcionada.
En su lugar, la anulación en nuestro GroundRunner.config archivo se parece a esto:
SHARED_LIBRARY_OVERRIDES=java-17=/Usuarios/nombre_usuario/.asdf/installs/java/corretto-17.0.6.10.1
Y en una máquina Windows, se vería algo así:
SHARED_LIBRARY_OVERRIDES=java-17=C:\Program Files\Java\jre-17
Nota: Asegúrese de que su instalación de Windows utiliza barras invertidas en la ruta proporcionada.
Solución de problemas
El GroundRunner no arranca si:
- Alguna de las rutas proporcionadas en su archivo de configuración no existe
- Las rutas no contienen un subdirectorio bin
Conectores excluidos
Estos conectores no son compatibles con las librerías compartidas de Workiva y deben utilizar la instalación Java del sistema GroundRunner:
Estos conectores siguen utilizando certificados personalizados leídos del archivo cacerts.