GroundRunners permite que los comandos en cadena interactúen con sistemas locales o fuentes de datos remotas a las que de otro modo no serían accesibles a través de Internet. Java 17 se incluye automáticamente con su instalación predeterminada 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 deshabilitar las bibliotecas compartidas predeterminadas de Workiva.
Requisitos
- Se recomienda un profesional de TI al utilizar un certificado personalizado. El soporte de Workiva no podrá ayudarle con esta instalación.
- Se requiere un sistema operativo compatible. Obtenga más información sobre los requisitos de GroundRunner.
- Algunos conectores no son compatibles con las bibliotecas compartidas de Workiva y deben utilizar la instalación Java del sistema GroundRunner. Vea la lista de exclusiones.
Importar el certificado personalizado
Al utilizar un certificado autofirmado o uno no emitido por una autoridad de certificación, sus GroundRunners deben utilizar el almacén de certificados del sistema.
Para importar un certificado:
- Comuníquese con su administrador de TI 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. Las ubicaciones válidas se enumeran a continuación.
Ubicaciones válidas
En versiones anteriores de GroundRunner, los certificados personalizados se leían desde el archivo cacerts en el directorio de instalación de JRE/JDK. Esta funcionalidad ha cambiado para que los certificados personalizados solo se puedan leer desde las siguientes ubicaciones.
Ubicaciones válidas:
- Windows-ROOT
- Windows-ROOT-LOCALMACHINE
- Usuario actual raíz de Windows
- Windows-MY
- Windows-MI-USUARIO-ACTUAL
- Windows-MI-MÁQUINA-LOCAL
Deshabilitar las bibliotecas compartidas de Workiva
Dentro de las cadenas, una "biblioteca compartida" es cualquier biblioteca externa o dependencia 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 agregarán dependencias adicionales según sea necesario.
Para deshabilitar las bibliotecas compartidas y sustituirlas por su propia biblioteca autoinstalada, agregue una nueva opción de configuración a su archivo GroundRunner.config :
ANULACIONES_DE_BIBLIOTECA_COMPARTIDA=java-17=/ruta/a/java17/inicio,java-21=/ruta/a/java21/inicio
La ruta proporcionada en esta anulación debe ser válida y debe contener una carpeta llamada bin que contenga los ejecutables relevantes. 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 muestra: ~/.asdf/installs/java/corretto-17.0.6.10.1 ❯ tree -L 1
.
├── INFORMACIÓN_ADICIONAL_DE_LICENCIA
├── EXCEPCIÓN_DE_ENSAMBLAJE [
├── LICENCIA
├── 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 cambio, la anulación en nuestro archivo GroundRunner.config se ve así:
OVERRIDES_DE_BIBLIOTECA_COMPARTIDA=java-17=/Usuarios/nombre_de_usuario/.asdf/instalaciones/java/corretto-17.0.6.10.1
Y en una máquina Windows, se vería así:
SHARED_LIBRARY_OVERRIDES=java-17=C:\Program Files\Java\jre-17
Nota: Asegúrese de que su instalación de Windows utilice barras invertidas en la ruta proporcionada.
Solución de problemas
El GroundRunner no arrancará 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 bibliotecas compartidas de Workiva y deben utilizar la instalación Java del sistema GroundRunner:
Estos conectores aún utilizan certificados personalizados leídos desde el archivo cacerts .