0046. Contexto de empresa por transacción para la RLS¶
Estado: Aceptado Fecha: 2026-10-20 Autor: Duval Alcivar Módulo(s) afectado(s): app/core/rls.py, app/api/deps.py, app/core/security.py, app/domains/usuarios/, app/domains/*/router.py, tests/, docs/adr/
Contexto¶
Trece tablas del esquema identidad tienen la RLS activada con la política
aislamiento_empresa:
empresa_id = NULLIF(current_setting('app.current_empresa_id', true), '')::BIGINT
El servicio nunca fijaba esa variable. Con un rol de base sin BYPASSRLS y
que no es dueño de las tablas —el rol real de la aplicación— las consultas
devuelven cero filas y los INSERT fallan con new row violates row-level
security policy. Sólo funcionaba con un superusuario, que ignora la RLS.
Hay dos huecos distintos:
- Requests autenticados: falta llevar el claim
empresa_iddel access token a la sesión de base de datos. - Flujo pre-auth:
renovar,cambiar_empresa,cerrar_sesionycerrar_todas_las_sesionesleentrx_refresh_tokens(RLS estricta) antes de conocer la empresa, yelegir_empresainserta en esa tabla. Ahí no hay access token del que sacarla.
Decisión¶
- La empresa sale del JWT, una sola vez por request.
get_db_empresa(app/api/deps.py) tomausuario.empresa_iddeget_current_usery lo deja en la sesión. Los repositorios no escribenWHERE empresa_idni fijan la variable: la RLS filtra.get_db()sigue entregando la sesión pelada porque los endpoints públicos corren antes de conocer la empresa. set_config('app.current_empresa_id', ..., true), local a la transacción. El valor muere con el COMMIT o el ROLLBACK y no queda pegado a una conexión del pool que luego use otra empresa. Como cadacommitdel repository cierra la transacción,app/core/rls.pyregistra un listenerafter_beginpor sesión que lo vuelve a aplicar al empezar cada transacción, leyendo la empresa vigente desession.info.- El refresh token lleva la empresa como prefijo
(
{empresa_id}.{128 hex}). El flujo pre-auth lee el prefijo, fija el contexto y recién entonces busca el hash SHA-256 del token completo. Un token sin prefijo válido es inválido: 401 enrenovarycambiar_empresa, y 204 idempotente en los cierres de sesión. El prefijo se acota a 19 dígitos y aBIGINT: un valor mayor desbordaría el cast de la política en un endpoint público, así que se rechaza antes de tocar la base.cambiar_empresarevoca el refresh viejo con el contexto de origen —la RLS solo ve las filas de esa empresa— y recién después pasa al contexto destino, porque el refresh nuevo se inserta con eseempresa_id. - El service no toca la RLS: en el flujo de autenticación lo hace a través
de
UsuariosRepository.fijar_empresa, y el repository de empresas fija la empresa nueva dentro del alta con plantilla. El service nunca importaapp.core.rls(router -> service -> repository);app/core/es infraestructura, no un repository. rootno tiene bypass. Opera con elempresa_idde su token en todos lados y cambia de empresa con/auth/cambiar-empresa(ADR 0042), que reemite los tokens con la empresa destino.
Alternativas descartadas¶
SETsinLOCAL— la empresa queda pegada a la conexión del pool y el request siguiente, de otra empresa, la hereda. Es una fuga entre inquilinos.- Función
SECURITY DEFINERpara las lecturas pre-auth — mueve el bypass a la base y deja el flujo normal igual de roto; el problema es que falta el contexto, no que la RLS esté de más. Se descartó también para la revocación global (ADR 0046): no se agrega un objeto de base con privilegios elevados para una operación que se resuelve recorriendo unas pocas empresas. - Un rol dedicado con
BYPASSRLSpara el servicio — la RLS deja de filtrar justo en el camino por el que pasan todos los requests: el aislamiento quedaría sólo en la aplicación. Tampoco se usa paralogout-allni para el replay: la revocación global no justifica ampliar los privilegios del rol de la API. - Un refresh token sin empresa y resolverla después del lookup — el lookup es exactamente la consulta que la RLS bloquea. Sin prefijo no hay forma de llegar a la fila.
Consecuencias¶
- Las sesiones vivas quedan inválidas: los refresh emitidos antes de este cambio no tienen prefijo. Todos los usuarios deben volver a iniciar sesión.
- El rol de base del servicio NO debe tener
BYPASSRLSni ser dueño de las tablas. Con superusuario la RLS no filtra y el aislamiento no se prueba; el diseño asume el rol de aplicación. - Los repositorios siguen sin filtro por empresa: la corrección de un
WHEREfaltante no es la solución, y agregarlo rompería el patrón. cerrar_todas_las_sesionesy la revocación por replay son globales. La RLS no permite elUPDATEcross-empresa, así que se recorre el catálogo completo demae_empresasfijando el contexto en cada empresa y se revoca con la operación de una sola empresa. Es solo de aplicación: no requiereBYPASSRLSniSECURITY DEFINER, y el rol de la API conserva sus privilegios. El costo es una pasada por empresa —el catálogo es chico— y uncommitpor empresa; como elset_configlocal muere con cadacommit, se vuelve a fijar el contexto en cada vuelta. Después del recorrido el service restaura el contexto de la empresa del token antes de escribirlog_sesiones, que se inserta con eseempresa_id.- El alta de empresa con plantilla (
materializar_plantilla=true) fija el contexto a la empresa nueva durante la materialización: la plantilla inserta en tablas con RLS y todas sus filas llevan eseempresa_id. Es la única excepción al «una sola empresa por request», y vive dentro de la misma transacción del alta. - Deuda explícita: las escrituras de administración que reciben un
empresa_idajeno en el cuerpo o en la ruta (POST /api/v1/sucursales,POST /api/v1/empresas/{id}/aplicacionesy los*Createde navegación) fallan fail-closed con un error de RLS, porque el contexto es siempre el del token. Falta decidir si se rechazan con 403 o si se obliga aroota cambiar de empresa con/auth/cambiar-empresa; los contratos no cambian en este paso. - El prefijo de empresa no reemplaza la validación de acceso: el token se sigue validando contra su hash y el usuario contra la empresa destino (ADR 0037 y 0042).