using System.Net.Security;
namespace ZB.MOM.WW.Auth.Abstractions.Ldap;
public enum LdapTransport { Ldaps, StartTls, None }
/// How authenticates a sign-in.
public enum LdapBindMode
{
/// Bind as the service account, search for the user, re-bind as the user (0.3.0 behaviour).
ServiceAccount,
///
/// Bind as the signing-in user (identity built from );
/// a successful bind authenticates them, and the same connection reads their own entry for groups.
/// No service account is used.
///
User,
}
public sealed record LdapOptions
{
public bool Enabled { get; init; } = true;
public string Server { get; init; } = "localhost";
public int Port { get; init; } = 3893;
public LdapTransport Transport { get; init; } = LdapTransport.Ldaps;
public bool AllowInsecure { get; init; }
public string SearchBase { get; init; } = "";
public string ServiceAccountDn { get; init; } = "";
public string ServiceAccountPassword { get; init; } = "";
public string UserNameAttribute { get; init; } = "cn";
public string DisplayNameAttribute { get; init; } = "cn";
public string GroupAttribute { get; init; } = "memberOf";
public int ConnectionTimeoutMs { get; init; } = 10_000;
///
/// Selects the authentication flow. (the default) is the
/// 0.3.0 bind-then-search-then-bind flow; binds as the user and needs
/// no / .
///
public LdapBindMode BindMode { get; init; } = LdapBindMode.ServiceAccount;
///
/// only: the simple-bind identity, with {0} replaced by the
/// normalised login name. Must contain {0} exactly once.
///
/// Prefer the down-level form EXAMPLE\{0}: it maps exactly to the sAMAccountName the
/// group search uses, so the account that binds is the account whose groups are read. A UPN
/// template ({0}@example.com) is only correct where every account's UPN prefix equals its
/// sAMAccountName — AD resolves a UPN bind against the explicit userPrincipalName, so
/// a mismatch can fail sign-in or bind a different account than the one whose groups are read.
///
///
public string UserBindTemplate { get; init; } = "";
///
/// only: when (default) a login typed as
/// DOMAIN\name or name@suffix is reduced to name; when
/// such input is refused as bad credentials without contacting the directory.
///
public bool AcceptDomainQualifiedNames { get; init; } = true;
///
/// Ordered fallback LDAP endpoints tried when the primary (and any earlier fallback)
/// fails with a system-side error (connect/TLS, service-account bind, or search).
/// Each entry is "host" (adopts ) or "host:port".
/// Empty (the default) disables failover entirely — single-endpoint behavior is
/// unchanged. The TLS validation policy (
/// / ) applies to every endpoint. Endpoint preference is
/// sticky: the service keeps using the last endpoint that answered until it fails.
///
public IReadOnlyList FallbackServers { get; init; } = Array.Empty();
///
/// Optional hook to harden (or, in dev, relax) TLS server-certificate validation for the
/// / transports. When
/// (the default) the LDAP client validates the server certificate against
/// the OS trust store — it does not blind-accept. Supply a callback to pin a CA, validate
/// the SAN against , or otherwise tighten validation. This is a code-only seam
/// (not bound from configuration) and takes precedence over .
///
public RemoteCertificateValidationCallback? ServerCertificateValidationCallback { get; init; }
}
public enum LdapAuthFailure { BadCredentials, UserNotFound, AmbiguousUser, GroupLookupFailed, ServiceAccountBindFailed, Disabled }
public sealed record LdapAuthResult(bool Succeeded, string Username, string DisplayName, IReadOnlyList Groups, LdapAuthFailure? Failure)
{
public static LdapAuthResult Success(string username, string displayName, IReadOnlyList groups) => new(true, username, displayName, groups, null);
public static LdapAuthResult Fail(LdapAuthFailure failure) => new(false, "", "", Array.Empty(), failure);
}
public interface ILdapAuthService
{
///
/// Authenticates against the directory by bind-then-search and
/// returns the outcome, including the resolved display name and group memberships on success.
///
/// The login name to authenticate.
/// The credential to bind with.
/// A token to request cancellation of the operation.
/// The authentication result.
///
/// The cancellation token is observed at entry only. Implementations backed by synchronous
/// LDAP clients cannot abort an in-flight bind or search once it has been dispatched, so full
/// cooperative cancellation is not guaranteed mid-call: a request that has already reached the
/// directory will run to completion (subject to the configured connection timeout) even if the
/// token is cancelled.
///
Task AuthenticateAsync(string username, string password, CancellationToken ct);
}