JWT

Похожие

Что такое Декодирование, Проверка и Генерация JWT?

Варианты использования

• Онлайн-декодирование JWT: быстрое разделение токена при отладке входа OAuth 2.0 / OIDC для проверки алгоритма Header и Claims Payload
• Проверка подписей JWT: используйте секретный ключ / публичный ключ для проверки подписей токенов в реальном времени и определения, является ли 401 'плохой подписью', 'истекшим' или 'несоответствием алгоритма'
• Генерация тестовых JWT во время интеграции: выпустите JWT в браузере с тестовой парой ключей, без необходимости временно изменять код backend для выдачи токена
• Конвертация PEM ↔ JWK: OIDC IdP дал вам JWK, но серверу нужен PEM (или наоборот) — конвертируйте на месте вместо написания скрипта OpenSSL
• Диагностика 401 Unauthorized: пошагово проверяйте истечение срока, соответствие alg шлюзу, соответствие ключа и форматирование PEM
• Сравнение RS256 и PS256: многие провайдеры OIDC по умолчанию используют RS256, тогда как AWS SigV4 предпочитает PS256 — переключайте алгоритмы с той же парой ключей RSA и сравнивайте результаты
• Изучение внутренностей JWT: измените alg, отредактируйте Payload, переключите ключ в браузере и наблюдайте, как подпись ломается в реальном времени — намного быстрее, чем чтение RFC

Как использовать

1. Вставьте или введите токен: поместите строку JWT в поле ввода; инструмент автоматически разделит Header, Payload и Signature и отобразит каждый как отформатированный JSON
2. Выберите алгоритм: переключайтесь между HS256 / RS256 / ES256 / PS256 / EdDSA; инструмент выводит из Header.alg и помечает любые несоответствия
3. Импортируйте ключ: вставьте секретный ключ HMAC, строку PEM или JSON JWK; для асимметричных алгоритмов нажмите 'Сгенерировать пару ключей', чтобы немедленно получить тестовый ключ
4. Проверьте или подпишите заново: в режиме Decode проверяйте публичным ключом и смотрите '✅ подпись действительна / ❌ подпись недействительна'; в режиме Encode редактируйте Claims и подписывайте приватным ключом, чтобы создать новый токен

Output Example

A real MP3 file encoded to a Data URI — copy-ready:

Header (Base64URL): eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9
Payload (Base64URL): eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkphbmUgRG9lIiwiaWF0IjoxNzE2MjM5MDIyfQ
Signature: kZJfaYjK3iCkVFL5EL9zGRZ5SmD8_x2h6B5c7pVFfVGo

Функции

• Декодирование + Проверка + Генерация в одном месте: вставьте токен, чтобы разделить Header/Payload/Signature, переключите алгоритм и ключ для проверки подписи, отредактируйте Claims и подпишите заново, чтобы создать новый токен — покрывает полную цепочку устранения неполадок JWT
• Поддерживаются все 13 алгоритмов: HS256/HS384/HS512 (HMAC), RS256/RS384/RS512 (RSA-PKCS1-v1_5), ES256/ES384/ES512 (ECDSA), PS256/PS384/PS512 (RSA-PSS), EdDSA — покрывает OAuth 2.0, OIDC, JWS, API-шлюзы и корпоративные SSO
• Форматы PEM и JWK: ключи RSA, ECDSA и Ed25519 принимают строки PEM (с заголовками -----BEGIN PUBLIC KEY-----) и JSON JWK (поля kid/kty/n/e) — вставьте напрямую вывод OIDC /.well-known/jwks.json
• Множество форм ввода секретного ключа HMAC: необработанная строка UTF-8, hex-байты или кодированный Base64/Base64URL — переключайте одним кликом, чтобы никогда не случалось 'выглядит так же, но подпись не проходит'
• Автоматическая генерация пар ключей: пары ключей RSA-2048, RSA-4096, P-256, P-384 и Ed25519 генерируются в браузере, представлены в форматах PEM и JWK для немедленного использования в тестах
• Семантическое выделение Claims: exp / iat / nbf автоматически конвертируются в читаемое время с выделенным статусом истек / еще-не-действителен / выдан; alg / typ / kid в Header помечены индивидуально
• 100% на стороне клиента, нулевая загрузка: каждый парсинг, проверка и подпись работают через нативный Web Crypto API браузера — токены, ключи и payload никогда не покидают браузер, следуя принципу безопасности 'никогда не вставляйте production-токены в случайные онлайн-инструменты'
• Копирование одним кликом: Header, Payload, Signature и только что сгенерированный токен копируются независимо для документации, тикетов и команд curl

Примеры кода

const crypto = require('node:crypto')

