Comment redémarrer un proxy inverse sans redémarrer les services qui gèrent l’état des sessions

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.

La maintenance planifiée du proxy est plus sûre lorsque le proxy inverse peut être rechargé ou redémarré indépendamment des services d’authentification et de gestion de l’état des sessions qui se trouvent derrière lui.

Un processus proxy n’a généralement pas besoin de gérer l’état de connexion qu’il relaie. Avant la maintenance, déterminez quel composant signe les cookies, stocke les sessions côté serveur, gère l’authentification et termine les connexions HTTP actives. Laissez ces composants avec état en fonctionnement, privilégiez les rechargements gracieux du proxy lorsque seule la configuration change et vérifiez qu’un remplacement complet du proxy se reconnecte à la même passerelle d’authentification et au même magasin de sessions, avec les secrets inchangés.

Séparez le cycle de vie du proxy de celui du service d’authentification

Vérifiez les dépendances Compose, les politiques de redémarrage, les scripts partagés et les actions du gestionnaire de pile afin de vous assurer que le redémarrage du proxy ne recrée pas automatiquement la passerelle d’authentification, l’application, Redis ou la base de données.

Un exemple d’architecture de session utilise Redis en dehors du cycle de vie du proxy afin que plusieurs instances d’authentification et plusieurs redémarrages puissent partager le même backend de session.

Ne regroupez pas tous les services en périphérie derrière une seule commande de redémarrage brutale. Si une modification de certificat ou de route ne concerne que le proxy, laissez en fonctionnement les services qui valident les connexions existantes.

Rechargez la configuration au lieu de redémarrer quand c’est possible

Pour les modifications de routes, de certificats ou d’en-têtes, utilisez la procédure de rechargement gracieux prise en charge par le proxy plutôt que d’arrêter le service. Validez la configuration avant de l’appliquer afin qu’une erreur de syntaxe ne transforme pas une maintenance planifiée en interruption de service.

Le tutoriel d’API7 sur NGINX explique comment les anciens workers terminent le traitement des connexions tandis que les nouveaux acceptent les requêtes avec la configuration mise à jour.

Un rechargement conserve la famille de processus du proxy, mais ne protège pas un service d’authentification distinct si votre script de déploiement redémarre aussi ce service. Gérez ces deux cycles de vie séparément.

Préservez le stockage externe des sessions lors du remplacement du proxy

Si une passerelle d’authentification stocke les données de session hors des cookies, veillez à ce que son backend de session Redis ou autre reste persistant et inchangé pendant l’opération sur le proxy. Consignez l’adresse du backend et le secret utilisés par chaque instance d’authentification.

OAuth2 Proxy prend en charge Redis comme stockage partagé des sessions lorsque les sessions doivent être partagées entre plusieurs instances.

Ne confondez pas un cache temporaire avec l’état de connexion faisant autorité. Si le backend de session est nécessaire pour valider les utilisateurs actuels, ne le redémarrez et ne le videz que selon sa propre procédure de maintenance testée.

Conservez stables les cookies et les secrets de signature

Notez le secret de chiffrement ou de signature des cookies utilisé par la passerelle d’authentification et assurez-vous que la pile de proxy de remplacement monte le même secret. Générer une nouvelle valeur lors du redéploiement invalidera les cookies du navigateur, même s’ils sont par ailleurs valides.

Un guide sur les sessions des proxys inverses souligne qu’une politique de session stable résiste aux redémarrages, au lieu de dépendre de la durée de vie d’une seule connexion TCP.

Faites tourner les secrets de signature dans le cadre d’un changement de sécurité distinct, avec une déconnexion attendue explicitement ou une stratégie de chevauchement. Ne combinez pas la rotation des secrets avec un rechargement ordinaire et planifié du proxy, sauf si l’invalidation des sessions est intentionnelle.

Drainer les connexions lors d’un redémarrage complet du proxy

Lorsque le binaire ou le conteneur du proxy doit être remplacé, utilisez son mécanisme de redémarrage en douceur ou sans interruption, s’il est disponible, afin que les requêtes établies ne soient pas coupées avant la fin de leur réponse. Prévoyez un délai d’expiration de maintenance pour les connexions de longue durée.

Le guide de rechargement de HAProxy explique comment les rechargements sans interruption préservent les connexions au lieu de tuer immédiatement l’ancien processus.

La continuité de la connexion et celle de la session sont deux choses différentes. Même si une connexion WebSocket se reconnecte, la session doit rester valide, car le proxy de remplacement accède aux mêmes services d’authentification et d’état.

Testez une session avant et après la maintenance planifiée

Utilisez un navigateur avec une session ouverte et une nouvelle session privée. Notez le cookie de session, la route du proxy, le service d’authentification et le backend avant la maintenance, puis rechargez ou remplacez uniquement le proxy et répétez la même requête protégée.

Un guide d’exploitation de Caddy recommande de recharger plutôt que redémarrer complètement lors des mises à jour de configuration planifiées.

La conception de la maintenance fonctionne lorsque les connexions existantes sont conservées, que les nouvelles connexions réussissent et qu’aucune dépendance avec état n’a subi de redémarrage imprévu. L’article connexe de ZimaSpace sur la perte de session après le redémarrage du proxy reste la bonne piste de dépannage si les utilisateurs sont toujours déconnectés.

Questions fréquentes

Un rechargement en douceur du proxy garantit-il que les utilisateurs restent connectés ?

Non. Il protège les connexions du proxy, mais les utilisateurs peuvent quand même être déconnectés si le service d’authentification, le magasin de sessions ou le secret de signature du cookie change en même temps.

Redis doit-il toujours survivre au redémarrage d’un proxy ?

Uniquement lorsque Redis stocke l’état de session ou une autre dépendance persistante à l’authentification. Une instance Redis utilisée uniquement comme cache a un périmètre de récupération différent.

Conserver le même nom de cookie suffit-il ?

Non. Le secret de signature ou de chiffrement ainsi que l’état de session côté serveur doivent aussi rester compatibles avec le cookie que le navigateur possède déjà.

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.