Pourquoi le redémarrage d’un proxy inverse invalide-t-il toutes les sessions d’une application auto-hébergée ?

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.

Le redémarrage d’un proxy inverse déconnecte tous les utilisateurs uniquement lorsqu’il modifie, perd ou redirige l’état de session utilisé par l’application concernée.

Un proxy de base transmet généralement les cookies sans gérer la session de l’application ; son seul redémarrage ne devrait donc pas invalider toutes les connexions. Le véritable déclencheur peut être le redémarrage d’une passerelle d’authentification, la régénération d’un secret de signature des cookies, un cache de sessions en mémoire, un changement de réplique du serveur dorsal ou une dépendance Docker Compose qui redémarre l’application avec le proxy. Identifiez le composant qui a émis et valide la session avant de modifier les attributs des cookies ou de forcer les utilisateurs à se reconnecter.

Confirmez quels services ont redémarré avec le proxy

Avant et après un redémarrage contrôlé du proxy, relevez les identifiants des conteneurs, leurs heures de démarrage, leurs nombres de redémarrages, leurs événements d’état de santé et leurs journaux pour le proxy inverse, le service d’authentification, l’application, le cache et la base de données.

Docker Compose peut redémarrer les services dépendants lorsqu’une dépendance est explicitement configurée pour propager les redémarrages. Les consignes officielles sur l’ordre de démarrage montrent pourquoi une commande présentée comme un redémarrage du proxy peut aussi remplacer ou redémarrer un conteneur d’authentification ou d’application.

Si seule l’heure de démarrage du proxy est récente, concentrez-vous sur l’authentification gérée par le proxy, le routage et les cookies. Si l’application, le cache ou la passerelle d’authentification redémarre aussi, examinez d’abord la persistance de leurs sessions et leurs secrets.

Identifiez la couche qui a émis le cookie de connexion

Avant le redémarrage, notez le nom du cookie, son domaine, son chemin, ses attributs Secure, HttpOnly et SameSite, sa date d’expiration, ainsi que l’identité du composant qui le définit : l’application ou une passerelle d’authentification.

MDN explique que la portée et les attributs des cookies déterminent où le navigateur les envoie, mais ces attributs ne révèlent pas quel serveur dorsal valide leur valeur.

Comparez les en-têtes de réponse de la requête de connexion et de la première requête après le redémarrage. L’absence d’un cookie indique un problème de portée du navigateur ; si le serveur rejette un cookie inchangé, cela pointe vers une perte d’état, un changement de clés ou un autre serveur dorsal.

Vérifier si une passerelle d’authentification a régénéré son secret de session

Examinez la source du secret de la passerelle d’authentification, le montage du fichier, l’environnement, la recréation du conteneur et la configuration générée. Comparez la source de la valeur avant et après le redémarrage sans exposer le secret lui-même.

La documentation d’Authelia précise que le secret de session chiffre les données de session stockées ; changer ou perdre ce secret empêche donc le service de lire les sessions créées auparavant.

Stockez les secrets de session dans un fichier secret persistant ou dans un gestionnaire de secrets, au lieu de les générer à chaque démarrage du conteneur. Effectuez les rotations délibérément, en définissant une période de déconnexion prévue et documentée.

Écarter l’hypothèse d’un stockage des sessions en mémoire vive

Déterminez si l’application stocke les sessions en mémoire vive, dans un cache local, dans Redis, dans une base de données ou dans des cookies signés côté client. Comparez le temps de fonctionnement du processus de stockage des sessions à l’heure de la déconnexion.

Django indique qu’un backend de session reposant uniquement sur le cache peut perdre les données de session lorsque le cache est redémarré ou que des entrées sont évincées, ce qui déconnecte les utilisateurs lorsque les données de session disparaissent.

Si la pile du proxy comprend le conteneur de cache, le redémarrage de cette pile peut effacer les sessions, même si le conteneur de l’application reste actif. Utilisez une configuration de cache persistante ou une solution de repli basée sur une base de données lorsque la continuité de connexion est importante.

Comparer les clés de signature de l’application après chaque redémarrage

Examinez la source de la clé de signature ou de chiffrement des sessions de l’application et déterminez si elle est persistante, chargée depuis le fichier d’environnement attendu ou générée au démarrage.

Flask utilise SECRET_KEY pour signer les cookies de session ; remplacer cette clé invalide donc les cookies signés existants, même si le navigateur continue de les envoyer.

Ne résolvez pas ce problème en partageant un même secret entre des applications sans lien entre elles. Attribuez à chaque application un secret stable, protégez-le comme une configuration critique à sauvegarder et vérifiez qu’il est conservé lors de la recréation de l’image.

Vérifiez la persistance des sessions et les changements de réplique du backend

Répertoriez les répliques du backend, leurs stockages de sessions et la politique d’équilibrage de charge du proxy. Vérifiez si l’utilisateur reste connecté lorsque les requêtes sont dirigées vers une autre réplique.

La configuration de persistance de session de Traefik redirige un client vers un backend spécifique, mais les utilisateurs peuvent tout de même perdre leur session si les répliques ne partagent pas leur état et qu’un redémarrage modifie le point de terminaison sélectionné.

La persistance des sessions peut masquer un stockage de sessions local mal configuré. Privilégiez un état de session partagé et durable lorsque plusieurs répliques de l’application doivent rester opérationnelles malgré le remplacement du proxy ou du backend.

Reproduisez le problème avec un seul compte de test et une configuration stable

Faites un instantané de la configuration, connectez-vous avec un compte de test jetable, notez les identifiants de session, redémarrez uniquement le proxy et testez la même requête avant de redémarrer tout autre composant.

L’article de ZimaSpace sur les boucles de connexion uniquement depuis l’extérieur aborde les échecs de connexion liés au chemin d’accès ; cet article se concentre sur l’invalidation simultanée de sessions déjà valides après un redémarrage.

Le problème est résolu lorsque les redémarrages du proxy seul préservent les sessions, que les redémarrages volontaires du service d’authentification ou de l’application utilisent des secrets stables et un état persistant, et que chaque réplique accepte la même session active.

Foire aux questions

Un proxy inverse peut-il stocker lui-même les sessions utilisateur ?

Cela peut arriver s’il inclut une passerelle d’authentification, un middleware de contrôle d’accès ou un mécanisme de sessions persistantes. Un simple proxy de transfert ne gère généralement pas la session de connexion de l’application.

Le redémarrage de Redis déconnecte-t-il toujours les utilisateurs ?

Uniquement lorsque les sessions existent exclusivement dans Redis et que ses données ne sont ni persistées ni restaurées. Les applications utilisant des sessions stockées en base de données ou dans des cookies signés se comportent différemment.

Dois-je augmenter la durée de vie du cookie pour éviter les déconnexions au redémarrage ?

Non. Un cookie à durée de vie plus longue ne résout pas le problème si sa clé de signature change ou si l’enregistrement de session côté serveur disparaît. Corrigez d’abord la persistance et la stabilité du secret.

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.