NoGrind.Auth.Core 2.2.0

NoGrind.Auth (v2)

NoGrind.Auth is a production-ready authentication library for ASP.NET Core 8.0+. It provides a complete solution for user management, authentication (JWT/Cookie), and security monitoring with minimal boilerplate.

Features

• Authentication: Built-in support for JWT (with refresh tokens) and Cookie authentication.
• User Management: Registration, password policies, role-based access control (RBAC).
• Data Access: EF Core integration with support for PostgreSQL, SQL Server, and SQLite.
• Monitoring: Optional add-on for audit logging, login tracking, and security alerts.
• Extensibility: Override default validation logic with your own FluentValidation rules.
• Configuration: Strongly-typed configuration via appsettings.json.

Documentation

Full documentation is available in the docs/ directory:

• Quickstart Guide - Get started in minutes.
• Configuration Reference - Detailed configuration options.
• Database & Migrations - Database setup and migration guides.
• Monitoring - Audit logging and security monitoring.
• Extensibility - Customization and extension guides.
• Changelog - Version history.

Quick Start

1. Install Packages

dotnet add package NoGrind.Auth.AspNetCore
dotnet add package NoGrind.Auth.EfCore

2. Configure appsettings.json

{
  "NoGrind": {
    "Authentication": {
      "Provider": "JWT",
      "JWT": {
        "Secret": "YOUR_SUPER_SECRET_KEY_MUST_BE_AT_LEAST_32_CHARS",
        "Issuer": "MyApi",
        "Audience": "MyClient"
      }
    },
    "Database": {
      "Provider": "SQLite", // Options: "SQLite", "Postgres", "SqlServer"
      "Connection": {
        "Sqlite": { "DataSource": "nogrind.db" }
        // "Postgres": { "Host": "...", ... }
        // "SqlServer": { "Server": "...", ... }
      }
    }
  }
}

3. Register in Program.cs

var builder = WebApplication.CreateBuilder(args);

// Add NoGrind services
builder.Services.AddNoGrind(builder.Configuration);

var app = builder.Build();

// Add middleware
app.UseAuthentication();
app.UseAuthorization();

app.Run();

Example Project

A fully functional example Web API is available in examples/ExampleWebApi.

To run it:

cd examples/ExampleWebApi
dotnet run

Then visit https://localhost:7123/swagger to explore the API.