03 Autenticación con Laravel Breeze y Configuración de Virtual Host y el Dominio Central MultiTenant

Duración: 17 min
Módulo: Fundamentos y Configuración del Entorno Central Lección 3 de 4

Descripció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

TipoComando / RutaDescripción / Propósito
💻 Terminalcomposer require laravel/breeze --devInstalación del paquete Laravel Breeze como dependencia de desarrollo.
💻 Terminalphp artisan breeze:install bladeGeneración del scaffolding de autenticación con vistas Blade.
💻 Terminalphp artisan make:model TenantCreació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

  1. 🌐 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.
  2. 🔀 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.
  3. 🔐 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.