Что такое 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 коротких урока на телефоне.





