06 Como Iniciar Sesión en Cada Tienda con Base de Datos Por Separado Laravel Multi-Tenant Saas
Duración: 26 minDescripció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
| Tipo | Comando / Ruta | Descripción |
|---|---|---|
| Comando Artisan | php artisan make:migration create_cache_table --path=database/migrations/tenant | Crea la migración de la tabla de caché de sesiones directamente en la carpeta de los tenants. |
| Comando Artisan | php artisan tenancy:migrate | Ejecuta las migraciones pendientes en todas las bases de datos de los inquilinos. |
| Archivo de Configuración | config/tenancy.php | Archivo central de configuración donde se define el comportamiento de dominios y recursos compartidos. |
| Archivo de Rutas | routes/tenant.php | Define las rutas HTTP aisladas que responden exclusivamente bajo el contexto de un subdominio tenant. |
| Ruta HTTP Tenant | GET /login | Formulario de autenticación procesado en la base de datos del subdominio activo. |
| Ruta HTTP Tenant | POST /logout | Cierre de sesión respetando la sesión del tenant actual sin afectar al dominio central. |
🔒 Buenas Prácticas y Seguridad
- 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.
- 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.
- 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.
- 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.