Authentication Dotnet Jwt

JWT Bearer

Package

Program.cs

Đăng ký trong callback của AddJarvisAuthentication (không gọi AddAuthentication() trực tiếp):

using Jarvis.Authentication;          // AddJarvisAuthentication
using Jarvis.Authentication.Jwt;      // AddCoreJwtBearer
using Microsoft.AspNetCore.Authentication.JwtBearer;

builder.Services.AddJarvisAuthentication(builder.Configuration, auth =>
{
    auth.AddCoreJwtBearer(builder.Configuration, JwtBearerDefaults.AuthenticationScheme);
});

Scheme mặc định "Bearer". Bind từ Authentication:Jwt:{scheme}.

Hai chế độ validate

| Chế độ | Điều kiện | Dùng cho | |--------|-----------|----------| | OIDC metadata | có Authority | OpenIddict, Cognito, Azure AD — validate qua issuer metadata | | Symmetric key | không Authority, có IssuerSigningKeys | dev/test |

Validator startup yêu cầu Authority HOẶC IssuerSigningKeys (khi ValidateIssuerSigningKey). ClockSkew = 0. MaxExpireMinutes > 0 → giới hạn lifetime token theo policy.

Revoke / blacklist — IJwtTokenAccessChecker

Mặc định AllowAllJwtTokenAccessChecker (cho tất cả). Override để chặn token bị thu hồi:

auth.AddCoreJwtBearer(builder.Configuration, "Bearer");

Checker đăng ký Singleton, gọi trong OnTokenValidated sau khi chữ ký + lifetime OK. Tra DB → dùng IDbContextFactory / IServiceScopeFactory (không inject scoped DbContext).

appsettings.json

{
  "Authentication": {
    "Jwt": {
      "Bearer": {
        "Authority": "",
        "Audience": "",
        "IssuerSigningKeys": [],
        "ValidateAudience": true,
        "ValidateIssuer": false,
        "MaxExpireMinutes": 0
      }
    }
  }
}

Signing key / secret — env / secret store, không commit.

Swagger

[swashbuckle-dotnet/providers/jwt-security](../../../swashbuckle-dotnet/providers/jwt-security/SKILL.md) — SecuritySchemes: ["JWT"].

Validate

• Endpoint [Authorize] → 401 khi thiếu token
• Token symmetric hợp lệ → 200
• (nếu có checker) token bị revoke → 401 dù chữ ký đúng

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: hoangnh2412
• Source: hoangnh2412/ai-skills
• License: MIT

Install and usage instructions live in the source repository linked above.