73 lines
2.6 KiB
TypeScript
73 lines
2.6 KiB
TypeScript
/**
|
|
* Origin-allowlist helper for the form-widget submission endpoint.
|
|
*
|
|
* Supports exact-match (`https://example.com`), bare hostnames (`example.com`)
|
|
* and wildcard subdomain patterns (`*.example.com`). Schemes default to https
|
|
* when not provided. Ports must match exactly when present.
|
|
*
|
|
* Returns `true` only when at least one allowed entry matches. An empty
|
|
* allowlist always returns `false` — a form with no allowed origins is
|
|
* non-submittable from any browser, by design.
|
|
*/
|
|
|
|
export function normalizeOrigin(input: string | null | undefined): string | null {
|
|
if (!input) return null;
|
|
const trimmed = input.trim();
|
|
if (trimmed === "") return null;
|
|
// Browsers send Origin as scheme + host[:port], no path. Strip trailing slash.
|
|
try {
|
|
const url = new URL(trimmed.includes("://") ? trimmed : `https://${trimmed}`);
|
|
return `${url.protocol}//${url.host}`.toLowerCase();
|
|
} catch {
|
|
return null;
|
|
}
|
|
}
|
|
|
|
function parseAllowedEntry(entry: string): { host: string; wildcard: boolean; port?: string; scheme?: string } | null {
|
|
const trimmed = entry.trim().toLowerCase();
|
|
if (trimmed === "") return null;
|
|
let scheme: string | undefined;
|
|
let rest = trimmed;
|
|
if (rest.includes("://")) {
|
|
const [s, r] = rest.split("://", 2) as [string, string];
|
|
scheme = s;
|
|
rest = r;
|
|
}
|
|
// host[:port]
|
|
const wildcard = rest.startsWith("*.");
|
|
const hostAndPort = wildcard ? rest.slice(2) : rest;
|
|
const [host, port] = hostAndPort.split(":", 2);
|
|
if (!host) return null;
|
|
return { host, wildcard, port, scheme };
|
|
}
|
|
|
|
export function matchAllowedOrigin(originHeader: string | null | undefined, allowed: readonly string[]): boolean {
|
|
if (!allowed || allowed.length === 0) return false;
|
|
const normalized = normalizeOrigin(originHeader);
|
|
if (!normalized) return false;
|
|
let parsed: URL;
|
|
try {
|
|
parsed = new URL(normalized);
|
|
} catch {
|
|
return false;
|
|
}
|
|
const reqHost = parsed.hostname.toLowerCase();
|
|
const reqPort = parsed.port; // empty string when default
|
|
const reqScheme = parsed.protocol.replace(":", "");
|
|
|
|
for (const entry of allowed) {
|
|
const candidate = parseAllowedEntry(entry);
|
|
if (!candidate) continue;
|
|
if (candidate.scheme && candidate.scheme !== reqScheme) continue;
|
|
if (candidate.port !== undefined && candidate.port !== reqPort) continue;
|
|
if (candidate.wildcard) {
|
|
// *.example.com matches foo.example.com but NOT example.com
|
|
if (reqHost === candidate.host) continue;
|
|
if (reqHost.endsWith(`.${candidate.host}`)) return true;
|
|
} else if (reqHost === candidate.host) {
|
|
return true;
|
|
}
|
|
}
|
|
return false;
|
|
}
|