JSON Web Token состоит из трёх частей в Base64url через точку: заголовок с алгоритмом, payload с claims (id пользователя, роли, срок действия) и подпись. Первые две части показываются как отформатированный JSON. Поля exp, iat, nbf и auth_time переводятся в обычные даты, так что сразу видно, не из-за истёкшего ли токена API отвечает 401.
Как пользоваться
- Вставьте токен. Префикс
Bearerиз заголовка Authorization удаляется сам. - Посмотрите на статус: действителен, истёк или ещё не действует.
- Проверьте header и payload. Каждую часть можно скопировать как JSON.
- Для токенов HS256/384/512 введите секрет, чтобы проверить подпись. У токена из примера секрет
kural-secret.
Частые вопросы
Можно ли расшифровать JWT без секрета?
Да. Header и payload закодированы, а не зашифрованы, прочитать их может любой, у кого есть токен. Секрет нужен только чтобы убедиться, что токен не подделан и не изменён.
Что означают exp, iat и nbf?
exp: когда токен истекает. iat: когда выпущен. nbf (not before): раньше этого времени токен недействителен. Значения хранятся в Unix-времени, в секундах.
Почему мой токен не декодируется?
Он может быть обрезан или содержать пробелы и переносы строк. Ещё вариант: это зашифрованный JWE, у него пять частей вместо трёх.
Почему подпись RS256 не проверяется?
Для RS- и ES-алгоритмов нужен публичный ключ, такая проверка здесь не поддерживается. Токен при этом декодируется как обычно.
Токен куда-то отправляется?
Нет, декодирование и проверка подписи идут на вашем устройстве.