Porque é que o ciclo de início de sessão da nuvem privada só aparece fora da rede doméstica?

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.

Um ciclo de início de sessão que ocorre apenas quando se acede de fora de casa costuma indicar que o percurso através do proxy remoto altera o esquema, o nome do anfitrião, o cookie, a chamada de retorno ou as informações da sessão que a aplicação recebe.

Dentro de casa, o navegador pode ligar-se diretamente ao serviço de nuvem privada através do respetivo endereço local, enquanto os utilizadores remotos acedem através de DNS público, terminação TLS, um proxy inverso, uma camada de autenticação de encaminhamento, um túnel ou um fornecedor de identidade. As credenciais podem ser aceites corretamente, mas o pedido seguinte pode voltar à página de início de sessão porque o cookie de sessão não é guardado ou devolvido, o servidor de aplicação interpreta HTTPS como HTTP, o URL de chamada de retorno difere do valor registado ou a aplicação gera redirecionamentos para o nome do anfitrião interno.

Registe o ciclo exato de redirecionamento no navegador

Abra o painel de rede do navegador antes de iniciar sessão fora de casa. Guarde o registo dos pedidos e anote cada código de estado, cabeçalho Location, cabeçalho Set-Cookie, nome do anfitrião do pedido e se o cookie de sessão aparece no pedido seguinte.

Um guia de resolução de problemas do Keycloak recomenda observar toda a cadeia de redirecionamentos, uma vez que a ausência de cabeçalhos encaminhados, o âmbito dos cookies e as chamadas de retorno podem causar um redirecionamento de início de sessão infinito, mesmo quando a palavra-passe é aceite.

Se não for emitido nenhum cookie, investigue a resposta da aplicação e do proxy. Se for emitido um cookie, mas este não for devolvido, verifique o domínio, o caminho e os atributos Secure e SameSite. Se o cookie for devolvido, mas a aplicação continuar a redirecionar, verifique a confiança no proxy e o armazenamento da sessão.

Compare os nomes dos anfitriões e os esquemas local e público

Anote o URL local e o URL público exatos, incluindo http ou https, o nome do anfitrião, a porta e o subcaminho. Verifique se a aplicação tem um URL base canónico ou externo configurado.

Uma análise do WordPress com proxy inverso explica que, quando o backend considera que o pedido utiliza HTTP, pode redirecionar repetidamente para HTTPS enquanto o proxy continua a terminar o TLS. O ciclo resulta da deteção incorreta de HTTPS atrás do proxy, não da palavra-passe do utilizador.

Utilize sempre o mesmo nome de anfitrião público para o início de sessão remoto, callbacks e cookies. Não misture o domínio público, o IP privado, o nome de anfitrião interno e portas alternativas no mesmo fluxo de autenticação, a menos que a aplicação suporte explicitamente várias origens fiáveis.

Verifique os cabeçalhos de encaminhamento do anfitrião e do protocolo

Verifique a configuração do proxy inverso e os registos do backend quanto a X-Forwarded-Proto, X-Forwarded-Host, X-Forwarded-Port e ao endereço original do cliente. Confirme que a aplicação só confia no proxy conhecido e reconstrói o mesmo URL público utilizado pelo navegador.

Um caso de proxy inverso do qBittorrent refere que a página de início de sessão pode carregar e aceitar as credenciais, mas um cabeçalho Host ou HTTPS incompatível pode impedir que a sessão autenticada seja reconhecida.

Se o proxy enviar os valores públicos corretos, mas a aplicação os ignorar, configure as definições de proxy fiável e URL externa da aplicação. Se o proxy não os enviar, adicione apenas os cabeçalhos necessários, em vez de reencaminhar inalterados todos os cabeçalhos fornecidos pelo cliente.

Inspecione Domain, Path, Secure e SameSite do cookie

Compare o cookie de sessão criado localmente com o criado através do domínio público. Um cookie associado a um nome de anfitrião interno, ao domínio principal errado, a um caminho diferente ou a um contexto não seguro pode não ser enviado com o pedido público redirecionado.

O acesso externo acrescenta muitas vezes outro domínio de autenticação ou um callback entre sites. Por isso, as restrições de SameSite e os requisitos de Secure podem afetar o acesso remoto, embora um início de sessão local direto nunca saia da mesma origem.

Limpe os cookies apenas dos domínios da nuvem privada afetados, reproduza o ciclo e inspecione os novos atributos. Corrija as definições de URL público e de cookies da aplicação ou do proxy; não use o relaxamento generalizado dos cookies no navegador como solução permanente do lado do servidor.

Verifique a identidade de retorno de chamada de OAuth, OIDC ou autenticação de encaminhamento

Se a nuvem privada utilizar um fornecedor de identidade ou um serviço de autenticação de encaminhamento, compare o URL de retorno de chamada gerado pela aplicação, registado no fornecedor e acedido pelo navegador. O esquema, o nome de anfitrião, a porta, o caminho e a barra final podem ter de corresponder exatamente.

Um caso da comunidade NGINX descreve um ciclo de início de sessão remoto em que a ligação TLS termina no proxy, mas o backend vê HTTP, pelo que a aplicação não consegue manter a sessão externa segura prevista.

Teste diretamente o endpoint de retorno de chamada através do domínio público e confirme que chega à rota correta do proxy e ao backend. Se a autenticação for bem-sucedida, mas o retorno de chamada reiniciar o início de sessão, verifique o estado, o nonce, a persistência dos cookies, a sincronização do relógio e o URI de redirecionamento exato.

Valide a sessão remota completa sem contornar o proxy

Depois de corrigir uma das causas, comece numa janela privada limpa, numa rede externa. Inicie sessão, atualize o painel, abra um ficheiro, aguarde mais do que o curto intervalo da sessão e volte a ligar-se para confirmar que a sessão se mantém durante a navegação normal.

O guia da ZimaSpace para acesso controlado à NAS a partir de redes remotas define os limites de segurança necessários: resolver o ciclo não deve exigir a exposição direta do backend nem a desativação da autenticação.

O problema só fica resolvido quando os utilizadores locais e remotos acedem ao nome de anfitrião pretendido, o proxy preserva a identidade pública do pedido, o cookie continua válido e todo o processo de início de sessão e retorno de chamada é concluído repetidamente. Após a verificação, remova as exceções temporárias e os registos detalhados de autenticação.

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.