Configurar o proxy de encaminhamento do Edge para um servidor de back-end

Edge para nuvem privada v. 4.17.01

Se você quiser usar um proxy de encaminhamento HTTP entre o Edge e os servidores de destino do back-end, será necessário configurar as propriedades de configurações de proxy de saída nos nós do processador de mensagens do Edge. Essas propriedades configuram os processadores de mensagens para rotear solicitações de destino do Edge para o proxy de encaminhamento HTTP.

Para configurar o processador de mensagens, edite o arquivo /opt/apigee/customer/application/message-processor.properties e reinicie o processador de mensagens. Se o arquivo message-processor.properties não existir, crie-o.

Defina as seguintes propriedades para configurar o processador de mensagens:

Propriedade

Descrição

conf_http_HTTPClient.use.proxy

Especifica se todos os proxies de API usam o proxy de encaminhamento por padrão, true, ou não o usam por padrão, false.

conf_http_HTTPClient.use.tunneling

Por padrão, o Edge usa o encapsulamento para todo o tráfego. Para desativar o roteamento em túneis por padrão, defina essa propriedade como false.

conf/http.properties+HTTPClient.proxy.type

Especifica o tipo do proxy HTTP como HTTP ou HTTPS. Por padrão, ele usa HTTP.

conf/http.properties+HTTPClient.proxy.host (link em inglês)

Especifica o nome do host ou o endereço IP em que o proxy HTTP está em execução.

conf/http.properties+HTTPClient.proxy.port (link em inglês)

Especifica a porta em que o proxy HTTP está sendo executado. Se esta propriedade for omitida, por padrão, usará a porta 80 para HTTP e a porta 443 para HTTPS.

conf/http.properties+HTTPClient.proxy.user
conf/http.properties+HTTPClient.proxy.password

Se o proxy HTTP exigir autenticação básica, use essas propriedades para fornecer detalhes de autorização.

Exemplo:

conf_http_HTTPClient.use.proxy=true
conf_http_HTTPClient.use.tunneling=false
conf/http.properties+HTTPClient.proxy.type=HTTP
conf/http.properties+HTTPClient.proxy.host=my.host.com
conf/http.properties+HTTPClient.proxy.port=3128
conf/http.properties+HTTPClient.proxy.user=uName
conf/http.properties+HTTPClient.proxy.password=pWord

Não se esqueça de reiniciar o processador de mensagens depois de definir estas propriedades:

/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

Se o encaminhamento de proxy estiver configurado para o processador de mensagens, todo o tráfego que flui dos proxies de API para os destinos de back-end vai passar pelo proxy de encaminhamento HTTP especificado. Se o tráfego de um destino específico de um proxy de API precisar ir diretamente para o destino do back-end, ignorando o proxy de encaminhamento, defina a seguinte propriedade no endpoint de destino para substituir o proxy de encaminhamento HTTP:

<Property name="use.proxy">false</Property> 

Consulte a Referência de propriedades do endpoint para mais informações sobre como definir propriedades no endpoint de destino.

Se você não quiser que nenhum destino use o proxy de encaminhamento HTTP por padrão, especifique http.properties conforme abaixo:

conf_http_HTTPClient.use.proxy=false

Em seguida, defina use.proxy como verdadeiro para qualquer TargetEndpoint que você queira passar por um proxy de encaminhamento HTTP:

<Property name="use.proxy">true</Property>

Por padrão, o Edge usa o encapsulamento para o tráfego do proxy. Para desativar o encapsulamento por padrão, defina a seguinte propriedade no arquivo message-processor.properties:

conf_http_HTTPClient.use.tunneling=false 

Se for um destino específico, se você quiser desativar o encapsulamento, defina a propriedade use.proxy.tunneling no endpoint de destino. Se o destino usar TLS/SSL, essa propriedade será ignorada e a mensagem será sempre enviada por um túnel:

<Property name="use.proxy.tunneling">false</Property>

Para que o Edge atue como proxy de encaminhamento, recebendo solicitações dos serviços de back-end e encaminhando-as para a Internet fora da empresa, configure primeiro um proxy de API no Edge . O serviço de back-end pode fazer uma solicitação para o proxy da API, que pode se conectar a serviços externos.