Tema 10 · Fundamentos Sanctum

10. Introducción a Laravel Sanctum: Arquitectura de Personal Access Tokens

Comprende el paquete oficial Sanctum, el trait HasApiTokens y cómo almacena los hashes SHA-256 de los tokens en la tabla personal_access_tokens.

¿Qué es Laravel Sanctum?

Laravel Sanctum es el paquete oficial y estándar de la industria para autenticar aplicaciones web SPA (Single Page Applications), aplicaciones móviles nativas y APIs basadas en tokens simples y ligeros sin la tremenda complejidad de un servidor OAuth2 completo (como Passport).

Diagrama Técnico: Flujo de Autenticación con Laravel Sanctum

El token en texto plano solo se ve una vez al crearse; en la base de datos se almacena únicamente su hash SHA-256.

El Trait HasApiTokens y la Tabla de Base de Datos

Para que un modelo de Eloquent (habitualmente App\Models\User) pueda emitir tokens de acceso, debe implementar el trait Laravel\Sanctum\HasApiTokens:

use Laravel\Sanctum\HasApiTokens;

class User extends Authenticatable
{
    use HasApiTokens, HasFactory, Notifiable;
}

Sanctum gestiona la tabla personal_access_tokens, que almacena:

  • tokenable_type y tokenable_id: Relación polimórfica al usuario dueño del token.
  • name: Nombre descriptivo (ej: "iPhone 15 de Juan", "Postman Dev").
  • token: El hash SHA-256 del token. Incluso si la base de datos es vulnerada, los atacantes no pueden usar los tokens porque nunca se guardan en texto plano.
  • abilities: Array JSON con los permisos o permisos específicos otorgados al token.
  • last_used_at y expires_at: Fechas de último uso y expiración automática.

⚡ Configuración del Modelo User con el Trait HasApiTokens

Estructura recomendada del modelo de usuario preparado para emitir tokens de Sanctum:

app/Models/UserSanctum.php
Solo lectura
<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Foundation\Auth\User as Authenticatable;
use Illuminate\Notifications\Notifiable;
use Laravel\Sanctum\HasApiTokens;

class User extends Authenticatable
{
    // HasApiTokens dota al modelo de métodos como createToken(), tokens(), currentAccessToken()
    use HasApiTokens, HasFactory, Notifiable;

    protected $fillable = [
        'name',
        'email',
        'password',
    ];

    protected $hidden = [
        'password',
        'remember_token',
    ];

    protected function casts(): array
    {
        return [
            'email_verified_at' => 'datetime',
            'password' => 'hashed',
        ];
    }
}
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Cómo almacena Laravel Sanctum los tokens de acceso personal en la tabla "personal_access_tokens"?
🦉
¿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.