03 Autenticación con Laravel Breeze y Configuración de Virtual Host y el Dominio Central MultiTenant
Duración: 17 minDescripción
🎓 Lección 03: Autenticación con Laravel Breeze y Configuración del Dominio Central Multi-Tenant
Objetivo de la lección: Implementar el sistema de autenticación central con Laravel Breeze, configurar un Virtual Host local (mitienda.test) y parametrizar los dominios centrales en el entorno Multi-Tenant para evitar redirecciones incorrectas.
🚀 Pasos Clave con Timestamps
- 📦 ⏱️ 01:19 Instalación de Laravel Breeze: Descarga del paquete de autenticación mediante Composer para proveer las vistas de Login y Register.
- 🌐 ⏱️ 02:17 Creación del Virtual Host Local (mitienda.test): Configuración en WampServer/Apache apuntando al directorio public/ para simular un dominio de producción.
- ⚙️ ⏱️ 05:00 Instalación del Scaffolding Blade: Ejecución de php artisan breeze:install seleccionando el stack Blade sin modo oscuro para el panel central.
- 🛠️ ⏱️ 07:19 Configuración de Dominios Centrales en tenancy.php: Definición de mitienda.test dentro del arreglo central_domains y modelo Tenant en el archivo de configuración de Tenancy.
- 🔀 ⏱️ 09:59 Agrupación de Rutas Centrales en routes/web.php: Envolver las rutas de Breeze dentro del bucle de dominios centrales (central_domains) para prevenir errores 404 en subdominios.
- 🔑 ⏱️ 12:04 Parametrización en .env (Buenas Prácticas): Mover la variable CENTRAL_DOMAIN al archivo de entorno .env para evitar hardcoding de URLs.
- 👤 ⏱️ 14:46 Prueba de Registro y Dashboard Central: Creación del primer usuario administrador (Landlord) en la base de datos central y acceso exitoso al Dashboard.
🛠️ Comandos y Rutas Principales
| Tipo | Comando / Ruta | Descripción / Propósito |
|---|---|---|
| 💻 Terminal | composer require laravel/breeze --dev | Instalación del paquete Laravel Breeze como dependencia de desarrollo. |
| 💻 Terminal | php artisan breeze:install blade | Generación del scaffolding de autenticación con vistas Blade. |
| 💻 Terminal | php artisan make:model Tenant | Creación del modelo Tenant que extiende de Stancl\Tenancy\Database\Models\Tenant. |
| 🌐 Ruta HTTP | [http://mitienda.test](http://mitienda.test) | Dominio central simulado para la plataforma SaaS principal (Landlord). |
| 🌐 Ruta HTTP | [http://mitienda.test/register](http://mitienda.test/register) | Formulario de registro de administradores del sistema central. |
| 🌐 Ruta HTTP | [http://mitienda.test/dashboard](http://mitienda.test/dashboard) | Panel de control central post-autenticación. |
🔒 Buenas Prácticas y Seguridad
- 🌐 Variables de Entorno para Dominios: Definir los dominios centrales (CENTRAL_DOMAIN=mitienda.test) directamente en el archivo .env en lugar de dejarlos fijos (hardcoded) en config/tenancy.php, facilitando el despliegue en producción sin tocar código.
- 🔀 Enrutamiento Estricto de Dominios Centrales: Asegurar que todas las rutas de la plataforma administradora (web.php) estén encapsuladas dentro de la restricción de dominio central para evitar que los tenants accedan a vistas del Landlord.
- 🔐 Hashing y Sanitización en Breeze: Aprovechar las reglas nativas de validación y encriptación de contraseñas (Bcrypt/Argon2) que Breeze implementa por defecto en los formularios de autenticación.