ASP.NET Core 2.0 LDAP 活动目录身份验证

XML

ASP.NET Core 2.0 LDAP 活动目录身份验证

ASP.NET Core 是一个跨平台的开发框架，用于构建现代化的 Web 应用程序。它提供了一种简单而强大的方式来实现用户身份验证和授权。LDAP（轻型目录访问协议）是一种用于访问和维护分布式目录服务的协议，活动目录是一种基于 LDAP 的目录服务。

在本文中，我们将介绍如何在 ASP.NET Core 2.0 中使用 LDAP 进行活动目录身份验证。我们将通过一个实际的案例来演示如何配置和使用 LDAP 身份验证。

配置 LDAP 身份验证

首先，我们需要在 ASP.NET Core 2.0 项目中添加所需的 NuGet 包。打开项目文件（.csproj）并添加以下包引用：

XML
<ItemGroup>
  <PackageReference Include="Microsoft.Extensions.Logging" Version="2.2.0" />
  <PackageReference Include="Microsoft.AspNetcore.Authentication" Version="2.2.0" />
  <PackageReference Include="System.DirectoryServices.AccountManagement" Version="4.6.0" />
</ItemGroup>

接下来，我们需要在应用程序的 Startup.cs 文件中进行一些配置。在 ConfigureServices 方法中，添加以下代码：

csharp
services.AddAuthentication(IISDefaults.AuthenticationScheme);
services.Configure<IISOptions>(options =>
{
    options.AutomaticAuthentication = true;
});
services.Configure<LdapOptions>(Configuration.GetSection("Ldap"));
services.AddSingleton<LdapService>();

这里我们通过调用 AddAuthentication 方法来添加身份验证服务，并配置 IIS 作为默认的身份验证方案。然后，我们可以通过调用 Configure 方法来配置 LdapOptions，该配置将在后面的步骤中使用。

接下来，在 Configure 方法中添加以下代码：

csharp
app.UseAuthentication();

这将在应用程序的请求管道中启用身份验证。

配置 LDAP 选项

在 appsettings.JSon 文件中，我们需要添加一个 Ldap 部分来配置 LDAP 选项。示例如下：

JSon
"Ldap": {
  "DomAIn": "yourdomAIn.com",
  "Server": "yourldapserver.com",
  "Username": "yourusername",
  "Password": "yourpassword"
}

在这里，我们需要提供我们的域名、LDAP 服务器地址以及用于身份验证的用户名和密码。

创建 LdapService

现在，我们将创建一个 LdapService 类，该类将用于与 LDAP 服务器进行通信并执行身份验证。创建一个名为 LdapService.cs 的新文件，并添加以下代码：

csharp
using System.DirectoryServices.AccountManagement;
public class LdapService
{
    private readonly LdapOptions _ldapOptions;
    public LdapService(IOptions<LdapOptions> ldapOptions)
    {
        _ldapOptions = ldapOptions.Value;
    }
    public bool Authenticate(string username, string password)
    {
        using (var context = new PrincipalContext(ContextType.DomAIn, _ldapOptions.DomAIn, null, ContextOptions.SimpleBind, _ldapOptions.Username, _ldapOptions.Password))
        {
            return context.ValidateCredentials(username, password);
        }
    }
}

在这里，我们创建了一个 LdapService 类，该类具有一个 Authenticate 方法，用于执行身份验证。在该方法中，我们使用 System.DirectoryServices.AccountManagement 命名空间中的 PrincipalContext 和 ValidateCredentials 方法来与 LDAP 服务器进行通信并验证用户凭据。

使用 LDAP 身份验证

现在，我们可以在我们的控制器或其他地方使用我们创建的 LdapService 来执行身份验证。以下是一个示例控制器的代码：

csharp
using Microsoft.AspNetcore.Mvc;
public class AuthController : Controller
{
    private readonly LdapService _ldapService;
    public AuthController(LdapService ldapService)
    {
        _ldapService = ldapService;
    }
    [HttpPost]
    public IActionResult Login(string username, string password)
    {
        if (_ldapService.Authenticate(username, password))
        {
            // 身份验证成功，执行其他逻辑
            return Ok();
        }
        // 身份验证失败，返回错误信息
        return Unauthorized();
    }
}

在这里，我们注入了 LdapService，并在 Login 方法中调用 Authenticate 方法来执行身份验证。如果身份验证成功，我们可以执行其他逻辑；如果失败，我们返回一个未经授权的错误信息。

通过使用 ASP.NET Core 2.0 提供的身份验证和 LDAP，我们可以轻松地集成活动目录身份验证到我们的应用程序中。这使得我们能够安全地验证用户身份，并根据需要进行授权。