Lorixen.
DE

Echte Besucher-IP hinter Proxy und CDN richtig auslesen

Kurz gesagt: Sobald Ihre Website hinter einem Load Balancer, einem Reverse Proxy oder einem CDN läuft, sieht Ihre Anwendung nicht mehr die IP-Adresse des Besuchers, sondern die des vorgeschalteten Systems. Dann sperrt der Login-Schutz plötzlich alle Kunden gleichzeitig, Protokolle zeigen nur noch eine einzige Adresse, und Missbrauch lässt sich nicht mehr zuordnen. Die echte Adresse steht im Header X-Forwarded-For oder im standardisierten Header Forwarded. Lesen Sie ihn aber nur aus, wenn er von einem Proxy stammt, den Sie selbst kontrollieren. Sonst kann jeder Besucher eine beliebige Adresse vortäuschen.

Woran Sie das Problem erkennen

Die Symptome tauchen oft erst nach einem Umbau auf, etwa nach dem Wechsel zu einem neuen Hoster, dem Einschalten eines CDN oder dem Umzug in Container:

  • Im Zugriffsprotokoll steht bei allen Anfragen dieselbe interne Adresse, zum Beispiel aus dem Bereich 10.x oder 172.x.
  • Die Begrenzung von Login-Versuchen greift für alle Besucher zugleich, weil scheinbar alle von einer Adresse kommen.
  • Formularschutz und Spamfilter blockieren echte Kunden oder lassen auffällige Anfragen durch.
  • Statistiken zur Herkunft der Besucher sind plötzlich unbrauchbar.

Der Grund ist einfach: Die TCP-Verbindung, die Ihre Anwendung sieht, kommt vom Proxy. Der Besucher hat sich mit dem Proxy verbunden, nicht mit Ihrem Server.

Wie X-Forwarded-For aufgebaut ist

Ein Proxy, der eine Anfrage weiterreicht, hängt die Adresse seines Gegenübers an den Header X-Forwarded-For an. Laut MDN entsteht so eine Liste: Ganz links steht die Adresse des ursprünglichen Clients, ganz rechts die des zuletzt durchlaufenen Proxys. Ein Beispiel:

X-Forwarded-For: 203.0.113.7, 198.51.100.20

Hier hat ein Besucher mit der Adresse 203.0.113.7 einen ersten Proxy erreicht, und dieser hat die Anfrage an einen zweiten weitergegeben. Die Verbindung zu Ihrem Server stammt vom zweiten Proxy.

Der standardisierte Nachfolger heißt Forwarded. Er fasst die Angaben in Schlüssel-Wert-Paaren zusammen, etwa for für den Client, by für den Proxy, proto für das Protokoll und host für den angefragten Host. In der Praxis begegnet Ihnen trotzdem meist X-Forwarded-For, weil viele Load Balancer und CDNs ihn setzen.

Die Falle: Der linke Eintrag kann gefälscht sein

Der Header ist ein ganz normaler Text, den jeder Client selbst mitschicken kann. Wer Ihre Seite aufruft, kann also einen erfundenen X-Forwarded-For mitsenden. Ihr Proxy hängt dann nur seine Beobachtung hinten an. Der linke Eintrag stammt in diesem Fall vom Angreifer.

MDN weist ausdrücklich darauf hin: Jeder Teil des Headers, der nicht von einem vertrauenswürdigen Proxy hinzugefügt wurde, kann gefälscht sein. Wer naiv den ersten Eintrag übernimmt, öffnet zwei Probleme. Ein Angreifer kann die Sperre nach fehlgeschlagenen Logins umgehen, indem er bei jedem Versuch eine andere Adresse vortäuscht. Und er kann gezielt eine fremde Adresse eintragen, damit ein unbeteiligter Kunde gesperrt wird.

Die sichere Regel: von rechts lesen, nur vertrauenswürdige Proxys überspringen

Sicher ist folgendes Vorgehen:

  1. Legen Sie fest, welche Proxys Ihnen gehören oder vertraglich zu Ihrer Infrastruktur zählen, etwa Ihr Load Balancer und die Adressbereiche Ihres CDN.
  2. Prüfen Sie zuerst, ob die direkte Verbindung überhaupt von einem dieser Proxys kommt. Wenn nicht, ignorieren Sie den Header vollständig.
  3. Lesen Sie die Liste von rechts nach links und überspringen Sie jede Adresse, die zu Ihren vertrauenswürdigen Proxys gehört.
  4. Die erste Adresse, die nicht dazugehört, behandeln Sie als Besucher-IP.

So kann ein Angreifer zwar links beliebige Einträge erfinden, an Ihre Auswertung kommt er damit aber nicht heran, denn die rechten Einträge stammen von Systemen, denen Sie vertrauen.

Umsetzung im Webserver

