Proxies confiáveis

Cadastro dos proxies e balanceadores de carga confiáveis na identificação do endereço do cliente das requisições HTTP.

Quando o acesso ao sistema passa por balanceadores de carga ou proxies reversos, o Engine recebe a conexão do último desses elementos, e não do navegador do usuário. O endereço do cliente final é informado pelos próprios elementos intermediários, nos cabeçalhos HTTP X-Forwarded-For ou Forwarded. Como esses cabeçalhos também podem ser enviados por qualquer cliente, o Engine só confia neles quando a requisição chega de um proxy registrado neste cadastro.

O endereço identificado é utilizado na auditoria do sistema, como na coluna iSourceAddr do log transacional e nos relatórios de logins, e na limitação das tentativas de acesso malsucedidas, que atrasam novas tentativas do mesmo endereço. A limitação considera apenas endereços verificados: quando o endereço do cliente não pode ser verificado, é utilizado o endereço da conexão recebida. Assim, sem o cadastro de um balanceador de carga, todos os usuários que acessam o sistema por meio dele compartilham o mesmo limite de tentativas. Por isso, é importante que todos os elementos intermediários da infraestrutura do sistema estejam cadastrados.

Processo Proxies confiáveis

Caminho: Administração do sistema > Servidores > Proxies confiáveis.

Cada registro identifica um balanceador de carga, proxy reverso ou outro elemento intermediário da infraestrutura de rede do sistema, com os seguintes campos:

  • Nome: nome que identifica o proxy.
  • Endereço IP ou rede: endereço IPv4 ou IPv6 do proxy, como 10.0.0.5 ou 2001:db8::5. Também é possível informar uma rede na notação CIDR, como 10.0.0.0/24, quando o serviço utilizar um conjunto de endereços, como ocorre com balanceadores de carga em nuvem.

As redes devem ter a máscara de, no mínimo, /8 no IPv4 e /16 no IPv6. Redes mais amplas, como 0.0.0.0/0, fariam o Engine confiar em praticamente qualquer cliente, que poderia então informar um endereço falso. Os endereços inválidos e as redes mais amplas que esse limite são ignorados pelo Engine e registrados em seu log.

Os endereços de loopback (127.0.0.1 e ::1) são sempre confiáveis e não precisam ser cadastrados, pois correspondem a proxies executados no mesmo computador do Engine.

Devem ser cadastrados somente os proxies administrados pela própria empresa, cujos cabeçalhos de encaminhamento sejam confiáveis, como os balanceadores de carga, os proxies reversos e os proxies das filiais. Proxies de terceiros, como os da rede de um cliente, de um provedor de internet ou de uma VPN pública, não devem ser cadastrados, pois o Engine não tem como garantir os endereços informados por eles.

Proxies das filiais

Quando os usuários de uma filial acessam o sistema por meio de um proxy da própria filial, o endereço registrado depende do caminho da requisição:

  • Proxy da filial, seguido de um proxy cadastrado, como um balanceador de carga: sem o cadastro do proxy da filial, o endereço registrado é o dele, normalmente o endereço de saída da filial para a internet ou para a rede corporativa. O endereço é considerado verificado, mas todos os usuários da filial aparecem com o mesmo endereço. Isso ocorre porque o Engine percorre a cadeia de encaminhamento somente enquanto os elementos são proxies confiáveis, e os endereços informados pelo proxy da filial poderiam ter sido forjados. Para registrar o endereço do computador de cada usuário, cadastre o endereço com que o proxy da filial chega ao proxy seguinte.
  • Proxy da filial conectado diretamente a um Engine: sem o cadastro do proxy, os endereços informados por ele são registrados como não verificados. Cadastre o endereço do proxy para que eles sejam considerados confiáveis.

Em ambos os casos, o endereço do computador do usuário não é perdido: o evento de login da sessão, no log transacional, guarda o endereço da conexão recebida pelo Engine e a cadeia completa de endereços informada pelos cabeçalhos de encaminhamento, inclusive os que não puderam ser verificados.

Ao cadastrar o endereço de saída de uma filial, os demais computadores que utilizem esse mesmo endereço sem passar pelo proxy também podem informar os cabeçalhos de encaminhamento e, portanto, um endereço falso. Esse risco costuma ser aceitável em uma rede corporativa, mas deve ser avaliado antes do cadastro.

Identificação do endereço do cliente

O Engine identifica o endereço do cliente final de cada requisição HTTP da seguinte forma:

  • Sem os cabeçalhos de encaminhamento, é utilizado o endereço da conexão recebida.
  • Quando a conexão é recebida de um proxy confiável, a cadeia de endereços informada pelos cabeçalhos é percorrida do último ao primeiro elemento, enquanto eles forem proxies confiáveis. O primeiro endereço que não corresponder a um proxy confiável é o do cliente. Dessa forma, um endereço forjado pelo cliente e repassado pelo proxy não é considerado.
  • Um elemento da cadeia sem um endereço válido, como os identificadores unknown e ofuscados (_hidden) do cabeçalho Forwarded, indica que o proxy seguinte não conhece o seu cliente. Os endereços anteriores a esse elemento não podem ser verificados: o primeiro deles é registrado como não verificado e, se não houver nenhum, o proxy seguinte é considerado o cliente.
  • Quando a conexão é recebida de um computador que não está cadastrado, os cabeçalhos podem ter sido forjados. O primeiro endereço informado por eles é registrado, por ser a melhor informação disponível, mas é marcado como não verificado.