function b64url(input) {
  return Buffer.from(input)
    .toString('base64')
    .replace(/\+/g, '-')
    .replace(/\//g, '_')
    .replace(/=+$/, '')
}

function hmacSign(data, secret) {
  return b64url(crypto.createHmac('sha256', secret).update(data).digest())
}

function sign(payload, secret) {
  const header = b64url(JSON.stringify({ alg: 'HS256', typ: 'JWT' }))
  const body = b64url(JSON.stringify(payload))
  const signature = hmacSign(`${header}.${body}`, secret)
  return `${header}.${body}.${signature}`
}

function verify(token, secret) {
  const [h, p, s] = token.split('.')
  const expected = hmacSign(`${h}.${p}`, secret)
  const a = Buffer.from(s)
  const b = Buffer.from(expected)
  return a.length === b.length && crypto.timingSafeEqual(a, b)
}

const SECRET = 'my-super-secret-key'
const payload = { userId: 42, role: 'admin', exp: Math.floor(Date.now() / 1000) + 3600 }
const token = sign(payload, SECRET)

console.log(token)
console.log(verify(token, SECRET))       // true
console.log(verify(token, 'wrong-key'))  // false

<!doctype html>
<html>
  <body>
    <pre id="out"></pre>
    <script>
      const out = document.getElementById('out')

      const b64url = buf =>
        btoa(String.fromCharCode(...new Uint8Array(buf)))
          .replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '')

      const b64urlStr = str => b64url(new TextEncoder().encode(str))

      async function sign(payload, secret) {
        const header = b64urlStr(JSON.stringify({ alg: 'HS256', typ: 'JWT' }))
        const body = b64urlStr(JSON.stringify(payload))
        const data = new TextEncoder().encode(`${header}.${body}`)

        const key = await crypto.subtle.importKey(
          'raw',
          new TextEncoder().encode(secret),
          { name: 'HMAC', hash: 'SHA-256' },
          false,
          ['sign']
        )

        const sig = await crypto.subtle.sign('HMAC', key, data)
        return `${header}.${body}.${b64url(sig)}`
      }

      ;(async () => {
        const token = await sign({ user: 'alice', role: 'admin' }, 'browser-demo-secret')
        out.textContent = token
      })()
    </script>
  </body>
</html>

import { jwtVerify, importSPKI } from 'jose'
import { readFile } from 'node:fs/promises'

const token = 'eyJhbGciOiJSUzI1NiIsImtpZCI6IjEifQ.payload.signature'
const publicKeyPem = await readFile('public.pem', 'utf8')

try {
  const { payload, protectedHeader } = await jwtVerify(
    token,
    await importSPKI(publicKeyPem, 'RS256'),
    {
      issuer: 'https://idp.example.com',
      audience: 'my-app',
      algorithms: ['RS256'],     // critical: algorithm whitelist blocks alg:none and HS256-substitution attacks
    }
  )
  console.log('alg =', protectedHeader.alg)
  console.log('sub  =', payload.sub)
} catch (err) {
  console.error('verify failed:', err.code, err.message)
  // common: ERR_JWT_EXPIRED / ERR_JWS_INVALID / ERR_JWS_SIGNATURE_VERIFICATION_FAILED
}

import jwt

token = 'eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxMjM0In0.SflKxw'

# Parse (no signature check, just look at Header and Payload)
print(jwt.get_unverified_header(token))
# {'alg': 'HS256', 'typ': 'JWT'}

print(jwt.decode(token, options={'verify_signature': False}))
# {'sub': '1234'}

# Full verification
claims = jwt.decode(
    token,
    'my-super-secret-key',
    algorithms=['HS256'],
    audience='my-app',
    issuer='my-service',
)
print(claims['sub'])

Сравнение 5 типов алгоритмов подписи JWT: какой выбрать?

JWT — это не один алгоритм, а 5 семейств алгоритмов с разными компромиссами по ключам, производительности, безопасности и совместимости. Сначала определите сценарий, а затем выбирайте алгоритм — это поможет избежать многих проблем.

Best Practices

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

Устранение неполадок

Privacy & Security

Эта рабочая среда JWT работает на 100% в вашем браузере, поддерживается нативным Web Crypto API браузера. Токен, который вы вставляете, Header, Payload, Signature, секретный ключ HMAC, любые приватные ключи RSA/ECDSA, любые сгенерированные пары ключей и каждый расчет подписи/проверки остаются на вашем устройстве — они никогда не отправляются на сервер, никогда не логируются, никогда не анализируются и никогда не кэшируются. Страница может использоваться офлайн после загрузки. Лучшая практика: никогда не вставляйте долгоживущие production-токены или production-приватные ключи в какой-либо онлайн-инструмент, включая этот. Этот инструмент подходит для отладки, тестирования интеграции, обучения и генерации тестовых токенов — production-секретные ключи и приватные ключи должны обрабатываться в контролируемой локальной среде.

Supported Video Formats

Authoritative References

• IETFRFC 7519: JSON Web Token (JWT)
• IETFRFC 7515: JSON Web Signature (JWS)
• IETFRFC 7517: JSON Web Key (JWK)
• Auth0JWT.io — official debugger and library index
• OWASPOWASP JSON Web Token Cheat Sheet
• IETFJOSE working group overview