Kck.Bundle.WebApi 5.0.0

dotnet add package Kck.Bundle.WebApi --version 5.0.0
                    
NuGet\Install-Package Kck.Bundle.WebApi -Version 5.0.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Kck.Bundle.WebApi" Version="5.0.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Kck.Bundle.WebApi" Version="5.0.0" />
                    
Directory.Packages.props
<PackageReference Include="Kck.Bundle.WebApi" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Kck.Bundle.WebApi --version 5.0.0
                    
#r "nuget: Kck.Bundle.WebApi, 5.0.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Kck.Bundle.WebApi@5.0.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Kck.Bundle.WebApi&version=5.0.0
                    
Install as a Cake Addin
#tool nuget:?package=Kck.Bundle.WebApi&version=5.0.0
                    
Install as a Cake Tool

Kck.Bundle.WebApi

One-line ASP.NET Core Web API setup: registers Serilog, Argon2 hashing, the in-memory cache, the in-memory event bus, exception handling, health check services, and rate limiting with security headers and CORS from the Kck configuration section. With Kck:Security:Jwt:Issuer set it also registers the JWT token service; ASP.NET Core authentication, persistence, the Mediator pipeline and OpenTelemetry are configured separately.

New to Kck? Your first Kck API in five minutes creates a working API with this package: dotnet new install Kck.Templates, then dotnet new kck-webapi.

Installation

dotnet add package Kck.Bundle.WebApi

Quick Start

// Program.cs
var builder = WebApplication.CreateBuilder(args);

builder.Services.AddKckWebApiDefaults(builder.Configuration);

var app = builder.Build();

app.UseKckWebApiDefaults();

app.MapControllers();

app.Run();

That is all the setup required. Add your controllers, Mediator handlers, and domain entities — the bundle wires everything else.

Configuration

Property Description Default
Kck:Security:Jwt:Issuer JWT token issuer; setting it registers the JWT token service —
Kck:Security:Jwt:Audience JWT token audience; required once Issuer is set —
Kck:AspNetCore:RateLimitPermitLimit Requests per window per client IP 100
Kck:AspNetCore:RateLimitWindowSeconds Rate limit window (seconds) 60
Kck:AspNetCore:SecurityHeaders Adds the security headers middleware true
Kck:AspNetCore:CorsOrigins Allowed CORS origins (string array, for example ["https://myapp.com"]) none — CORS off

These are the only settings the bundle reads. The cache is always the in-memory one and the health checks have no configuration; configure the providers in code for anything else.

Issuer alone is not enough: the JWT options are validated at start-up, and without Audience and an RS256 signing key start-up fails with a JwtOptions is invalid error that lists Audience: null or empty and RsaKeyBase64 … is empty. The bundle does not bind the key; set it (and any other JwtOptions value, such as AccessTokenExpiration) on JwtOptions yourself:

using Kck.Security.Jwt;

builder.Services.AddKckWebApiDefaults(builder.Configuration);
builder.Services.Configure<JwtOptions>(jwt =>
    jwt.RsaKeyBase64 = Environment.GetEnvironmentVariable("JWT_RSA_KEY_B64"));

Resources

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
5.0.0 241 11/2/2026
4.8.0 568 10/31/2026
Loading failed