在 .NET Web API 中实现 JWT 认证需先安装必要包，再配置 JWT 参数，接着创建令牌生成服务，然后在 Program.cs 中添加认证中间件，最后通过 [Authorize] 保护接口并返回 Token。
在 .NET Web API 中实现 JWT（JSON Web Token）用户认证，主要涉及生成令牌、配置认证中间件以及保护 API 资源。下面是一个简洁实用的实现流程。
1. 安装必要包
确保项目中安装了以下 NuGet 包：
Microsoft.AspNetCore.Authentication.JwtBearer：用于配置 JWT 认证方案System.IdentityModel.Tokens.Jwt：用于生成和处理 JWTMicrosoft.IdentityModel.Tokens：提供加密支持
可通过 NuGet 包管理器或命令行安装：
dotnet add package Microsoft.AspNetCore.Authentication.JwtBearer
2. 配置 JWT 设置
在 appsettings.json 中添加 JWT 相关配置：
{ "JwtSettings": { "Key": "your-very-secret-key-that-is-at-least-32-characters-long", "Issuer": "your-api-site.com", "Audience": "your-client-site.com", "TokenExpirationInMinutes": 60 }}
创建一个对应的 C# 类来读取这些设置：
public class JwtSettings{ public string Key { get; set; } public string Issuer { get; set; } public string Audience { get; set; } public int TokenExpirationInMinutes { get; set; }}
在 Program.cs 中注册该配置：
builder.Configuration.GetSection("JwtSettings").Bind(new JwtSettings());builder.Services.Configure(builder.Configuration.GetSection("JwtSettings"));
3. 生成 JWT 令牌
创建一个服务用于生成令牌，例如：
public class TokenService{ private readonly JwtSettings _jwtSettings;public TokenService(IOptions jwtSettings){ _jwtSettings = jwtSettings.Value;}public string GenerateToken(string userId, string role){ var securityKey = new SymmetricSecurityKey(Encoding.UTF8.GetBytes(_jwtSettings.Key)); var credentials = new SigningCredentials(securityKey, SecurityAlgorithms.HmacSha256); var claims = new[] { new Claim(JwtRegisteredClaimNames.Sub, userId), new Claim(ClaimTypes.Role, role), new Claim(JwtRegisteredClaimNames.Jti, Guid.NewGuid().ToString()) }; var token = new JwtSecurityToken( issuer: _jwtSettings.Issuer, audience: _jwtSettings.Audience, claims: claims, expires: DateTime.Now.AddMinutes(_jwtSettings.TokenExpirationInMinutes), signingCredentials: credentials ); return new JwtSecurityTokenHandler().WriteToken(token);}
}
将服务注册到依赖注入：
builder.Services.AddScoped();
4. 配置 JWT 认证中间件
在 Program.cs 中启用 JWT Bearer 认证：
builder.Services.AddAuthentication(options =>{ options.DefaultAuthenticateScheme = JwtBearerDefaults.AuthenticationScheme; options.DefaultChallengeScheme = JwtBearerDefaults.AuthenticationScheme;}).AddJwtBearer(options =>{ options.TokenValidationParameters = new TokenValidationParameters { ValidateIssuer = true, ValidateAudience = true, ValidateLifetime = true, ValidateIssuerSigningKey = true, ValidIssuer = builder.Configuration["JwtSettings:Issuer"], ValidAudience = builder.Configuration["JwtSettings:Audience"], IssuerSigningKey = new SymmetricSecurityKey(Encoding.UTF8.GetBytes(builder.Configuration["JwtSettings:Key"])) };});// 启用认证和授权中间件app.UseAuthentication();app.UseAuthorization();
5. 创建登录接口返回 Token
示例登录控制器：
[ApiController][Route("api/[controller]")]public class AuthController : ControllerBase{ private readonly TokenService _tokenService;public AuthController(TokenService tokenService){ _tokenService = tokenService;}[HttpPost("login")]public IActionResult Login([FromBody] LoginModel model){ // 这里应验证用户名密码（可对接数据库或 Identity） if (model.Username == "admin" && model.Password == "password") { var token = _tokenService.GenerateToken("1", "Admin"); return Ok(new { Token = token }); } return Unauthorized();}
}
6. 保护 API 接口
使用 [Authorize] 特性保护需要认证的接口：
[ApiController][Route("api/[controller]")][Authorize]public class SecureController : ControllerBase{ [HttpGet] public IActionResult Get() { return Ok(new { Message = "This is a secure endpoint.", User = User.Identity.Name }); }[HttpGet("admin")][Authorize(Roles = "Admin")]public IActionResult AdminOnly(){ return Ok(new { Message = "Only admins can see this." });}
}
客户端在请求时需在 Header 中携带 Token：
Authorization: Bearer
基本上就这些。只要配置正确，.NET 的 JWT 支持非常稳定且易于扩展。注意密钥安全、过期时间合理设置，并结合 HTTPS 使用。
以上就是.NET Web API如何实现JWT用户认证的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1441686.html
微信扫一扫 
支付宝扫一扫 
