Одного jwt.decode(token) вместо jwt.verify или одного process.env.JWT_SECRET || 'secret' достаточно, чтобы кто угодно мог войти под любым пользователем. Этот навык находит эти и ещё десять ошибок JWT до публикации и объясняет, как исправить каждую из них.

Ваш агент запускает сканер для кода JavaScript/TypeScript, Python, Go, Java, PHP и Ruby, а также файлов зависимостей. Сканер знает реальные API библиотек jsonwebtoken, jose, PyJWT, python-jose, golang-jwt, jjwt, java-jwt, Nimbus, firebase/php-jwt и ruby-jwt, пропускает комментарии, строки и тесты и отслеживает значение переменной ключа в пределах одного файла. Он не отмечает обычное использование с проверкой: jwt.verify с algorithms, PyJWT decode с algorithms и ключом, ParseWithClaims с функцией получения ключа, проверяющей метод подписи. Сканер никогда не запускает ваш код. Он возвращает BLOCK, REVIEW или NOT FLAGGED с указанием файла, строки, причины и более безопасного подхода. Секреты никогда не выводятся.

Что проверяется

BLOCK (исправить до публикации)

• W01: чтение токенов без проверки подписи (jwt.decode, decodeJwt, verify_signature False, get_unverified_claims, ParseUnverified, java-jwt JWT.decode, JWT.decode(token, key, false), ручное декодирование полезной нагрузки из base64) в функции, которая вообще не проверяет токен

• W02: алгоритм none ('none' в списке алгоритмов, UnsecuredJWT, SigningMethodNone, Algorithm.none(), jjwt unsecured() и parseClaimsJwt, Nimbus PlainJWT)

• W03: выбор алгоритма самим токеном (PyJWT или python-jose decode без algorithms, get_default_algorithms(), header['alg'])

• W04: жёстко заданные ключи подписи, передаваемые напрямую или через переменную вроде $key = '...', и резервные секреты вроде process.env.JWT_SECRET || 'dev-secret'

REVIEW (проверить до выпуска)

• W11: токены без срока действия или со сроком более 30 дней

• W12: токены в localStorage или sessionStorage

• W13: файлы cookie с токенами и сеансами без HttpOnly, Secure или SameSite, а также токены в document.cookie

• W14: ignoreExpiration, отключённый verify_exp, пропущенная проверка утверждений токена, допустимое отклонение времени более 5 минут

• W15: принятие токенов JWKS (SSO) без проверки аудитории и издателя

• W16: токены в URL и строках запроса

• W17: jsonwebtoken до версии 9, PyJWT до 2.4.0, python-jose 3.3.0 или старше, firebase/php-jwt до 6, golang-jwt до v4.5.2 / v5.2.2, dgrijalva/jwt-go

• W18: verify без фиксированного списка алгоритмов, функции получения ключа golang-jwt без проверки метода, HS и RS в одном списке

Что входит в комплект

• Сканер (Python 3.9+, только стандартная библиотека)

• Руководство по правилам с объяснением причин и более безопасным подходом для каждого правила

• Небезопасный и безопасный примеры проекта (Node API, браузерный клиент, сервис Python, сервис Java), а также настоящий отчёт сканера по небезопасному примеру

Ограничения

Код анализируется как текст, без компилятора: значения отслеживаются в пределах одного файла, поэтому ключи или параметры, определённые в другом файле, не видны. Другие библиотеки JWT (jwt-decode в браузере, lcobucci/jwt, Authlib, jwx, .NET) и lock-файлы не проверяются. NOT FLAGGED не является гарантией безопасности.

Содержимое

Один ZIP-архив с 22 файлами: SKILL.md, сканер в scripts/ (5 файлов Python), references/rules.md (каждое правило с объяснением причин и более безопасным подходом) и examples/ (14 файлов примеров и report.md, настоящий результат работы сканера на небезопасном примере).

Как использовать: Это навык для агента: папка с файлом SKILL.md и скриптами Python, которые может запускать ИИ-агент для программирования, например Claude Code, Cursor или Codex CLI. Распакуйте архив в папку навыков вашего агента (для Claude Code: ~/.claude/skills/), затем попросите агента проверить проект. Скрипты также можно запускать отдельно с Python 3.9 или новее, без установки дополнительных пакетов. Они только читают ваши файлы: не подключаются к сети и ничего никуда не отправляют.