Felsökningsguide för sessioner i självhostade appar vid ändringar av proxy och cookies

Eva Wong är teknisk skribent och händig hemmabyggare på ZimaSpace. Som tekniknörd sedan barnsben med ett brinnande intresse för hemlabb och programvara med öppen källkodspecialiserar hon sig på att göra komplexa tekniska koncept begripliga genom praktiska, praktiska guider. Eva tycker att självhosting ska vara roligt, inte avskräckande. Genom sina handledningar hjälper hon communityn att göra hårdvaruinstallationer mindre mystiska, från att bygga sin första NAS till att bemästra Docker-containrar.

Det säkra tillvägagångssättet är att behandla en jämförelse lager för lager av direkta förfrågningar och proxade förfrågningar, svarscookies, webbläsarlagring och backendens sessionstillstånd som en sekvens av observerbara kontrollpunkter, inte som ett enda kommando.

I en egenvärd webbaserad app bakom en omvänd proxy är den praktiska risken att användare loggas ut, fastnar i en omdirigeringsslinga eller inte kan upprätta en session efter ändringar av proxyn eller cookies. Dokumentera det aktuella läget och återställningspunkten, börja med det minst ingripande testet, tolka godkända och misslyckade resultat innan du ändrar en annan variabel och avbryt om lagringen blir instabil eller om den enda återställningsbara kopian skulle exponeras. Arbetsflödet nedan är slutfört först när den ursprungliga arbetsbelastningen fungerar eller underlaget visar att ärendet måste eskaleras.

Återskapa en sessionsväg och bevara bevismaterialet

Välj en användare, en webbläsarprofil, ett värdnamn och en inloggningsväg. Dokumentera den första misslyckade förfrågan, statussekvensen, omdirigeringsadresserna, svarens Set-Cookie-huvuden med värdena maskerade, förfrågningens cookies, proxyloggar, apploggar och den exakta konfigurationsändring som föregick felet.

Börja inte med att rensa alla cookies eller byta programmets hemlighet. Använd en privat webbläsarprofil som ren kontrollmiljö och bevara profilen där felet uppstår för jämförelse. Bekräfta om direkt åtkomst till backend fungerar; det skiljer programmets autentisering från URL- och cookiehantering som påverkas av proxyn.

Avbryt om programmet exponerar token i loggar, proxyn godtar förfalskade vidarebefordringshuvuden från obetrodda klienter eller inloggning kringgår TLS. Skydda inloggningsuppgifter och korrigera säkerhetsgränsen innan du fortsätter med felsökningen.

Verifiera schema, värd och tillit till vidarebefordran

Jämför den externa URL:en med vad programmet tror gäller: schema, värd, port, bassökväg och klientens IP-adress. Granska Host, X-Forwarded-Proto eller standardiserade vidarebefordringshuvuden samt programmets lista över betrodda proxyservrar. En backend som tror att HTTPS-förfrågningar använder HTTP kan vägra säkra cookies eller skapa en oändlig omdirigering till HTTPS.

Använd en enda betrodd proxy för att ange eller ersätta vidarebefordringshuvuden och konfigurera programmet så att det bara litar på det proxysteget. Lägg inte blint till värden som skickats av klienten. Testa en inloggning och en absolut omdirigering efter varje ändring i stället för att ändra proxyhuvuden och programmets bas-URL samtidigt.

ZimaSpaces guide om felsökning av direkt inloggning jämfört med inloggning via proxy använder samma jämförelse efter en omstart av proxyn. Dess Immich-exempel är mer avgränsat, men felsökningsmetoden är densamma: bevisa att backend-sessionen fungerar och granska sedan vidarebefordringshuvuden, routning och webbläsarens tillstånd.

Granska cookiens omfattning och webbläsarens beslut

Kontrollera cookiens namn, Domain, Path, Secure, HttpOnly, SameSite, utgångstid och om det finns dubbla cookies med samma namn på olika sökvägar eller domäner. Webbläsarens utvecklarverktyg visar om en cookie sparades, avvisades eller utelämnades i nästa begäran. Serverloggar kan inte ensamma avslöja det beslutet.

OWASP:s beskrivning av SameSite-cookies beteende förklarar hur SameSite-värden styr överföringen av cookies mellan olika webbplatser. Om autentiseringen går över webbplatsgränser eller använder ett inbäddat flöde kräver SameSite=None även Secure. För en enkel applikation som bara används på samma webbplats försvagar en onödigt bredare cookie utformningen.

Radera endast den berörda cookien i kontrollprofilen efter att du har dokumenterat den och upprepa sedan inloggningen. Om en ny cookie fungerar medan den bevarade profilen misslyckas, jämför omfattning och utgångstid. Om båda misslyckas, gå tillbaka till svarshuvuden eller backendens sessionslagring i stället för att upprepade gånger rensa tillståndet.

Kontrollera delat sessionstillstånd och validera lösningen

För applikationer med flera containrar eller replikerade instanser bör du bekräfta att alla instanser använder samma hemlighet för sessionssignering, tidskälla och delad sessionsbackend där det behövs. En proxy som växlar mellan instanser kan ge intryck av slumpmässig utloggning när en instans inte kan validera en annan instans cookie.

PortSwiggers diskussion om SameSite-säkerhetsgränsen fokuserar på säkerhet, men förtydligar att SameSite är en gräns i webbläsaren, inte en generell lösning för att reparera inloggning. Bevara CSRF-skyddet samtidigt som du anpassar dig efter applikationens faktiska ursprung och omdirigeringsflöde.

Validera inloggning, utloggning, utgång vid inaktivitet, omstart av webbläsaren, lösenordsändring och åtkomst via avsedda interna värdnamn och fjärrvärdnamn. Stäng ärendet först när gamla cookies inte längre fungerar på ett säkert sätt, nya sessioner överlever normal routning och ingen vidarebefordran eller cookie-attribut har gjorts mindre strikt än vad det dokumenterade behovet kräver.

Support och tips

Mer att läsa

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.