Перейти к содержанию

JWT: структура токена и проверка claims

JSON Web Token (JWT) — компактный формат передачи утверждений, или claims, между сторонами. В распространённом компактном виде подписанный токен состоит из заголовка, полезной нагрузки и подписи, разделённых точками. Его часто можно прочитать без секрета, потому что данные закодированы Base64URL. Декодирование показывает содержимое, но не подтверждает подпись и не доказывает, что утверждения токена верны.

ОБУЧЕНИЕ

Структура токена

RFC 7519 описывает JWT как представление набора claims, которое может быть оформлено как JSON Web Signature (JWS) или JSON Web Encryption (JWE). В типичном JWS первая часть содержит заголовок с параметрами вроде алгоритма, вторая — JSON-утверждения, третья — подпись или MAC. Base64URL — способ кодирования байтов для безопасной передачи в URL и HTTP-заголовках. Он не шифрует значения.

Claims могут включать sub (субъект), iss (издатель), aud (аудитория), exp (время окончания), iat (время выпуска) и данные приложения. Наличие поля не означает, что принимающая сторона его проверила. Сервер должен знать, какие claims обязательны для данного типа токена, в какой единице представлены даты и какой диапазон расхождения часов допустим.

В JWS подпись или MAC защищает сообщение от изменения и связывает его с ключом. Но подписанные claims остаются читаемыми для каждого, кто получил токен. JWE обеспечивает шифрование, когда нужна конфиденциальность, однако добавляет другие алгоритмы, ключи и правила проверки. JWT может также иметь вложенные формы, поэтому приложение должно ясно ожидать конкретный профиль и отвергать неожиданные форматы.

Практический пример проверки

API получает токен от браузера или мобильного приложения. Сначала оно ограничивает допустимые алгоритмы и проверяет криптографическую подпись ключом, связанным с доверенным издателем. Затем проверяет iss, aud, exp, nbf и нужные предметные права. Если токен рассчитан на сервис A, аудитория сервиса B не должна принять его только потому, что подпись математически корректна.

Например, JWT содержит sub=user-42, aud=payments-api и время истечения. Сервис платежей должен проверить, что издатель ожидаемый, аудитория именно этот API, срок не закончился, подпись проверена по актуальному ключу, а предъявитель имеет нужную роль. Если он лишь декодирует вторую часть и видит роль admin, он не получил доказательство, что claim подлинный. Нападающий может сам создать Base64URL-строку с любым текстом.

При ротации ключей издатель может публиковать несколько открытых ключей с идентификаторами kid. Проверяющая сторона должна получать ключи из доверенного набора, защищать кэш и корректно отказывать, если нужный ключ неизвестен. Нельзя без проверки обращаться к произвольному URL из заголовка токена за ключом: атакующий контролирует токен и может попытаться направить сервер на внешний ресурс.

Основные ошибки реализации

Алгоритм берётся из заголовка токена, поэтому сервер обязан не принимать произвольное значение. RFC 8725 рекомендует задавать разрешённый список алгоритмов и проверять, что алгоритм токена соответствует выполненной криптографической операции. Нельзя считать заголовок доверенным указанием. Также не следует разрешать none, если конкретный профиль специально этого не требует.

Ещё одна ошибка — путать симметричный HS256 и асимметричный RS256/ES256. В HMAC один общий секрет одновременно создаёт и проверяет MAC; в схеме с публичным ключом подпись создаётся приватным, а проверяется открытым. Ключи разных типов не взаимозаменяемы. Каждая служба должна чётко выбрать ожидаемую схему, не допуская путаницы алгоритмов и неправильного использования ключа.

JWT не следует хранить в URL, логах или аналитических событиях без необходимости: bearer-токен, попавший к постороннему, может давать доступ до истечения или отзыва. Используйте защищённый канал, подходящее место хранения, короткий срок там, где это соответствует модели приложения, и ротацию сессий. Шифрование канала не гарантирует защиту от XSS, вредоносного расширения или утечки журнала.

