Leitfaden zur Fehlerbehebung bei Sitzungen selbst gehosteter Apps bei Proxy- und Cookie-Änderungen

Eva Wong ist die technische Redakteurin und begeisterte Tüftlerin bei ZimaSpace. Als lebenslanger Geek mit einer Leidenschaft für Homelabs und Open-Source-Softwarehat sie sich darauf spezialisiert, komplexe technische Konzepte in verständliche, praxisnahe Anleitungenzu übersetzen. Eva ist überzeugt, dass Self-Hosting Spaß machen sollte und nicht einschüchternd sein darf. Mit ihren Tutorials hilft sie der Community dabei, Hardware-Setups zu durchschauen, vom Bau des ersten NAS bis zum sicheren Umgang mit Docker-Containern.

Der sichere Ansatz besteht darin, den schichtweisen Vergleich direkter und weitergeleiteter Anfragen, Antwort-Cookies, Browser-Speicher und Backend-Sitzungsstatus als Abfolge überprüfbarer Prüfpunkte zu behandeln, nicht als einzelnen Befehl.

Bei einer selbst gehosteten Webanwendung hinter einem Reverse-Proxy besteht das praktische Risiko darin, dass Benutzer abgemeldet werden, in einer Weiterleitungsschleife feststecken oder nach Änderungen am Proxy oder an Cookies keine Sitzung einrichten können. Halten Sie den aktuellen Zustand und den Wiederherstellungspunkt fest, beginnen Sie mit der am wenigsten invasiven Unterscheidungsprüfung, werten Sie erfolgreiche und fehlgeschlagene Ergebnisse aus, bevor Sie eine weitere Variable ändern, und brechen Sie ab, wenn der Speicher instabil wird oder die einzige wiederherstellbare Kopie offengelegt würde. Der folgende Ablauf endet erst, wenn die ursprüngliche Arbeitslast erfolgreich ausgeführt wird oder die Belege eine Eskalation erfordern.

Einen Sitzungsablauf reproduzieren und Belege sichern

Wählen Sie einen Benutzer, ein Browserprofil, einen Hostnamen und einen Anmeldeweg. Halten Sie die erste fehlgeschlagene Anfrage, die Statusabfolge, die Weiterleitungsziele, die Antwortheader Set-Cookie mit geschwärzten Werten, Anfrage-Cookies, Proxy-Protokolle, Anwendungsprotokolle und die genaue Konfigurationsänderung fest, die dem Fehler vorausging.

Beginnen Sie nicht damit, alle Cookies zu löschen oder das Anwendungsgeheimnis zu ändern. Verwenden Sie ein privates Browserprofil als saubere Kontrollumgebung und behalten Sie das fehlerhafte Profil zum Vergleich bei. Prüfen Sie, ob der direkte Zugriff auf das Backend funktioniert; so lässt sich das Anwendungsauthentifizierungsproblem von URL- und Cookie-Verhalten durch den Proxy unterscheiden.

Beenden Sie den Vorgang, wenn die Anwendung Tokens in Protokollen offenlegt, der Proxy gefälschte Weiterleitungsheader von nicht vertrauenswürdigen Clients akzeptiert oder die Anmeldung TLS umgeht. Schützen Sie Zugangsdaten und korrigieren Sie die Sicherheitsgrenze, bevor Sie mit der funktionalen Fehlersuche fortfahren.

Schema, Host und Vertrauen in Weiterleitungsheader überprüfen

Vergleichen Sie die externe URL mit den Angaben der Anwendung: Schema, Host, Port, Basispfad und Client-IP. Prüfen Sie Host, X-Forwarded-Proto oder standardisierte Weiterleitungsheader sowie die Liste der vertrauenswürdigen Proxys der Anwendung. Wenn ein Backend HTTPS-Anfragen für HTTP hält, kann es Secure-Cookies ablehnen oder eine endlose Weiterleitung zu HTTPS erzeugen.

