SuperAPI AI 工具集

jwt-authentication

安全与审计

查看项目

更新于 10-16 08:08

技能介绍

用途:为 .NET API 实现基于 JWT 的认证方案。访问令牌为短时效 JWT,在响应体中返回;刷新令牌存放于 HttpOnly Cookie 中,不可由 JavaScript 读取。 主要能力:生成访问令牌与刷新令牌;校验传入令牌;从声明中提取用户上下文;通过 JwtOptions 配置过期时间;每次刷新时签发新刷新令牌实现令牌轮换;对刷新令牌做哈希存储与校验。 组成:IJwtService 负责令牌生成接口,JwtService 为其实现,JwtOptions 承载配置(签发方、受众、密钥、过期时间等),JwtBearerOptionsSetup 配置验证参数,IUserContext 与 UserContext 提供当前用户信息,IRefreshTokenRepository 负责刷新令牌存储,CookieSettings 配置 Cookie。 用法:在 appsettings.json 的 Jwt 节配置 Issuer、Audience、SecretKey、AccessTokenExpirationMinutes、RefreshTokenExpirationDays 及 Cookie 项(Name、Domain、Path、SameSite、SecureOnly)。刷新令牌 Cookie 默认名 X-Refresh-Token,默认路径 /api/v1/auth,默认 SameSite 为 Strict、SecureOnly 为 true。令牌验证启用签发方、受众、签名密钥与有效期校验,ClockSkew 为零。密钥需至少 32 字符。 适用场景:需要访问令牌加刷新令牌、注重刷新令牌安全存储(HttpOnly Cookie)与令牌轮换的 .NET API,例如对审计跟踪有要求的合规场景。 限制:资料未提供具体安装命令、依赖包版本、完整的控制器或端点使用示例,也未说明收费与平台信息。