Introducción a la autenticación - Knowledge of Laravel

¿Qué es la autenticación?

La autenticación consiste en verificar “quién es” el usuario que accede. En una aplicación web, un formulario de login recibe correo y contraseña y, si son correctos, guarda la información del usuario en la sesión. En las siguientes solicitudes se identifica al usuario consultando esa sesión. La autenticación en Laravel se compone de dos conceptos: “guards” y “providers”.

Guard: define cómo autenticar al usuario en cada solicitud. Por defecto se usa el guard session, que gestiona el estado con sesión y cookies.
Provider: define cómo obtener al usuario desde la base de datos. Por defecto usa Eloquent.

El archivo de configuración de autenticación es config/auth.php. Con la configuración por defecto es suficiente para la mayoría de aplicaciones web.

Autenticación con starter kit

En Laravel, con solo elegir un starter kit al crear la aplicación con laravel new, se generan automáticamente las funciones de login, registro, restablecimiento de contraseña, etc. Es el método más recomendado.

Crear la aplicación

Crea la aplicación con el instalador de Laravel. Durante el proceso aparece un prompt para elegir el starter kit.

laravel new my-app

Puedes elegir entre React, Vue, Livewire y Svelte como starter kits. Elige según la pila técnica de tu equipo.

Instalar las dependencias del frontend

cd my-app
npm install && npm run build

Preparar la base de datos

Después de comprobar la configuración de base de datos en .env, ejecuta las migraciones.

php artisan migrate

Se aplica la migración inicial que incluye la tabla users.

Iniciar el servidor de desarrollo

composer run dev

Al acceder a http://localhost:8000 en el navegador verás en la navegación los enlaces “Register” y “Log in”. Prueba a registrarte accediendo a /register.

Al usar un starter kit dispones de las siguientes funciones:

Funcionalidad	URL
Registro de usuario	`/register`
Inicio de sesión	`/login`
Restablecimiento de contraseña	`/forgot-password`
Verificación de correo	`/email/verify`
Edición del perfil	`/settings/profile`

Todo el código generado por el starter kit (controladores, rutas, vistas) vive en tu propia aplicación. Puedes modificarlo y personalizarlo libremente.

Starter kits disponibles

React

Con React 19, TypeScript, Tailwind y shadcn/ui puedes crear una SPA moderna. Gracias a Inertia puedes usar React en el frontend manteniendo el enrutamiento del lado del servidor.

Vue

Adopta la Composition API de Vue, TypeScript, Tailwind y shadcn-vue. Igual que React, se integra con el servidor mediante Inertia.

Livewire

Utiliza Livewire, que permite construir UIs dinámicas solo con PHP. Ideal para equipos centrados en plantillas Blade o que no quieran usar un framework JavaScript. Incluye la librería de componentes Flux UI.

Svelte

Utiliza Svelte 5, TypeScript, Tailwind y shadcn-svelte. Combinado con Inertia permite construir una SPA moderna.

Fachada Auth

Con la fachada Auth puedes obtener la información del usuario autenticado y comprobar el estado de autenticación.

Obtener el usuario autenticado

use Illuminate\Support\Facades\Auth;

// Obtiene el usuario actual
$user = Auth::user();

// Obtiene solo el ID
$id = Auth::id();

En los controladores también puedes obtenerlo desde el objeto Request.

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class DashboardController extends Controller
{
    public function index(Request $request)
    {
        $user = $request->user();

        return view('dashboard', ['user' => $user]);
    }
}

Comprobar el estado de autenticación

Auth::check() devuelve true o false según si el usuario ha iniciado sesión.

use Illuminate\Support\Facades\Auth;

if (Auth::check()) {
    // Sesión iniciada
} else {
    // Sin sesión
}

En plantillas Blade son cómodas las directivas @auth y @guest.

@auth
    <p>Hola, {{ Auth::user()->name }}</p>
    <a href="/logout">Cerrar sesión</a>
@endauth

@guest
    <a href="/login">Iniciar sesión</a>
    <a href="/register">Registrarse</a>
@endguest

Protección de rutas

Para crear rutas accesibles solo a usuarios autenticados, usa el middleware auth.

// routes/web.php

// Solo accesible por usuarios autenticados
Route::get('/dashboard', function () {
    return view('dashboard');
})->middleware('auth');