Wenn vor Ihrer Anwendung ein nginx läuft, übernimmt das Modul ngx_http_realip_module diese Arbeit. Laut nginx-Dokumentation legen Sie mit set_real_ip_from die vertrauenswürdigen Adressen fest und mit real_ip_header den Header, aus dem die Adresse stammen soll. Ohne weitere Angabe liest nginx X-Real-IP. Mit real_ip_recursive on ersetzt nginx die Adresse durch die letzte nicht vertrauenswürdige Adresse im Header, genau wie in der Regel oben beschrieben. Die ursprüngliche Verbindungsadresse bleibt in der Variablen realip_remote_addr erhalten. Das Modul ist laut Dokumentation nicht in jedem Build enthalten und muss beim Kompilieren aktiviert sein. Bei Paketen aus gängigen Distributionen ist das oft bereits der Fall, prüfen Sie es aber.

Ein schlankes Beispiel:

set_real_ip_from 10.0.0.0/8;
real_ip_header X-Forwarded-For;
real_ip_recursive on;

Tragen Sie hier nur die Bereiche ein, die tatsächlich zu Ihrem Load Balancer gehören. Ein zu weit gefasster Bereich macht die Regel wirkungslos.

Umsetzung in der Anwendung

Viele Web-Frameworks haben eine Einstellung, die festlegt, welchen Proxys sie vertrauen. In Express heißt sie zum Beispiel trust proxy, andere Frameworks sprechen von Trusted Proxies. Setzen Sie diese Einstellung nicht pauschal auf „allen vertrauen“, sondern auf die konkrete Zahl der Proxy-Stufen oder deren Adressbereiche. Danach liefert die übliche Abfrage der Client-Adresse den korrekten Wert, und alle Funktionen, die darauf aufbauen, arbeiten wieder richtig.

Manche CDNs setzen zusätzlich einen eigenen Header mit der Besucheradresse. Den dürfen Sie nur verwenden, wenn Ihr Server ausschließlich Verbindungen von diesem CDN annimmt. Ist der Server auch direkt erreichbar, kann jeder diesen Header ebenso fälschen.

Prüfen, ob alles stimmt

Testen Sie die Umstellung mit drei Fällen:

  • Normaler Aufruf über die öffentliche Adresse: Im Protokoll muss Ihre eigene öffentliche IP erscheinen, nicht die des Proxys.
  • Aufruf mit einem selbst gesetzten, erfundenen X-Forwarded-For: Im Protokoll darf weiterhin nur Ihre echte Adresse stehen.
  • Direktaufruf des Servers unter Umgehung des Proxys, falls möglich: Der Header muss ignoriert werden. Besser noch, der Server nimmt solche Verbindungen gar nicht an.

Kontrollieren Sie danach die Funktionen, die von der Adresse abhängen: Login-Sperre, Formularschutz, Protokolle und gegebenenfalls Ihre Statistik.

Beispiel aus der Praxis

Ein Onlineshop für Ersatzteile in Leipzig stellte auf einen Load Balancer um. Am nächsten Morgen meldeten mehrere Kunden, dass sie sich nicht mehr anmelden konnten. Die Login-Sperre zählte alle Fehlversuche einer einzigen Adresse zu, nämlich der des Load Balancers. Nach der Umstellung liest die Anwendung X-Forwarded-For von rechts, vertraut nur dem eigenen Load Balancer und sperrt wieder einzelne Adressen statt aller Kunden. Das Beispiel ist illustrativ.

Häufige Fragen

Kann ich einfach den ersten Eintrag in X-Forwarded-For nehmen?

Nur wenn Sie sicher sind, dass jeder Eintrag von Ihren eigenen Proxys stammt. In der Regel ist das nicht garantiert, deshalb ist das Lesen von rechts der sicherere Weg.

Was ist der Unterschied zwischen X-Forwarded-For und Forwarded?

Forwarded ist der standardisierte Header mit klar benannten Feldern. X-Forwarded-For ist älter, aber weiter verbreitet. Für die Vertrauensfrage gelten bei beiden dieselben Regeln.

Was passiert, wenn ich IPv6 nutze?

Die Logik bleibt gleich. Achten Sie nur darauf, dass Ihre Liste vertrauenswürdiger Proxys auch deren IPv6-Bereiche enthält.

Muss ich die IP-Adresse überhaupt speichern?

Für Sicherheitsfunktionen wie Login-Sperren brauchen Sie sie meist kurzfristig. Wie lange Sie Protokolle aufbewahren, sollten Sie bewusst festlegen und sparsam halten.

Wenn Ihre Anwendung hinter einem Proxy die falschen Adressen sieht, richten wir die Erkennung gerne mit Ihnen sauber ein: Proxy-Einstellung prüfen lassen.

Quellen

WhatsAppTermin buchen