ASP.NET Core 中的自定义身份认证

在 ASP.NET Core 应用开发中，身份认证和授权是保障应用安全的关键环节。虽然 ASP.NET Core 提供了多种内置的身份验证方式（如 Cookie 认证、JWT 认证等），但在某些特定场景下，我们可能需要实现自定义的身份验证和授权策略，以满足独特的业务需求。

一、创建自定义认证方案

首先，需要定义一个字符串常量来表示自定义认证方案的名称，这个名称将在后续的请求处理管道中用于引用我们的认证服务

public static class CustomAuthenticationScheme
{
    public const string SchemeName = "CustomAuthenticationScheme";
}

二、实现 AuthenticationHandler 类

接下来，我们需要实现一个自定义的 AuthenticationHandler 类，这个类将负责具体的认证逻辑。AuthenticationHandler<TOptions> 是一个泛型类，其中 TOptions 是我们的自定义认证选项类。

public classCustomAuthenticationHandler : AuthenticationHandler<CustomAuthenticationOptions>
{
    public CustomAuthenticationHandler(
        IOptionsMonitor<CustomAuthenticationOptions> options,
        ILoggerFactory logger,
        UrlEncoder encoder,
        ISystemClock clock) 
        : base(options, logger, encoder, clock)
    {
    }

    protected override async Task<AuthenticateResult> HandleAuthenticateAsync()
    {
        try
        {
            // 从请求中获取认证信息，例如从请求头、查询字符串或Cookie中获取
            var token = "";

            // 验证token，例如检查token的有效性、过期时间等
            var isValid = ValidateToken(token);
            if (!isValid)
            {
                return AuthenticateResult.Fail("Invalid token");
            }

            // 创建ClaimsIdentity和ClaimsPrincipal对象
            var claims = new[]
            {
            new Claim(ClaimTypes.Name, "CustomUser"),
            // 添加其他需要的Claims
        };
            var identity = new ClaimsIdentity(claims, CustomAuthenticationScheme.SchemeName);
            var user = new ClaimsPrincipal(identity);

            // 创建AuthenticationTicket对象
            var ticket = new AuthenticationTicket(user, CustomAuthenticationScheme.SchemeName);

            return AuthenticateResult.Success(ticket);
        }
        catch (Exception ex)
        {
            Logger.LogError(ex, "Error during authentication");
            return AuthenticateResult.Fail(ex.Message);
        }
    }

}

将创建ClaimsIdentity和ClaimsPrincipal对象的逻辑放在HandleAuthenticateAsync方法中，是为了在每个请求中都能实时、灵活地根据认证信息构建用户身份上下文，确保请求的安全性和合法性。

三、定义自定义认证选项类

为了存储自定义认证方案的配置信息，定义一个自定义认证选项类。这个类继承自 AuthenticationSchemeOptions，

public class CustomAuthenticationOptions : AuthenticationSchemeOptions
{
    // 在这里添加自定义的配置属性
}

四、注册自定义认证服务

在 Program.cs 或 Startup.cs 中，使用 AddAuthentication 和 AddScheme 方法注册自定义认证服务

builder.Services.AddAuthentication(options =>
{
    options.DefaultScheme = CustomAuthenticationScheme.SchemeName;
})
.AddScheme<CustomAuthenticationOptions, CustomAuthenticationHandler>(CustomAuthenticationScheme.SchemeName, options =>
{
    // 配置自定义认证选项
});

builder.Services.AddAuthorization();

五、使用自定义认证方案

在控制器或操作方法上使用 [Authorize] 属性，并指定自定义认证方案的名称，以启用自定义认证。

[Authorize(AuthenticationSchemes = CustomAuthenticationScheme.SchemeName)]
public class CustomAuthController : Controller
{
    // 控制器中的操作方法
}

六、总结

通过以上步骤，就在 ASP.NET Core 应用程序中成功实现自定义的身份认证方式。自定义认证方式为我们提供了极大的灵活性，使我们能够根据具体的业务需求设计和实现个性化的认证逻辑。