Saltar al contenido

Servidor proxy para agentes privados de Jitterbit

Introducción

Se puede configurar un agente privado para comunicarse a través de un servidor proxy. La forma de hacerlo depende de la plataforma de su agente y de si el agente ya está instalado y en funcionamiento. En cualquier caso, debe conocer los detalles del servidor proxy (nombre de host, número de puerto, credenciales de inicio de sesión). Estos se mencionan en las siguientes secciones mediante las palabras clave de marcador de posición que se muestran a continuación, las cuales debe reemplazar con los valores de su servidor proxy:

Palabra clave Valor
HOSTNAME Nombre de host o dirección IP.
PORT (Opcional.) Número de puerto. Predeterminado: 0.
USERNAME/PASSWORD (Opcional.) Nombre de usuario y contraseña para servidores que requieren autenticación.
NTLM_DOMAIN (Opcional.) Dominio NTLM para autenticación NTLM.

Consejo

Para un proxy HTTPS, debe agregar un certificado al almacén de claves de Java.

Nota

En el agente 12.7 y versiones posteriores, el servicio de métricas de observabilidad del agente utiliza esta configuración de proxy automáticamente.

Configurar un proxy durante la configuración del agente

Para configurar un proxy mientras se configura un agente, siga estos pasos:

  1. En la página de Credenciales de inicio de sesión del instalador estándar, haga clic en Habilitar Proxy.

  2. En la página de Información del Proxy, ingrese la información de su servidor proxy, seleccione las opciones que desee y luego haga clic en el botón Ok:

    Configuración del proxy

  3. Reinicie el agente.

No se puede configurar un servidor proxy antes de la configuración del agente y debe utilizar la línea de comandos o la utilidad de configuración después de la configuración del agente.

  1. En el paso Configurar, agrega los argumentos que se muestran a continuación al comando jitterbit-config antes de ejecutarlo:

    jitterbit-config --proxy-host HOSTNAME[:PORT] \
--proxy-user USERNAME \
--proxy-password PASSWORD \
--proxy-ntlm-domain NTLM_DOMAIN

  2. Reinicia el agente.

  1. Configura un proxy inverso.

  2. Configura Docker para usar un servidor proxy.

  3. Establece valores para las siguientes variables de entorno que se pasarán al entorno de tu contenedor (pasadas con las opciones -e/--env o --env-file):

    Variable de entorno Valor
    PROXY_SERVER_HOSTNAME HOSTNAME
    PROXY_SERVER_USERNAME USERNAME
    PROXY_SERVER_PASSWORD PASSWORD
    PROXY_SERVER_PORT PORT
    http_proxy http://host.docker.internal:8888
    https_proxy https://host.docker.internal:8888

  4. Inicia el contenedor usando registro manual y variables de entorno.

Configurar después de la configuración del agente

Para usar un proxy después de configurar un agente, sigue estos pasos:

Puedes configurar un proxy en la línea de comandos o con la utilidad de configuración:

  1. En un Símbolo del sistema o PowerShell, ejecuta el comando JitterbitUtils.exe:

    JitterbitUtils.exe --set-http-proxy-host HOSTNAME[:PORT] `
--set-http-proxy-username USERNAME `
--set-http-proxy-pwd PASSWORD `
--set-http-proxy-domain NTLM_DOMAIN

  2. Reinicia el agente.

  1. Selecciona Inicio > Jitterbit Agent > Configurar Jitterbit. Se abre la Utilidad de Configuración del Agente Jitterbit.

  2. Ingresa la información de tu servidor proxy, selecciona las opciones que desees y luego haz clic en el botón Aceptar:

    Configurar Jitterbit

  3. Reiniciar el agente.

  1. Ejecuta el comando jitterbit-utils:

    jitterbit-utils --set-http-proxy-host HOSTNAME[:PORT] \
--set-http-proxy-username USERNAME \
--set-http-proxy-pwd PASSWORD \
--set-http-proxy-domain NTLM_DOMAIN

  2. Reiniciar el agente.

Comunicándose a través de un proxy con un gateway API privado

Si estás utilizando un gateway API privado con una configuración de proxy de agente, debes especificar la dirección IP del host del gateway en el campo Excepciones o con la opción de línea de comandos --set-http-proxy-exceptions del comando jitterbit-utils.

Deshabilitar proxy

Para detener un agente privado de usar el servidor proxy configurado, sigue estos pasos:

  1. Ejecuta este comando:

    JitterbitUtils.exe --disable-http-proxy

  2. Reinicia el agente.

Nota

Esto no deshabilita un proxy NTLM. Para hacerlo, utiliza la utilidad de configuración.

  1. Selecciona Inicio > Agente Jitterbit > Configurar Jitterbit.

  2. Cuando se abra la Utilidad de Configuración del Agente Jitterbit, haz clic en el botón Limpiar, luego en el botón Aceptar.

  3. Reiniciar el agente.

  1. Ejecuta este comando:

    jitterbit-utils --disable-http-proxy

  2. Reiniciar el agente.