Een reverse proxy herstarten zonder sessiestatusservices te herstarten

Eva Wong is de technisch schrijver en vaste knutselaar bij ZimaSpace. Als levenslange geek met een passie voor homelabs en open-sourcesoftwareis ze gespecialiseerd in het vertalen van complexe technische concepten naar toegankelijke, praktische handleidingen. Eva vindt dat self-hosting leuk moet zijn en niet intimiderend. Met haar tutorials helpt ze de community om hardware-installaties te doorgronden, van het bouwen van hun eerste NAS tot het beheersen van Docker-containers.

Gepland proxyonderhoud is veiliger wanneer de reverse proxy onafhankelijk kan worden herladen of herstart van de authenticatie- en sessiestatusservices erachter.

Een proxyproces hoeft doorgaans niet de inlogstatus te beheren die het doorstuurt. Breng vóór onderhoud in kaart welk onderdeel cookies ondertekent, sessies aan de serverzijde opslaat, authenticatie afhandelt en actieve HTTP-verbindingen laat uitlopen. Laat die statusbeheerende onderdelen actief, geef de voorkeur aan graceful reloads van de proxy wanneer alleen de configuratie verandert en controleer of een volledige vervanging van de proxy opnieuw verbinding maakt met dezelfde authenticatiegateway en sessieopslag, met ongewijzigde geheimen.

Scheid de levenscyclus van de proxy van die van de authenticatieservice

Controleer de afhankelijkheden, herstartbeleidsregels, gedeelde scripts en acties van de stackbeheerder in Compose om ervoor te zorgen dat het herstarten van de proxy niet automatisch de authenticatiegateway, applicatie, Redis of database opnieuw aanmaakt.

Een voorbeeld van een sessiearchitectuur gebruikt Redis buiten de levenscyclus van de proxy, zodat meerdere authenticatie-instanties en herstarts dezelfde sessiebackend kunnen delen.

Groepeer niet alle edge-services onder één bot herstartcommando. Als een wijziging aan een certificaat of route alleen invloed heeft op de proxy, laat de services die bestaande inlogstatus valideren dan ongemoeid.

Herlaad de configuratie waar mogelijk in plaats van opnieuw op te starten

Gebruik voor wijzigingen aan routes, certificaten of headers de ondersteunde graceful reload-methode van de proxy in plaats van de service te stoppen. Valideer de configuratie voordat je deze toepast, zodat een syntaxisfout gepland onderhoud niet in downtime verandert.

In de NGINX-handleiding van API7 wordt uitgelegd hoe oude workers verbindingen afhandelen terwijl nieuwe workers aanvragen accepteren met de bijgewerkte configuratie.

Een herlaadactie behoudt de proxyprocesgroep, maar beschermt geen afzonderlijke authenticatieservice als je implementatiescript die service ook herstart. Behandel die twee levenscycluskwesties onafhankelijk van elkaar.

Behoud externe sessieopslag bij vervanging van de proxy

Als een authenticatiegateway sessiegegevens buiten cookies opslaat, houd de Redis- of andere sessiebackend dan persistent en ongewijzigd tijdens de proxybewerking. Noteer het backendadres en geheim dat door elke authenticatie-instantie wordt gebruikt.

OAuth2 Proxy ondersteunt Redis als gedeelde sessieopslag wanneer sessies tussen instanties moeten worden gedeeld.

Verwar een tijdelijke cache niet met de gezaghebbende inlogstatus. Als de sessiebackend nodig is om huidige gebruikers te valideren, herstart of leeg deze dan alleen volgens de eigen, geteste onderhoudsprocedure.

Single board computer zimaboard2

Houd cookie- en ondertekeningsgeheimen stabiel

Leg het geheim voor cookieversleuteling of -ondertekening van de authenticatiegateway vast en zorg ervoor dat de vervangende proxystack dezelfde geheime bron koppelt. Als er tijdens de implementatie een nieuwe waarde wordt gegenereerd, worden anders gezonde browsercookies ongeldig.

In een handleiding over reverse-proxysessies staat dat een stabiel sessiebeleid herstarts overleeft, in plaats van afhankelijk te zijn van de levensduur van één TCP-verbinding.

Roteer ondertekeningsgeheimen als een afzonderlijke beveiligingswijziging, met een expliciete verwachting van uitloggen of een strategie met een overlapperiode. Combineer het roteren van geheimen niet met een gewone geplande proxyherlaadactie, tenzij het opzettelijk ongeldig maken van sessies de bedoeling is.

Verbindingen afbouwen tijdens een volledige proxyherstart

Wanneer het proxybestand of de container moet worden vervangen, gebruik dan waar beschikbaar het mechanisme voor een geleidelijke herstart of een herstart zonder onderbreking, zodat lopende verzoeken niet halverwege een antwoord worden afgebroken. Stel een time-out voor onderhoud in voor langdurige verbindingen.

In de herlaadinstructies voor HAProxy staat hoe herlaadacties zonder onderbreking verbindingen behouden in plaats van het oude proces onmiddellijk te beëindigen.

Verbindingscontinuïteit en continuïteit van aanmeldingen zijn verschillend. Zelfs als een WebSocket opnieuw verbinding maakt, moet de sessie geldig blijven doordat de vervangende proxy dezelfde authenticatie- en statusservices bereikt.

Test één sessie vóór en na gepland onderhoud

Gebruik één ingelogde browser en één nieuwe privésessie. Noteer vóór het onderhoud de sessiecookie, proxyrouting, authenticatieservice en backend. Laad daarna alleen de proxy opnieuw of vervang deze en herhaal hetzelfde beveiligde verzoek.

Een Caddy-handleiding voor beheer raadt aan om bij geplande configuratie-updates opnieuw te laden in plaats van volledig te herstarten.

Het onderhoudsontwerp werkt wanneer bestaande aanmeldingen behouden blijven, nieuwe aanmeldingen nog steeds slagen en geen enkele stateful afhankelijkheid onbedoeld opnieuw is gestart. Het gerelateerde ZimaSpace-artikel over sessieverlies na een proxyherstart blijft de juiste herstelroute als gebruikers nog steeds zijn uitgelogd.

Veelgestelde vragen

Garandeert een proxyherlaadactie zonder onderbreking dat gebruikers ingelogd blijven?

Nee. Dit beschermt proxyverbindingen, maar gebruikers kunnen nog steeds worden uitgelogd als de authenticatieservice, sessieopslag of het geheim voor cookieondertekening tegelijkertijd verandert.

Moet Redis een proxyherstart altijd overleven?

Alleen wanneer Redis sessiestatus of een andere persistente afhankelijkheid voor authenticatie opslaat. Een Redis-instantie die alleen als cache dient, heeft een andere herstelgrens.

Is dezelfde cookienaam voldoende?

Nee. Het geheim voor ondertekening of versleuteling en de sessiestatus aan de backend moeten ook compatibel blijven met de cookie die de browser al heeft.

Ondersteuning en tips

Meer om te lezen

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.