Pourquoi une boucle de connexion au cloud privé apparaît-elle uniquement en dehors du réseau domestique ?

Eva Wong est la rédactrice technique et bricoleuse résidente chez ZimaSpace. Geek depuis toujours, passionnée par les laboratoires informatiques personnels et les logiciels open source, elle se spécialise dans la vulgarisation de concepts techniques complexes au moyen de guides pratiques et concrets. Eva pense que l’hébergement personnel doit être amusant, et non intimidant. À travers ses tutoriels, elle aide la communauté à démystifier les configurations matérielles, de la construction de leur premier NAS à la maîtrise des conteneurs Docker.

Une boucle de connexion qui se produit uniquement depuis l’extérieur signifie généralement que le chemin du proxy distant modifie le schéma, le nom d’hôte, le cookie, l’URL de rappel ou les informations de session reçues par l’application.

À domicile, un navigateur peut se connecter directement au service de cloud privé via son adresse locale, tandis que les utilisateurs distants passent par le DNS public, la terminaison TLS, un proxy inverse, une couche d’authentification préalable, un tunnel ou un fournisseur d’identité. Les identifiants peuvent être acceptés correctement, mais la requête suivante renvoie à la page de connexion parce que le cookie de session n’est pas stocké ou renvoyé, que le backend interprète HTTPS comme HTTP, que l’URL de rappel diffère de la valeur enregistrée ou que l’application génère des redirections vers son nom d’hôte interne.

Capturez la boucle de redirection exacte dans le navigateur

Ouvrez le panneau réseau du navigateur avant de vous connecter depuis l’extérieur du domicile. Conservez le journal des requêtes et notez chaque code d’état, en-tête Location, en-tête Set-Cookie, nom d’hôte de la requête et si le cookie de session apparaît dans la requête suivante.

Un guide de dépannage Keycloak recommande d’observer toute la chaîne de redirections, car des en-têtes de transfert manquants, la portée des cookies et les URL de rappel peuvent tous provoquer une boucle de redirection infinie vers la connexion, même lorsque l’étape du mot de passe réussit.

Si aucun cookie n’est émis, examinez la réponse de l’application et du proxy. Si un cookie est émis, mais n’est pas renvoyé, vérifiez son domaine, son chemin et ses attributs Secure et SameSite. Si le cookie est renvoyé, mais que l’application continue de rediriger, examinez la confiance accordée au proxy et le stockage de session.

Comparez les noms d’hôte et les schémas locaux et publics

Notez l’URL locale exacte et l’URL publique, y compris http ou https, le nom d’hôte, le port et le sous-chemin. Vérifiez si l’application a une URL de base canonique ou externe configurée.

Une analyse de WordPress derrière un proxy inverse explique que lorsque le serveur d’arrière-plan croit que la requête utilise HTTP, il peut rediriger en boucle vers HTTPS alors que le proxy continue de terminer la connexion TLS. La boucle est due à une mauvaise détection du protocole HTTPS derrière le proxy, et non au mot de passe de l’utilisateur.

Utilisez le même nom d’hôte public pour la connexion à distance, les rappels et les cookies. Ne mélangez pas le domaine public, l’adresse IP privée, le nom d’hôte interne et d’autres ports au sein d’un même parcours d’authentification, sauf si l’application prend explicitement en charge plusieurs origines de confiance.

Vérifiez les en-têtes d’hôte et de protocole transmis

Vérifiez la configuration du proxy inverse et les journaux du serveur d’arrière-plan pour les en-têtes X-Forwarded-Proto, X-Forwarded-Host, X-Forwarded-Port et l’adresse d’origine du client. Confirmez que l’application ne fait confiance qu’au proxy connu et qu’elle reconstitue la même URL publique que celle utilisée par le navigateur.

Un cas de proxy inverse pour qBittorrent indique que la page de connexion peut se charger et accepter les identifiants alors qu’un en-tête Host ou HTTPS incompatible empêche la reconnaissance de la session authentifiée.

Si le proxy envoie les bonnes valeurs publiques, mais que l’application les ignore, configurez les paramètres de proxy de confiance et d’URL externe de l’application. Si le proxy les omet, ajoutez uniquement les en-têtes nécessaires plutôt que de transmettre sans modification tous les en-têtes fournis par le client.

Vérifiez les attributs Domain, Path, Secure et SameSite du cookie

Comparez le cookie de session créé en local à celui créé via le domaine public. Un cookie associé à un nom d’hôte interne, au mauvais domaine parent, à un sous-chemin différent ou à un contexte non sécurisé peut ne pas être envoyé avec la requête publique après redirection.

L’accès externe ajoute souvent un autre domaine d’authentification ou un rappel intersites. Les restrictions SameSite et les exigences Secure peuvent donc affecter le parcours à distance, même si une connexion locale directe reste sur une seule origine.

Effacez les cookies uniquement pour les domaines du cloud privé concernés, reproduisez la boucle et examinez les nouveaux attributs. Corrigez l’URL publique et les paramètres des cookies de l’application ou du proxy ; ne modifiez pas globalement les règles des cookies du navigateur comme solution permanente côté serveur.

Vérifiez l’identité du rappel OAuth, OIDC ou d’authentification déléguée

Si le cloud privé utilise un fournisseur d’identité ou un service d’authentification déléguée, comparez l’URL de rappel générée par l’application, enregistrée auprès du fournisseur et utilisée par le navigateur. Le schéma, le nom d’hôte, le port, le chemin et la barre oblique finale doivent parfois correspondre exactement.

Un cas signalé dans la communauté NGINX décrit une boucle de connexion à distance où la terminaison TLS a lieu sur le proxy, mais où le backend voit du HTTP : l’application ne peut donc pas maintenir la session externe sécurisée attendue.

Testez directement le point de terminaison de rappel via le domaine public et confirmez qu’il aboutit à la bonne route du proxy et au bon backend. Si l’authentification réussit, mais que le rappel relance la connexion, vérifiez l’état, le nonce, la persistance du cookie, la synchronisation de l’horloge et l’URI de redirection exacte.

Validez la session distante complète sans contourner le proxy

Après avoir corrigé une cause, commencez par ouvrir une fenêtre de navigation privée vierge depuis un réseau externe. Connectez-vous, actualisez le tableau de bord, ouvrez un fichier, attendez au-delà de la courte durée de session, puis reconnectez-vous pour confirmer que la session résiste à une navigation ordinaire.

Le guide ZimaSpace sur l’accès contrôlé à distance au NAS définit le cadre de sécurité général : corriger la boucle ne doit pas nécessiter d’exposer directement le backend ni de désactiver l’authentification.

Le problème n’est résolu que lorsque les utilisateurs locaux et distants accèdent au nom d’hôte prévu, que le proxy préserve l’identité publique de la requête, que le cookie reste valide et que l’ensemble du processus de connexion et de rappel fonctionne à plusieurs reprises. Après vérification, supprimez les contournements temporaires et les journaux d’authentification détaillés.

Assistance et conseils

À lire aussi

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.