Verwenden Sie einen vertrauenswürdigen Proxy, um Weiterleitungsheader zu setzen oder zu ersetzen, und konfigurieren Sie die Anwendung so, dass sie nur diesem Proxy vertraut. Hängen Sie nicht ungeprüft vom Client gelieferte Werte an. Testen Sie nach jeder Änderung eine Anmeldung und eine absolute Weiterleitung, statt Proxy-Header und Basis-URL der Anwendung gleichzeitig zu ändern.

Die ZimaSpace-Anleitung zur Diagnose direkter und über einen Proxy vermittelter Anmeldungen verwendet nach einem Proxy-Neustart denselben Vergleich zwischen direktem und vermitteltem Zugriff. Ihr Immich-Beispiel ist enger gefasst, aber der Diagnoseweg lässt sich übertragen: Weisen Sie nach, dass die Backend-Sitzung funktioniert, und prüfen Sie anschließend Weiterleitungsheader, Routing und Browserstatus.

Cookie-Gültigkeitsbereich und Browserentscheidungen prüfen

Prüfen Sie Cookie-Name, Domain, Path, Secure, HttpOnly, SameSite, Ablaufzeit und ob doppelte Cookies mit demselben Namen unter verschiedenen Pfaden oder Domains vorhanden sind. In den Entwicklertools des Browsers sehen Sie, ob ein Cookie gespeichert, abgelehnt oder bei der nächsten Anfrage weggelassen wurde. Serverprotokolle allein können diese Entscheidung nicht erkennen lassen.

OWASPs Erläuterung des SameSite-Cookie-Verhaltens beschreibt, wie SameSite-Werte die Übermittlung von Cookies zwischen verschiedenen Websites steuern. Wenn die Authentifizierung websiteübergreifend erfolgt oder einen eingebetteten Ablauf verwendet, erfordert SameSite=None außerdem Secure. Bei einer einfachen Anwendung innerhalb derselben Website schwächt eine unnötige Ausweitung den Schutz.

Löschen Sie im Kontrollprofil nur das betroffene Cookie, nachdem Sie es dokumentiert haben, und wiederholen Sie dann die Anmeldung. Funktioniert ein neues Cookie, während das beibehaltene Profil fehlschlägt, vergleichen Sie Gültigkeitsbereich und Ablaufzeit. Schlagen beide fehl, prüfen Sie erneut die Antwortheader oder den Sitzungsdatenspeicher des Backends, anstatt den Status immer wieder zu löschen.

Gemeinsamen Sitzungsstatus prüfen und die Korrektur validieren

Bei Anwendungen mit mehreren Containern oder Replikaten sollten Sie sicherstellen, dass alle Instanzen dasselbe Sitzungssignaturgeheimnis, dieselbe Zeitquelle und bei Bedarf dasselbe gemeinsame Sitzungs-Backend verwenden. Ein Proxy, der zwischen Instanzen wechselt, kann wie eine zufällige Abmeldung wirken, wenn eine Instanz das Cookie einer anderen nicht validieren kann.

Die sicherheitsorientierte Erläuterung von PortSwigger zur SameSite-Sicherheitsgrenze macht deutlich, dass SameSite eine Browsergrenze und kein allgemeiner Schalter zur Reparatur der Anmeldung ist. Behalten Sie den CSRF-Schutz bei und stimmen Sie die Konfiguration auf den tatsächlichen Origin- und Weiterleitungsablauf der Anwendung ab.

Prüfen Sie Anmeldung, Abmeldung, Ablauf bei Inaktivität, Browserneustart, Passwortänderung und den Zugriff über die vorgesehenen internen und externen Hostnamen. Schließen Sie das Problem erst, wenn alte Cookies sicher fehlschlagen, neue Sitzungen bei normalem Routing bestehen bleiben und keine Weiterleitungs- oder Cookie-Attribute über das dokumentierte Erfordernis hinaus gelockert wurden.

Support und Tipps

Mehr zum Lesen

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.