标题

".NET Core WebAPI JWT 更为清爽的认证详解"

简介

本篇文章将详细介绍使用JWT实现.NET Core WebAPI的认证过程，并提供使用示例和代码，帮助读者更好地理解和实践该过程。

JWT认证的概念和用途

JWT（JSON Web Token）是一种基于JSON格式的WEB TOKEN。它可以在用户和服务器之间安全传输信息，而且这些信息可以被验证和信任。JWT可以用于身份验证（Authentication）和授权（Authorization）的过程。

JWT认证的实现过程

JWT的认证过程一般需要以下步骤：

构建token的认证头和内容
用密钥对认证信息进行签名，并获取token
token验证，用密钥解析token信息，判断是否有效
JWT认证过程的示例说明

下面以.NET Core WebAPI为例介绍JWT的认证过程。首先，我们需要在Startup.cs文件中配置中间件服务：

public void ConfigureServices(IServiceCollection services)
{
    services.AddAuthentication(options =>
    {
        options.DefaultScheme = JwtBearerDefaults.AuthenticationScheme;
    })
    .AddJwtBearer(options =>
    {
        options.TokenValidationParameters = new TokenValidationParameters
        {
            ValidateIssuer = true,
            ValidateAudience = true,
            ValidateLifetime = true,
            ValidateIssuerSigningKey = true,
            ValidIssuer = Configuration["Jwt:Issuer"],
            ValidAudience = Configuration["Jwt:Audience"],
            IssuerSigningKey = new SymmetricSecurityKey(Encoding.UTF8.GetBytes(Configuration["Jwt:Key"]))
        };
    });
}

然后，我们需要实现JWT的认证逻辑和生成Token的过程：

//JWT认证逻辑实现
[HttpPost]
[AllowAnonymous]
public async Task<IActionResult> Login([FromBody] LoginModel login)
{
    var user =await _userService.GetUser(login.UserName,login.Password);
    if (user != null)
    {
        var token = GenerateToken(user);
        return Ok(new {access_token = token});
    }
    else
    {
        return Unauthorized();
    }
}

//token生成过程实现
private string GenerateToken(User user)
{
    var tokenHandler = new JwtSecurityTokenHandler();
    var key = Encoding.ASCII.GetBytes(Configuration["Jwt:Key"]);
    var tokenDescriptor = new SecurityTokenDescriptor
    {
        Subject = new ClaimsIdentity(new Claim[]
        {
            new Claim(ClaimTypes.Name,user.UserName),
            new Claim(ClaimTypes.Role,user.Role.Name)
        }),
        Expires = DateTime.UtcNow.AddMinutes(30),
        SigningCredentials = new SigningCredentials(new SymmetricSecurityKey(key), SecurityAlgorithms.HmacSha256Signature)
    };
    var token = tokenHandler.CreateToken(tokenDescriptor);
    return tokenHandler.WriteToken(token);
}

最后，在需要认证的Controller上加上[Authorize]标签即可实现JWT的认证，如下所示：

[ApiController]
[Route("api/[controller]")]
public class UserController : ControllerBase
{
    [HttpGet]
    [Authorize(Roles="Admin")]
    public async Task<IActionResult> GetUsers()
    {
        var users = await _userService.GetUsers();
        return Ok(users);
    }
}