.NET 8 深度解析：全面掌握认证（Authentication）组件

拾忆4377

于 2024-08-13 09:35:54 发布

阅读量734

点赞数 27

分类专栏： .NET 8 入门到精通文章标签： .net

本文链接：https://blog.csdn.net/qq_40998698/article/details/141155194

版权

.NET 8 入门到精通专栏收录该内容

13 篇文章 0 订阅

订阅专栏

引言

在现代的 Web 应用程序中，认证是确保只有经过授权的用户才能访问特定资源并执行操作的关键组成部分。随着 .NET 8 的推出，微软进一步完善并扩展了其认证组件，使开发者能够更轻松地在应用程序中实现安全且可扩展的认证机制。本文将探讨 .NET 8 中的认证组件，涵盖其主要功能、配置方法以及最佳实践。

什么是 .NET 8 中的认证？

在 .NET 8 中，认证是指验证与您的应用程序交互的用户或系统的身份的过程。认证成功后，系统可以根据用户的角色或声明（claims）来授权其访问特定资源。.NET 8 提供了一个强大而灵活的认证框架，支持多种认证方式，包括：

基于 Cookie 的认证
JWT（JSON Web Token）认证
OAuth2 和 OpenID Connect
第三方认证提供商（如 Google、Facebook、Microsoft）
API 密钥认证

.NET 8 认证的关键组件

1. 认证中间件

在 .NET 8 中，认证过程由中间件支持。该中间件会拦截 HTTP 请求，检查认证信息（例如令牌或 Cookie），并决定是否允许请求继续处理。通常在 Startup.cs 或 Program.cs 文件中添加该中间件。

public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
    app.UseAuthentication(); // 添加认证中间件
    app.UseAuthorization(); // 添加授权中间件

    app.UseEndpoints(endpoints =>
    {
        endpoints.MapControllers();
    });
}

2. 认证方案

认证方案是用于确定系统如何进行用户认证的配置。.NET 8 允许开发者定义多个方案，使得在同一个应用程序中支持不同的认证方式成为可能。

services.AddAuthentication(options =>
{
    // 设置默认的认证方案为 JWT
    options.DefaultAuthenticateScheme = JwtBearerDefaults.AuthenticationScheme;
    options.DefaultChallengeScheme = JwtBearerDefaults.AuthenticationScheme;
})
.AddJwtBearer(options =>
{
    // 配置 JWT 认证参数
    options.TokenValidationParameters = new TokenValidationParameters
    {
        ValidateIssuer = true, // 验证令牌的签发者
        ValidateAudience = true, // 验证令牌的接收者
        ValidateLifetime = true, // 验证令牌的有效期
        ValidateIssuerSigningKey = true, // 验证签名密钥
        ValidIssuer = "yourdomain.com", // 设定合法的签发者
        ValidAudience = "yourdomain.com", // 设定合法的接收者
        IssuerSigningKey = new SymmetricSecurityKey(Encoding.UTF8.GetBytes("your_secret_key")) // 设置签名密钥
    };
});

3. 认证处理程序

认证处理程序负责处理实际的认证过程。例如，JwtBearerHandler 用于认证 JWT 令牌。处理程序与特定的认证方案相关联，并通过服务依赖注入（DI）容器进行配置。

在 .NET 8 应用程序中设置认证

以下是如何在 .NET 8 Web API 中设置 JWT 认证的步骤。

1. 安装必要的包

首先，安装必要的 NuGet 包：

dotnet add package Microsoft.AspNetCore.Authentication.JwtBearer
dotnet add package Microsoft.IdentityModel.Tokens

2. 配置 JWT 认证

在 Program.cs 或 Startup.cs 文件中配置 JWT 认证：

builder.Services.AddAuthentication(options =>
{
    // 设置默认的认证方案为 JWT
    options.DefaultAuthenticateScheme = JwtBearerDefaults.AuthenticationScheme;
    options.DefaultChallengeScheme = JwtBearerDefaults.AuthenticationScheme;
})
.AddJwtBearer(options =>
{
    // 配置 JWT 令牌验证参数
    options.TokenValidationParameters = new TokenValidationParameters
    {
        ValidateIssuer = true, // 验证签发者
        ValidateAudience = true, // 验证接收者
        ValidateLifetime = true, // 验证令牌有效期
        ValidateIssuerSigningKey = true, // 验证签名密钥
        ValidIssuer = "https://yourdomain.com", // 设定合法的签发者
        ValidAudience = "https://yourdomain.com", // 设定合法的接收者
        IssuerSigningKey = new SymmetricSecurityKey(Encoding.UTF8.GetBytes("your_secret_key")) // 设置签名密钥
    };
});

3. 保护 API 端点

使用 [Authorize] 特性来保护 API 端点：

[Authorize] // 该特性确保只有经过认证的用户才能访问该端点
[ApiController]
[Route("api/[controller]")]
public class ValuesController : ControllerBase
{
    [HttpGet]
    public IActionResult Get()
    {
        return Ok(new { message = "这是一个受保护的 API 端点。" });
    }
}

高级认证场景

1. 多认证方案

.NET 8 支持多种认证方案，允许你为应用程序的不同部分配置不同的认证机制。例如，你可以为 Web 应用程序使用 Cookie 认证，为 API 使用 JWT 认证。

services.AddAuthentication()
    .AddCookie(CookieAuthenticationDefaults.AuthenticationScheme, options => { /* ... */ })
    .AddJwtBearer(JwtBearerDefaults.AuthenticationScheme, options => { /* ... */ });