validate method

TenantContext validate(
  1. String hostHeader
)

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.',
  );
}