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 unDELETEmasivo que dejaría la tabla inflada (ADR 0021). Mismo patrón queaudit_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ónDEFAULTcomo red de seguridad, para que unINSERTnunca 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';