06 Como Iniciar Sesión en Cada Tienda con Base de Datos Por Separado Laravel Multi-Tenant Saas

Duración: 26 min
Módulo: Onboarding, Autenticación y Administración de Tenants Lección 2 de 3

Descripción

🎓 Lección 06: Autenticación por Inquilino, Resolución de Dominios Locales y Aislamiento de Base de Datos en Laravel Multi-Tenant

El propósito de esta lección es configurar el inicio de sesión y registro de usuarios de forma aislada dentro del dominio y base de datos de cada tienda (Tenant). Además, se aborda la solución de resolución de subdominios en entornos locales de Windows sin necesidad de modificar repetidamente el archivo hosts o la configuración de Apache.

🚀 Pasos Clave con Timestamps

  • 🌐 Sustitución de Dominios Locales por localhost: Modificar la extensión .test por .localhost en la configuración del servidor web y en el archivo .env (APP_URL=[http://mitienda.localhost](http://mitienda.localhost)) para permitir la resolución automática de subdominios sin editar el archivo hosts de Windows.⏱️ 02:42
  • ⚙️ Ajuste del Compartimento de Assets en Tenancy: Configurar 'assets' => false en el archivo de configuración config/tenancy.php para que los tenants compartan los recursos estáticos públicos del proyecto central.⏱️ 11:35
  • 🛣️ Habilitación de Rutas de Autenticación en routes/tenant.php: Definir el middleware y las rutas de autenticación (Auth::routes(), /login, /register, /dashboard) en el archivo de rutas del tenant para habilitar el flujo de acceso independiente.⏱️ 13:10
  • 🔗 Corrección de Redirecciones Relativas en Blade: Reemplazar las llamadas a rutas nombradas globales o absolutas por el helper url('/login'), url('/register') y url('/logout') en las vistas Blade para evitar que el tenant redirija al dominio central.⏱️ 13:52
  • 🗄️ Migración de Tablas de Caché para Tenant: Crear y copiar las migraciones de las tablas cache y cache_locks dentro de la carpeta database/migrations/tenant para asegurar la compatibilidad con Laravel 11/12/13 en cada base de datos aislada.⏱️ 16:16
  • 🔑 Autenticación y Registro Independiente en el Tenant: Probar el flujo completo de inicio de sesión, registro de nuevos clientes y cierre de sesión verificando que los registros persistan únicamente en la base de datos del subdominio correspondiente.⏱️ 21:25

🛠️ Comandos y Rutas Principales

TipoComando / RutaDescripción
Comando Artisanphp artisan make:migration create_cache_table --path=database/migrations/tenantCrea la migración de la tabla de caché de sesiones directamente en la carpeta de los tenants.
Comando Artisanphp artisan tenancy:migrateEjecuta las migraciones pendientes en todas las bases de datos de los inquilinos.
Archivo de Configuraciónconfig/tenancy.phpArchivo central de configuración donde se define el comportamiento de dominios y recursos compartidos.
Archivo de Rutasroutes/tenant.phpDefine las rutas HTTP aisladas que responden exclusivamente bajo el contexto de un subdominio tenant.
Ruta HTTP TenantGET /loginFormulario de autenticación procesado en la base de datos del subdominio activo.
Ruta HTTP TenantPOST /logoutCierre de sesión respetando la sesión del tenant actual sin afectar al dominio central.

🔒 Buenas Prácticas y Seguridad

  1. Aislamiento de Sesiones y Cookies por Subdominio: Configura el parámetro SESSION_DOMAIN en el archivo .env o en config/session.php para evitar la contaminación cruzada de tokens CSRF y cookies de sesión entre la app central y las tiendas de los tenants.
  2. Uso de .localhost en Entornos de Desarrollo: Utilizar la TLD reservada .localhost (definida en el RFC 2606) aprovecha la resolución automática del bucle de retorno (loopback) en navegadores modernos, evitando modificar el archivo del sistema C:\Windows\System32\drivers\etc\hosts.
  3. Migración Homogénea de Tablas del Sistema: En versiones recientes de Laravel (donde la caché y los locks se almacenan en base de datos), asegúrate de incluir las tablas cache y job_batches dentro del directorio database/migrations/tenant para prevenir excepciones SQL en peticiones autenticadas.
  4. Redirecciones Relativas al Contexto: Al maquetar botones de navegación o formularios dentro de las vistas compartidas, utiliza helpers basados en el contexto (url('/ruta')) o rutas nombradas registradas expresamente dentro del grupo de tenants.