Watir.DotNetCore.HttpPipelineExtensions 1.0.2

Watir.DotNetCore.HttpPipelineExtensions

A modular set of ASP.NET Core startup and middleware extensions for configuring HTTP request pipelines. This package provides reusable helpers for authentication, diagnostics, Swagger setup, correlation IDs, and shared service registration — designed to streamline bootstrapping across multiple APIs.

✨ Key Features

• 🔐 Authentication

  • AddJwtAuthentication() — Configures Entra ID–backed JWT auth
  • AddTestAuthentication() — Enables test-mode auth for local/dev
  • UseTestAuthMiddleware() — Injects mock user into pipeline

• 📊 Diagnostics

  • LogStartupInfo() — Logs environment, config, and startup metadata

• 📦 Swagger

  • AddSwaggerWithBearer() — Adds Swagger with JWT Bearer support
  • UseSwagger() / UseSwaggerUI() — Standard Swagger setup

• 🔗 Middleware

  • UseCorrelationMiddleware() — Adds correlation ID for tracing

• 🧰 Shared Services

  • AddSharedServices() — Registers common services (e.g., logging, telemetry)

🚀 Installation

dotnet add package Watir.DotNetCore.HttpPipelineExtensions

Usage Example In Program.cs:

builder.Services.AddSharedServices();
builder.Services.AddAuthorization();

if (useTestAuth)
{
    builder.Services.AddTestAuthentication(configuration, "GreetingApi");
}
else
{
    builder.Services.AddJwtAuthentication(configuration, "GreetingApi");
}

builder.Services.AddSwaggerWithBearer(
    title: "GreetingApi",
    version: "v1",
    description: "GreetingApi - Secured backend that receives and stores greetings, protected by Entra ID and scoped access");

var app = builder.Build();

StartupDiagnostics.LogStartupInfo(logger, configuration, environment, "GreetingApi");
app.UseCorrelationMiddleware("GreetingApi");

if (app.Environment.IsDevelopment() || Environment.GetEnvironmentVariable("ENABLE_SWAGGER") == "true")
{
    app.UseSwagger();
    app.UseSwaggerUI(options =>
    {
        options.SwaggerEndpoint("/swagger/v1/swagger.json", "GreetingApi v1");
        options.RoutePrefix = "swagger";
    });
}

if (useTestAuth)
{
    var testAuthOptions = app.Services.GetRequiredService<IOptions<TestAuthOptions>>().Value;
    app.UseTestAuthMiddleware(testAuthOptions, loggerCategory: "GreetingApi");
}

app.UseHttpsRedirection();
app.UseAuthentication();
app.UseAuthorization();
app.MapControllers();
await app.RunAsync();

🧪 Test Auth Mode

Enable test-mode authentication for local development:

builder.Services.AddTestAuthentication(configuration, "GreetingApi");
app.UseTestAuthMiddleware(options, loggerCategory: "GreetingApi");

📄 License

MIT — free to use, modify, and distribute.

🧭 Source & Contributions

Coming soon: [GitHub repo link]