Kuwait.Lis.Common.Security 2.0.1

Kuwait.Lis.Common.Security

A .NET library providing common security utilities for Kuwait LIS services.

Features

• JWT Token Management: Generate and validate JWT tokens with custom claims
• Token Blacklisting: In-memory token blacklist service for security
• Service Validation: Health check and validation services for microservices
• User Service Health Check: Monitor user service availability and instances

Installation

Install the package via NuGet Package Manager:

dotnet add package Kuwait.Lis.Common.Security

Or via Package Manager Console:

Install-Package Kuwait.Lis.Common.Security

Usage

JWT Token Service

using Kuwait.Lis.Common.Security;

var tokenService = new TokenService("your-secret-key", "issuer", "audience");

// Generate token
string token = tokenService.GenerateToken("userId", "user@example.com", 60);

// Validate token
ClaimsPrincipal? principal = tokenService.ValidateToken(token);

Service Validation

using Kuwait.Lis.Common.Security;
using Microsoft.Extensions.DependencyInjection;

// Register in DI container
services.AddHttpClient<IServiceValidationService, ServiceValidationService>();

// Use in your service
public class MyController
{
    private readonly IServiceValidationService _validationService;
    
    public MyController(IServiceValidationService validationService)
    {
        _validationService = validationService;
    }
    
    public async Task<bool> CheckService()
    {
        return await _validationService.IsUserServiceAvailableAsync();
    }
}

Token Blacklisting

// Blacklist a token
_validationService.BlacklistToken("jwt-token-here");

// Check if token is blacklisted
bool isBlacklisted = _validationService.IsTokenBlacklisted("jwt-token-here");

Configuration

Add the following configuration to your appsettings.json:

{
  "Services": {
    "UserService": {
      "BaseUrl": "https://your-user-service-url"
    }
  },
  "UserService": {
    "BaseUrl": "https://your-user-service-url"
  }
}

Build and Package

To build the project and create NuGet package:

# Build the project
dotnet build --configuration Release

# Create NuGet package
dotnet pack --configuration Release --output ./packages

# Push to NuGet (optional)
dotnet nuget push ./packages/Kuwait.Lis.Common.Security.1.0.0.nupkg --api-key YOUR_API_KEY --source https://api.nuget.org/v3/index.json

Dependencies

• .NET 9.0
• System.IdentityModel.Tokens.Jwt (7.0.3)
• Microsoft.Extensions.Configuration.Abstractions (9.0.0)
• Microsoft.Extensions.Http (9.0.0)

License

MIT License