Nera.Lib.Gateway 1.0.0

Nera.Lib.Gateway

Kong API Gateway integration library for Nextera Systems microservices, providing service registration, routing, authentication, rate limiting, and other gateway features.

Features

• Kong Gateway Integration: Complete Kong Admin API client with service and route management
• Auto Service Registration: Middleware for automatic service registration with Kong
• Configuration Management: Flexible configuration options for Kong integration
• JWT Authentication: Support for JWT Bearer authentication via Kong plugins
• Service Discovery: Integration with Nera service discovery library

Project Structure

• Kong/ - Kong Gateway integration services and models
  • IKongAdminClient.cs - Refit interface for Kong Admin API
  • IKongGatewayService.cs - Service interface for Kong operations
  • KongGatewayService.cs - Implementation of Kong service operations
  • Models/KongModels.cs - Kong API data models
• Middleware/ - ASP.NET Core middleware components
  • KongGatewayRegistrationMiddleware.cs - Auto-registration middleware
• Authentication/ - Authentication components (placeholder)
• RateLimiting/ - Rate limiting components (placeholder)
• Routing/ - Custom routing components (placeholder)
• KongGatewayExtensions.cs - DI extension methods

Getting Started

Installation

Add the package reference to your project:

<PackageReference Include="Nera.Lib.Gateway" Version="1.0.0" />

Configuration

Add Kong configuration to your appsettings.json:

{
  "Kong": {
    "AdminApiUrl": "http://localhost:8001",
    "AdminApiKey": "your-api-key-if-enabled",
    "ProxyUrl": "http://localhost:8000",
    "ServiceNamePrefix": "nera-",
    "DefaultTags": ["nera", "microservice"]
  }
}

Basic Usage

1. Register Kong Services in DI Container

public void ConfigureServices(IServiceCollection services)
{
    services.AddKongGateway(Configuration);
}

2. Use Kong Gateway Service

public class MyController : ControllerBase
{
    private readonly IKongGatewayService _kongService;
    
    public MyController(IKongGatewayService kongService)
    {
        _kongService = kongService;
    }
    
    public async Task RegisterService()
    {
        var service = await _kongService.RegisterServiceAsync(
            "my-service",
            "localhost",
            5000,
            "/api/v1");
            
        var route = await _kongService.CreateRouteAsync(
            "my-service",
            "my-route",
            new[] { "/my-service" });
    }
}

3. Auto Registration Middleware (Advanced)

public void Configure(IApplicationBuilder app)
{
    app.UseKongGatewayRegistration(options =>
    {
        options.ServiceName = "my-service";
        options.ServicePath = "/api/v1";
    });
}

Development

• Target Framework: .NET 9.0
• Key Dependencies:
  • Microsoft.AspNetCore.App
  • Microsoft.AspNetCore.Authentication.JwtBearer
  • Refit (HTTP client generation)
  • Nera.Lib.Core
  • Nera.Lib.ServiceDiscovery

Building

dotnet build

Testing

dotnet test

Contributing

Contributions are welcome! Please open issues or submit pull requests for improvements or bug fixes.

License

MIT License - © 2025 Nextera Systems. All rights reserved.

Links

• Repository: https://github.com/nextera-systems/nera-libraries
• Company: Nextera Systems
• Package: Nera.Lib.Gateway v1.0.0