JWT и авторизация в веб-приложениях: токены, сессии, OAuth и типичные дыры в защите API
JWT (JSON Web Token) — строка из трёх частей через точку: заголовок, полезная нагрузка с данными о пользователе и подпись. Сервер выдаёт её после входа, клиент прикладывает её к каждому запросу, а API проверяет подпись и срок действия, не обращаясь к базе сессий. Чтобы применять JWT без дыр, нужно понимать разницу между аутентификацией и авторизацией, выбор алгоритма подписи, связку access- и refresh-токенов, хранение на клиенте, отзыв доступа, место JWT в OAuth 2.0 и проверки против подмены алгоритма.
Содержание

Самое частое заблуждение — считать JWT «безопаснее» или «современнее» сессий. Токен решает другую задачу: он позволяет нескольким сервисам проверять пользователя без общего хранилища. Цена — токен нельзя просто удалить на сервере: пока не истёк срок, он действует.
Аутентификация и авторизация: что сервер проверяет на каждом запросе
Аутентификация отвечает на вопрос «кто это»: сервер сверяет пароль, код из приложения или результат входа через внешний сервис и выдаёт идентификатор сессии или токен. Авторизация отвечает на вопрос «что ему можно»: при каждом запросе API смотрит, принадлежит ли заказ этому пользователю и есть ли у него роль администратора.
Новички часто проверяют только первое. Сервер убедился, что токен настоящий, и отдаёт заказ по номеру из адреса — а номер можно подставить чужой. Подпись JWT подтверждает, что токен выдал ваш сервер, но не то, что пользователь имеет право на конкретную запись. Проверку владельца объекта пишут в обработчике отдельно.
Как устроен JWT и чем HS256 отличается от RS256
Формат описан в RFC 7519: токен выглядит как header.payload.signature. Заголовок — JSON в кодировке base64url с алгоритмом подписи alg. Нагрузка — набор утверждений (claims), из которых стандарт регистрирует общие: iss — кто выдал, sub — о ком токен, aud — для какого сервиса, exp — срок действия, jti — уникальный номер. Подпись вычисляется над первыми двумя частями. Base64url — кодирование, а не шифрование: перехваченный токен читается в любом декодере, поэтому в нагрузку кладут идентификатор и роли, но не паспортные данные.
HS256 использует один общий секрет: им и подписывают, и проверяют. Это удобно, пока токены выпускает и принимает одно приложение, но любой сервис, получивший секрет для проверки, сможет и выпускать токены. RS256 (как и ES256 на эллиптических кривых) работает на паре ключей: закрытый хранится только у сервера авторизации, открытый раздают всем, и те проверяют подпись, но подделать её не могут. Открытые ключи публикуют в JWKS — JSON-списке, где у каждого ключа есть идентификатор kid — так ключи проще менять.
Сессии или токены
При классической сессии сервер хранит запись «сессия 8f3a… — пользователь 42», а браузер получает только случайный идентификатор в cookie. Выйти или заблокировать пользователя легко — достаточно удалить запись. JWT оправдан, когда запросы проверяют несколько независимых сервисов, когда клиент — мобильное приложение или когда вход выполняет отдельный сервер авторизации. Для одного приложения с одной базой токены добавят работы: отзыв, обновление и хранение придётся придумывать самому.
Access и refresh: короткий пропуск и долгий
Раз JWT нельзя отозвать до истечения срока, его делают коротким. Access-токен живёт минуты и уходит в заголовке Authorization: Bearer …. Refresh-токен живёт дни или недели и нужен для одного действия — получить новый access-токен без пароля. Его часто делают случайной строкой с записью в базе, чтобы можно было отозвать.
Учебная ситуация. Сервис заметок: фронтенд на React, API на Python. После входа API выдаёт access-токен на 15 минут и refresh-токен на 30 дней. Когда access истекает, клиент получает 401, обращается за новой парой, а старый refresh-токен сервер помечает использованным. Повторное предъявление использованного refresh-токена — признак кражи: сервер отзывает всю цепочку. При выходе и смене пароля удаляют все refresh-токены пользователя, а выданные access-токены доживают свои 15 минут. Такую схему называют ротацией, и по RFC 9700 — рекомендациям IETF по безопасности OAuth 2.0 (январь 2025 года) — refresh-токены браузерных и мобильных приложений должны либо ротироваться, либо быть привязаны к отправителю.
Где хранить токен на клиенте
Из localStorage токен легко прочитать своим кодом, но так же легко и вредоносным скриптом при XSS-уязвимости. Cookie с флагом HttpOnly скриптам недоступна, зато браузер сам прикладывает её к запросам, и появляется риск CSRF — подделки запроса с чужого сайта, который закрывают атрибутом SameSite и проверкой происхождения. Частый компромисс: refresh-токен в cookie с HttpOnly, Secure и SameSite=Strict, access-токен только в памяти страницы. Но если злоумышленник выполняет свой код на вашей странице, проигрывает любое хранение, поэтому защита от XSS важнее выбора места.
OAuth 2.0 и OpenID Connect
OAuth 2.0 (RFC 6749) — протокол выдачи доступа: пользователь разрешает приложению действовать от его имени на другом сервисе, не сообщая пароль. Кнопка «Войти через…» обычно работает на OpenID Connect — надстройке, которая добавляет ID-токен в формате JWT с данными о вошедшем. Для веб- и мобильных приложений используют поток authorization code с PKCE, а упрощённый поток implicit, где токен приходил прямо в адресе страницы, по RFC 9700 применять не следует.
Типичные дыры: alg=none и подмена алгоритма
Главные ошибки с JWT собраны в RFC 8725 — документе IETF о лучших практиках (BCP 225, февраль 2020 года). Раздел 2.1 описывает две атаки, которые выросли из того, что алгоритм записан в самом токене. Первая: злоумышленник ставит alg: none, удаляет подпись, а библиотека верит заголовку. Вторая тоньше: токен подписан RS256, атакующий меняет alg на HS256 и подписывает поддельную нагрузку открытым ключом сервера как секретом HMAC. Если код вызывает проверку без указания ожидаемого алгоритма, библиотека посчитает HMAC с тем же открытым ключом — и подпись сойдётся. А открытый ключ не секрет: он лежит в JWKS. RFC ссылается на реальную уязвимость CVE-2015-9235.
Защита в разделе 3.1 сформулирована как обязательное требование: библиотека должна позволять задать список допустимых алгоритмов и не использовать другие, а каждый ключ — применяться ровно с одним алгоритмом. В Python это выглядит как jwt.decode(token, public_key, algorithms=["RS256"], audience="notes-api"). Документация PyJWT предупреждает: не вычисляйте algorithms из поля alg самого токена и не смешивайте симметричные и асимметричные алгоритмы. Там же видно, что список обязательных утверждений require по умолчанию пуст, а exp проверяется, только если оно есть, — токен без срока пройдёт, пока вы не потребуете это поле явно.
Ещё два требования стоит помнить. По разделу 3.5 запоминаемый пароль нельзя использовать напрямую как ключ HS256: его подберут перебором по перехваченному токену. По разделу 3.9 токен для одного из нескольких сервисов должен содержать aud, иначе токен внутренней админки примет и публичный API. Обновлённую редакцию IETF готовит как черновик draft-ietf-oauth-rfc8725bis, но действует RFC 8725.
С чего начать и в каком порядке осваивать
Если сразу подключить готовую библиотеку авторизации, легко не заметить, что именно она проверяет. Поэтому сначала стоит руками разобрать токен, потом написать проверку самому, затем добавить обновление и только после этого браться за OAuth.
- Выпустите токен, разберите его в декодере и убедитесь, что нагрузка читается без ключа.
- Напишите API с одним защищённым адресом: подпись,
exp,aud, явный список алгоритмов. Проверьте, что сервер отклоняет токен сalg: noneи токен, переподписанный HS256 открытым ключом. - Добавьте refresh-токен с ротацией, выход из аккаунта и отзыв всех сессий при смене пароля.
- Перенесите refresh-токен в cookie с
HttpOnlyиSameSite. - Подключите вход через OAuth-провайдера по потоку authorization code с PKCE.
Проверить себя помогает правило: для каждого обработчика вы должны знать, что будет, если прислать токен другого пользователя, просроченный, выданный для другого сервиса или не прислать токен вовсе. Оформите ответы автотестами. Следующий шаг — авторизация в полноценном проекте: на курсе Skillbox «FastAPI» после подключения PostgreSQL идёт этап «регистрация и авторизация по JWT», а затем тесты для операций с данными и авторизации. На входе ждут Python, ООП, асинхронность и SQL.
Чему учат на курсах
На программах по бэкенду авторизация обычно оказывается одним из этапов, и важно, где он стоит. Если в самом конце, на неё может остаться пара уроков; если в середине — её успеют встроить в сквозной проект и покрыть тестами.
На курсе SF Education «Бекенд-разработчик на Python» авторизация через JWT и OAuth названа в стеке программы. Обучение рассчитано на три месяца и девять модулей, среди них отдельный модуль о работе с API и сквозной проект на Django с базой данных и авторизацией. В опубликованном обзоре JWT и OAuth не привязаны к конкретному модулю, так что раздел стоит уточнить у школы.
Тем, кто уже пишет API, полезно посмотреть на сторону сервера авторизации: как готовое решение выдаёт токены, хранит ключи и подключает старые системы без переписывания.
Этому посвящён курс Слёрма «Система управления доступом Keycloak»: шесть модулей, 9 часов теории и 20 часов практики на стендах, в программе — OAuth2, развёртывание Keycloak, вход через Google и подключение старых систем. На входе нужны базовые Linux и Kubernetes. Про JWT и refresh-токены обзор прямо не говорит — уточните это у школы.
Как навык влияет на доход
Отдельной надбавки «за JWT» в вакансиях не бывает: авторизацию ждут от любого бэкенд-разработчика наряду с SQL и HTTP. Ориентир по профессии в целом — медиана зарплаты бэкенд-разработчика за первое полугодие 2026 года в 254 тысячи рублей по данным Хабр Карьеры (статья от 10 августа 2026 года; разбивки по уровням и регионам в ней нет).
Влияет навык иначе: он открывает задачи, которые не доверяют новичку, — перевести сервис на единый вход, настроить замену ключей подписи, закрыть замечание пентестера «принимает токен с alg=none». Отсюда же путь к ролям, где безопасность API — основная работа, например к специалисту по безопасной разработке. Живые цифры смотрите в вакансиях с фильтром по городу и опыту.
Как выбрать обучение
Перед оплатой проверьте, есть ли в программе проверка прав на объекты, а не только вход по паролю, тесты на отказ в доступе, хранение токенов на клиенте и обновление по refresh-токену.
Сравнить школы по формату и практике поможет рейтинг онлайн-школ по бэкенд-разработке — он охватывает направление шире, чем авторизация. А уровень после любого курса проверяется одинаково: напишите API, попробуйте взломать его способами из RFC 8725 и убедитесь, что не вышло.