ASP.NET Core 6中如何跨平台读取Active Directory数据？

你用的DirectorySearcher和DirectoryEntry属于System.DirectoryServices组件，确实是Windows专属API，无法在Linux/macOS等非Windows平台运行。要实现跨平台读取AD数据，推荐使用Novell.Directory.Ldap.NETStandard这个开源NuGet包——它是完全跨平台的LDAP客户端库，支持.NET Core/.NET 5+全平台。

步骤1：安装NuGet包 #

用.NET CLI执行安装命令：

dotnet add package Novell.Directory.Ldap.NETStandard

也可以直接在NuGet包管理器中搜索同名包完成安装。

步骤2：替换原有代码的跨平台实现 #

以下是对应你原有需求的代码示例，实现查询指定SAMAccountName用户的目标属性：

using Novell.Directory.Ldap;

// 配置LDAP连接参数
string ldapServer = GlobalConfig.Configuration.LDAP; // 格式示例："ldap://your-domain.com:389"
int ldapPort = LdapConnection.DEFAULT_PORT; // 默认389，LDAPS加密连接用636
string bindAccount = Input.Username; // 绑定账号格式："username@domain.com" 或 "DOMAIN\\username"
string bindPassword = Input.Password;

LdapConnection connection = null;
try
{
    // 初始化并建立LDAP连接
    connection = new LdapConnection();
    connection.Connect(ldapServer, ldapPort);
    // 绑定AD账号验证身份
    connection.Bind(bindAccount, bindPassword);

    // 设置查询过滤条件与要加载的属性
    string searchFilter = $"(&(objectClass=user)(SAMAccountName={Input.Username}))";
    string[] targetAttributes = new[] { "cn", "memberOf", "employeeid", "telephonenumber", "displayName", "mail" };
    
    // 执行查询，需替换为你的AD域根节点（示例："DC=company,DC=com"）
    LdapSearchResults searchResults = connection.Search(
        "DC=your-domain,DC=com",
        LdapConnection.SCOPE_SUB,
        searchFilter,
        targetAttributes,
        false // false表示返回属性值，true仅返回属性名
    );

    if (searchResults.HasMore())
    {
        LdapEntry userEntry = searchResults.Next();
        // 读取单值属性
        string displayName = userEntry.GetAttribute("displayName")?.StringValue;
        string email = userEntry.GetAttribute("mail")?.StringValue;
        // 读取多值属性（如memberOf）
        var userGroups = userEntry.GetAttribute("memberOf")?.StringValueArray ?? Array.Empty<string>();
        
        // 处理获取到的用户数据...
    }
}
catch (LdapException ex)
{
    // 处理LDAP异常：连接失败、权限不足、用户不存在等
    // 自定义异常逻辑...
}
finally
{
    // 确保连接关闭
    if (connection != null && connection.Connected)
    {
        connection.Disconnect();
    }
}

关键注意事项 #

• LDAP地址格式：若使用加密的LDAPS连接，地址需写成ldaps://your-domain.com:636，Linux/macOS环境下需确保客户端信任AD服务器的SSL证书。
• 域根节点：必须替换为你的AD域实际根DN，比如域名为company.com，根DN就是DC=company,DC=com。
• 过滤条件安全：如果Input.Username是用户输入内容，建议做LDAP特殊字符转义，避免注入风险。
• 权限要求：绑定的AD账号只需具备AD用户数据的读取权限，普通用户账号通常即可满足需求。

除了Novell的库，也可以使用官方的System.DirectoryServices.Protocols库，它是.NET官方提供的跨平台LDAP协议实现，但API相对底层，使用成本略高。

内容的提问来源于stack exchange，提问作者Marvin Klein