Утилита разработчика

JWT декодер

Расшифруйте JSON Web Token: заголовок, полезная нагрузка, срок действия и проверка подписи. Токен не покидает ваш браузер

Декодирование идёт в браузере: токен и секрет никуда не отправляются

Из чего состоит JWT

  • • Header — тип токена и алгоритм подписи.
  • • Payload — данные: кто выпустил токен, для кого, когда он истекает и любые поля приложения.
  • • Signature — подпись первых двух частей. Она защищает токен от подделки, но не скрывает его содержимое.
  • • Содержимое JWT не зашифровано — его может прочитать любой, у кого есть токен. Не кладите в него пароли и персональные данные.

JWT: как устроен токен и как его читать

Что такое JWT

JSON Web Token — компактный способ передать сведения о пользователе между сервисами. После входа сервер выдаёт токен, и клиент прикладывает его к каждому запросу; серверу не нужно хранить сессию — достаточно проверить подпись.

Токен состоит из трёх частей в кодировке Base64URL: заголовка с алгоритмом подписи, полезной нагрузки с данными и самой подписи.

Что видно в декодере

Заголовок показывает алгоритм (alg) и тип токена. В полезной нагрузке — стандартные поля: iss — кто выпустил, sub — для кого, aud — кому предназначен, exp, iat и nbf — временные рамки, а также любые поля приложения: роль, права, идентификаторы.

Декодер переводит даты в читаемый вид и сразу отвечает на главный вопрос при отладке: действует ли токен или уже истёк.

Типичные ошибки безопасности

Хранить в токене конфиденциальные данные: содержимое читается без ключа. Принимать токены с алгоритмом none — они не подписаны. Использовать короткий или предсказуемый секрет для HS256: его можно подобрать. Выпускать токены без срока действия — украденный токен будет работать бессрочно.

При проверке на сервере всегда сверяйте подпись, срок действия и поля iss и aud, а алгоритм задавайте в коде, а не берите из заголовка токена.

Часто задаваемые вопросы

Как расшифровать JWT-токен?+

Вставьте токен в поле — заголовок и полезная нагрузка сразу отобразятся в виде JSON. Префикс «Bearer» и кавычки вокруг токена удалять не нужно, декодер уберёт их сам.

Безопасно ли вставлять сюда рабочий токен?+

Декодирование и проверка подписи выполняются в браузере: ни токен, ни секрет на сервер не отправляются. Тем не менее действующий токен — это ключ к учётной записи; не оставляйте его в открытых вкладках и чатах, а при любых сомнениях отзовите и выпустите новый.

Можно ли прочитать токен без секретного ключа?+

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

Как проверить подпись токена?+

Для алгоритмов HS256, HS384 и HS512 введите секретный ключ в блоке «Подпись» — декодер пересчитает подпись и сообщит, совпадает ли она. Для RS256, ES256 и других асимметричных алгоритмов нужен открытый ключ издателя; такую проверку инструмент не выполняет.

Что означают поля exp, iat и nbf?+

Это время в формате Unix: exp — когда токен истекает, iat — когда выпущен, nbf — с какого момента начинает действовать. Декодер переводит их в обычные дату и время и показывает, действует ли токен сейчас и сколько ему осталось.

Почему токен не декодируется?+

JWT состоит из трёх частей, разделённых точками. Если частей меньше — токен скопирован не целиком. Если их пять — это зашифрованный токен (JWE), его содержимое без ключа не прочитать. Также ошибку даёт лишний текст до или после токена.