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).
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_typeytokenable_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_atyexpires_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:
<?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¿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.