Tema 11 · Login & Tokens

11. Endpoints de Registro, Login y Emisión de Bearer Tokens

Construye un AuthController completo: validación de credenciales con Hash::check, emisión de plainTextToken y respuesta JSON con datos del usuario.

El Ciclo de Autenticación de un Endpoint de Login

El endpoint POST /api/v1/login es el punto de partida donde el usuario presenta sus credenciales (email y password) y el dispositivo (por ejemplo "Xiaomi 13 de Carlos").

El flujo en Laravel debe ser estrictamente secuencial:

  1. Validar que el email tenga formato correcto y la contraseña esté presente.
  2. Buscar el usuario en la base de datos por su email.
  3. Comprobar la contraseña mediante Hash::check($password, $user->password) (nunca comparar textos planos).
  4. Si las credenciales no coinciden, abortar con 422 Unprocessable o 401 Unauthorized con un mensaje genérico para no dar pistas a atacantes ("Credenciales incorrectas").
  5. Si coinciden, llamar a $user->createToken($deviceName)->plainTextToken y retornar el token en JSON.

⚡ Controlador AuthController Completo con Registro y Login en Sanctum

Implementación lista para producción con emisión de Bearer Tokens:

app/Http/Controllers/Api/V1/AuthController.php
Solo lectura
<?php

namespace App\Http\Controllers\Api\V1;

use App\Http\Controllers\Controller;
use App\Models\User;
use App\Http\Resources\UserResource;
use Illuminate\Http\Request;
use Illuminate\Http\JsonResponse;
use Illuminate\Support\Facades\Hash;
use Illuminate\Validation\ValidationException;

class AuthController extends Controller
{
    /**
     * POST /api/v1/registro
     */
    public function registro(Request $request): JsonResponse
    {
        $datos = $request->validate([
            'name'        => ['required', 'string', 'max:100'],
            'email'       => ['required', 'string', 'email', 'unique:users,email'],
            'password'    => ['required', 'string', 'min:8'],
            'device_name' => ['required', 'string', 'max:50'],
        ]);

        $user = User::create([
            'name'     => $datos['name'],
            'email'    => $datos['email'],
            'password' => Hash::make($datos['password']),
        ]);

        $token = $user->createToken($datos['device_name'])->plainTextToken;

        return response()->json([
            'status'  => 'success',
            'mensaje' => 'Usuario registrado exitosamente',
            'token'   => $token,
            'usuario' => new UserResource($user),
        ], 201);
    }

    /**
     * POST /api/v1/login
     */
    public function login(Request $request): JsonResponse
    {
        $credenciales = $request->validate([
            'email'       => ['required', 'email'],
            'password'    => ['required', 'string'],
            'device_name' => ['required', 'string', 'max:50'],
        ]);

        $user = User::where('email', $credenciales['email'])->first();

        // Verificar existencia y comparar hash seguro
        if (!$user || !Hash::check($credenciales['password'], $user->password)) {
            throw ValidationException::withMessages([
                'email' => ['Las credenciales proporcionadas son incorrectas.'],
            ]);
        }

        // Crear token asociado al nombre del dispositivo
        $token = $user->createToken($credenciales['device_name'])->plainTextToken;

        return response()->json([
            'status'  => 'success',
            'token'   => $token,
            'usuario' => new UserResource($user),
        ], 200);
    }
}
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Cuál es la propiedad de createToken() en Laravel Sanctum que contiene el token en texto plano que debe enviarse al cliente?
🦉
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.

🚀 ¿Quieres dominar APIs RESTful con Laravel, Resources & Sanctum y crear proyectos reales?

Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.