Common.API.Extensions.Lib 1.0.17

Common.API.Extensions for .NET 8

This project provides a set of extensions for .NET 8 applications, covering authentication, logging, security, and validation.

Features

• Custom Authorization: Implements role-based access control with custom attributes.
• Logging: Provides Serilog-based logging extensions.
• Security: Includes middleware for XSS protection.
• Utilities: Provides reusable token management services.
• Validation: Implements custom DTO validation attributes.

Project Structure

Common.API.Extensions
├── CustomAuthorization
│   ├── Model
│   │   ├── Menu.cs
│   │   ├── Permission.cs
│   │   ├── SubMenu.cs
│   │   ├── UserAccessDetails.cs
│   ├── CustomAuthorizeAttribute.cs
├── Logging
│   ├── ConfigurationExtensions.cs
│   ├── Constants.cs
│   ├── RequestLoggingMiddleware.cs
├── Sanitation
│   ├── AntiXssMiddleware.cs
│   ├── ErrorResponse.cs
│   ├── XssSettings.cs
├── Utils
│   ├── TokenService.cs
├── Validation
│   ├── CustomDtoValidations
│   │   ├── AccomodationKind
│   │   ├── ContactKind
│   │   ├── EventKind
│   │   ├── RoomType
│   │   ├── DateGreaterThanAttribute.cs
│   ├── AccessTokenValidationMiddleware.cs
│   ├── OpenIdConnectConfiguration.cs
│   ├── TokenValidationService.cs
├── LICENSE.txt
├── README.md

Installation

1. Install required NuGet packages:

   dotnet add package Microsoft.AspNetCore.Authentication.JwtBearer
   dotnet add package Serilog.AspNetCore
   dotnet add package Serilog.Settings.Configuration
   dotnet add package Serilog.Sinks.Console
   

Usage

Logging Configuration

using Microsoft.Extensions.Hosting;
using Serilog;
using Serilog.Events;
using Serilog.Formatting.Json;

public static class LoggingExtensions
{
    public static IHostBuilder UseUniversalLogging(this IHostBuilder hostBuilder)
    {
        hostBuilder.UseSerilog((context, services, loggerConfiguration) =>
        {
            loggerConfiguration
                .ReadFrom.Configuration(context.Configuration)
                .MinimumLevel.Override("Microsoft", LogEventLevel.Information)
                .Enrich.FromLogContext()
                .WriteTo.Console(new JsonFormatter()) // Writes logs to console
                .WriteTo.Console(new JsonFormatter(), standardErrorFromLevel: LogEventLevel.Verbose); // Writes logs to stdout
        });

        return hostBuilder;
    }
}

Authorization

[CustomAuthorize("Admin")]
public class AdminController : ControllerBase
{
    // Controller logic here
}

XSS Protection Middleware

app.UseMiddleware<AntiXssMiddleware>();

Token Validation

services.AddSingleton<ITokenService, TokenService>();

Deployment Notes

• Ensure your authentication and logging configurations are properly set in appsettings.json.
• Supports Kubernetes logging with JSON formatting for compatibility with log aggregators like Fluentd and Loki.

Contributing

1. Fork the repository.
2. Create a new branch: git checkout -b feature-branch
3. Commit changes: git commit -m "Added new feature"
4. Push and create a PR.