Ozcorps.Jwt 8.1.0

Ozcorps.Jwt

JWT (JSON Web Token) authentication library for ASP.NET Core. Provides Options Pattern configuration, Swagger integration, and a full-featured token service.

Installation

dotnet add package Ozcorps.Jwt

<PackageReference Include="Ozcorps.Jwt" Version="8.1.0" />

Configuration

Add the following section to appsettings.json:

{
  "Jwt": {
    "Issuer": "YourApp",
    "Audience": "YourApp.Users",
    "Key": "your-super-secret-key-at-least-32-chars-long",
    "ValidateIssuer": true,
    "ValidateAudience": true,
    "ValidateLifetime": true,
    "ValidateIssuerSigningKey": true,
    "ClockSkew": "00:00:00"
  }
}

Security: Never commit real JWT keys to source control. Use environment variables or a secrets manager.

Configuration Reference

Quick Start

using Ozcorps.Jwt.Extensions;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddJwtAuthentication(builder.Configuration);

var app = builder.Build();

app.UseAuthentication();
app.UseAuthorization();

app.Run();

Swagger Integration

builder.Services.AddSwaggerGen(options =>
{
    options.SwaggerDoc("v1", new OpenApiInfo { Title = "My API", Version = "v1" });
    options.AddJwtSecurity();
});

AddJwtSecurity() adds the Bearer security scheme to Swagger UI so tokens can be entered directly in the UI.

IJwtTokenService

IJwtTokenService is registered as scoped and available via dependency injection.

public class AuthController(IJwtTokenService jwtTokenService) : ControllerBase
{
    [HttpPost("login")]
    public IActionResult Login([FromBody] LoginRequest request)
    {
        // validate credentials...

        var token = jwtTokenService.GenerateToken(
            userId: user.Id.ToString(),
            username: user.Username,
            roles: new[] { "User" },
            expiration: DateTime.UtcNow.AddHours(8)
        );

        return Ok(new { token, expiresAt = jwtTokenService.GetTokenExpiration(token) });
    }
}

API

Custom Section Name

// appsettings.json
{
  "Auth": {
    "Jwt": { "Issuer": "...", "Audience": "...", "Key": "..." }
  }
}

// Program.cs
builder.Services.AddJwtAuthentication(builder.Configuration, sectionName: "Auth:Jwt");