re:re:actable
Урок 112 минуты чтения

Как проектировать logout и token rotation?

На этой странице
Кратко

Logout должен не только удалить данные на клиенте, но и инвалидировать session или refresh token на сервере. Token rotation уменьшает риск повторного использования украденного refresh token.

Вопрос

Как правильно реализовать logout? Что такое refresh token rotation и зачем он нужен?

Плохой logout

localStorage.removeItem('accessToken');

Это очищает только browser storage. Если refresh token или session на сервере все еще валидны, пользователь или атакующий может получить новый access token.

Хороший logout для session

POST /auth/logout

Server:

  1. находит session по cookie;
  2. удаляет session из store;
  3. очищает cookie.
Set-Cookie: sid=; Max-Age=0; Path=/; HttpOnly; Secure; SameSite=Lax

Хороший logout для token pair

Server:

  1. принимает refresh token;
  2. инвалидирует refresh token или token family;
  3. frontend очищает access token из memory/storage;
  4. refresh endpoint больше не выдает новую пару.

Refresh token rotation

refresh_1 -> выдать access_2 + refresh_2
refresh_1 -> становится недействительным

Если старый refresh_1 используют повторно, это сигнал возможной кражи. Server может отозвать всю token family.

Logout from all devices

Для "выйти на всех устройствах" нужно удалить все sessions или refresh tokens пользователя.

DELETE FROM sessions WHERE user_id = 42

или пометить все token families revoked.

Что важно помнить

  • Logout должен выполняться через POST: GET /logout может вызвать любая чужая страница картинкой.
  • При logout очищайте и клиентское состояние: кеш TanStack Query, store, данные в localStorage.
  • Logout в одной вкладке стоит синхронизировать с остальными через событие storage или BroadcastChannel.
  • Header Clear-Site-Data: "cookies", "storage" позволяет серверу очистить данные сайта в браузере.

Мини-шпаргалка

  • Logout должен затрагивать server-side state.
  • Просто удалить token из frontend недостаточно.
  • Session logout удаляет session и cookie.
  • Refresh token нужно отзывать.
  • Rotation помогает обнаружить replay украденного refresh token.
  • Logout from all devices требует удаления всех sessions/tokens пользователя.

Документация

OWASP: Session Management — Logout, MDN: Clear-Site-Data, MDN: BroadcastChannel.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам