using Microsoft.Extensions.Options; namespace SlpModularCms.Core.Email; /// /// Start-up validation of the mail configuration. Only runs checks when mail is enabled (an SMTP host /// is set); a host without mail configuration starts exactly as before. Messages never contain the /// credentials. /// public sealed class EmailOptionsValidator(IOptions app) : IValidateOptions { public ValidateOptionsResult Validate(string? name, EmailOptions options) { var failures = Check(options, app.Value); return failures.Count == 0 ? ValidateOptionsResult.Success : ValidateOptionsResult.Fail(failures); } /// /// The problems of a mail configuration (setting names only, never values). Empty when mail is off (no host) /// or the configuration is valid. /// public static IReadOnlyList Check(EmailOptions options, AppMailOptions appOptions) { if (string.IsNullOrWhiteSpace(options.Smtp.Host)) return []; // mail disabled var failures = new List(); if (!EmailAddressRules.IsValidAddress(options.FromAddress)) failures.Add("Email:FromAddress must be a valid e-mail address."); if (!EmailAddressRules.IsValidDisplayName(options.FromName)) failures.Add($"Email:FromName is required (1..{EmailAddressRules.MaxDisplayNameLength} characters, no control characters)."); if (options.Smtp.Port is < 1 or > 65535) failures.Add("Email:Smtp:Port must be between 1 and 65535."); if (options.Smtp.TimeoutSeconds is < 1 or > 120) failures.Add("Email:Smtp:TimeoutSeconds must be between 1 and 120."); if (!string.IsNullOrEmpty(options.Smtp.Username) && string.IsNullOrEmpty(options.Smtp.Password)) failures.Add("Email:Smtp:Password is required when Email:Smtp:Username is set."); if (!string.IsNullOrEmpty(options.BrandColor) && !EmailAddressRules.IsValidColour(options.BrandColor)) failures.Add("Email:BrandColor must look like #rrggbb."); foreach (var allowed in options.AllowedFromAddresses) { if (!EmailAddressRules.IsValidAddress(allowed)) failures.Add("Email:AllowedFromAddresses contains an invalid e-mail address."); } var baseUrl = appOptions.PublicBaseUrl; if (!IsValidPublicBaseUrl(baseUrl)) failures.Add("App:PublicBaseUrl must be an absolute https URL (http only for localhost) without a path."); if (!MailLanguages.IsSupported(appOptions.DefaultLanguage)) failures.Add("App:DefaultLanguage must be 'nl' or 'en'."); if (!string.IsNullOrEmpty(options.LogoUrl) && !IsValidLogoUrl(options.LogoUrl)) failures.Add("Email:LogoUrl must be an https URL or a path starting with '/'."); if (!string.IsNullOrEmpty(options.LogoDarkUrl) && !IsValidLogoUrl(options.LogoDarkUrl)) failures.Add("Email:LogoDarkUrl must be an https URL or a path starting with '/'."); return failures; } public static bool IsValidPublicBaseUrl(string? value) { if (string.IsNullOrWhiteSpace(value) || !Uri.TryCreate(value, UriKind.Absolute, out var uri)) return false; var local = uri.IsLoopback; if (uri.Scheme != Uri.UriSchemeHttps && !(local && uri.Scheme == Uri.UriSchemeHttp)) return false; return (uri.AbsolutePath == "/" || uri.AbsolutePath == "") && string.IsNullOrEmpty(uri.Query) && string.IsNullOrEmpty(uri.Fragment) && string.IsNullOrEmpty(uri.UserInfo); } private static bool IsValidLogoUrl(string value) { if (value.StartsWith('/') && !value.StartsWith("//") && !value.Any(char.IsControl)) return true; return Uri.TryCreate(value, UriKind.Absolute, out var uri) && uri.Scheme == Uri.UriSchemeHttps; } }