Warum tritt eine Anmeldeschleife bei einer Private Cloud nur außerhalb des Heimnetzwerks auf?

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.

Eine Anmeldeschleife, die nur von außerhalb auftritt, bedeutet meist, dass der Remote-Proxy-Pfad das von der Anwendung erkannte Protokoll, den Hostnamen, das Cookie, den Callback oder die Sitzungsinformationen verändert.

Zu Hause kann sich ein Browser über die lokale Adresse direkt mit dem Private-Cloud-Dienst verbinden, während externe Nutzer über öffentliches DNS, TLS-Terminierung, einen Reverse-Proxy, eine Forward-Auth-Ebene, einen Tunnel oder einen Identitätsanbieter zugreifen. Die Anmeldedaten können korrekt akzeptiert werden, doch bei der nächsten Anfrage wird wieder die Anmeldeseite aufgerufen, weil das Sitzungscookie nicht gespeichert oder zurückgesendet wird, das Backend HTTPS als HTTP interpretiert, die Callback-URL vom registrierten Wert abweicht oder die Anwendung Weiterleitungen für ihren internen Hostnamen erzeugt.

Die genaue Weiterleitungsschleife im Browser aufzeichnen

Öffnen Sie das Netzwerk-Panel des Browsers, bevor Sie sich von außerhalb Ihres Zuhauses anmelden. Speichern Sie das Anfrageprotokoll und notieren Sie jeden Statuscode, jeden Location-Header, jeden Set-Cookie-Header, den Hostnamen der Anfrage und ob das Sitzungscookie bei der nächsten Anfrage mitgesendet wird.

Ein Leitfaden zur Fehlerbehebung bei Keycloak empfiehlt, die gesamte Weiterleitungskette zu beobachten, da fehlende Weiterleitungs-Header, der Cookie-Gültigkeitsbereich und Callbacks selbst dann eine endlose Anmeldeweiterleitung verursachen können, wenn die Passwortprüfung erfolgreich ist.

Wenn kein Cookie ausgegeben wird, untersuchen Sie die Antwort der Anwendung und des Proxys. Wenn ein Cookie ausgegeben, aber nicht zurückgesendet wird, prüfen Sie dessen Domain-, Pfad-, Secure- und SameSite-Attribute. Wenn das Cookie zurückgesendet wird, die Anwendung aber weiterhin weiterleitet, fahren Sie mit dem Proxy-Vertrauen und der Sitzungsspeicherung fort.

Lokale und öffentliche Hostnamen und Protokolle vergleichen

Notieren Sie die genaue lokale und öffentliche URL, einschließlich http oder https, Hostname, Port und Unterpfad. Prüfen Sie, ob in der Anwendung eine kanonische oder externe Basis-URL konfiguriert ist.

Eine Analyse von WordPress hinter einem Reverse-Proxy erklärt, dass das Backend wiederholt zu HTTPS weiterleiten kann, wenn es die Anfrage für HTTP hält, während der Proxy weiterhin TLS beendet. Die Schleife entsteht durch eine fehlerhafte HTTPS-Erkennung hinter dem Proxy und nicht durch das Passwort des Benutzers.

Verwenden Sie für Remote-Anmeldungen, Callbacks und Cookies durchgehend denselben öffentlichen Hostnamen. Mischen Sie innerhalb eines Authentifizierungsablaufs nicht die öffentliche Domain, private IP-Adresse, den internen Hostnamen und alternative Ports, es sei denn, die Anwendung unterstützt ausdrücklich mehrere vertrauenswürdige Ursprünge.

Weitergeleitete Host- und Protokoll-Header überprüfen

Prüfen Sie die Reverse-Proxy-Konfiguration und Backend-Protokolle auf X-Forwarded-Proto, X-Forwarded-Host, X-Forwarded-Port und die ursprüngliche Clientadresse. Vergewissern Sie sich, dass die Anwendung nur dem bekannten Proxy vertraut und dieselbe öffentliche URL rekonstruiert, die der Browser verwendet hat.

