JSON Web Token (JWT) выглядит как длинная случайная строка, но это только три куска данных, склеенные точками. Первый говорит, как построен токен. Второй - claims: для кого, когда истекает и что еще записал issuer. Третий - signature, которую доверенный сервер может проверить. В руководстве - каждая часть, claims, которые вы видите каждый день, и разница между чтением токена и доверием ему. Чтобы разобрать реальный токен, вставьте его в JWT Decoder - работает в браузере и никогда не загружает значение.
Краткий ответ
JWT - это header.payload.signature. Header и payload - JSON в Base64URL. В header обычно alg и typ. В payload - claims вроде sub, iat, exp и любые кастомные поля. Signature - третий сегмент. Декодирование показывает JSON. Оно не доказывает подлинность - verification нужен secret или public key на доверенном сервере.
Три части, соединенные точками
RFC 7519 задает компактный JWT как три сегмента Base64URL, разделенных точкой. Нет обертки, нет внешнего JSON, обычно нет padding-символов equals. Разбивка по . всегда дает три строки, даже если последняя пустая (неподписанная форма alg none).
- Header: метаданные токена, почти всегда JSON с alg и typ.
- Payload: claims. Это данные, которые реально читают API.
- Signature: криптографическая метка над header и payload. В этом инструменте и статье - непрозрачные байты.
Любой, кто умеет писать JSON, может сделать header и payload и закодировать Base64URL. Поэтому первые две части публичны. Перехвативший JWT прочитает claims. Конфиденциальные данные не место в JWT, если вы не шифруете (JWE) - это другой формат.
Header
Header говорит верификаторам, как обрабатывать токен. Это небольшой JSON-объект. После Base64URL-декодирования первого сегмента обычно видите:
- alg - алгоритм подписи (или none). Частые значения: HS256 (HMAC с общим secret), RS256 или ES256 (асимметричные ключи).
- typ - обычно JWT. Некоторые issuer опускают.
- kid - опциональный id ключа, чтобы сервер взял нужный public key из JWKS.
- cty - тип контента, редко, когда payload - вложенный JWT.
Опасное поле header - alg. Декодер покажет, что заявляет токен. Наивный verifier, который принимает alg none или позволяет сменить RS256 на HS256 и подписать public key как HMAC secret, примет подделку. Это баг сервера, а не то, что исправит браузерный декодер. Читайте alg как подсказку, никогда как доказательство.
Payload (claims)
Payload - еще один JSON-объект. Спецификации JWT делят claims на зарегистрированные имена (общий словарь) и приватные или публичные кастомные имена вашего приложения. Метки времени - NumericDate: секунды с 1970-01-01 UTC, не миллисекунды.
Зарегистрированные claims, которые часто встречаются
- iss - issuer. Кто выпустил токен (URL или имя auth-server).
- sub - subject. Пользователь или сервис, о котором токен.
- aud - audience. API или приложение, которое должно его принять. Строка или массив.
- exp - expiration. Отклонять токен после этого Unix-времени.
- nbf - not before. Отклонять до этого Unix-времени.
- iat - issued at. Когда issuer создал токен.
- jti - JWT id. Уникальный id для отзыва или дедупликации.
Кастомные claims
Все остальное - данные приложения: name, email, role, scope, tenant или массив permissions. Удобно для API и тривиально подделать, если вы только декодируете. role: admin в токене, вставленном в декодер, значит issuer (или атакующий) написал эту строку. Это не grant прав, пока бэкенд не проверит signature и iss, aud, exp.
Signature
Третий сегмент - не JSON. Для HS256 это HMAC-SHA256 над ASCII-строкой header.payload с общим secret. Для RS256 или ES256 - асимметричная подпись над тем же входом. Декодер показывает сырой Base64URL для сравнения токенов; он не пересчитывает и не проверяет метку. Verification нужен secret или public key issuer и доверенная машина.
Decode - не verify
Чтение JSON header и payload отвечает лишь на вопрос "что заявляет токен?" Сервер, который принимает токен, должен проверить signature, отвергнуть неверный alg, проверить exp / nbf / iat и совпадение iss и aud. JWT Decoder - для инспекции и отладки, не для логина.
Base64URL, не обычный Base64
Header и payload JWT используют Base64URL (RFC 4648): та же 6-битная кодировка, что Base64, но + на -, / на _, а trailing = padding часто убирают. Это держит токены безопасными в query strings и заголовках. Если вставить сегмент JWT в обычный Base64 tool, сначала верните URL-символы, иначе JSON не декодируется. Base64 Encoder / Decoder - для обычного Base64; JWT tool уже применяет URL-алфавит.
Разобранный пример
Классический демо-токен из документации JWT декодируется в крошечный header и payload. После split по точкам и Base64URL первых двух частей получаете:
- Header JSON: {"alg":"HS256","typ":"JWT"}
- Payload JSON: {"sub":"1234567890","name":"John Doe","iat":1516239022}
- iat 1516239022 - 2018-01-18 01:30:22 UTC; токен на годы старше любого реального exp, если бы его задали.
- Третий сегмент - HMAC signature. По виду не скажешь, верен ли secret.
Префикс Bearer не часть JWT. Authorization: Bearer eyJ... - соглашение HTTP. Уберите Bearer и пробел, затем декодируйте оставшиеся три сегмента. Декодер ToolsMinify сделает это за вас.
Что можно прочитать и что сервер обязан проверить
Декодер - для отладки. Verifier - для авторизации.
- Можно прочитать alg, typ, kid и увидеть, какой ключ задумал issuer.
- Можно прочитать sub, email или role, чтобы понять падающий запрос.
- Можно сравнить exp и iat с часами и увидеть, устарел ли токен.
- Сервер обязан проверить signature правильным ключом и алгоритмом.
- Сервер обязан отклонять токены с неверным iss или aud и еще не действительные или просроченные.
- Сервер обязан считать каждый claim недоверенным, пока проверки не пройдены.
Типичные ошибки
- Доверие claims из декодера. Любой может собрать header.payload и оставить мусорную signature.
- Принятие alg none или выбор алгоритма verify по токену.
- Пароли, секреты сессии или персональные данные в payload. Payload читается всем, у кого есть токен.
- Вставка продакшен-токенов на случайный сайт. Предпочитайте client-side декодер, чтобы токен не покидал машину.
- Путаница с зашифрованными JWT (JWE). Компактный JWE имеет пять сегментов, не три.
Частые вопросы
JWT зашифрован?
Стандартный подписанный JWT (JWS) не зашифрован. Header и payload только закодированы. Любой с токеном читает claims. Зашифрованные токены - JWE и выглядят иначе. Если в декодере виден JSON, это не было конфиденциально.
Почему декодер не проверяет signature?
Verification нужен secret или public key держателя приватного ключа. Отдавать их в публичную веб-страницу небезопасно, а зеленая надпись "valid" на недоверенном сайте приучит доверять не той проверке. Декодируйте локально; verify - на вашем API.
Что значит alg none?
Issuer (или атакующий) пометил токен как неподписанный. Третий сегмент пустой. Декодер все равно покажет header и payload. Продакшен API должен отклонять alg none, если нет очень явной локальной причины принимать неподписанные токены.
exp и iat в миллисекундах?
Нет. NumericDate JWT - секунды Unix epoch. Если claim похож на 1.7e12, вы, вероятно, смотрите на миллисекунды JavaScript Date.now() по ошибке.
Можно ли пересобрать токен после правки payload?
Можно перекодировать JSON в Base64URL и склеить три сегмента, но старая signature не совпадет. Без secret или private key issuer новый токен подделан. Так и должно быть. Декодеры - для чтения, не для выпуска продакшен-токенов.
Где безопасно смотреть токен?
Страница, которая декодирует в браузере и не загружает строку. JWT Decoder на ToolsMinify так и работает. Пошагово - JWT Decoder.
Разобрать токен в браузере
Вставьте JWT, чтобы увидеть header, payload и signature в читаемом виде. Ничего не загружается:
- JWT Decoder - разбить токен, pretty-print JSON header и payload, копировать каждую часть.
- Base64 Encoder / Decoder - обычный Base64, не JWT URL-алфавит.
- Hash Generator - SHA-256 checksums в браузере. Не подпись JWT.
- Все инструменты для разработчиков - полный индекс категории.
Декодировать JWT - бесплатно
Откройте JWT Decoder, вставьте токен и прочитайте header и claims. Signature показывается как есть и никогда не верифицируется. Все в браузере.