Porque é que reiniciar um proxy inverso invalida todas as sessões de uma aplicação autoalojada?

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.

O reinício de um proxy inverso termina a sessão de todos os utilizadores apenas quando também altera, perde ou redireciona o estado da sessão utilizado pela aplicação.

Um proxy básico costuma encaminhar os cookies, em vez de gerir a sessão da aplicação, pelo que, por si só, um reinício do proxy não deverá invalidar todas as sessões de início de sessão. O verdadeiro desencadeador pode ser o reinício de uma gateway de autenticação, a regeneração de um segredo de assinatura de cookies, uma cache de sessões em memória, a alteração da réplica de back-end ou uma dependência do Compose que reinicia a aplicação juntamente com o proxy. Identifique o componente que emitiu e valida a sessão antes de alterar os atributos dos cookies ou obrigar os utilizadores a iniciar sessão novamente.

Confirme quais os serviços que reiniciaram com o proxy

Registe os IDs dos contentores, as horas de início, o número de reinícios, os eventos de estado e os registos do proxy inverso, do serviço de autenticação, da aplicação, da cache e da base de dados antes e depois de um reinício controlado do proxy.

O Docker Compose pode reiniciar serviços dependentes quando uma dependência está explicitamente configurada para propagar os reinícios. As orientações oficiais sobre a ordem de arranque explicam por que motivo um comando descrito como um reinício do proxy também pode substituir ou reiniciar um contentor de autenticação ou da aplicação.

Se apenas o proxy tiver uma nova hora de início, concentre-se na autenticação, no encaminhamento e nos cookies geridos pelo proxy. Se a aplicação, a cache ou a gateway de autenticação também reiniciar, verifique primeiro a persistência das sessões e os segredos.

Identifique a camada que emitiu o cookie de início de sessão

Antes de reiniciar, registe o nome, o domínio, o caminho, os atributos Secure, HttpOnly e SameSite, a validade do cookie e se é definido pela aplicação ou por uma gateway de autenticação.

A MDN explica que o âmbito e os atributos dos cookies determinam para onde o navegador os envia, mas esses atributos não revelam qual o back-end que valida o seu valor.

Compare os cabeçalhos de resposta do pedido de início de sessão e do primeiro pedido após o reinício. Se faltar um cookie, o problema está no âmbito do navegador; se o cookie não tiver mudado e for rejeitado pelo servidor, isso aponta para perda de estado, alteração de chaves ou utilização de outro back-end.

Verifique se um gateway de autenticação voltou a gerar o seu segredo de sessão

Inspecione a origem do segredo, a montagem do ficheiro, o ambiente, a recriação do contentor e a configuração gerada do gateway de autenticação. Compare a origem do valor antes e depois do reinício sem revelar o próprio segredo.

O Authelia documenta que o seu segredo de sessão encripta os dados de sessão armazenados, pelo que alterar ou perder esse segredo impede o serviço de ler sessões criadas anteriormente.

Armazene os segredos de sessão num ficheiro persistente ou num sistema de gestão de segredos, em vez de os gerar no arranque de cada contentor. Faça as rotações de forma deliberada, com um período de término de sessões documentado.

Exclua a possibilidade de as sessões serem armazenadas apenas em memória

Identifique se a aplicação armazena as sessões em memória do processo, numa cache local, no Redis, numa base de dados ou em cookies de cliente assinados. Compare o tempo de atividade do processo que armazena as sessões com o momento em que a sessão é terminada.

O Django avisa que um backend de sessões que usa apenas cache pode perder dados de sessão quando a cache é reiniciada ou expulsa entradas, o que termina as sessões dos utilizadores quando os dados de sessão desaparecem.

Se a pilha de proxy incluir o contentor de cache, reiniciar essa pilha pode eliminar sessões, mesmo que o contentor da aplicação continue em execução. Use uma configuração de cache persistente ou uma alternativa com base de dados quando for importante manter as sessões iniciadas.

Compare as chaves de assinatura da aplicação entre reinícios

Inspecione a origem da chave de assinatura ou encriptação de sessões da aplicação e determine se a chave é persistente, carregada do ficheiro de ambiente esperado ou gerada no arranque.

O Flask usa SECRET_KEY para assinar cookies de sessão, pelo que substituir essa chave invalida os cookies assinados existentes, mesmo que o navegador continue a enviá-los.

Não resolva isto partilhando um segredo entre aplicações sem relação entre si. Atribua a cada aplicação um segredo estável, proteja-o como configuração essencial para as cópias de segurança e confirme que se mantém após recriar a imagem.

Verifique as sessões persistentes e as alterações às réplicas do backend

Indique as réplicas do backend, os respetivos armazenamentos de sessões e a política de balanceamento de carga do proxy. Teste se o mesmo utilizador continua com a sessão iniciada quando os pedidos chegam a outra réplica.

A configuração de sessões persistentes do Traefik encaminha um cliente para o mesmo backend, mas os utilizadores podem continuar a perder as sessões se as réplicas não partilharem o estado e um reinício alterar o endpoint selecionado.

A persistência da sessão pode ocultar um armazenamento de sessões incorretamente local. Prefira um estado de sessão partilhado e duradouro quando se pretende que várias réplicas da aplicação sobrevivam à substituição do proxy ou do backend.

Reproduza o problema com uma conta de teste e uma configuração estável

Guarde uma cópia da configuração, inicie sessão com uma conta descartável, registe os identificadores da sessão, reinicie apenas o proxy e teste o mesmo pedido antes de reiniciar qualquer outro componente.

O artigo da ZimaSpace sobre ciclos de início de sessão apenas no acesso externo aborda falhas de início de sessão dependentes do caminho; este artigo centra-se na invalidação simultânea de sessões já válidas após um reinício.

O problema fica resolvido quando os reinícios apenas do proxy preservam as sessões, os reinícios deliberados da autenticação ou da aplicação usam segredos estáveis e estado persistente, e todas as réplicas aceitam a mesma sessão ativa.

Perguntas frequentes

Um proxy inverso pode armazenar as sessões dos utilizadores?

Pode acontecer quando inclui um gateway de autenticação, middleware de controlo de acesso ou um mecanismo de sessão persistente. Um proxy de encaminhamento simples, normalmente, não gere a sessão de início de sessão da aplicação.

Reiniciar o Redis termina sempre a sessão dos utilizadores?

Só quando as sessões existem exclusivamente no Redis e os respetivos dados não são persistidos nem restaurados. As aplicações que usam sessões baseadas numa base de dados ou em cookies assinados comportam-se de forma diferente.

Devo aumentar a duração do cookie para evitar que a sessão termine ao reiniciar?

Não. Um cookie de maior duração continua a falhar se a chave de assinatura mudar ou o registo da sessão no servidor desaparecer. Corrija primeiro a persistência e a estabilidade dos segredos.

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.