validate method
Validates hostHeader against registered tenants.
Returns the matched TenantContext if authorized, or throws HostValidationException if invalid.
Implementation
TenantContext validate(String hostHeader) {
final String cleanHost;
if (hostHeader.startsWith('[')) {
final closingBracket = hostHeader.indexOf(']');
if (closingBracket != -1) {
cleanHost = hostHeader.substring(0, closingBracket + 1).toLowerCase();
} else {
cleanHost = hostHeader.split(':').first.trim().toLowerCase();
}
} else {
cleanHost = hostHeader.split(':').first.trim().toLowerCase();
}
// Check against tenant custom domains & primary domains
for (final tenant in tenants) {
if (tenant.allAuthorizedHosts.contains(cleanHost)) {
return tenant;
}
}
// Check if host matches authorized root wildcard domain (e.g. *.platform.com)
for (final rootDomain in allowedRootDomains) {
final cleanRoot = rootDomain.toLowerCase();
if (cleanHost == cleanRoot) {
final matched = tenants
.where(
(t) =>
t.tenantId == cleanRoot ||
t.primaryDomain.toLowerCase() == cleanRoot,
)
.firstOrNull;
if (matched != null) return matched;
} else if (cleanHost.endsWith('.$cleanRoot')) {
final subdomain = cleanHost.substring(
0,
cleanHost.length - cleanRoot.length - 1,
);
final matched = tenants
.where(
(t) =>
t.tenantId == subdomain ||
t.allAuthorizedHosts.contains(cleanHost),
)
.firstOrNull;
if (matched != null) return matched;
}
}
throw HostValidationException(
'Unauthorized or unregistered Host header: "$hostHeader". Access denied to prevent host injection.',
);
}