Centro de soporte de Workiva

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. 

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.
• No se ha instalado un entorno de ejecución de Java (JRE) con GroundRunner durante la instalación inicial de GroundRunner. Una vez que se haya completado la instalación y el GroundRunner se esté ejecutando, descargará automáticamente una JRE según sea necesario para ejecutar comandos que dependan de Java. No se requiere instalación ni intervención del administrador, y el JRE recuperado no afectará a las instalaciones existentes de JRE si existen en el host. 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:

1. Ponerse en contacto con el administrador informático para obtener una copia del certificado utilizado para proteger el sitio, o exportarlo desde el navegador.
2. 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.

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 añadirse 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/hacia/java21/home,java-24=/ruta/hacia/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-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

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_de_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úrate de que tu 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:

• Oracle Essbase
• Oracle Hyperion Gestión Financiera (HFM)

Estos conectores siguen utilizando certificados personalizados leídos desde el archivo cacerts.

Nota: Cuando los conectores "compatibles" se ejecutan en el mismo GroundRunner que un conector excluido, los conectores compatibles seguirán utilizando las Bibliotecas compartidas de Workiva de forma predeterminada. Puedes Invalidar esto configurando la opción SHARED_LIBRARY_OVERRIDES detallada en este artículo.