using ZB.MOM.WW.Auth.Abstractions.Ldap;
namespace ZB.MOM.WW.Auth.Ldap.Tests;
///
/// 0.5.0 passwordless group lookup (): statuses, parity with
/// 's group set, the shared failover walk, and the
/// configurations that cannot search without a password.
///
public class LdapGroupLookupTests
{
private static LdapOptions Opts(params string[] fallbacks) => new()
{
Enabled = true,
Server = "dc1",
Port = 636,
Transport = LdapTransport.Ldaps,
SearchBase = "dc=x",
ServiceAccountDn = "cn=svc,dc=x",
ServiceAccountPassword = "svcpw",
UserNameAttribute = "sAMAccountName",
DisplayNameAttribute = "displayName",
FallbackServers = fallbacks,
};
private static FakeLdapConnection Alice(string? userAccountControl = null)
{
var extra = new Dictionary { ["sAMAccountName"] = new[] { "Alice" } };
if (userAccountControl is not null)
extra["userAccountControl"] = new[] { userAccountControl };
return new FakeLdapConnection().WithUserEntry(
"cn=Alice,ou=people,dc=x",
new[] { "cn=Operators,ou=g,dc=x", @"cn=Eng\,ineers,ou=g,dc=x" },
displayName: "Alice Smith",
extraAttributes: extra);
}
// ---- the happy path and parity with AuthenticateAsync ----
[Fact]
public async Task Found_ReturnsCanonicalNameDisplayNameAndGroups_WithServiceAccountOnly()
{
var fake = Alice();
var svc = new LdapAuthService(Opts(), new FakeLdapConnectionFactory(fake));
var result = await svc.GetUserGroupsAsync(" alice ", CancellationToken.None);
Assert.Equal(LdapGroupLookupStatus.Found, result.Status);
Assert.True(result.IsFound);
Assert.Equal("Alice", result.Username); // directory spelling, not the typed one
Assert.Equal("Alice Smith", result.DisplayName);
Assert.Equal(new[] { "Operators", "Eng,ineers" }, result.Groups);
// Exactly one bind, as the service account — never a bind as the user.
Assert.Equal(new[] { "cn=svc,dc=x" }, fake.BoundDns);
Assert.Equal(1, fake.BindAttempts);
Assert.Contains("search:(sAMAccountName=alice)", fake.Calls);
Assert.Contains("userAccountControl", fake.SearchAttributes!);
}
[Fact]
public async Task Found_MatchesTheGroupSetAuthenticateAsyncReturns()
{
var lookup = await new LdapAuthService(Opts(), new FakeLdapConnectionFactory(Alice()))
.GetUserGroupsAsync("alice", CancellationToken.None);
var login = await new LdapAuthService(Opts(), new FakeLdapConnectionFactory(Alice()))
.AuthenticateAsync("alice", "pw", CancellationToken.None);
Assert.True(login.Succeeded);
Assert.Equal(login.Groups, lookup.Groups);
Assert.Equal(login.Username, lookup.Username);
Assert.Equal(login.DisplayName, lookup.DisplayName);
}
[Fact]
public async Task Found_WithZeroGroups_IsFoundWithAnEmptySet()
{
var fake = new FakeLdapConnection().WithUserEntry("cn=bob,dc=x", Array.Empty());
var svc = new LdapAuthService(Opts(), new FakeLdapConnectionFactory(fake));
var result = await svc.GetUserGroupsAsync("bob", CancellationToken.None);
Assert.Equal(LdapGroupLookupStatus.Found, result.Status);
Assert.Empty(result.Groups);
}
// ---- directory answers ----
[Fact]
public async Task NoEntry_IsUserNotFound()
{
var svc = new LdapAuthService(Opts(), new FakeLdapConnectionFactory(new FakeLdapConnection().WithNoMatch()));
var result = await svc.GetUserGroupsAsync("ghost", CancellationToken.None);
Assert.Equal(LdapGroupLookupStatus.UserNotFound, result.Status);
Assert.Empty(result.Groups);
Assert.Equal("", result.Username);
}
[Fact]
public async Task TwoEntries_IsAmbiguousUser()
{
var svc = new LdapAuthService(Opts(), new FakeLdapConnectionFactory(new FakeLdapConnection().WithDuplicateMatch()));
var result = await svc.GetUserGroupsAsync("dup", CancellationToken.None);
Assert.Equal(LdapGroupLookupStatus.AmbiguousUser, result.Status);
Assert.Empty(result.Groups);
}
[Theory]
[InlineData("514")] // NORMAL_ACCOUNT | ACCOUNTDISABLE
[InlineData("66050")] // + DONT_EXPIRE_PASSWORD
[InlineData("2")]
public async Task AccountDisableFlag_IsUserDisabled_AndReturnsNoGroups(string uac)
{
var svc = new LdapAuthService(Opts(), new FakeLdapConnectionFactory(Alice(uac)));
var result = await svc.GetUserGroupsAsync("alice", CancellationToken.None);
Assert.Equal(LdapGroupLookupStatus.UserDisabled, result.Status);
Assert.Empty(result.Groups);
}
[Theory]
[InlineData("512")] // NORMAL_ACCOUNT
[InlineData("66048")] // + DONT_EXPIRE_PASSWORD
[InlineData("garbage")] // unparseable is "not disabled", never a fault
public async Task EnabledOrUnparseableAccountControl_IsFound(string uac)
{
var svc = new LdapAuthService(Opts(), new FakeLdapConnectionFactory(Alice(uac)));
var result = await svc.GetUserGroupsAsync("alice", CancellationToken.None);
Assert.Equal(LdapGroupLookupStatus.Found, result.Status);
}
// ---- system-side faults and failover ----
[Fact]
public async Task ConnectFailure_OnOnlyEndpoint_IsDirectoryUnavailable()
{
var svc = new LdapAuthService(Opts(), new FakeLdapConnectionFactory(new FakeLdapConnection().ThrowOnConnect()));
var result = await svc.GetUserGroupsAsync("alice", CancellationToken.None);
Assert.Equal(LdapGroupLookupStatus.DirectoryUnavailable, result.Status);
}
[Fact]
public async Task ServiceBindFailure_IsDirectoryUnavailable_NotUserNotFound()
{
var svc = new LdapAuthService(Opts(), new FakeLdapConnectionFactory(Alice().ThrowOnServiceBind()));
var result = await svc.GetUserGroupsAsync("alice", CancellationToken.None);
Assert.Equal(LdapGroupLookupStatus.DirectoryUnavailable, result.Status);
}
[Fact]
public async Task SearchFailure_IsDirectoryUnavailable()
{
var svc = new LdapAuthService(Opts(), new FakeLdapConnectionFactory(Alice().ThrowOnSearch()));
var result = await svc.GetUserGroupsAsync("alice", CancellationToken.None);
Assert.Equal(LdapGroupLookupStatus.DirectoryUnavailable, result.Status);
}
[Fact]
public async Task ConnectFailure_FailsOverToFallback_AndFindsTheUser()
{
var factory = new SequenceLdapConnectionFactory(new FakeLdapConnection().ThrowOnConnect(), Alice());
var svc = new LdapAuthService(Opts("dc2:3894"), factory);
var result = await svc.GetUserGroupsAsync("alice", CancellationToken.None);
Assert.Equal(LdapGroupLookupStatus.Found, result.Status);
Assert.Equal(2, factory.Created.Count);
Assert.Equal(("dc2", 3894), (factory.Created[1].ConnectArgs!.Value.Host, factory.Created[1].ConnectArgs!.Value.Port));
}
[Fact]
public async Task SearchFailure_FailsOverToFallback()
{
var factory = new SequenceLdapConnectionFactory(Alice().ThrowOnSearch(), Alice());
var svc = new LdapAuthService(Opts("dc2"), factory);
var result = await svc.GetUserGroupsAsync("alice", CancellationToken.None);
Assert.Equal(LdapGroupLookupStatus.Found, result.Status);
Assert.Equal(2, factory.Created.Count);
}
[Fact]
public async Task UserNotFound_IsFinal_AndDoesNotFailOver()
{
var factory = new SequenceLdapConnectionFactory(new FakeLdapConnection(), Alice());
var svc = new LdapAuthService(Opts("dc2"), factory);
var result = await svc.GetUserGroupsAsync("alice", CancellationToken.None);
Assert.Equal(LdapGroupLookupStatus.UserNotFound, result.Status);
Assert.Single(factory.Created);
}
[Fact]
public async Task AllEndpointsDown_IsDirectoryUnavailable_AfterTryingEach()
{
var factory = new SequenceLdapConnectionFactory(
new FakeLdapConnection().ThrowOnConnect(), new FakeLdapConnection().ThrowOnServiceBind());
var svc = new LdapAuthService(Opts("dc2"), factory);
var result = await svc.GetUserGroupsAsync("alice", CancellationToken.None);
Assert.Equal(LdapGroupLookupStatus.DirectoryUnavailable, result.Status);
Assert.Equal(2, factory.Created.Count);
}
[Fact]
public async Task StickyPreference_IsSharedWithAuthentication()
{
// A lookup that fails over to dc2 makes dc2 preferred for the next sign-in too.
var factory = new SequenceLdapConnectionFactory(
new FakeLdapConnection().ThrowOnConnect(), Alice(), Alice());
var svc = new LdapAuthService(Opts("dc2"), factory);
await svc.GetUserGroupsAsync("alice", CancellationToken.None);
var login = await svc.AuthenticateAsync("alice", "pw", CancellationToken.None);
Assert.True(login.Succeeded);
Assert.Equal(3, factory.Created.Count);
Assert.Equal("dc2", factory.Created[2].ConnectArgs!.Value.Host);
}
[Fact]
public async Task UsesConfiguredTransportTimeoutAndCertificatePolicy()
{
System.Net.Security.RemoteCertificateValidationCallback callback = (_, _, _, _) => true;
var fake = Alice();
var options = Opts() with { Transport = LdapTransport.StartTls, ConnectionTimeoutMs = 1234, ServerCertificateValidationCallback = callback };
var svc = new LdapAuthService(options, new FakeLdapConnectionFactory(fake));
await svc.GetUserGroupsAsync("alice", CancellationToken.None);
Assert.Equal(LdapTransport.StartTls, fake.ConnectArgs!.Value.Transport);
Assert.Equal(1234, fake.ConnectArgs!.Value.TimeoutMs);
Assert.Same(callback, fake.ConnectCertCallback);
}
// ---- configurations that cannot look up ----
[Fact]
public async Task UserBindMode_IsNotSupported_WithoutTouchingTheNetwork()
{
var fake = Alice();
var options = Opts() with { BindMode = LdapBindMode.User, UserBindTemplate = @"X\{0}", ServiceAccountDn = "" };
var svc = new LdapAuthService(options, new FakeLdapConnectionFactory(fake));
var result = await svc.GetUserGroupsAsync("alice", CancellationToken.None);
Assert.Equal(LdapGroupLookupStatus.NotSupported, result.Status);
Assert.Empty(fake.Calls);
}
[Fact]
public async Task UserBindMode_IsNotSupported_EvenWithAServiceAccountConfigured()
{
var fake = Alice();
var options = Opts() with { BindMode = LdapBindMode.User, UserBindTemplate = @"X\{0}" };
var svc = new LdapAuthService(options, new FakeLdapConnectionFactory(fake));
var result = await svc.GetUserGroupsAsync("alice", CancellationToken.None);
Assert.Equal(LdapGroupLookupStatus.NotSupported, result.Status);
Assert.Empty(fake.Calls);
}
[Fact]
public async Task BlankServiceAccount_IsNotSupported_NeverAnAnonymousBind()
{
var fake = Alice();
var svc = new LdapAuthService(Opts() with { ServiceAccountDn = " " }, new FakeLdapConnectionFactory(fake));
var result = await svc.GetUserGroupsAsync("alice", CancellationToken.None);
Assert.Equal(LdapGroupLookupStatus.NotSupported, result.Status);
Assert.Empty(fake.Calls);
}
[Fact]
public async Task DisabledProvider_IsProviderDisabled_WithoutTouchingTheNetwork()
{
var fake = Alice();
var svc = new LdapAuthService(Opts() with { Enabled = false }, new FakeLdapConnectionFactory(fake));
var result = await svc.GetUserGroupsAsync("alice", CancellationToken.None);
Assert.Equal(LdapGroupLookupStatus.ProviderDisabled, result.Status);
Assert.Empty(fake.Calls);
}
[Theory]
[InlineData(null)]
[InlineData("")]
[InlineData(" ")]
public async Task BlankUsername_IsUserNotFound_WithoutTouchingTheNetwork(string? username)
{
var fake = Alice();
var svc = new LdapAuthService(Opts(), new FakeLdapConnectionFactory(fake));
var result = await svc.GetUserGroupsAsync(username!, CancellationToken.None);
Assert.Equal(LdapGroupLookupStatus.UserNotFound, result.Status);
Assert.Empty(fake.Calls);
}
[Fact]
public async Task FilterMetacharacters_AreEscaped()
{
var fake = new FakeLdapConnection();
var svc = new LdapAuthService(Opts(), new FakeLdapConnectionFactory(fake));
await svc.GetUserGroupsAsync("*)(cn=*", CancellationToken.None);
Assert.Contains(@"search:(sAMAccountName=\2a\29\28cn=\2a)", fake.Calls);
}
[Fact]
public async Task CancelledToken_Throws()
{
var svc = new LdapAuthService(Opts(), new FakeLdapConnectionFactory(Alice()));
using var cts = new CancellationTokenSource();
cts.Cancel();
await Assert.ThrowsAnyAsync(() => svc.GetUserGroupsAsync("alice", cts.Token));
}
[Fact]
public void Of_RefusesFound()
=> Assert.Throws(() => LdapGroupLookupResult.Of(LdapGroupLookupStatus.Found));
}