Refresh HiveGrid Cloud reference snapshot
This commit is contained in:
1 parent
5e99e14772
commit
7f88026f79
5955 files changed
+1177325
-188362
No files matched your search
@@ -1,4 +1,5 @@
|
||||
import isIP from "is-ip";
|
||||
import { getTrustedProxyClientIp } from "@hivegrid/foundation/trusted-client-ip";
|
||||
|
||||
/**
|
||||
* This is the list of headers, in order of preference, that will be used to
|
||||
@@ -67,31 +68,19 @@ export function getClientIPAddress(requestOrHeaders: Request | Headers): string
|
||||
}
|
||||
|
||||
/**
|
||||
* Trusted client-IP headers, in order of preference. These are set by the
|
||||
* edge/proxy and OVERWRITE any client-supplied value, so — unlike
|
||||
* X-Forwarded-For's leftmost entry or X-Client-IP — they cannot be spoofed by
|
||||
* the client. In this estate every public request 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 trustedHeaderNames = Object.freeze(["CF-Connecting-IP", "True-Client-Ip", "X-Real-IP"] as const);
|
||||
|
||||
/**
|
||||
* Get the client IP from a TRUSTED, proxy-set header only. Use this 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 "unknown" when no trusted header is present (e.g.
|
||||
* local development without a proxy) so callers can still key a shared bucket.
|
||||
* Resolve the client IP from the Traefik-appended peer and, only when that peer
|
||||
* belongs to Cloudflare, CF-Connecting-IP. Returns "unknown" without a
|
||||
* verifiable proxy peer so security-sensitive callers share a bounded bucket.
|
||||
*/
|
||||
export function getTrustedClientIp(requestOrHeaders: Request | Headers): string {
|
||||
const headers = requestOrHeaders instanceof Request ? requestOrHeaders.headers : requestOrHeaders;
|
||||
for (const headerName of trustedHeaderNames) {
|
||||
const value = headers.get(headerName)?.trim();
|
||||
if (value && isIP(value)) {
|
||||
return value;
|
||||
}
|
||||
}
|
||||
return "unknown";
|
||||
return getTrustedProxyClientIp((name) => headers.get(name)) ?? "unknown";
|
||||
}
|
||||
|
||||
/** Trusted client IP for persistence/audit call sites where no value is preferable to a synthetic marker. */
|
||||
export function getTrustedClientIpOrNull(requestOrHeaders: Request | Headers): string | null {
|
||||
const value = getTrustedClientIp(requestOrHeaders);
|
||||
return value === "unknown" ? null : value;
|
||||
}
|
||||
|
||||
function parseForwardedHeader(value: string | null): string | null {
|
||||
|
||||
Reference in new issue
Block a user