Si un usuario no autenticado intenta acceder, se le redirige automáticamente a /login. Para proteger varias rutas de una vez, usa un grupo.

Route::middleware('auth')->group(function () {
    Route::get('/dashboard', [DashboardController::class, 'index']);
    Route::get('/profile', [ProfileController::class, 'show']);
    Route::get('/settings', [SettingsController::class, 'index']);
});

Si olvidas aplicar el middleware auth, los usuarios sin sesión podrán acceder. Asegúrate de aplicarlo en todas las rutas que deban protegerse.

Rutas solo para invitados

Para redirigir a los usuarios autenticados usa el middleware guest. Aplicándolo a las páginas de login y registro, los usuarios que ya han iniciado sesión se envían al dashboard.

Route::middleware('guest')->group(function () {
    Route::get('/login', [AuthController::class, 'showLogin']);
    Route::get('/register', [AuthController::class, 'showRegister']);
});

Autenticación manual

Para implementar el login manualmente sin usar un starter kit, usa Auth::attempt().

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Illuminate\Http\RedirectResponse;
use Illuminate\Support\Facades\Auth;

class LoginController extends Controller
{
    public function login(Request $request): RedirectResponse
    {
        $credentials = $request->validate([
            'email' => ['required', 'email'],
            'password' => ['required'],
        ]);

        if (Auth::attempt($credentials)) {
            // Éxito — regenera la sesión para prevenir ataques CSRF
            $request->session()->regenerate();

            return redirect()->intended('/dashboard');
        }

        // Fallo de autenticación
        return back()->withErrors([
            'email' => 'El correo o la contraseña no son correctos.',
        ])->onlyInput('email');
    }
}

Pasa un array de credenciales como primer argumento a Auth::attempt(). La contraseña se compara automáticamente con el hash guardado, así que pásala en texto plano. Para implementar la función “recordarme”, pasa true como segundo argumento.

// Usa el valor del checkbox "Recordarme"
Auth::attempt($credentials, $request->boolean('remember'));

Aunque implementes la autenticación manualmente, es recomendable inspirarse en el código del starter kit como referencia para una implementación segura.

Cierre de sesión

Para cerrar la sesión del usuario, llama a Auth::logout(). La buena práctica es invalidar la sesión y regenerar el token CSRF al mismo tiempo.

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Illuminate\Http\RedirectResponse;
use Illuminate\Support\Facades\Auth;

class LogoutController extends Controller
{
    public function logout(Request $request): RedirectResponse
    {
        Auth::logout();

        // Invalida la sesión
        $request->session()->invalidate();

        // Regenera el token CSRF
        $request->session()->regenerateToken();

        return redirect('/');
    }
}

Usa el método POST en la ruta.

Route::post('/logout', [LogoutController::class, 'logout'])->middleware('auth');

En la plantilla Blade, envía la solicitud POST con un formulario.

<form method="POST" action="/logout">
    @csrf
    <button type="submit">Cerrar sesión</button>
</form>

Resumen

Objetivo	Método
Añadir autenticación rápidamente	Starter kit (`laravel new`)
Obtener el usuario actual	`Auth::user()` / `$request->user()`
Comprobar si hay sesión iniciada	`Auth::check()`
Proteger una ruta	`->middleware('auth')`
Iniciar sesión manualmente	`Auth::attempt($credentials)`
Cerrar sesión	`Auth::logout()`

Próximos pasos

Middleware

Aprende en detalle el funcionamiento del middleware auth y cómo crear middlewares propios.

​¿Qué es la autenticación?

​Autenticación con starter kit

​Starter kits disponibles

​React

​Vue

​Livewire

​Svelte

​Fachada Auth

​Obtener el usuario autenticado

​Comprobar el estado de autenticación

​Protección de rutas

​Rutas solo para invitados

​Autenticación manual

​Cierre de sesión

​Resumen

​Próximos pasos

Middleware

¿Qué es la autenticación?

Autenticación con starter kit

Starter kits disponibles

React

Vue

Livewire

Svelte

Fachada Auth

Obtener el usuario autenticado

Comprobar el estado de autenticación

Protección de rutas

Rutas solo para invitados

Autenticación manual

Cierre de sesión

Resumen

Próximos pasos