Декодер JWT

Три куска текста, соединённые точками

Когда вы вошли на сайт, сервер должен узнавать вас снова при следующем запросе. Распространённый способ это сделать: выдать браузеру короткую подписанную записку вида «это пользователь 48213, ему можно читать заказы, до 15:15». Эта записка и есть JSON Web Token, или JWT.

JWT выглядит как одна длинная случайная строка, но у него всегда одна и та же форма, header.payload.signature.

• Заголовок (header) представляет собой небольшой JSON-объект, который называет алгоритм подписи (alg) и часто использованный ключ (kid).
• Полезная нагрузка (payload) представляет собой JSON-объект из claims, то есть утверждений, таких как sub (кто), aud (для какого сервиса) и exp (до какого момента).
• Подпись (signature) представляет собой печать, вычисленную из первых двух частей и ключа.

Заголовок и payload записаны в Base64URL, способом записать байты буквами, цифрами, - и _, чтобы они пережили путь через адрес или HTTP-заголовок. Поэтому же почти каждый токен начинается с eyJ: так в этой кодировке выглядит {".

Закодировано не значит зашифровано

Base64URL всего лишь способ записи. Он ничего не запирает, и чтобы превратить его обратно в текст, ключ не нужен, а больше эта страница ничего и не делает. Значит, подписанный JWT не скрывает вообще ничего. Если в payload лежит адрес почты, роль или внутренний ID, прочитать его может любой, к кому попал токен, будь то расширение браузера, журнал прокси или скриншот.

Подпись даёт целостность. Измените один символ payload, и печать перестанет совпадать, поэтому сервер отклонит токен. Прочитать его по-прежнему можно. Переписать нельзя.

Что читает эта страница и о чём предупреждает

Декодер убирает начальный Bearer, пробелы и переводы строк, делит токен на части и выводит заголовок и payload в виде отформатированного JSON. Затем он перебирает claims по одному. Три даты, exp, nbf (не раньше) и iat (выдан), представляют собой число секунд с 1 января 1970 года. Вы видите их в своём часовом поясе и в UTC, с живым отсчётом вроде «действителен ещё 12 минут».

Есть и пара слов об алгоритме. HS256 использует один общий секрет и для подписи, и для проверки. RS256, ES256 и EdDSA используют пару ключей: закрытый ключ подписывает, открытый проверяет, поэтому сервисы, которые только проверяют токены, не могут их создавать.

Чего декодирование не скажет

Эта страница не проверяет подпись. Для этого нужен секрет или открытый ключ выдавшей стороны, а страницу, которая просит ваш секрет для подписи, лучше сразу закрыть. Поэтому поддельный и настоящий токены выглядят здесь одинаково. Читайте результат как «вот что утверждает токен», но никогда как «этот токен действителен».

По той же причине «не истёк» означает лишь, что exp позже часов вашего устройства. Сервер мог отозвать токен час назад.

Если вы пишете принимающую сторону, важные проверки происходят в вашем коде. Принимайте только ожидаемые алгоритмы, проверяйте подпись ключом, которому уже доверяете, затем сравнивайте iss, aud и exp с тем, что ожидаете. Используйте поддерживаемую библиотеку и никогда не ветвите логику по alg, который просит токен.

Действующий токен равен учётным данным

Пока он не истёк, bearer-токен работает для любого, кто его предъявит. Вставьте рабочий токен на сайт, и вы отдали его этому сайту, если только декодирование не происходит в вашем браузере. Здесь оно происходит в браузере. Ни один запрос не несёт токен, он не пишется в адресную строку и не сохраняется в хранилище браузера. Верить нам на слово не обязательно: следите за вкладкой «Сеть» в инструментах разработчика или загрузите страницу и отключитесь от сети, прежде чем вставлять.

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