HarPer.TenantConnectionProvider 1.0.5

TenantConnectionProvider

Proveedor de cadenas de conexión multi-tenant con autenticación basada en token y soporte de caché. Diseñado para aplicaciones multi-tenant que requieren obtener dinámicamente cadenas de conexión desde una API administrativa, autenticándose con el token JWT actual del usuario

🚀 Instalación

Instala el paquete usando NuGet:

dotnet add package HarPer.TenantConnectionProvider

🛠️ Configuración

1️⃣ Registrar el servicio en Program.cs:

builder.Services.AddTenantConnectionProvider(builder.Configuration["AdminApiBaseUrl"]);

Configurar appsettings.json:

{
  "AdminApiBaseUrl": "https://tu-api-de-admin.com/"
}

🛠️ Cómo usarlo

Obtener la cadena de conexión:

Desde cualquier clase con acceso al ITenantConnectionProvider, puedes obtener la cadena de conexión del tenant actual:

public class MyService
{
    private readonly ITenantConnectionProvider _connectionProvider;

    public MyService(ITenantConnectionProvider connectionProvider)
    {
        _connectionProvider = connectionProvider;
    }

    public async Task DoSomethingAsync()
    {
        var connectionString = await _connectionProvider.GetConnectionStringAsync();
        // Usar connectionString para lo que necesites
    }
}

Ejemplo en DbContextFactory

public class MyDbContextFactory
{
    private readonly ITenantConnectionProvider _connectionProvider;

    public MyDbContextFactory(ITenantConnectionProvider connectionProvider)
    {
        _connectionProvider = connectionProvider;
    }

    public async Task<MyDbContext> CreateDbContextAsync()
    {
        var connectionString = await _connectionProvider.GetConnectionStringAsync();
        var optionsBuilder = new DbContextOptionsBuilder<MyDbContext>();
        optionsBuilder.UseSqlServer(connectionString);
        return new MyDbContext(optionsBuilder.Options);
    }
}

Flujo de funcionamiento

• El front-end envía el token JWT con el tenant_id en los claims.
• TenantConnectionProvider extrae el tenant_id desde los claims del token.
• Si la cadena de conexión ya está en caché (por tenant_id), se devuelve directamente.
• Si no, consulta a la API administrativa usando el mismo token para autenticarse.
• Cachea la cadena de conexión por tenant_id (ej.: 10 minutos) y la devuelve.

📤 Estructura de respuesta esperada

Tu API Tenant debe retornar este JSON:

{
  "isSuccess": true,
  "data": {
    "name": "Tenant Name",
    "description": "Tenant Description",
    "connectionString": "YourConnectionStringHere"
  },
  "error": null,
  "message": null,
  "timestamp": "2025-04-13T01:45:14.593Z"
}

🌟 Requisitos

• .NET 9 o superior
• Token JWT válido con tenant_id en los claims.
• Configuración válida de AdminApiBaseUrl.

📄 Licencia

MIT License

🧑‍💻 Autor

HarPer SRL