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

Что такое access token, refresh token и session token?

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

Access token дает доступ к API на короткое время. Refresh token нужен для получения нового access token. Session token или session id связывает browser с server-side session.

Вопрос

Чем отличаются access token, refresh token и session token? Зачем нужна пара токенов?

Access token

Access token отправляют к API:

Authorization: Bearer access_token

Он обычно живет недолго: минуты или десятки минут.

Если access token украдут, короткий срок жизни уменьшает ущерб.

Refresh token

Refresh token нужен, чтобы получить новый access token без повторного login.

refresh token -> /auth/refresh -> new access token

Refresh token живет дольше и должен храниться осторожнее access token.

Session token

Session token часто выглядит как случайный id:

sid=abc123

Server хранит:

abc123 -> userId=42, expiresAt=...

Token rotation

При refresh можно выдавать новый refresh token и инвалидировать старый.

Это помогает заметить reuse украденного refresh token:

old refresh token used twice -> possible theft -> revoke token family

Сравнение

ТипГде проверяетсяСрок жизниОтзыв
Access tokenAPI/auth middlewareкороткийсложнее, если stateless JWT
Refresh tokenauth serverдлинныйобязателен
Session idsession storeзависит от sessionпростой через удаление session

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

  • При одновременном истечении access token несколько запросов могут параллельно вызвать refresh. Делайте один общий refresh-промис и очередь запросов.
  • Refresh endpoint должен принимать токен только из HttpOnly cookie или защищенного хранилища, а не из URL.
  • Время жизни access token — компромисс: короче — безопаснее, но больше refresh-запросов.
  • Opaque token (случайная строка) нужно проверять на сервере, а JWT — по подписи.

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

  • Access token нужен для API access.
  • Refresh token нужен для обновления access token.
  • Session token указывает на server-side session.
  • Refresh token должен храниться особенно осторожно.
  • Rotation снижает риск replay украденного refresh token.

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

OAuth: Access Tokens, OAuth: Refresh Tokens.

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

Поиск

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