Os endereços não verificados são gravados no log transacional com o sufixo ?, como 203.0.113.5?, e são exibidos nos relatórios com o rótulo “(não confiável)”. Ao clicar no rótulo, são exibidas as causas possíveis: um proxy não cadastrado, um proxy confiável que não informou o endereço do seu cliente ou cabeçalhos de encaminhamento que indicam clientes diferentes. As consultas por endereço de origem, como as do relatório “Administração do sistema > Auditoria > Logs de alterações de registros”, encontram tanto os endereços verificados quanto os não verificados.

Quando os cabeçalhos X-Forwarded-For e Forwarded informam o cliente ao mesmo tempo, prevalece o X-Forwarded-For, que é o mais utilizado pelos proxies. Se eles indicarem endereços diferentes, o endereço é registrado como não verificado, pois um proxy pode ter escrito apenas um deles e repassado o outro como foi enviado pelo cliente. Nesse caso, o Engine registra um aviso em seu log, e os proxies devem ser configurados para informar o cliente pelo mesmo cabeçalho. Um cabeçalho Forwarded que informa apenas o protocolo ou o host, sem o parâmetro for, não é considerado na identificação do cliente.

Identificação dos proxies a cadastrar

Teste de conexão

A opção “Testar conexão” do processo exibe como o Engine recebeu a requisição do próprio usuário:

  • Endereço do cliente: endereço identificado pelo Engine, com a indicação “(não confiável)” quando ele não pode ser verificado.
  • Endereço do servidor: endereço e porta do Engine que atendeu a requisição e o host solicitado pelo navegador.
  • Elementos da requisição: o cliente e os proxies pelos quais a requisição passou, do cliente ao Engine, conforme a identificação do endereço do cliente realizada pelo Engine. São indicados os proxies considerados confiáveis, com o seu nome no cadastro, os executados no computador do Engine, os que não estão cadastrados, os endereços que não puderam ser verificados e os elementos sem endereço, como unknown. Um proxy não cadastrado na mesma rede de um proxy cadastrado indica que o serviço utiliza vários endereços, como os balanceadores de carga em nuvem, e que a sua rede deve ser cadastrada.
  • Dados recebidos pelo Engine: o endereço da conexão e os cabeçalhos X-Forwarded-For, Forwarded, X-Forwarded-Proto, X-Forwarded-Host e Via, como recebidos pelo Engine.

Alguns balanceadores de carga acrescentam ao cabeçalho X-Forwarded-For o seu próprio endereço público, que também deve ser cadastrado. O manual de balanceadores de carga descreve o cadastro no Google Cloud Load Balancing.

Quando há proxies não cadastrados, a opção “Cadastrar proxies” solicita o nome de cada um deles, em diálogos sucessivos, permitindo também informar a sua rede na notação CIDR em vez do endereço. Além do primeiro proxy não cadastrado, são oferecidos os elementos informados por ele entre o cliente e o Engine, como o endereço público de um balanceador de carga. Como esses endereços não puderam ser verificados, cadastre apenas os que reconhecer como proxies administrados pela empresa e cancele o diálogo dos demais. O Engine passa a considerar o cadastro após alguns segundos, quando o teste deve ser repetido para confirmar a identificação do endereço do cliente. Caso a requisição seja recebida por meio do Google Cloud Load Balancing, o sistema exibirá o botão “Cadastrar Google Cloud” em vez de “Cadastrar proxies”, com um fluxo otimizado para esse serviço.

O teste somente analisa o caminho da própria requisição. Por isso, o sistema deve ser acessado pelo mesmo endereço utilizado pelos usuários, como o do balanceador de carga, e não diretamente pelo endereço do Engine. Quando os usuários acessam o sistema por caminhos diferentes, como pelos proxies das filiais, o teste deve ser repetido a partir de cada um deles. Como os endereços anteriores ao primeiro proxy cadastrado podem ter sido informados pelo cliente, cadastre apenas os proxies que fazem parte da infraestrutura administrada pela empresa.

Log do Engine

Quando uma requisição com cabeçalhos de encaminhamento é recebida de um computador que não está cadastrado, o Engine registra em seu log, uma única vez para cada computador, uma mensagem como a abaixo:

The peer 10.0.0.5 is not a trusted proxy, but it informed the client address 203.0.113.5 by the
forwarding headers. The address will be recorded as unverified, with the suffix "?".

Se o computador indicado fizer parte da infraestrutura do sistema, ele deve ser cadastrado. O manual de balanceadores de carga descreve a configuração dos cabeçalhos de encaminhamento nas soluções mais utilizadas.