.Net 8.0 Web API下使用JWT登录和鉴权

NuGet添加：

• Microsoft.AspNetCore.Authentication.JwtBearer

JWT

JWT把登录信息(也称为令牌)保存在客户端；

JWT由三部分组成：Header，PayLoad，Signature；

为了防止客户端造假，保存在客户端的令牌经过了签名处理，签名的密钥只有客户端知道，每次服务器端收到客户端提交过来的令牌时检查签名(Signature)；

使用

1. 在appsetting.json中"ConnectionStrings"下配置JWT的密钥；

   ? ?"JwtSecretKey": "sadae21iasuhduashdu1h2ihduah",

2. 在program.cs中注册 JWT 身份验证服务并启用

   ?//启动Jwt身份验证
   ?builder.Services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme).AddJwtBearer(options =>
   ?{
   ? ? ?var jwtSecretKey =builder.Configuration.GetConnectionString("JwtSecretKey");
   ? ? ?options.TokenValidationParameters = new TokenValidationParameters
   ? ?  {
   ? ? ? ? ?
   ? ? ? ? ?ValidateIssuer = false,//验证令牌的发行者是否有效
   ? ? ? ? ?ValidateAudience = false,//验证令牌的受众是否有效
   ? ? ? ? ?ValidateLifetime = true,//验证令牌的有效期
   ? ? ? ? ?ValidateIssuerSigningKey = true,//验证令牌的签名密钥是否有效
   ? ? ? ? ?IssuerSigningKey = new SymmetricSecurityKey(Encoding.UTF8.GetBytes(jwtSecretKey)) // 替换为你的密钥
   ? ?  };
   ?});
   ?//启动鉴权
   ?builder.Services.AddAuthorization(options =>
   ?{
   ? ?//定义一个名为 "Admin" 的授权策略。
   ?  //该策略要求 JWT 令牌中必须包含一个 "userRole" 声明，其值为 "admin"。
   ? ? ?options.AddPolicy("Admin", policy => policy.RequireClaim("userRole", "admin"));
   ? ?//定义一个名为 "User" 的授权策略。
   ?  //该策略要求 JWT 令牌中必须包含一个 "userRole" 声明，其值为 "user"。
   ? ? ?options.AddPolicy("User", policy => policy.RequireClaim("userRole", "user"));
   ?});
   ??
   ??
   ??
   ??
   ??
   ??
   ?app.UseAuthentication();// 启用身份验证
   ?app.UseAuthorization();// 启用授权

3. 定义生成Jwt的方法

   using System.IdentityModel.Tokens.Jwt;
   ?using System.Security.Claims;
   ?using System.Text;
   ?using AiAnswerBackend.Config;
   ?using Microsoft.IdentityModel.Tokens;
   ??
   ?namespace AiAnswerBackend.Utils;
   ??
   ?public class JwtUtils
   ?{
   ? ? ?public static string GenerateToken(Guid userId,string userRole)
   ? ?  {
   ? ? ? ? ?var claims = new[]
   ? ? ? ?  {
   ? ? ? ? ? ? ?//JwtRegisteredClaimNames.Sub:
   ? ? ? ? ? ? ?// 这是一个预定义的 JWT 声明类型，表示 "subject"（主体）。
   ? ? ? ? ? ? ?// 在此上下文中，它通常用于存储用户的唯一标识符（如用户名或用户ID）。
   ? ? ? ? ? ? ?new Claim("userId", userId.ToString()),
   ? ? ? ? ? ? ?new Claim("userRole", userRole)
   ? ? ? ?  };
   ? ? ? ? ?var key = new SymmetricSecurityKey(Encoding.UTF8.GetBytes("sadae21iasuhduashdu1h2ihduah"));//""内填自己的密钥，要足够长。
   ? ? ? ? ?var creds = new SigningCredentials(key, SecurityAlgorithms.HmacSha256);
   ? ? ? ? ?var token = new JwtSecurityToken(
   ? ? ? ? ? ? ?claims: claims,
   ? ? ? ? ? ? ?expires: DateTime.Now.AddMinutes(60),//过期时间
   ? ? ? ? ? ? ?signingCredentials: creds);
   ? ? ? ? ?
   ? ? ? ? ?return new JwtSecurityTokenHandler().WriteToken(token);
   ? ?  }
   ?}

4. 在Controller中使用：

   ?[Authorize(Policy = "User")]
   ?[HttpGet("test")]
   ?public async Task<string> Test()
   ?{
   ? ? ?var userRole = User.FindFirst("userRole").Value;
   ? ? ?var userId = User.FindFirst("userId").Value;
   ? ? ?return "OK"+userRole+userId;
   ?}

注意：前端发送请求时要在请求头中加上字段 Authorization :"Bearer{Bearer后要添加一个空格}+{对应账号的Token}"即：Bearer空格Token