Los GroundRunner permiten que los comandos en cadena interactúen con sistemas locales o fuentes de datos remotas a las que no se puede acceder de otro modo a través de Internet. Java 21 se incluye automáticamente con tu instalación por defecto de GroundRunner.
Para utilizar un certificado personalizado, un profesional informático o alguien familiarizado con la configuración de red de tu organización debe importar el certificado al almacén de certificados de tu sistema y deshabilitar las Bibliotecas compartidas predeterminadas de Workiva.
Requisitos
- Se recomienda recurrir a un profesional informático cuando se utilice un certificado a medida. El Soporte técnico de Workiva no podrá ayudarte con esta instalación.
- Se requiere un sistema operativo compatible. Más información: requisitos de GroundRunner.
- Algunos conectores no son compatibles con las Bibliotecas compartidas de Workiva y deben utilizar la instalación Java del sistema de GroundRunner. Consulta la lista de exclusión.
Importar el certificado personalizado
Cuando utilices un certificado autofirmado o no emitido por una Autoridad de Certificación, tus GroundRunners deben utilizar el almacén de certificados del sistema.
Para importar un certificado:
- Ponerse en contacto con el administrador informático para obtener una copia del certificado utilizado para proteger el sitio, o exportarlo desde el navegador.
- Importa el certificado al almacén de claves de certificados del sistema. A continuación se enumeran las ubicaciones válidas.
Ubicaciones válidas
En versiones anteriores de GroundRunner, los certificados personalizados se leían desde el archivo cacerts del directorio de instalación JRE/JDK. Esta funcionalidad ha cambiado para que los certificados personalizados sólo puedan leerse desde las siguientes ubicaciones.
Ubicaciones válidas:
- Windows-ROOT
- Windows-ROOT-LOCALMACHINE
- Windows-ROOT-CURRENTUSER
- Windows-MY
- Windows-MY-CURRENTUSER
- windows-mi-máquina-local
Deshabilitar las bibliotecas compartidas de Workiva.
Dentro de las Cadenas, una "biblioteca compartida" es cualquier biblioteca o dependencia externa necesaria para la correcta función de un conector. Estas Bibliotecas compartidas son mantenidas, actualizadas y distribuidas directamente por Workiva (con algunas excepciones). En este momento, Java 21 es nuestra única biblioteca compartida, pero pueden agregarse dependencias adicionales según sea necesario.
Para deshabilitar las Bibliotecas compartidas y sustituirlas por tu propia biblioteca autoinstalada, añade una nueva opción de configuración a tu archivo GroundRunner.config:
SHARED_LIBRARY_OVERRIDES=java-21=/ruta/a/java21/home,java-24=/ruta/a/java24/home
La ruta proporcionada en este invalidar debe ser válida, y debe contener una carpeta llamada bin que contenga los ejecutables pertinentes. Sin embargo, la propia ruta no debe incluir el directorio bin.
Ejemplo
Considera la estructura de carpetas de un ejemplo de instalación de 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
Verás la carpeta bin en nuestra estructura de archivos. Es importante señalar que este subdirectorio no está incluido en nuestra ruta proporcionada.
En cambio, la invalidación en nuestro archivo GroundRunner.config tiene este aspecto:
SHARED_LIBRARY_OVERRIDES=java-21=/Usuarios/nombre_usuario/.asdf/installs/java/corretto-21.0.6.10.1
Y en una máquina Windows, sería algo parecido a esto:
SHARED_LIBRARY_OVERRIDES=java-21=C:\Program Files\Java\jre-21
Nota: Asegúrese de que su instalación de Windows utiliza barras invertidas en la ruta proporcionada.
Solución de problemas
El GroundRunner no arrancará si:
- Cualquiera de las rutas proporcionadas en tu archivo de configuración no existe.
- Las rutas no contienen un subdirectorio bin
Conectores excluidos
Estos conectores no son compatibles con las Bibliotecas compartidas de Workiva y deben utilizar la instalación Java del sistema GroundRunner:
Estos conectores siguen utilizando certificados personalizados leídos desde el archivo cacerts.