Så verifierar du att en reverse proxy skickar rätt klient-IP

Eva Wong är teknisk skribent och händig hemmabyggare på ZimaSpace. Som tekniknörd sedan barnsben med ett brinnande intresse för hemlabb och programvara med öppen källkodspecialiserar hon sig på att göra komplexa tekniska koncept begripliga genom praktiska, praktiska guider. Eva tycker att självhosting ska vara roligt, inte avskräckande. Genom sina handledningar hjälper hon communityn att göra hårdvaruinstallationer mindre mystiska, från att bygga sin första NAS till att bemästra Docker-containrar.

Verifiera vidarebefordran av klient-IP genom att jämföra en känd extern källa med varje proxyhuvud och backendens slutligt parsade adress.

En omvänd proxy avslutar klientanslutningen, så backend ser normalt proxyns socketadress om inte proxyn vidarebefordrar betrodda metadata för begäran. Testet måste skilja den direkta peeradressen från Forwarded, X-Forwarded-For och X-Real-IP, dokumentera varje betrott steg och bevisa att en internetklient inte kan förfalska värdet som används för loggar, hastighetsbegränsningar eller åtkomstkontroll.

Skapa ett test med en känd klient-IP-adress utifrån hemnätverket

Använd en enhet med mobildata eller ett annat externt nätverk och anteckna dess offentliga IPv4- eller IPv6-adress omedelbart före begäran. Skicka en unik sökväg, ett frågevärde eller en tidsstämpel via den publika omvända proxyn.

MDN beskriver X-Forwarded-For som en de facto-rubrik för att bevara den ursprungliga klientadressen genom proxyanslutningar.

Samla in edge-proxyns logg, eventuella mellanliggande proxyl.loggar och backendapplikationens logg för just den begäran. Utan en känd källa och en korrelerad tidsstämpel kan flera samtidiga användare göra rubrikkedjan tvetydig.

Registrera socket-peeradressen och alla vidarebefordrade rubriker

Logga backendens direkta TCP-peeradress separat från Forwarded, X-Forwarded-For, X-Real-IP och eventuella klientspecifika CDN-rubriker. Skriv inte över råvärdena under det första testet.

En praktisk analys av hanteringen av klientens ”riktiga” IP-adress varnar för att precisionen beror på hur proxyn anger eller lägger till rubriker och på om tidigare värden kan förfalskas. Den fullständiga modellen för proxytillit måste stämma överens med den faktiska nätverksarkitekturen.

Socket-peeradressen i backend ska vara samma som den omedelbara betrodda proxyn, medan den valda klientadressen ska vara samma som den externa testenheten. Om backend bara loggar proxyadressen saknas skapande eller parsning av rubriken.

Kontrollera hur varje proxy lägger till eller ersätter rubriken

Granska varje steg från CDN eller tunnel till edge-proxy, intern proxy och applikation. Anteckna om varje steg lägger till värden i en befintlig lista, ersätter opålitlig indata eller skickar vidare rubriken oförändrad.

Sling Academy förklarar att NGINX kan ange X-Real-IP utifrån den omedelbara anslutningen och lägga till en kedja med proxy_add_x_forwarded_for.

Konfigurera den första betrodda kanten så att klientangivna vidarebefordringsheaders tas bort eller ersätts, och lägg sedan till adresser vid kontrollerade interna proxyhopp. Godta inte blint det vänstraste eller högstraste värdet utan att ange hur många proxyservrar som är betrodda.

Konfigurera backend att endast lita på kända proxyadresser

Ange den exakta listan över omvända proxyadresser eller kontrollerade subnät som betrodda proxyservrar i applikationen eller webbservern. Bekräfta att direktanslutningar från vanliga LAN- eller internetklienter inte behandlas som betrodda källor för headers.

Ip2Geos förklaring påpekar att applikationens anslutning kommer från lastbalanseraren eller den omvända proxyn och att det krävs en regel för betrodda proxyhopp för att tolka den ursprungliga IP-adressen säkert, i stället för att godta godtycklig indata.

Om proxyadressen ändras på grund av containrar, överlagrade nätverk eller ett CDN ska du dokumentera det tillåtna intervallet och uppdatera det medvetet. Betro inte alla privata adresser bara för att proxyn för närvarande använder en sådan adress.

Kör ett test med förfalskade headers

Skicka ett förfalskat värde för X-Forwarded-For eller Forwarded från den externa testenheten samtidigt som du ansluter via den riktiga proxyn. Jämför den ursprungliga inkommande headern, den normaliserade proxy-headern och backendens valda klientadress.

Rätt resultat är att den betrodda kanten ersätter eller säkert lägger till uppgifter i obetrodd indata, och att backend väljer adress utifrån det dokumenterade antalet betrodda proxyhopp. En förfalskad adress får inte bli det värde som används för autentisering eller tillåtelselistor.

Upprepa ett test direkt mot backend från ett LAN-segment om porten är åtkomlig. Backend ska ignorera vidarebefordrade headers från en direkt klient som inte är betrodd och registrera den faktiska socket-motparten.

Validera IPv4, IPv6 och vägar med flera proxyservrar

Upprepa testet via IPv4 och IPv6, via det vanliga offentliga värdnamnet och genom eventuellt CDN, tunnel eller sekundär proxy som används i produktion. Bekräfta att loggarna bevarar giltiga adressformat och inte trunkerar kedjan.

ZimaSpaces guide till begärandeidentitet bakom en omvänd proxy ger sammanhang kring varför korrekta vidarebefordrade värden är viktiga även utöver loggning.

Proxyadressen är verifierad först när den kända källan matchar den tolkade klientens IP-adress, betrodda proxyservrar fortfarande syns i den råa kedjan, försök till förfalskning misslyckas och säkerhetskontroller konsekvent använder det normaliserade värdet. Kontrollera igen när du lägger till ett CDN, en tunnel eller ytterligare ett proxyhopp.

Support och tips

Mer att läsa

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.