X-Forwarded-For (XFF) ist ein HTTP-Anforderungsheader, der die ursprüngliche IP-Adresse eines Clients identifiziert, der über einen Proxy mit einem Webserver verbunden ist. Ohne ihn sieht der Server nur die IP des letzten Proxys. Da der Header die IP des Clients absichtlich offenlegt, gibt ein Proxy, der ihn hinzufügt, Ihre ursprüngliche Adresse an die Zielseite weiter.

Jeder Proxy in der Kette fügt die IP-Adresse hinzu, von der er die Verbindung erhalten hat. Der linkeste Eintrag ist der angegebene Client und der rechteste ist der zuletzt verwendete Proxy, zum Beispiel X-Forwarded-For: 203.0.113.195, 198.51.100.178.

Standardstatus und verwandte Header

  • De-facto-Standard: XFF wird häufig verwendet, ist jedoch in keiner aktuellen Spezifikation definiert.
  • Forwarded-Header: RFC 7239 definiert einen Standard Forwarded Header für dieselben Informationen, wird jedoch in der Praxis viel seltener verwendet.
  • Begleitheader: X-Forwarded-Host, X-Forwarded-Proto und Via enthalten verwandte Proxy-Details.
  • Lastenausgleich: Einige Lastenausgleicher ermöglichen es Ihnen, die Client-IP an XFF anzuhängen, sie unverändert durchzureichen oder sie zu entfernen.

Vertrauen und Spoofing

Ein Client kann einen gefälschten X-Forwarded-For-Header senden, daher sind nur Adressen, die von vertrauenswürdigen Proxys hinzugefügt wurden, zuverlässig. Server, die XFF für die Ratenbegrenzung oder Zugriffskontrolle verwenden, sollten die Liste von rechts lesen, bekannte vertrauenswürdige Proxys überspringen und die linkesten Werte als nicht vertrauenswürdig behandeln. Wenn der Server auch direkt aus dem Internet erreichbar ist, kann kein Teil der Liste vertraut werden.

Wofür X-Forwarded-For verwendet wird

Ein Server hinter einem Proxy oder Lastenausgleich protokolliert nur die IP-Adresse dieses Geräts. XFF ermöglicht es, die Adresse des Clients für Debugging, Statistiken und standortabhängige Inhalte wiederherzustellen.

Lesen von X-Forwarded-For in NGINX

Das Realip-Modul von NGINX ersetzt die Client-Adresse durch eine, die aus einem Header wie X-Forwarded-For entnommen wurde.

  • set_real_ip_from: Listet vertrauenswürdige Adressen auf, die bekannt dafür sind, korrekte Werte zu senden.
  • real_ip_header X-Forwarded-For;: Sagt NGINX, welchen Header es lesen soll.
  • real_ip_recursive on;: Verwendet die letzte Adresse im Header, die nicht vertrauenswürdig ist, anstelle der letzten Adresse insgesamt.

Das Modul ist standardmäßig nicht eingebaut. Es benötigt die --with-http_realip_module Build-Option.

Verwandte Begriffe