Dev.to Security 🔐 Cybersecurity 👁 0 📖 1 min read

Как прочитать JWT без библиотек: header, payload, exp по Москве и проверка подписи HS256

JWT-токен выглядит как длинная бессмысленная строка из трёх частей через точку. На деле две из трёх частей читаются за секунды, и без всякого ключа. Разберём на синтетическом примере, что именно видно в токене, как перев

JWT-токен выглядит как длинная бессмысленная строка из трёх частей через точку. На деле две из трёх частей читаются за секунды, и без всякого ключа. Разберём на синтетическом примере, что именно видно в токене, как перевести exp в московское время и почему «я декодировал токен» ещё не значит «я проверил токен».

Сразу оговорюсь: я сделал бесплатный JWT-декодер на base64decodetool.com. Все значения ниже я проверил кодом на Node.js, повторив ту же логику, что выполняет страница. Токен и секрет в статье выдуманы и нигде не используются.

Пример токена (иллюстративный)

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c2VyLTQyIiwibmFtZSI6ItCY0LLQsNC9Iiwicm9sZSI6ImVkaXRvciIsImlhdCI6MTc5NTAwMDAwMCwiZXhwIjoxNzk1MDAzNjAwfQ.F8WIDMfyy7TTP88zGKZhlppbWvgl2Zxzg0wnipArZVk

Подписан алгоритмом HS256 с учебным секретом demo-secret-do-not-use.

Шаг 1. Делим по точкам

У подписанного JWT (формат JWS Compact) ровно три сегмента:

  1. Header: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9
  2. Payload: eyJzdWIiOiJ1c2VyLTQy...MDB9, полностью см. выше
  3. Signature: F8WIDMfyy7TTP88zGKZhlppbWvgl2Zxzg0wnipArZVk

Если сегментов не три, это либо не JWS, либо строку обрезали при копировании.

Шаг 2. Декодируем Base64URL

Сегменты закодированы в Base64URL: вместо + и / используются - и _, а символы = в конце отброшены. Чтобы раскодировать обычным декодером Base64, нужно вернуть замены и дополнить длину до кратной 4:

function b64urlToText(s) {
  let b64 = s.replace(/-/g, '+').replace(/_/g, '/');
  while (b64.length % 4) b64 += '=';
  return new TextDecoder('utf-8').decode(
    Uint8Array.from(atob(b64), c => c.charCodeAt(0))
  );
}

Результат:

{"alg":"HS256","typ":"JWT"}
{"sub":"user-42","name":"Иван","role":"editor","iat":1795000000,"exp":1795003600}

Обратите внимание на TextDecoder('utf-8'). Голый atob() вернёт для кириллицы «кракозябры», потому что отдаёт байты, а не символы. Имя «Иван» в UTF-8 занимает 8 байт, по два на букву. Поэтому JSON payload здесь весит 85 байт, а его Base64URL-строка состоит из 114 символов: 4 × ⌈85/3⌉ = 116, минус два отброшенных =.

Главный вывод шага 2: payload не зашифрован. Любой, у кого есть токен, видит sub, role и всё остальное. Не кладите в JWT паспортные данные, телефоны и прочие секреты.

Шаг 3. Переводим iat и exp в московское время

По RFC 7519 exp и iat имеют тип NumericDate, то есть это секунды с 1970-01-01T00:00:00Z (UTC). Не миллисекунды: если передать число прямо в new Date(), получится дата в январе 1970 года.

const fmt = t => new Date(t * 1000).toLocaleString('ru-RU', { timeZone: 'Europe/Moscow' });
fmt(1795000000); // "18.11.2026, 14:06:40"
fmt(1795003600); // "18.11.2026, 15:06:40"
Claim Значение UTC Москва (UTC+3)
iat 1795000000 18.11.2026 11:06:40 18.11.2026 14:06:40
exp 1795003600 18.11.2026 12:06:40 18.11.2026 15:06:40

Разница ровно 3600 секунд, то есть токен живёт один час.

Москва живёт по UTC+3 круглый год: в базе часовых поясов IANA для Europe/Moscow последнее изменение датировано 26 октября 2014 года, с тех пор действует постоянное MSK = UTC+3 без перехода на летнее время. А вот для коллег в Екатеринбурге тот же exp наступит в 17:06:40 (UTC+5). Поэтому в логах и тикетах лучше писать время в UTC или явно указывать пояс.

Ещё одна деталь из RFC 7519: при проверке exp и nbf допускается небольшой запас («leeway»), обычно не больше нескольких минут, на расхождение часов между серверами. Если токен «протух» на 20 секунд раньше, чем вы ожидали, сначала сверьте NTP.

Шаг 4. Проверяем подпись HS256

Декодирование ничего не доказывает. Подлинность гарантирует только подпись: HMAC-SHA256 от строки header.payload (в том виде, как она закодирована) с общим секретом.

const key = await crypto.subtle.importKey(
  'raw', new TextEncoder().encode('demo-secret-do-not-use'),
  { name: 'HMAC', hash: 'SHA-256' }, false, ['verify']
);
const ok = await crypto.subtle.verify(
  'HMAC', key, sigBytes, new TextEncoder().encode(`${header}.${payload}`)
);

Что я получил на этом примере:

  • правильный секрет → подпись верна; длина подписи 32 байта, как и положено SHA-256;
  • секрет wrong-secret → подпись неверна;
  • заменил в payload "role":"editor" на "role":"admin" и оставил старую подпись → неверна.

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

Пара правил из RFC 8725 (JWT Best Current Practices), которые стоит держать в голове:

  • сервер должен сам решать, какой алгоритм допустим, а не верить полю alg из токена. Токен с "alg":"none" не должен проходить там, где вы ждёте HS256;
  • для HS256 нужен длинный случайный секрет, а не слово из словаря: короткий секрет перебирают офлайн по одному перехваченному токену.

Как сделать это в инструменте

  1. Откройте base64decodetool.com/ru/jwt/ и вставьте токен в поле «Входная строка» (или нажмите «Пример текста»).
  2. Инструмент покажет Header и Payload в виде JSON, алгоритм и длину подписи в байтах (здесь 32 bytes). В строке статуса виден exp: время показывается в часовом поясе вашего браузера. Сообщения статуса пока на английском (Valid until / Expired).
  3. Для HS256/HS384/HS512 введите секрет в поле HMAC Secret Key (UTF-8 text): появится ✅ Signature Verified или ❌ Invalid Signature. Токены RS256/ES256 инструмент только декодирует, проверку по открытому ключу он не делает.

Всё выполняется в браузере через Web Crypto API, токен и секрет никуда не отправляются. И всё же боевые токены и секреты лучше никуда не вставлять: для отладки выпускайте тестовые.

Коротко

  • Header и payload — это Base64URL, а не шифрование. Читаются без ключа.
  • exp/iat — секунды UTC. Москва = UTC+3 круглый год (с 26.10.2014).
  • Доверять токену можно только после проверки подписи и разрешённого алгоритма на сервере.

Источники (проверено 18 ноября 2026)

Пример токена, секрет и пользователь «Иван» выдуманы для иллюстрации.

📰 Read the original article on Dev.to Security

Originally published by Dev.to Security. Aggregated on AIWithGhost for educational purposes — full credit and traffic to the original publisher.