SaaS multiinquilino: aislamiento de datos y jerarquías de permisos para distribuidores

EN BREVE: El incidente que todo sistema multiinquilino teme es que el inquilino A vea los datos del inquilino B. Una base de datos compartida con una columna de inquilino es un punto de partida razonable para la mayoría de los SaaS B2B, siempre que el filtrado por inquilino no dependa de que cada desarrollador lo recuerde. El contexto de inquilino se fija solo en la autenticación, la capa de acceso a datos inyecta el filtro en todas partes, la base de datos lo respalda con seguridad por filas, la jerarquía de plataforma, distribuidor y subcuenta se modela de forma explícita, y las pruebas de control de acceso se escriben antes que las funcionales.

Diagrama multiinquilino. Arriba, la ruta de petición: una petición con token o sesión pasa por un middleware de autenticación que determina inquilino, rol y ámbito, la capa de acceso a datos inyecta un filtro de inquilino y la base de datos aplica seguridad por filas; el id de inquilino sale solo de la autenticación. Abajo, un árbol de organizaciones con un operador de plataforma, dos distribuidores y dos subcuentas bajo uno de ellos, con una zona punteada que marca lo que ve ese distribuidor.
Figura 1. Ruta de petición y árbol de organizaciones. Un distribuidor ve su propio subárbol, ni más ni menos.

1.0 Tres modelos de aislamiento

ModeloVentajaCosteEncaja con
Una base de datos por inquilinoEl aislamiento más fuerte; cada inquilino se puede respaldar, migrar o restaurar por separadoLas migraciones se ejecutan N veces; conexiones y operación crecen con el número de inquilinosPocos inquilinos, o contratos que exigen separación física
Base de datos compartida, un esquema por inquilinoAislamiento fuerteMigraciones y monitorización se complican a medida que aumentan los esquemasUn número moderado de inquilinos
Tablas compartidas con columna de inquilinoLo más sencillo de operar; los informes entre inquilinos son fácilesEl aislamiento depende por completo del código y de las políticas de la base de datosMuchos inquilinos con pocos datos cada uno

Se pueden combinar, con los clientes grandes en su propia base de datos y el resto compartido, siempre que la capa de acceso a datos oculte dónde están los datos de cada inquilino y el código de negocio no tenga que saberlo.

2.0 De dónde sale el contexto de inquilino

El id de inquilino solo puede salir de la autenticación, es decir, de una claim del token o de la sesión en el servidor. Nunca de un parámetro de la petición ni de una cabecera que el cliente pueda fijar libremente. Un middleware determina en cada petición el inquilino, el rol y el ámbito de datos y los coloca en el contexto de la petición; todo lo que viene después los lee solo de ahí.

Los trabajos en segundo plano y los consumidores de mensajes también necesitan contexto de inquilino, y es justo ahí donde más a menudo falta. Un trabajo programado no tiene petición ni middleware, y es fácil acabar operando sobre toda la tabla. Exigimos que cada trabajo declare qué inquilinos procesa; un trabajo sin esa declaración no se ejecuta.

3.0 El filtrado no puede depender de la disciplina

  • El ORM añade la condición de inquilino de forma centralizada mediante un filtro global o una clase base de repositorio. El código de negocio no alcanza datos de otro inquilino por defecto, y cruzar inquilinos tiene que ser explícito.
  • En PostgreSQL, la seguridad por filas (RLS) es una segunda línea de defensa: aunque una consulta escrita a mano olvide la condición, la base de datos la rechaza. Vigile cómo se fijan y restablecen las variables de sesión con un pool de conexiones, o el inquilino de una petición se filtrará a la siguiente.
  • Las operaciones que de verdad abarcan varios inquilinos, como los informes de plataforma o la reparación de datos, usan un rol y una ruta de código propios y escriben un log de auditoría.
  • Las restricciones de unicidad y los índices incluyen la columna de inquilino; si no, dos inquilinos que usen el mismo número de referencia chocarán.

4.0 Jerarquías de distribuidores

Muchos productos no son una lista plana de inquilinos sino una jerarquía: plataforma, distribuidor y subcuenta o cliente final. Lo que suele funcionar:

  • Guardar las organizaciones como un árbol y dejar que cada distribuidor vea los datos de su propio subárbol. Consultar subárboles con una tabla de cierre o una ruta materializada, no con consultas recursivas en cada petición.
  • Modelar por separado los roles y el ámbito de datos. El rol dice qué operaciones se permiten; el ámbito, sobre qué organizaciones. Combinar ambos en lugar de crear un rol nuevo para cada combinación, o la tabla de roles se descontrola enseguida.
  • Cada nivel suele tener su propio front end, como una consola de plataforma, una consola de distribuidor y páginas móviles para subcuentas, pero el backend tiene un único modelo de permisos. Ocultar un botón no es control de acceso; la API comprueba en cada llamada.

5.0 Pruebas que van primero

  • Una matriz de acceso: para cada rol y nivel, el acceso a sus propios datos, a los de su mismo nivel y a los del nivel superior, con los resultados esperados en una tabla que se ejecuta automáticamente.
  • Sustitución de ID: cambiar el id del recurso en una petición por el de otro inquilino; la API debe responder “prohibido” o “no encontrado”, nunca con datos.
  • Trabajos en segundo plano: ejecutar cada trabajo sobre datos que mezclan varios inquilinos y comprobar que solo tocó los previstos.

Estas pruebas merecen ir antes que las funcionales. Un fallo funcional es un problema de uso; un fallo de control de acceso es un incidente.

Para un nuevo back office SaaS, o para añadir aislamiento de inquilinos a un sistema existente, consulte Web, nube y gestión de dispositivos o hable de un proyecto con nosotros.

Referencias

Preguntas frecuentes

Empezamos con tablas compartidas. ¿Podrá un cliente grande tener su propia base de datos más adelante?

La clave es si la capa de acceso a datos enruta por inquilino desde el principio en lugar de repartir la misma conexión por todas partes. Si lo hace, sacar a un inquilino consiste en exportar sus datos, cambiar la ruta y verificar el resultado, y casi todo el coste está en ensayarlo.

¿La seguridad por filas ralentiza las consultas?

Una política es en la práctica una condición más en cada consulta, así que el coste depende de si esa condición puede usar un índice. Con la columna de inquilino al principio de los índices compuestos, el impacto suele ser pequeño. Revise los planes de ejecución con volúmenes de datos realistas antes de la puesta en producción en lugar de suponerlo.

¿Pueden los distribuidores compartir datos entre sí?

Modélelo como una concesión explícita: una organización concede a otra un tipo concreto de datos, y la concesión queda registrada y se puede revocar. Por defecto no se comparte nada, para que nadie vea datos ajenos como efecto secundario de la jerarquía.

Si el usuario de una subcuenta se va, ¿de quién son sus datos?

Los datos pertenecen a la organización, no a la cuenta personal. Al desactivar la cuenta, los datos siguen en la organización y un responsable los reasigna. Decídalo al diseñar el modelo; cambiarlo después afecta a muchas tablas.