Initial commit: scadaproj umbrella — sister-project index, auth component normalization (design + GAPS), and the built ZB.MOM.WW.Auth shared library (0.1.0, flattened in).

2026-06-01 03:59:23 -04:00
commit 37e23cf9f2
73 changed files with 6836 additions and 0 deletions
@@ -0,0 +1,32 @@
+namespace ZB.MOM.WW.Auth.Ldap.Internal;
+
+using ZB.MOM.WW.Auth.Abstractions.Ldap;
+
+/// <summary>
+/// A single LDAP search result entry: its DN and a flat attribute bag.
+/// </summary>
+internal sealed record LdapSearchEntry(
+    string Dn,
+    IReadOnlyDictionary<string, IReadOnlyList<string>> Attributes);
+
+/// <summary>
+/// Abstraction over a single LDAP connection. Allows unit-testing
+/// <c>LdapAuthService</c> without a live directory server.
+/// </summary>
+internal interface ILdapConnection : IDisposable
+{
+    /// <summary>Opens (and optionally upgrades to TLS) a connection to the given host.</summary>
+    void Connect(string host, int port, LdapTransport transport, bool allowInsecure, int timeoutMs);
+
+    /// <summary>Binds with the supplied DN and password. Throws <c>LdapException</c> on bad credentials.</summary>
+    void Bind(string dn, string password);
+
+    /// <summary>Executes a subtree search and returns all matching entries.</summary>
+    IReadOnlyList<LdapSearchEntry> Search(string searchBase, string filter, IReadOnlyList<string> attributes);
+}
+
+/// <summary>Factory that produces <see cref="ILdapConnection"/> instances.</summary>
+internal interface ILdapConnectionFactory
+{
+    ILdapConnection Create();
+}