So überprüfen Sie, ob ein Reverse-Proxy die richtige Client-IP-Adresse übermittelt

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.

Überprüfe die Weiterleitung der Client-IP, indem du eine bekannte externe Quelle mit jedem Proxy-Header und der endgültig ausgelesenen Adresse im Backend vergleichst.

Ein Reverse-Proxy beendet die Clientverbindung, daher sieht das Backend normalerweise die Socket-Adresse des Proxys, sofern der Proxy keine vertrauenswürdigen Anfragemetadaten weitergibt. Beim Test müssen die direkte Peer-Adresse und Forwarded, X-Forwarded-For sowie X-Real-IP voneinander unterschieden, jeder vertrauenswürdige Hop dokumentiert und nachgewiesen werden, dass ein Internet-Client den für Protokolle, Ratenbegrenzungen oder Zugriffskontrollen verwendeten Wert nicht fälschen kann.

Führe von außerhalb des Heimnetzwerks einen Test mit bekannter Client-IP durch

Verwende ein Gerät im Mobilfunknetz oder in einem anderen externen Netzwerk und notiere unmittelbar vor der Anfrage dessen öffentliche IPv4- oder IPv6-Adresse. Sende einen eindeutigen Pfad, Abfragewert oder Zeitstempel über den öffentlichen Reverse-Proxy.

MDN beschreibt X-Forwarded-For als De-facto-Header, mit dem die ursprüngliche Clientadresse über Proxy-Verbindungen hinweg erhalten bleibt.

Sammle für diese eine Anfrage das Protokoll des Edge-Proxys, aller zwischengeschalteten Proxys und der Backend-Anwendung. Ohne bekannte Quelle und zugehörigen Zeitstempel können mehrere gleichzeitige Benutzer die Header-Kette mehrdeutig machen.

Protokolliere den Socket-Peer und alle weitergeleiteten Header

Protokolliere im Backend die direkte TCP-Peer-Adresse separat von Forwarded, X-Forwarded-For, X-Real-IP und allen CDN-spezifischen Client-Headern. Überschreibe die Rohwerte beim ersten Test nicht.

Eine praktische Analyse des Umgangs mit der „echten“ Client-IP weist darauf hin, dass die Genauigkeit davon abhängt, wie der Proxy Header setzt oder ergänzt und ob frühere Werte gefälscht werden können. Das gesamte Proxy-Vertrauensmodell muss der tatsächlichen Netzwerkarchitektur entsprechen.

Der Socket-Peer des Backends sollte dem unmittelbar vorgeschalteten vertrauenswürdigen Proxy entsprechen, während die ausgewählte Clientadresse der externen Testvorrichtung entsprechen sollte. Wenn das Backend nur die Proxy-Adresse protokolliert, fehlt die Erstellung oder das Auslesen des Headers.

Prüfe, wie jeder Proxy den Header hinzufügt oder ersetzt

Prüfe jeden Hop vom CDN oder Tunnel über Edge-Proxy und internen Proxy bis zur Anwendung. Halte fest, ob jeder Hop eine vorhandene Liste erweitert, nicht vertrauenswürdige Eingaben ersetzt oder den Header unverändert weitergibt.

Sling Academy erklärt, dass NGINX X-Real-IP anhand der unmittelbaren Verbindung setzen und mit proxy_add_x_forwarded_for eine Kette anhängen kann.

Konfigurieren Sie den ersten vertrauenswürdigen Edge so, dass er vom Client gesetzte Weiterleitungs-Header entfernt oder ersetzt und an kontrollierten internen Hops Adressen ergänzt. Akzeptieren Sie nicht blind den ganz linken oder rechten Wert, ohne festzulegen, wie viele Proxys vertrauenswürdig sind.

Das Backend so konfigurieren, dass es nur bekannte Proxy-Adressen als vertrauenswürdig behandelt

Legen Sie in der Anwendung oder im Webserver eine Liste mit genau den vertrauenswürdigen Proxy-Adressen oder kontrollierten Subnetzen fest. Vergewissern Sie sich, dass direkte Verbindungen von gewöhnlichen LAN- oder Internet-Clients nicht als vertrauenswürdige Header-Quellen behandelt werden.

In der Erklärung von Ip2Geo wird darauf hingewiesen, dass die Anwendungsverbindung vom Load Balancer oder Reverse-Proxy ausgeht und die sichere Auswertung der ursprünglichen IP eine Regel für vertrauenswürdige Hops erfordert, statt beliebige Eingaben zu akzeptieren.

Ändert sich die Proxy-Adresse aufgrund von Containern, Overlay-Netzwerken oder einem CDN, dokumentieren Sie den unterstützten Adressbereich und aktualisieren Sie ihn bewusst. Vertrauen Sie nicht allen privaten Adressen, nur weil der Proxy derzeit eine davon verwendet.

Einen Test mit gefälschtem Header durchführen

Senden Sie vom externen Testgerät aus einen gefälschten X-Forwarded-For- oder Forwarded-Wert, während Sie über den echten Proxy verbunden sind. Vergleichen Sie den eingehenden Roh-Header, den normalisierten Proxy-Header und die vom Backend ausgewählte Client-Adresse.

Das richtige Ergebnis ist, dass der vertrauenswürdige Edge nicht vertrauenswürdige Eingaben ersetzt oder sicher ergänzt und das Backend die Adresse anhand der dokumentierten Anzahl vertrauenswürdiger Hops auswählt. Eine gefälschte Adresse darf nicht für die Authentifizierung oder Zulassungslisten verwendet werden.

Wiederholen Sie den Test direkt zum Backend von einem LAN-Segment aus, sofern der Port erreichbar ist. Das Backend sollte weitergeleitete Header von einem nicht vertrauenswürdigen direkten Client ignorieren und den tatsächlichen Socket-Peer protokollieren.

IPv4-, IPv6- und Multi-Proxy-Pfade validieren

Wiederholen Sie den Test über IPv4 und IPv6, über den regulären öffentlichen Hostnamen sowie über alle in der Produktion verwendeten CDNs, Tunnel oder zusätzlichen Proxys. Vergewissern Sie sich, dass die Protokolle gültige Adressformate beibehalten und die Kette nicht abgeschnitten wird.

Der ZimaSpace-Leitfaden zu Identität von Reverse-Proxy-Anfragen bietet den Kontext dazu, warum korrekte weitergeleitete Werte über die Protokollierung hinaus wichtig sind.

Der Proxy gilt erst dann als überprüft, wenn die bekannte Quelle mit der ermittelten Client-IP übereinstimmt, vertrauenswürdige Proxys in der Rohkette sichtbar bleiben, Spoofing-Versuche scheitern und Sicherheitskontrollen durchgängig denselben normalisierten Wert verwenden. Prüfen Sie erneut, nachdem Sie ein CDN, einen Tunnel oder einen weiteren Proxy-Hop hinzugefügt haben.

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.