Что такое 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.
Как исправить
Проверяйте подпись при каждом запросе с зафиксированным алгоритмом и отклоняйте «none».
Используйте длинный случайный секрет (32 байта и больше) или асимметричные ключи и храните их только на сервере. Если они раскрыты, перевыпустите.
Задавайте короткий срок жизни (минуты) для токенов доступа и используйте refresh-токены, которые можно отозвать.
Никогда не кладите секреты в нагрузку и не доверяйте ролям из токена, на которые пользователь может повлиять, без проверки на сервере.
Для сессий в браузере предпочитайте 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-токены или чёрный список на сервере. Токен без состояния нельзя отозвать до истечения срока.
Связанные термины
Утечка API-ключа
Секретный ключ попал в публичный код, репозиторий или сборку.
Читать →IDOR
Подстановка другого ID в запрос открывает чужие данные.
Читать →CORS
Каким сайтам браузер разрешает читать ответы вашего API.
Читать →Проверьте свой сайт
Утёкшие ключи Stripe, OpenAI, AWS и паролей баз в публичном JavaScript.
Открыть подходящую проверку →
Узнайте, касается ли это вашего сайта
Бесплатно для любого публичного сайта, без регистрации. Нужна полная или глубокая проверка? Выберите уровень на странице проверки.
Выбрать уровень проверки →