Перейти к содержимому
ScanAnt

Что такое JWT (JSON Web Token)?

JSON Web Token (JWT) — компактная подписанная строка с утверждениями, например ID пользователя и ролью, которую сервер может проверить без обращения к базе. Токен подписан, но не зашифрован: тот, у кого он есть, может прочитать его содержимое.

Как это работает

JWT состоит из трёх частей в base64: заголовка с алгоритмом подписи, полезной нагрузки с утверждениями и подписи, сделанной секретом или закрытым ключом. Сервер пересчитывает подпись, чтобы убедиться, что нагрузку не меняли. Проблемы начинаются, когда сервер принимает алгоритм, указанный в самом токене (включая «none»), когда секрет короткий или угадываемый, когда токены не истекают или когда в нагрузку кладут чувствительные данные, считая их скрытыми. Утёкший токен можно повторно использовать до истечения срока.

// header.payload.signature
// payload (читается кем угодно):
{ "sub": "user_123", "role": "authenticated", "exp": 1767225600 }

// Проверка с зафиксированным алгоритмом
jwt.verify(token, secret, { algorithms: ["HS256"] });

Как понять, что это касается вашего сайта

  • Сервер проверяет токены без фиксации допустимого алгоритма или принимает alg «none».
  • Секрет подписи HS256 короткий, является словом из словаря или значением по умолчанию из учебника.
  • У токенов нет утверждения exp или они живут месяцами.
  • В нагрузке лежат пароли, персональные данные или внутренние флаги, которые клиент может править, а сервер им верит.
  • Токены хранятся в localStorage, откуда их может прочитать любой XSS.

Как исправить

  1. Проверяйте подпись при каждом запросе с зафиксированным алгоритмом и отклоняйте «none».

  2. Используйте длинный случайный секрет (32 байта и больше) или асимметричные ключи и храните их только на сервере. Если они раскрыты, перевыпустите.

  3. Задавайте короткий срок жизни (минуты) для токенов доступа и используйте refresh-токены, которые можно отозвать.

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

  5. Для сессий в браузере предпочитайте cookie с HttpOnly, Secure и SameSite. В Supabase никогда не раскрывайте JWT service_role — это токен с полным доступом.

Как ScanAnt это проверяет

БыстраяГлубокая

Бесплатная быстрая проверка декодирует строки, похожие на JWT, в вашем публичном JavaScript и сообщает о токене service_role, дающем полный доступ к базе. Токен показывается в маске и никогда не используется. В глубокой проверке для подтверждённого владельца выполняется офлайн-проверка слабого секрета подписи по короткому списку частых значений, без запросов к вашему серверу. Работа с токенами внутри серверного кода не проверяется.

Вопросы и ответы

Зашифрован ли JWT?

Нет. Он подписан, поэтому изменить его незаметно нельзя, но нагрузка лишь закодирована в base64. Считайте содержимое публичным.

Anon JWT в Supabase — секрет?

Нет. Anon-ключ — это JWT с ролью anon, и он задуман публичным. Секретом является JWT service_role.

Где хранить JWT в браузере?

Cookie с HttpOnly надёжнее всего от кражи через XSS. localStorage удобен, но доступен любому внедрённому скрипту.

Как разлогинить пользователя при JWT?

Короткий срок жизни плюс отзываемые refresh-токены или чёрный список на сервере. Токен без состояния нельзя отозвать до истечения срока.

Узнайте, касается ли это вашего сайта

Бесплатно для любого публичного сайта, без регистрации. Нужна полная или глубокая проверка? Выберите уровень на странице проверки.

Выбрать уровень проверки →