Apps multi-tenant

Una app multi-tenant es una sola aplicación tuya que da servicio a muchas empresas, cada una con sus usuarios y sus datos. Tú escribes la interfaz y la lógica; Dinaup pone el inicio de sesión, el aislamiento entre empresas y la base de datos.

Antes de empezar

• Paquete Dinaup instalado y tu biblioteca MyDinaup para trabajar tipado.
• El AppId (un GUID) y el AppToken de tu aplicación, registrados en Dinaup. Guárdalos en el Vault con las claves DINAUP_APPID y DINAUP_APPTOKEN.

Las tres piezas

MyAppClient hereda de DinaupClientC: informes, escritura, archivos y anotaciones funcionan igual que en el Cliente Dinaup. La diferencia es a qué datos llega: cada instancia opera solo sobre la empresa del usuario autenticado.

Montar la app

var vault = new Dinaup.Vault.VaultData("VAULT_URL", "VAULT_PASSWORD");
vault.Initialize();

var appConfig = new Dinaup.Models.DinaupExternalAppSettings(vault);

// Compartidos por todos los usuarios
builder.Services.AddSingleton<Dinaup.Models.DinaupExternalAppSettings>(appConfig);
builder.Services.AddSingleton<Dinaup.Auth.DinaupAuthClient>(new Dinaup.Auth.DinaupAuthClient());
builder.Services.AddSingleton<Dinaup.MyAppKVClient>();

// Uno por usuario/circuito
builder.Services.AddScoped<SessionUserContext>();

builder.Services.AddHealthChecks().AddCheck<Dinaup.MyAppKVClient>("MyAppKVClient");

var authResponse = await _authClient.LoginAsync(email, password);
if (authResponse == null) throw new Exception("Credenciales inválidas");

DinaupClient = new Dinaup.MyAppClient(_appSettings, authResponse);

// Al hacer login: estado al KV, solo el id a la cookie
var sessionId = Guid.NewGuid().ToString();
await _kvClient.SetKVAsync($"session:{sessionId}",
    $"{authResponse.TenantConnectionKeyword}|{authResponse.UserEmail}");
httpContext.Response.Cookies.Append("dinaup_sessionid", sessionId, cookieOptions);

// Al volver: recuperar el estado y reconstruir
var sessionId = httpContext.Request.Cookies["dinaup_sessionid"];
if (string.IsNullOrEmpty(sessionId) == false)
{
    var estado = await _kvClient.GetKVAsync($"session:{sessionId}");
    if (string.IsNullOrEmpty(estado) == false)
    {
        var partes = estado.Split('|');
        DinaupClient = new Dinaup.MyAppClient(_appSettings, partes[0], partes[1]);
    }
}

public class PaisesService
{
    private readonly SessionUserContext _session;

    public PaisesService(SessionUserContext session) => _session = session;

    public async Task<List<APIPaisesC.APIPaises_RowC>> GetAllAsync()
    {
        var rpt = new APIPaisesC();
        await rpt.ExecuteQueryAsync(_session.DinaupClient, 1, 1000);
        return rpt.Rows;
    }
}

Qué añade MyAppClient

Cuentas de usuario

MyAppClient hereda las operaciones de cuenta de DinaupClientC. Tu app da de alta usuarios, los activa y gestiona contraseñas sin pantallas de Dinaup. Todas reciben el userAgent y la IP del usuario final.

Para cambiar la contraseña de un usuario, genera el código con Session_CreatePasswordRecoveryCodeAsync y cámbiala con Session_ChangePasswordWithCodeAsync.

Los modelos de entrada (AccountCreationModel, AccountActivationModel, PasswordRecoveryModel, ChangePasswordModel, SignInModel, en Dinaup.Models) validan sus campos antes de llamar al servidor.

Almacenamiento clave-valor de la app

MyAppKVClient guarda pares clave-valor propios de tu aplicación: configuración, indicadores y las sesiones de tus usuarios (el patrón del paso 3). Es el estado compartido entre nodos: con él, la app no guarda estado en el proceso.

bool guardado = await _kvClient.SetKVAsync("clave", "valor");
string valor = await _kvClient.GetKVAsync("clave");

• El valor es texto plano, hasta 10 MB por clave; por encima, SetKVAsync lanza InvalidOperationException.
• El espacio de claves es único por aplicación, no por empresa. Si un valor pertenece a una empresa o a una sesión, prefíjalo: session:{id}, config:{empresa}.
• GetKVAsync devuelve cadena vacía si la clave no existe. Un error HTTP lanza HttpRequestException.

Registrado como comprobación de estado (AddCheck<MyAppKVClient>), escribe la clave myappkvclient.health en cada sonda y responde Unhealthy si falla. Cómo exponer el endpoint /HealthCheck está en ASP.NET Core.

El KV de una empresa es otro almacén: KV_GetAsync(space, key) y KV_SetAsync(space, key, value) de DinaupClientC guardan pares en su sección Dinaup KV, no en tu app. Ver Cliente Dinaup.

Ejecutar como un usuario concreto

En procesos sin sesión interactiva (importaciones, tareas programadas), envuelve la operación con DinaupContext.WithUser(userId, ip = "", userAgent = "") para atribuirla a un usuario: afecta al autor del alta, al histórico y a las anotaciones.

using (DinaupContext.WithUser(userId, ip, userAgent))
{
    await client.RunWriteOperationAsync(sectionId, op, false);
}

Para el detalle de informes, filtros y escritura, ver el Cliente Dinaup.