C#后端Web API实战：从零构建安全的Token认证体系

1次阅读

共计 2128 个字符，预计需要花费 6 分钟才能阅读完成。

曾经参与过一个电商平台项目，当用户量突破 50 万时，服务器开始频繁出现内存溢出。排查发现 Session 存储占用了 80% 的内存，每次大促时集群节点间的 Session 同步延迟导致用户频繁掉线。另一个政务云项目更棘手——由于浏览器禁用第三方 Cookie，跨域单点登录根本无法实现。

这些痛点催生了无状态认证方案，而 JWT(JSON Web Token) 凭借其自包含、紧凑的特性成为分布式系统的首选。与 OAuth2.0 相比，JWT 不需要每次请求都查询授权服务器，特别适合内部微服务之间的认证场景。

避免硬编码密钥是安全底线，ASP.NET Core 的 IConfiguration 天然支持多环境配置：

// appsettings.Development.json
{
  "Jwt": {
    "SecretKey": "开发环境密钥至少 32 位",
    "ExpiryMinutes": 30,
    "Issuer": "yourdomain.com"
  }
}

通过依赖注入获取配置：

var securityKey = new SymmetricSecurityKey(Encoding.UTF8.GetBytes(Configuration["Jwt:SecretKey"]));

使用 Microsoft.IdentityModel.Tokens 创建包含自定义 Claims 的 Token：

var claims = new[] {new Claim(JwtRegisteredClaimNames.Sub, user.Id),
    new Claim("role", user.IsAdmin ? "admin" : "user"), // 自定义声明
    new Claim(JwtRegisteredClaimNames.Jti, Guid.NewGuid().ToString())
};

var token = new JwtSecurityToken(issuer: Configuration["Jwt:Issuer"],
    audience: "api",
    claims: claims,
    expires: DateTime.Now.AddMinutes(Convert.ToDouble(Configuration["Jwt:ExpiryMinutes"])),
    signingCredentials: new SigningCredentials(securityKey, SecurityAlgorithms.HmacSha256)
);

在 Startup.cs 中添加 JWT 验证管道：

services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
    .AddJwtBearer(options =>
    {
        options.TokenValidationParameters = new TokenValidationParameters
        {
            ValidateIssuer = true,
            ValidIssuer = Configuration["Jwt:Issuer"],
            ValidateAudience = true,
            ValidAudience = "api",
            ValidateLifetime = true,
            ClockSkew = TimeSpan.Zero, // 严格过期时间
            IssuerSigningKey = securityKey
        };
        options.Events = new JwtBearerEvents
        {
            OnAuthenticationFailed = context =>
            {if (context.Exception.GetType() == typeof(SecurityTokenExpiredException))
                {context.Response.Headers.Add("Token-Expired", "true");
                }
                return Task.CompletedTask;
            }
        };
    });