Как проектировать 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/logoutServer:
- находит session по cookie;
- удаляет session из store;
- очищает cookie.
Set-Cookie: sid=; Max-Age=0; Path=/; HttpOnly; Secure; SameSite=LaxХороший logout для token pair
Server:
- принимает refresh token;
- инвалидирует refresh token или token family;
- frontend очищает access token из memory/storage;
- 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.