Common.API.Extensions.Lib 2.5.1

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
├── 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.