Hinter einem Reverse Proxy: weitergeleiteten Headern richtig vertrauen

Ziel

Der Anwendung die echte Client-Adresse und das echte Schema für Rate Limiting, Protokollierung und Weiterleitungen bekannt machen, ohne Clients eine Möglichkeit zu geben, diese zu fälschen.

Voraussetzungen

Die exakte Adresse (oder ein kleiner CIDR-Bereich) des Proxys im Netzwerk der Anwendung, sowie Kenntnis darüber, welche Header der Proxy setzt und ob er eingehende Header entfernt.

Schritte

1. Den Proxy so konfigurieren, dass er Weiterleitungsheader überschreibt oder ergänzt, statt vom Client gelieferte unverändert durchzureichen.
2. In der Anwendung Weiterleitungsheadern nur vertrauen, wenn der TCP-Peer der Proxy ist; andernfalls die Peer-Adresse als Client-Adresse verwenden.
3. X-Forwarded-For von rechts (dem Eintrag des Proxys) nach links durchlaufen und beim ersten Eintrag stoppen, der kein vertrauenswürdiger Proxy ist; das ist der Client. Nie blind den am weitesten links stehenden Wert übernehmen.
4. Das Schema nur unter derselben Vertrauensregel aus X-Forwarded-Proto (oder dem Standard-Header Forwarded nach RFC 7239) übernehmen; es für den Aufbau absoluter URLs und Entscheidungen über sichere Cookies verwenden.
5. Den Host-Header gegen eine Allow-Liste validieren und kanonische URLs aus der Konfiguration ableiten, nicht aus der Anfrage.
6. Mit gefälschten Headern von einem nicht vertrauenswürdigen Peer testen und bestätigen, dass sie ignoriert werden.

Erwartetes Ergebnis

Rate Limits greifen auf den echten Client, Logs zeigen echte Adressen, und ein Client kann Limits nicht umgehen, indem er X-Forwarded-For: 1.2.3.4 sendet.

Grenzen und Prüfbasis

Vertraut man einem ganzen gemeinsam genutzten Subnetz, kann jeder Container darin fälschen. Mehrere Proxy-Schichten (CDN plus lokaler Proxy) benötigen alle Hops in der vertrauenswürdigen Liste. Die Regeln folgen den zitierten Referenzen und den eigenen Middleware-Tests dieses Wikis.