Acontplus.Services 1.1.0

Acontplus.Services

A modern .NET 9+ library for API services, authentication, claims, middleware, and configuration. Includes JWT, user context, and exception handling for robust enterprise APIs.

🚀 Features

• Platform-aware Configuration Loading - Dynamic app and shared config loading
• Claims-based User Context Extensions - Easy access to user info and claims
• Identity & JWT Authentication - Flexible and strict JWT setup
• User Context Service - Abstracted access to user claims
• Global Exception Handling Middleware - Robust error logging and API error responses
• Mobile Request Detection Middleware - Detects mobile clients via headers

📦 Installation

NuGet Package Manager

Install-Package Acontplus.Services

.NET CLI

dotnet add package Acontplus.Services

PackageReference

<ItemGroup>
  <PackageReference Include="Acontplus.Services" Version="1.0.12" />
</ItemGroup>

🎯 Quick Start

1. Add JWT Authentication

using Microsoft.Extensions.DependencyInjection;
using Acontplus.Services.Extensions;

public void ConfigureServices(IServiceCollection services)
{
    services.AddIdentityService(Configuration); // or AddIdentityServiceStrict
}

public void Configure(IApplicationBuilder app)
{
    app.UseAuthentication();
    app.UseAuthorization();
}

2. Use ClaimsPrincipal Extensions

using System.Security.Claims;
using Acontplus.Services.Extensions;

var username = user.GetUsername();
var email = user.GetEmail();
var userId = user.GetUserId();

3. Global Exception Middleware

app.UseMiddleware<ApiExceptionMiddleware>();

🔧 Advanced Usage

AppConfiguration

using Acontplus.Services.Configuration;
var config = AppConfiguration.Load();

User Context Service

using Acontplus.Services.Extensions;
services.AddHttpContextAccessor();
services.AddScoped<IUserContext, UserContext>();

JsonConfigurationService

Centralizes and standardizes System.Text.Json options for your application.

using Acontplus.Services.Configuration;

// Get default options for serialization
var options = JsonConfigurationService.GetDefaultOptions();

// For pretty-printing (development)
var prettyOptions = JsonConfigurationService.GetPrettyOptions();

// For strict API validation
var strictOptions = JsonConfigurationService.GetStrictOptions();

Integrate with ASP.NET Core

// In Program.cs or Startup.cs
using Acontplus.Services.Configuration;

var builder = WebApplication.CreateBuilder(args);

// Use default or strict options for all controllers and minimal APIs
JsonConfigurationService.ConfigureAspNetCore(builder.Services, useStrictMode: false);

// Or, environment-aware:
JsonConfigurationService.ConfigureAspNetCore(builder.Services, builder.Environment.IsDevelopment());

Dependency Injection

// Register as singleton for DI
JsonConfigurationService.RegisterJsonConfiguration(services);

// Then inject IJsonConfigurationProvider wherever needed
public class MyService
{
    public MyService(IJsonConfigurationProvider jsonConfig) { ... }
}

📚 API Documentation

• AppConfiguration - Platform/environment config loader
• ClaimsPrincipalExtensions - User/claim helpers
• ApiExceptionMiddleware - Centralized error handling
• UserContext - User info abstraction
• RequestContextOptions - Request context config

🤝 Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

Development Setup

git clone https://github.com/Acontplus-S-A-S/acontplus-dotnet-libs.git
cd acontplus-dotnet-libs
dotnet restore
dotnet build

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🆘 Support

• 📧 Email: proyectos@acontplus.com
• 🐛 Issues: GitHub Issues
• 📖 Documentation: Wiki

👨‍💻 Author

Ivan Paz - @iferpaz7

🏢 Company

Acontplus S.A.S. - Enterprise software solutions

Built with ❤️ for the .NET community