ASP.NET C# Webform连接LDAP服务器报服务器不可用异常

你遇到的The server is not operational错误以及后续查不到用户的问题，来自3个核心代码错误，外加可能的连通性配置问题：

• LDAP路径配置错误：你当前写的路径包含不存在的目录层级CN=XYZ.LOCAL,OU=XXX，AD域的根路径直接对应DC层级即可，多余的错误CN、OU配置会导致DirectoryEntry直接定位到不存在的对象，触发服务器不可用的报错。
• 查询过滤器逻辑错误：sAMAccountName属性存储的是不带域名前缀的纯登录名，即john，传入带域名的XYZ\john作为筛选值，即使连通AD也无法匹配到任何用户对象。
• 身份验证逻辑冗余：已经启用Windows身份验证的场景下，不需要硬编码域账号密码初始化DirectoryEntry，直接使用当前运行上下文即可查询AD，还能避免密码硬编码的安全风险。

先在部署Web应用的服务器上执行以下检查，排除环境连通性问题：

• 执行命令ping XYZ.LOCAL，确认域名能正常解析到域控服务器IP
• 执行命令telnet XYZ.LOCAL 389，确认LDAP默认389端口连通正常，无防火墙拦截

// 正确的域根路径，直接指向域的DN结构
string path = "LDAP://XYZ.LOCAL/DC=XYZ,DC=LOCAL"; 
// 从Windows身份信息里拆分出不带域名的账号名
string strAccountId = User.Identity.Name.Split('\\')[1];

bool bSucceeded;
string strError;
string userEmail = string.Empty;

// 不需要硬编码账号密码，用当前运行上下文连接AD，using块自动释放资源
using (DirectoryEntry adsEntry = new DirectoryEntry(path))
{
    using (DirectorySearcher adsSearcher = new DirectorySearcher(adsEntry))
    {
        // 筛选条件用纯sAMAccountName匹配
        adsSearcher.Filter = $"(sAMAccountName={strAccountId})";
        // 指定要查询的mail属性，不拉取全量属性提升查询性能
        adsSearcher.PropertiesToLoad.Add("mail");
        
        try
        {
            SearchResult adsSearchResult = adsSearcher.FindOne();
            if (adsSearchResult != null && adsSearchResult.Properties["mail"].Count > 0)
            {
                bSucceeded = true;
                // 读取用户邮箱地址
                userEmail = adsSearchResult.Properties["mail"][0].ToString();
                strError = $"用户认证成功，邮箱：{userEmail}";
            }
            else
            {
                bSucceeded = false;
                strError = "未查询到匹配的AD用户信息";
            }
            EmailMsg.Text = strError;
        }
        catch (Exception ex)
        {
            bSucceeded = false;
            strError = $"查询AD出错：{ex.Message}";
            EmailMsg.Text = strError;
        }
    }
}

如果你的AD用户确实都在OU=XXX这个组织单位下，也可以把路径改成LDAP://XYZ.LOCAL/OU=XXX,DC=XYZ,DC=LOCAL缩小查询范围，提升查询速度，但不要加不存在的CN层级。如果域配置了LDAPS加密连接，把路径前缀改成LDAPS://，对应连通性测试端口改成636即可。

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