Saltar a contenido

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:

  1. Requests autenticados: falta llevar el claim empresa_id del access token a la sesión de base de datos.
  2. Flujo pre-auth: renovar, cambiar_empresa, cerrar_sesion y cerrar_todas_las_sesiones leen trx_refresh_tokens (RLS estricta) antes de conocer la empresa, y elegir_empresa inserta 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) toma usuario.empresa_id de get_current_user y lo deja en la sesión. Los repositorios no escriben WHERE empresa_id ni 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 cada commit del repository cierra la transacción, app/core/rls.py registra un listener after_begin por sesión que lo vuelve a aplicar al empezar cada transacción, leyendo la empresa vigente de session.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 en renovar y cambiar_empresa, y 204 idempotente en los cierres de sesión. El prefijo se acota a 19 dígitos y a BIGINT: 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_empresa revoca 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 ese empresa_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 importa app.core.rls (router -> service -> repository); app/core/ es infraestructura, no un repository.
  • root no tiene bypass. Opera con el empresa_id de 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

  • SET sin LOCAL — 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 DEFINER para 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 BYPASSRLS para 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 para logout-all ni 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 BYPASSRLS ni 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 WHERE faltante no es la solución, y agregarlo rompería el patrón.
  • cerrar_todas_las_sesiones y la revocación por replay son globales. La RLS no permite el UPDATE cross-empresa, así que se recorre el catálogo completo de mae_empresas fijando el contexto en cada empresa y se revoca con la operación de una sola empresa. Es solo de aplicación: no requiere BYPASSRLS ni SECURITY DEFINER, y el rol de la API conserva sus privilegios. El costo es una pasada por empresa —el catálogo es chico— y un commit por empresa; como el set_config local muere con cada commit, 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 escribir log_sesiones, que se inserta con ese empresa_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 ese empresa_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_id ajeno en el cuerpo o en la ruta (POST /api/v1/sucursales, POST /api/v1/empresas/{id}/aplicaciones y los *Create de 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 a root a 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).