12. Habilidades de Token (Abilities), Expiración y Cierre de Sesión (Revocación)
Asigna permisos granulares a cada token (ej: ["pedidos:crear"]), valida con $request->user()->tokenCan() y revoca tokens al hacer logout.
Permisos Granulares: Token Abilities
En Sanctum no todos los tokens tienen por qué tener acceso total (['*']). Puedes emitir tokens con habilidades limitadas (Abilities), similar a los scopes de OAuth2 o GitHub Personal Access Tokens (por ejemplo: un token solo para lectura de reportes o solo para crear pedidos desde un quiosco).
// Emitir token con permisos restringidos
$token = $user->createToken('lector-movil', ['pedidos:ver', 'perfil:ver'])->plainTextToken;
En el controlador o mediante middlewares de ruta puedes comprobar si el token tiene el permiso:
if (! $request->user()->tokenCan('pedidos:crear')) {
abort(403, 'Tu token no tiene permisos para crear pedidos.');
}
Cierre de Sesión (Revocación de Tokens)
En una API stateless, el logout consiste en eliminar el token de la base de datos para que no pueda volver a ser utilizado jamás:
- Cerrar sesión actual:
$request->user()->currentAccessToken()->delete();(solo revoca el token del dispositivo que hizo la petición). - Cerrar sesión en todos los dispositivos:
$request->user()->tokens()->delete();(ideal tras un cambio de contraseña por seguridad).
⚡ Endpoints de Logout y Verificación de Habilidades en Sanctum
Ejemplo de métodos para revocar el token activo y proteger endpoints con abilities:
<?php
namespace App\Http\Controllers\Api\V1;
use App\Http\Controllers\Controller;
use Illuminate\Http\Request;
use Illuminate\Http\JsonResponse;
class LogoutAbilitiesController extends Controller
{
/**
* POST /api/v1/logout
* Revoca el token con el que se autenticó esta petición
*/
public function logout(Request $request): JsonResponse
{
// Eliminar únicamente el token actual
$request->user()->currentAccessToken()->delete();
return response()->json([
'status' => 'success',
'mensaje' => 'Sesión cerrada y token revocado exitosamente',
], 200);
}
/**
* POST /api/v1/logout-todos
* Cierra todas las sesiones en todos los teléfonos y navegadores
*/
public function logoutTodos(Request $request): JsonResponse
{
$request->user()->tokens()->delete();
return response()->json([
'status' => 'success',
'mensaje' => 'Todas las sesiones activas han sido invalidadas',
], 200);
}
/**
* POST /api/v1/pedidos
*/
public function crearPedido(Request $request): JsonResponse
{
// Verificar si el token tiene la habilidad necesaria
if (! $request->user()->tokenCan('pedidos:crear')) {
return response()->json([
'status' => 'error',
'mensaje' => 'Habilidad "pedidos:crear" requerida en el token'
], 403);
}
// Lógica de creación de pedido...
return response()->json(['status' => 'Pedido creado'], 201);
}
}
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿Cómo se revoca ÚNICAMENTE el token con el que el usuario envió la petición actual en Laravel Sanctum sin cerrar sus otras sesiones en otros dispositivos?
¿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.