Guia de resolução de problemas de sessões de aplicações autoalojadas para alterações de proxy e cookies

Eva Wong é a redatora técnica e entusiasta residente na ZimaSpace. Uma geek desde sempre, apaixonada por homelabs e software de código aberto, dedica-se a traduzir conceitos técnicos complexos em guias práticos. A Eva acredita que a auto-hospedagem deve ser divertida, não intimidante. Através dos seus tutoriais, ajuda a comunidade a desmistificar configurações de hardware, desde montar o primeiro NAS até dominar os contentores Docker.

A abordagem segura consiste em tratar a comparação, camada a camada, dos pedidos diretos e encaminhados pelo proxy, dos cookies de resposta, do armazenamento do navegador e do estado da sessão no backend como uma sequência de verificações observáveis, não como um único comando.

Numa aplicação Web autoalojada atrás de um proxy inverso, o risco prático é os utilizadores perderem a sessão, ficarem presos num ciclo de redirecionamentos ou não conseguirem estabelecer uma sessão após alterações no proxy ou nos cookies. Registe a identidade atual e o ponto de recuperação, comece pelo teste de diferenciação menos invasivo, interprete os resultados positivos e negativos antes de alterar outra variável e pare se o armazenamento se tornar instável ou se a única cópia recuperável ficar exposta. O fluxo de trabalho abaixo só termina quando a carga de trabalho original funcionar ou quando as evidências atingirem um limite que exija escalonamento.

Reproduza um percurso de sessão e preserve as evidências

Escolha um utilizador, perfil do navegador, nome de anfitrião e percurso de início de sessão. Registe o primeiro pedido que falhou, a sequência de estados, os destinos dos redirecionamentos, os cabeçalhos de resposta Set-Cookie com os valores ocultados, os cookies do pedido, os registos do proxy e da aplicação e a alteração exata de configuração que antecedeu a falha.

Não comece por limpar todos os cookies nem por rodar o segredo da aplicação. Utilize um perfil privado do navegador como referência limpa, preservando o perfil com falhas para comparação. Confirme se o acesso direto ao backend funciona; isso permite distinguir a autenticação da aplicação do comportamento de URLs e cookies derivado do proxy.

Pare se a aplicação expuser tokens nos registos, se o proxy aceitar cabeçalhos de encaminhamento falsificados de clientes não fidedignos ou se o início de sessão contornar o TLS. Proteja as credenciais e corrija o limite de segurança antes de continuar a resolução de problemas funcionais.

Verifique o esquema, o anfitrião e a confiança no encaminhamento

Compare o URL externo com aquilo em que a aplicação acredita: esquema, anfitrião, porta, caminho base e IP do cliente. Inspecione Host, X-Forwarded-Proto ou os cabeçalhos de encaminhamento normalizados, bem como a lista de proxies de confiança da aplicação. Um servidor de backend que interprete os pedidos HTTPS como HTTP pode recusar cookies Secure ou gerar um redirecionamento interminável para HTTPS.

Utilize um único proxy de confiança para definir ou substituir os cabeçalhos de encaminhamento e configure a aplicação para confiar apenas nesse salto. Não acrescente cegamente valores enviados pelo cliente. Após cada alteração, teste um início de sessão e um redirecionamento absoluto, em vez de alterar em simultâneo os cabeçalhos do proxy e o URL base da aplicação.

O guia da ZimaSpace sobre o diagnóstico do início de sessão com e sem proxy aplica a mesma comparação entre o acesso direto e o acesso através do proxy após o reinício deste. O exemplo com Immich é mais específico, mas o método de recolha de evidências também se aplica: comprove que a sessão no backend funciona e, em seguida, inspecione os cabeçalhos de encaminhamento, o encaminhamento e o estado do navegador.

Inspecione o âmbito dos cookies e as decisões do navegador

Verifique o nome do cookie, Domain, Path, Secure, HttpOnly, SameSite, a expiração e se existem cookies duplicados com o mesmo nome em caminhos ou domínios diferentes. As ferramentas de desenvolvimento do navegador mostram se um cookie foi guardado, rejeitado ou omitido no pedido seguinte; os registos do servidor, por si só, não revelam essa decisão.

A descrição da OWASP sobre o comportamento dos cookies SameSite explica como os valores SameSite controlam o envio de cookies entre sites. Se a autenticação for feita entre sites ou usar um fluxo incorporado, SameSite=None também requer Secure; numa aplicação simples do mesmo site, alargar desnecessariamente o âmbito do cookie enfraquece a segurança da configuração.

Depois de registar o cookie, elimine apenas o cookie afetado no perfil de controlo e repita o início de sessão. Se um cookie novo funcionar e o perfil preservado falhar, compare o âmbito e a expiração; se ambos falharem, volte aos cabeçalhos de resposta ou ao armazenamento de sessões do backend, em vez de limpar repetidamente o estado.

Verifique o estado partilhado das sessões e valide a correção

Em aplicações com vários contentores ou replicadas, confirme que todas as instâncias usam o mesmo segredo de assinatura de sessão, a mesma referência temporal e o mesmo backend de sessões partilhado, quando necessário. Um proxy que alterna entre instâncias pode dar a impressão de que a sessão termina aleatoriamente quando uma delas não consegue validar o cookie de outra.

A discussão da PortSwigger sobre a fronteira de segurança SameSite centra-se na segurança, mas esclarece que SameSite é uma fronteira do navegador, não um mecanismo genérico para reparar o início de sessão. Preserve a proteção contra CSRF, tendo em conta a origem real da aplicação e o respetivo fluxo de redirecionamento.

Valide o início de sessão, o fecho de sessão, a expiração por inatividade, o reinício do navegador, a alteração da palavra-passe e o acesso através dos nomes de anfitrião internos e remotos previstos. Só feche o problema quando os cookies antigos deixarem de funcionar de forma segura, as novas sessões resistirem ao encaminhamento normal e nenhum cabeçalho de encaminhamento ou atributo de cookie tiver sido flexibilizado para além do necessário documentado.

Assistência e dicas

Mais para ler

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.