Что такое…

Что такое refresh-токен — и почему иногда выкидывает со всех устройств

Иллюстрация: длинный ключ в сейфе, короткий пропуск в кармане

Знакомая ситуация: сидишь в приложении неделями, всё хорошо. И вдруг тебя разлогинивает — причём сразу на телефоне, ноутбуке и планшете. Пароль не менял, ничего не делал.

Чаще всего это не сбой. Это сработала защита, и устроена она вокруг refresh-токена. Давай разберём.

Что такое refresh-токен простыми словами

После входа сервер выдаёт не один ключ, а два.

  • Access-токен — пропуск. Ты показываешь его при каждом запросе. Живёт минуты.
  • Refresh-токен — квитанция на новый пропуск. Живёт недели, показывается редко.

Аналогия: пропуск в бизнес-центре ты носишь в кармане и суёшь в турникет сто раз в день. Договор аренды лежит в сейфе, и ты достаёшь его раз в год, чтобы продлить пропуск.

Смысл размена: то, что путешествует часто, должно быть дешёвым в потере. То, что ценно, должно лежать и почти не двигаться.

Почему access-токен такой короткий

Тут начинается интересное. Обычно access-токен — это JWT, самодостаточная штука: сервер проверяет подпись и пускает, не заглядывая в базу.

Это быстро — и в этом же ловушка. Раз сервер не сверяется с базой, он не может узнать, что токен украли. Отозвать его попросту негде.

Единственная защита — время. Поэтому access-токен и живёт пять-пятнадцать минут: украли — злоумышленник погуляет четверть часа, а не полгода.

А отзывать умеют как раз refresh-токен: его сервер хранит у себя и в любой момент может вычеркнуть.

Ротация: каждый обмен выдаёт новую пару

Современный подход — не переиспользовать refresh-токен. Обменял старый на новую пару токенов, старый сразу становится недействительным.

Это не перестраховка, а требование: свежая практика безопасности OAuth (RFC 9700) прямо говорит, что для публичных клиентов — мобильных приложений и фронтенда — refresh-токены обязаны либо быть привязаны к клиенту, либо использовать ротацию.

Логика простая. Даже если refresh-токен утёк, он ценен только до ближайшего обновления. Дальше он мёртв.

Почему разлогинивает везде сразу

А теперь ответ на вопрос из начала.

Тот же документ рекомендует серверу отзывать всю цепочку токенов, если refresh-токен использован повторно. Причина: честный клиент старый токен уже выбросил. Если им кто-то воспользовался — значит, у кого-то есть копия. Кто из двоих вор, сервер не знает, поэтому вырубает обоих.

Отсюда и эффект «разлогинило на всех устройствах». Обычно виноват не хакер, а один из бытовых сценариев:

  • приложение отправило два запроса на обновление одновременно, и второй пришёл со старым токеном;
  • телефон восстановили из бэкапа, где лежала копия уже использованного токена;
  • запрос ушёл, ответ потерялся в метро, приложение повторило его позже.

Что с этим делать на своей стороне: обновлять токен строго в одном месте кода и ставить очередь, чтобы параллельные запросы ждали одно обновление, а не запускали пять.

Как выглядит обмен на практике

Никакой магии — это обычный запрос к серверу авторизации:

POST /token
grant_type=refresh_token&refresh_token=СТАРЫЙ_ТОКЕН

В ответ приходят три вещи: новый access-токен, время его жизни в секундах и — при включённой ротации — новый refresh-токен.

Дальше важное. Полученный refresh-токен надо записать поверх старого сразу, до того как ты продолжишь работу. Типичная ошибка новичка: обновил токены, обрадовался, повторил исходный запрос — и забыл сохранить новую пару. Приложение живёт нормально до перезапуска, а после него достаёт с диска уже потраченный токен и ловит разлогин.

И ещё: не вызывай обновление «на всякий случай» по таймеру. Проще и надёжнее реагировать на ответ 401 от своего API.

Где хранить refresh-токен

Раз он живёт долго, к нему и требования жёстче.

  • В мобильном приложении — только в защищённом хранилище, не в настройках.
  • В вебе — в cookie с флагами HttpOnly и Secure, чтобы её не читал скрипт на странице.

Access-токен можно держать просто в памяти. Он всё равно протухнет через десять минут.

Частые вопросы

Можно обойтись одним токеном?

Можно, но придётся выбрать из двух неприятностей. Длинный токен — удобно, но украденный работает месяцами. Короткий — безопасно, но пользователь логинится каждый час.

Refresh-токен — это тоже JWT?

Часто нет, и это осознанно. Обычно это просто случайная строка, записанная в базу: смысл refresh-токена в том, чтобы его можно было отозвать, а самопроверяемый JWT такого не умеет.

Сколько он должен жить?

Для обычного приложения нормально от недели до месяца с ротацией. Для банковского — часы. Если тебя постоянно выкидывает раньше срока, причины разобраны в статье почему меня всё время разлогинивает.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →