Tago.Extensions.Jwt 6.0.9

Tago.Extensions.Jwt

Tago.Extensions.Jwt is a .NET Core package that simplifies JWT authentication and token signing for ASP.NET Core applications.

It provides extension methods for registering JWT validation and signing services, along with built-in support for policy-based validation and configurable token settings.

Features

• Easy AddJwt() integration for ASP.NET Core authentication
• JWT bearer token validation with configurable validation settings
• Support for custom token validation policies
• JWT signing support via AddJwtSigner()
• Works with JwtBearerDefaults.AuthenticationScheme
• Includes a reusable core package for JWT operations

Package Metadata

• Package: Tago.Extensions.Jwt
• Authors: Tago-Solutions Ltd.
• License: Apache-2.0
• Repository: https://github.com/tago-solutions/Tago.Extensions.Jwt

Install

Install using NuGet Package Manager:

Install-Package Tago.Extensions.Jwt -Version 6.0.8

Or add the package reference directly in your project file:

<PackageReference Include="Tago.Extensions.Jwt" Version="6.0.8" />

Quick Start

Register JWT validation services in Startup.ConfigureServices:

public void ConfigureServices(IServiceCollection services)
{
    services.AddRestClient();

    services.AddJwt(opts =>
    {
        opts.Configure(Configuration.GetSection("JwtSettings"));
    });

    services.AddJwtSigner(opts =>
    {
        opts.Configure(Configuration.GetSection("JwtSigner"));
    });

    services.AddControllers();
}

Enable middleware in Startup.Configure:

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
    }

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

    app.UseEndpoints(endpoints =>
    {
        endpoints.MapControllers();
    });
}

You may also use the provided helper extension:

app.UseJwt();

Configuration

JwtSettings

Configure JWT validation settings in appsettings.json or any configuration provider:

{
  "JwtSettings": {
    "Keys": [
      {
        "Selector": "_Default",
        "KeySettings": {
          "Jwks": {
            "Path": "https://example.com/.well-known/jwks.json"
          }
        }
      }
    ]
  }
}

JwtSigner

Configure JWT signing options:

{
  "JwtSigner": {
    "Keys": [
      {
        "Selector": "default",
        "KeySettings": {
          "SymmetricKey": {
            "Key": "someSecretKey",
            "SecurityAlgorithm": "HS256"
          }
        }
      }
    ]
  }
}

Usage

• services.AddJwt(opts => opts.Configure(...)); to register token validation
• services.AddJwtSigner(opts => opts.Configure(...)); to register signing support
• app.UseJwt() to enable authentication and authorization middleware
• Policies can be configured using the package's validator and policy APIs

Development

Build the solution from the repository root:

dotnet build Tago.Extensions.Jwt.sln

Run tests from the Tests folder if available:

dotnet test Tago.Extensions.Jwt.sln

Contributing

Contributions are welcome. Please open issues or pull requests in the repository, and follow these guidelines:

• Use descriptive commit messages
• Keep feature changes small and self-contained
• Add tests for bug fixes and new features
• Update documentation when APIs change

License

This project is licensed under the Apache 2.0 License.