Ir para o conteúdo

Servidor proxy para agentes privados Jitterbit

Introdução

Você pode configurar um agente privado para se comunicar através de um servidor proxy. Como fazer isso depende da plataforma do seu agente e se o agente já está instalado e em execução. Em qualquer caso, você deve conhecer os detalhes do servidor proxy (nome do host, número da porta, credenciais de login). Estes são referidos nas seções seguintes pelos palavras-chave de espaço reservado mostradas abaixo, que você deve substituir pelos valores do seu servidor proxy:

Palavra-chave Valor
HOSTNAME Nome do host ou endereço IP.
PORT (Opcional.) Número da porta. Padrão: 0.
USERNAME/PASSWORD (Opcional.) Nome de usuário e senha para servidores que requerem autenticação.
NTLM_DOMAIN (Opcional.) Domínio NTLM para autenticação NTLM.

Dica

Para um proxy HTTPS, você deve adicionar um certificado ao Java keystore.

Nota

No agente 12.7 e versões posteriores, o serviço de métricas de observabilidade do agente usa essa configuração de proxy automaticamente.

Configurar um proxy durante a configuração do agente

Para configurar um proxy enquanto configura um agente, siga estas etapas:

  1. Na página Credenciais de Login do instalador padrão, clique em Habilitar Proxy.

  2. Na página Informações do Proxy, insira as informações do seu servidor proxy, selecione as opções desejadas e clique no botão Ok:

    Configurar proxy

  3. Reinicie o agente.

Você não pode configurar um servidor proxy antes da configuração do agente e deve usar a linha de comando ou a ferramenta de configuração após a configuração do agente.

  1. No passo Configurar, adicione os argumentos mostrados abaixo ao comando jitterbit-config antes de executá-lo:

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

  2. Reinicie o agente.

  1. Configure um proxy reverso.

  2. Configure o Docker para usar um servidor proxy.

  3. Defina valores para as seguintes variáveis de ambiente que serão passadas para o ambiente do seu contêiner (passadas com as opções -e/--env ou --env-file):

    Variável de ambiente 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. Inicie o contêiner usando registro manual e variáveis de ambiente.

Configurar após a configuração do agente

Para usar um proxy após configurar um agente, siga estas etapas:

Você pode configurar um proxy na linha de comando ou com a utilidade de configuração:

  1. Em um Prompt de Comando ou PowerShell, execute o 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. Reinicie o agente.

  1. Selecione Iniciar > Agente Jitterbit > Configurar Jitterbit. O Utilitário de Configuração do Agente Jitterbit será aberto.

  2. Insira as informações do seu servidor proxy, selecione as opções desejadas e clique no botão OK:

    Configurar Jitterbit

  3. Reinicie o agente.

  1. Execute o 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. Reinicie o agente.

Comunicando-se via um proxy com um gateway de API privado

Se você estiver usando um gateway de API privado com uma configuração de proxy de agente, deve especificar o endereço IP do host do gateway no campo Exceções ou com a opção de linha de comando --set-http-proxy-exceptions do jitterbit-utils.

Desativar proxy

Para impedir que um agente privado use o servidor proxy configurado, siga estas etapas:

  1. Execute este comando:

    JitterbitUtils.exe --disable-http-proxy

  2. Reinicie o agente.

Nota

Isso não desativa um proxy NTLM. Para fazer isso, use a utilidade de configuração.

  1. Selecione Iniciar > Agente Jitterbit > Configurar Jitterbit.

  2. Quando a Utilidade de Configuração do Agente Jitterbit abrir, clique no botão Limpar e, em seguida, no botão OK.

  3. Reinicie o agente.

  1. Execute este comando:

    jitterbit-utils --disable-http-proxy

  2. Reinicie o agente.