LoRemmit.Shared.Library 1.2.95

Introduction

TODO: Give a short introduction of your project. Let this section explain the objectives or the motivation behind this project.

Getting Started

TODO: Guide users through getting your code up and running on their own system. In this section you can talk about:

1. Installation process
2. Software dependencies
3. Latest releases
4. API references

Build and Test

TODO: Describe and show how to build your code and run the tests.

Contribute

TODO: Explain how other users and developers can contribute to make your code better If you want to learn more about creating good readme files then refer the following guidelines. You can also seek inspiration from the below readme files:

• ASP.NET Core
• Visual Studio Code
• Chakra Core

LoRemmit Shared Library

A comprehensive .NET 8 shared library providing authentication, JWT token blacklisting, Redis caching, HTTP client services, and common utilities for LoRemmit applications.

Features

• 🔐 JWT Authentication & Authorization - Complete JWT token validation with role and permission-based authorization
• 🚫 JWT Token Blacklisting - Environment-aware token revocation with Redis backend
• 🗄️ Redis Service - Environment-isolated caching with automatic key prefixing
• 🌐 HTTP Client Services - Polly-based resilient HTTP clients with retry policies
• 🔧 Common Utilities - Helpers for encryption, serialization, pagination, and more
• 📝 Rich ViewModels - Ready-to-use models for Dojah, Sumsub, and other integrations

Installation

From NuGetdotnet add package LoRemmit.Shared.Library

From Sourcegit clone https://github.com/your-repo/LoRemmit-Shared

cd LoRemmit-Shared/LoRemmit-Shared.Library dotnet build

Quick Start

1. Authentication Setup

// Program.cs using LoRemmit_Shared.Library.ServiceCollectionExtensions.AuthenticationExtension; using LoRemmit_Shared.Library.Validation.Authentication;

var builder = WebApplication.CreateBuilder(args);

// Register authentication services builder.Services.AddSharedAuthenticationServices(builder.Configuration);

var app = builder.Build();

// Configure middleware pipeline app.UseAuthentication(); app.UseTokenBlacklist(); // JWT blacklist middleware app.UseAuthorization();

app.MapControllers(); app.Run();

2. Configuration

{ "ConnectionStrings": { "Redis": "your-redis-connection-string" }, "Redis": { "ConnectionString": "your-redis-connection-string", "InstanceName": "URP-Central" }, "JwtSettings": { "Issuer": "your-issuer", "Audience": "your-audience", "SecretKey": "your-secret-key" } }

3. Controller Usage

[ApiController] [Route("api/[controller]")] public class TestController : ControllerBase { private readonly ICurrentUser _currentUser; private readonly ITokenBlacklistService _blacklistService; private readonly IRedisService _redisService;

public TestController(
    ICurrentUser currentUser,
    ITokenBlacklistService blacklistService,
    IRedisService redisService)
{
    _currentUser = currentUser;
    _blacklistService = blacklistService;
    _redisService = redisService;
}

[HttpGet("protected")]
[Authorize]
public IActionResult GetProtectedData()
{
    var userId = _currentUser.GetUserId();
    var email = _currentUser.GetEmail();
    
    return Ok(new { UserId = userId, Email = email });
}

[HttpPost("logout")]
[Authorize]
public async Task<IActionResult> Logout()
{
    var jti = _currentUser.GetJwtId();
    var expClaim = _currentUser.GetClaimValue("exp");
    
    var expiration = DateTimeOffset.UtcNow.AddDays(1);
    if (!string.IsNullOrEmpty(expClaim) && long.TryParse(expClaim, out var exp))
    {
        expiration = DateTimeOffset.FromUnixTimeSeconds(exp);
    }

    await _blacklistService.BlacklistTokenAsync(jti, expiration);
    
    return Ok(new { Message = "Logged out successfully" });
}

}

Core Services

Authentication Services

• ICurrentUser - Get current user claims and information
• ITokenBlacklistService - Manage JWT token blacklisting
• PermissionFilter - Role and permission-based authorization

Redis Service

• IRedisService - Environment-aware caching with automatic key prefixing
• Supports: SetAsync, GetAsync, RemoveAsync, ExistsAsync

HTTP Client Service

• IHttpClientAppService - Resilient HTTP client with Polly retry policies
• Supports: JSON, form-encoded, and custom requests

Advanced Features

Role-Based Authorization[HttpGet("admin-only")]

[RequiresRole("Administrator")] public IActionResult AdminEndpoint() ⇒ Ok();

Permission-Based Authorization[HttpPost("create-user")]

[RequiresPermission("UserManagement", "Create")] public IActionResult CreateUser() ⇒ Ok();

Redis Caching// Set cache with expiration

await _redisService.SetAsync("user:123", userData, 3600); // 1 hour

// Get cached data var userData = await _redisService.GetAsync("user:123");

// Check existence var exists = await _redisService.ExistsAsync("user:123");

Environment Isolation

The Redis service automatically prefixes all keys with the current environment:

• Development: Development_user:123
• Staging: Staging_user:123
• Production: Production_user:123

This ensures complete data isolation between environments.

Dependencies

• .NET 8.0
• Microsoft.AspNetCore.Authentication.JwtBearer
• StackExchange.Redis
• Microsoft.EntityFrameworkCore
• Polly (for HTTP resilience)
• System.IdentityModel.Tokens.Jwt

Build and Test

Build the library

dotnet build

Run tests (if available)

dotnet test

Create NuGet package

dotnet pack

Publishing to NuGet

Update version in .csproj first, then:

dotnet pack dotnet nuget push LoRemmit.Shared.Library.{version}.nupkg --api-key {your-api-key} --source https://api.nuget.org/v3/index.json

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

License

MIT License - see LICENSE file for details.

Support

For issues and questions, please create an issue in the repository or contact the development team.

Version: 1.2.89
Authors: EminenceTobi
Company: mcAdware Solutions

nuget oy2krnyyex3dmwvgvaoatzy6bultxjjutn62md5y7hcyii

dotnet nuget push LoRemmit.Shared.Library.1.2.95.nupkg --api-key oy2krnyyex3dmwvgvaoatzy6bultxjjutn62md5y7hcyii --source https://api.nuget.org/v3/index.json