BoricuaCoder.API.CoreSetup 1.0.0

BoricuaCoder.API.CoreSetup

A lightweight library that simplifies ASP.NET Core API setup with pre-configured JWT Bearer authentication and Swagger/OpenAPI documentation with JWT security support.

Purpose

This package eliminates boilerplate code when setting up new ASP.NET Core APIs. Instead of manually configuring JWT authentication and Swagger with security schemes, you can configure everything via appsettings.json with just two lines of code.

Features

• JWT Bearer Authentication - Pre-configured with Authority, Audience, and HTTPS metadata settings
• Swagger/OpenAPI - Auto-configured with JWT Bearer security scheme
• Configuration-driven - All settings via appsettings.json
• Minimal API friendly - Works with both Minimal APIs and Controller-based APIs

Installation

dotnet add package BoricuaCoder.API.CoreSetup

Quick Start

Step 1: Add Configuration

Add the CoreSetup section to your appsettings.json:

{
  "CoreSetup": {
    "Jwt": {
      "Authority": "https://your-identity-provider.com",
      "Audience": "your-api-audience",
      "RequireHttpsMetadata": true
    },
    "Swagger": {
      "Enabled": true,
      "Title": "My API",
      "Version": "v1",
      "RoutePrefix": "swagger"
    }
  }
}

Step 2: Configure Services

In your Program.cs, add the core setup services:

using BoricuaCoder.API.CoreSetup.Extensions;

var builder = WebApplication.CreateBuilder(args);

// Add CoreSetup (JWT + Swagger)
builder.Services.AddCoreSetup(builder.Configuration);

var app = builder.Build();

// Use CoreSetup middleware
app.UseCoreSetup();

app.MapGet("/", () => "Hello World!")
   .RequireAuthorization();

app.Run();

That's it! Your API now has:

• JWT Bearer authentication configured
• Swagger UI available at /swagger with JWT authorization support

Configuration Options

JwtOptions

SwaggerOptions

Environment-Specific Configuration

Use appsettings.Development.json for local development:

{
  "CoreSetup": {
    "Jwt": {
      "Authority": "http://localhost:5000",
      "Audience": "local-api",
      "RequireHttpsMetadata": false
    },
    "Swagger": {
      "Enabled": true,
      "Title": "My API (Dev)",
      "Version": "v1"
    }
  }
}

And appsettings.Production.json for production:

{
  "CoreSetup": {
    "Jwt": {
      "Authority": "https://auth.mycompany.com",
      "Audience": "production-api",
      "RequireHttpsMetadata": true
    },
    "Swagger": {
      "Enabled": false
    }
  }
}

Using the Swagger UI

1. Run your API
2. Navigate to https://localhost:{port}/swagger
3. Click the Authorize button
4. Enter your JWT token in the format: Bearer {your_token}
5. Click Authorize to apply the token to all requests

What Gets Configured

Authentication & Authorization

• JWT Bearer authentication scheme as default
• Authorization services registered
• UseAuthentication() and UseAuthorization() middleware added

Swagger/OpenAPI

• OpenAPI document generation
• JWT Bearer security scheme definition
• Security requirement applied globally
• Swagger UI with request duration display

Requirements

• .NET 10.0 or later
• ASP.NET Core application

License

MIT