Ein Fall mit qBittorrent hinter einem Reverse-Proxy weist darauf hin, dass eine Anmeldeseite geladen werden und Zugangsdaten akzeptieren kann, während ein nicht übereinstimmender Host- oder HTTPS-Header verhindert, dass die authentifizierte Sitzung erkannt wird.

Wenn der Proxy die korrekten öffentlichen Werte sendet, die Anwendung sie aber ignoriert, konfigurieren Sie die Einstellungen für vertrauenswürdige Proxys und externe URLs der Anwendung. Wenn der Proxy sie nicht mitsendet, fügen Sie nur die erforderlichen Header hinzu, statt alle vom Client bereitgestellten Header unverändert weiterzuleiten.

Single board computer zimaboard2

Cookie-Domain, Path, Secure und SameSite prüfen

Vergleichen Sie das lokal erstellte Sitzungscookie mit dem über die öffentliche Domain erstellten. Ein Cookie, das auf einen internen Hostnamen, eine falsche übergeordnete Domain, einen anderen Unterpfad oder einen nicht sicheren Kontext beschränkt ist, wird möglicherweise nicht bei der weitergeleiteten öffentlichen Anfrage mitgesendet.

Der externer Zugriff bringt oft eine weitere Authentifizierungsdomäne oder einen domainübergreifenden Callback mit sich. SameSite-Einschränkungen und Secure-Anforderungen können daher den Remote-Ablauf beeinflussen, obwohl eine direkte lokale Anmeldung nie den Ursprung wechselt.

Löschen Sie Cookies nur für die betroffenen Private-Cloud-Domains, reproduzieren Sie die Schleife und prüfen Sie die neuen Attribute. Korrigieren Sie die öffentliche URL und die Cookie-Einstellungen der Anwendung oder des Proxys. Verwenden Sie keine browserweite Lockerung der Cookie-Einstellungen als dauerhafte serverseitige Lösung.

OAuth-, OIDC- oder Forward-Auth-Callback-Identität überprüfen

Wenn die private Cloud einen Identitätsanbieter oder einen Forward-Auth-Dienst verwendet, vergleichen Sie die Callback-URL, die von der App generiert, beim Anbieter registriert und vom Browser aufgerufen wird. Schema, Hostname, Port, Pfad und abschließender Schrägstrich müssen möglicherweise exakt übereinstimmen.

Ein Fall aus der NGINX-Community beschreibt eine Anmeldeschleife beim Fernzugriff, bei der TLS am Proxy terminiert wird, das Backend jedoch HTTP erkennt. Daher kann die Anwendung die erwartete sichere externe Sitzung nicht aufrechterhalten.

Testen Sie den Callback-Endpunkt direkt über die öffentliche Domain und bestätigen Sie, dass die Anfrage die richtige Proxy-Route und das richtige Backend erreicht. Wenn die Authentifizierung erfolgreich ist, der Callback aber die Anmeldung erneut startet, überprüfen Sie Status, Nonce, Cookie-Beständigkeit, Zeitsynchronisierung und die genaue Redirect-URI.

Die vollständige Remotesitzung ohne Umgehung des Proxys überprüfen

Nachdem Sie eine Ursache behoben haben, beginnen Sie mit einem neuen privaten Browserfenster in einem externen Netzwerk. Melden Sie sich an, aktualisieren Sie das Dashboard, öffnen Sie eine Datei, warten Sie länger als das kurze Sitzungsintervall und verbinden Sie sich erneut, um zu bestätigen, dass die Sitzung bei normaler Navigation bestehen bleibt.

Der ZimaSpace-Leitfaden zu kontrolliertem NAS-Fernzugriff beschreibt den übergeordneten Sicherheitsrahmen: Die Behebung der Schleife sollte weder erfordern, das Backend direkt offenzulegen, noch die Authentifizierung zu deaktivieren.

Das Problem ist erst behoben, wenn lokale und externe Nutzer den vorgesehenen Hostnamen erreichen, der Proxy die öffentliche Anforderungsidentität beibehält, das Cookie gültig bleibt und der vollständige Anmelde- und Callback-Ablauf wiederholt erfolgreich ist. Entfernen Sie nach der Überprüfung vorübergehende Umgehungen und ausführliche Authentifizierungsprotokolle.

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.