Tema 12 · Habilidades & Logout

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:

LogoutAbilitiesController.php
Solo lectura
<?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
1 Pregunta
Pregunta 1
¿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.

🏛️ 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.