// Trusted, proxy-set client-IP headers in order of preference. These are set // by the edge/proxy and OVERWRITE any client-supplied value, so — unlike the // leftmost X-Forwarded-For entry or X-Client-IP — they cannot be spoofed by the // client. Every public request in this estate passes through Cloudflare // (proxied), which sets CF-Connecting-IP; X-Real-IP is the immediate reverse // proxy (Traefik) hop as a fallback for non-Cloudflare paths. const TRUSTED_IP_HEADERS = ["cf-connecting-ip", "true-client-ip", "x-real-ip"] as const; /** * Read the client IP from a trusted header only. Use for security-sensitive * decisions (rate limiting, abuse throttles) where an attacker must not be able * to rotate their apparent IP by forging X-Forwarded-For. Returns the empty * string when no trusted header is present so callers can key a shared bucket. */ export function getTrustedClientIp(request: Request): string { for (const headerName of TRUSTED_IP_HEADERS) { const value = request.headers.get(headerName)?.trim(); if (value) { return value; } } return ""; }