Saltar a contenido

Especificación Técnica: log_sesiones

Esquema: core.identidad
Base de Datos: core
Servicio: svc-identidad
Propósito: Bitácora transaccional de intentos y eventos de sesión (login/logout/fallos).


1. Justificación y Mejoras de Arquitectura

  • Registro liviano orientado a escritura intensiva (audit created).
  • Capacidad de correlación por token_jti e IP en diagnósticos.
  • RLS por empresa actual mantiene la confidencialidad de la bitácora.
  • Particionada por mes (PARTITION BY RANGE (created_at)): crece con cada login y la retención se hace soltando particiones enteras (DETACH/DROP) en vez de un DELETE masivo que dejaría la tabla inflada (ADR 0021). Mismo patrón que audit_log.
  • Consecuencia de particionar: la PK es compuesta (id, created_at), porque PostgreSQL exige que la columna de partición forme parte de la clave primaria.
  • Las particiones mensuales (log_sesiones_YYYYMM) las crea y retira el job del ADR 0021. Existe además una partición DEFAULT como red de seguridad, para que un INSERT nunca falle por falta de partición.

2. Definiciones de Implementación

Table core.identidad.log_sesiones {
    id                         uuid          [default: `gen_random_uuid()`]
    empresa_id                 bigint        [note: 'nullable: pre-auth, se asigna tras validar credenciales']
    usuario_id                 uuid          [not null, ref: > mae_usuarios.id]
    username_ingresado         varchar(50)   [not null]
    accion                     varchar(20)  
    token_jti                  uuid         
    ip                         varchar(45)  
    user_agent                 varchar(300) 
    exitoso                    boolean      
    razon_fallo                varchar(100) 

    // Auditoría General
    created_at              timestamptz   [not null, default: `now()`, note: 'Fecha de creación; clave de partición']

    // PK compuesta (id, created_at): exigida por la partición
    indexes {
        (id, created_at) [pk]
    }

    // RLS por empresa actual (permite filas pre-auth con empresa_id NULL)
    // Particionada por RANGE (created_at), mensual. Ver sección SQL.
}
CREATE TABLE IF NOT EXISTS core.identidad.log_sesiones (
    id UUID NOT NULL DEFAULT gen_random_uuid(),
    empresa_id BIGINT,
    usuario_id UUID NOT NULL,
    username_ingresado VARCHAR(50) NOT NULL,
    accion VARCHAR(20),
    token_jti UUID,
    ip VARCHAR(45),
    user_agent VARCHAR(300),
    exitoso BOOLEAN,
    razon_fallo VARCHAR(100),
    created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
    CONSTRAINT pk_log_sesiones PRIMARY KEY (id, created_at),
    CONSTRAINT fk_log_sesiones_usuario FOREIGN KEY (usuario_id) REFERENCES core.identidad.mae_usuarios (id)
) PARTITION BY RANGE (created_at);

-- Partición DEFAULT: red de seguridad para que un INSERT nunca falle.
-- Las particiones mensuales (log_sesiones_YYYYMM) las crea y retira el job
-- del ADR 0021; acá sólo se deja la red de seguridad.
CREATE TABLE core.identidad.log_sesiones_default
    PARTITION OF core.identidad.log_sesiones DEFAULT;

-- Row-Level Security
ALTER TABLE core.identidad.log_sesiones ENABLE ROW LEVEL SECURITY;
CREATE POLICY aislamiento_empresa ON core.identidad.log_sesiones
    FOR ALL
    USING (empresa_id IS NULL OR empresa_id = NULLIF(current_setting('app.current_empresa_id', true), '')::BIGINT)
    WITH CHECK (empresa_id IS NULL OR empresa_id = NULLIF(current_setting('app.current_empresa_id', true), '')::BIGINT);

-- Comentarios
COMMENT ON COLUMN core.identidad.log_sesiones.empresa_id IS 'Empresa de la sesión (NULL en intentos pre-autenticación)';
COMMENT ON COLUMN core.identidad.log_sesiones.usuario_id IS 'Usuario involucrado';
COMMENT ON COLUMN core.identidad.log_sesiones.username_ingresado IS 'Nombre de usuario capturado al inicio del intento';
COMMENT ON COLUMN core.identidad.log_sesiones.accion IS 'Acción registrada (login, logout, fallo)';
COMMENT ON COLUMN core.identidad.log_sesiones.token_jti IS 'Identificador del JWT emitido';
COMMENT ON COLUMN core.identidad.log_sesiones.ip IS 'IP origen';
COMMENT ON COLUMN core.identidad.log_sesiones.user_agent IS 'User-Agent del cliente';
COMMENT ON COLUMN core.identidad.log_sesiones.exitoso IS 'Resultado de la acción';
COMMENT ON COLUMN core.identidad.log_sesiones.razon_fallo IS 'Motivo del fallo';