Проверка подписи не заменяет авторизацию. Токен может быть подлинным, но не давать права на конкретное действие. Проверяйте минимальные нужные права при каждом запросе и отдельно учитывайте отзыв пользователя, смену пароля и закрытие сессии. Самодостаточный токен не обязательно узнает о немедленном изменении статуса аккаунта без дополнительных механизмов.

JWT в повседневной разработке

JWT удобен для компактного переноса утверждений между сервисами и часто используется в схемах OAuth/OpenID Connect. Он не всегда лучше серверной сессии: самодостаточность упрощает проверку, но усложняет отзыв и управление жизненным циклом. Выбор зависит от числа сервисов, нужной задержки, требований к аудиту и того, как приложение будет реагировать на компрометацию токена.

Декодер JWT полезен при отладке, если токен не содержит производственных секретов. Он показывает заголовок и claims в читаемом виде, но реальная проверка подписи требует ключа и ожидаемого алгоритма. Не вставляйте рабочие bearer-токены на незнакомые сайты: они часто дают временный доступ к аккаунту или API. Для тестирования используйте искусственные токены или локальные инструменты с прозрачной обработкой данных.

Вывод

Срок exp обычно выражается как время Unix, а не как текстовая дата; ошибка единиц или временной зоны может привести к принятию просроченного токена. Проверяйте nbf и временной допуск, заданный политикой сервиса. Не принимайте claim о роли, если подпись не проверена, а издатель не имеет права выдавать такую роль. Токен следует считать сообщением, которое нужно проверить, а не подтверждённым профилем пользователя.

Следует различать access token, refresh token и ID token. Их сериализация может выглядеть похоже, но назначение и правила проверки различаются. ID token предназначен клиенту для сведений об аутентификации, access token — серверу ресурсов для решения об авторизации, а refresh token — для получения новых токенов. Если приложение принимает один тип вместо другого, возникает риск подмены. RFC 8725 рекомендует разделять профили и контексты, например разными claims, audience, типом или ключами.

JWT часто называют самодостаточным, но это не означает, что все данные нужно помещать внутрь. Излишний набор claims увеличивает размер, риск утечки и сложность обновления прав. Если пользователь заблокирован после выдачи токена, приложение может продолжить принимать его до истечения, если не использует отзыв, короткий срок или серверную проверку состояния. Срок жизни и контроль статуса нужно выбирать с учётом возможных последствий.

JWT — формат claims с кодированием, подписью и, при необходимости, отдельным шифрованием. Base64URL не является защитой, а успешная проверка подписи не заменяет проверку издателя, аудитории, срока и прав. Сервер должен строго задавать формат, алгоритмы и ключи, а токены нужно обращаться как с временными секретами доступа.

Источники проверены: 21.11.2026.

Читать дальше

Источники

  1. RFC 7519: JSON Web Tokenrfc-editor.org
  2. RFC 8725: лучшие практики безопасного использования JWTrfc-editor.org
  3. OWASP: руководство по аутентификацииcheatsheetseries.owasp.org

Материал был полезен?

Обучение
Обучение

Как проверять криптоинформацию по первоисточникам

Криптоинформация быстро распространяется через чаты, видео и социальные сети. Чтобы отделить факт от рекламы и предположения, полезно проследить заявление до первичного документа, независимо сверить данные и записать, на какую дату они были верны.

6 мин

Обучение

Постквантовая криптография: зачем готовить сети заранее

Постквантовая криптография (PQC) разрабатывает алгоритмы, которые должны противостоять будущим квантовым компьютерам и обычным вычислителям. Это долгосрочная задача для систем, защищённых современными цифровыми подписями и обменом ключами, включая криптокошельки, инфраструктуру узлов, веб-сервисы и архивы данных.

6 мин

Обучение

Открытый код и bug bounty: как устроено внешнее тестирование

Открытый исходный код позволяет людям изучать устройство программы, а bug bounty предлагает вознаграждение за найденные уязвимости в определённой системе. Оба механизма могут расширить внешнюю проверку, но сам факт доступности кода или наличие программы не доказывают, что каждый компонент проверен.

5 мин