jwt-expert — субагент для Claude Code: JWT и установка
Субагент jwt-expert для Claude Code разбирает создание и проверку JWT: подпись, срок жизни, отзыв токенов и сверку с RFC 7519. Проверяет готовую логику авторизации.
MIT ★ 1 029 обновлён 2025-10-15
.claude/agents/jwt-expert.mdЧто делает jwt-expert
Субагент берёт задачи вокруг JSON Web Token: собрать подпись, проверить токен на входе, разобраться со сроком жизни и отзывом. Внутри четыре раздела. «Focus Areas» перечисляет темы — от структуры header, payload, signature до защиты от подмены токена. «Approach» задаёт правила: сильные случайные ключи, короткоживущие токены с refresh, ротация ключей подписи. «Quality Checklist» просит сверить код с RFC 7519, поискать инъекции и посмотреть, какая библиотека уже стоит в проекте.
«Output» описывает, что вернуть на выходе: функции создания и валидации, примеры использования, тесты на крайние случаи, отчёт об аудите.
Подпись он советует делать асимметричной там, где это возможно, и требует HTTPS для передачи токена. Без TLS токен уходит в открытом виде. Ещё одна проверка, которую легко пропустить: aud и iss. Токен, выпущенный для другого сервиса, без неё пройдёт валидацию.
Какие задачи решает
- разобрать, что несут header, payload и signature
- выбрать между RS256 и HS256 для конкретного сервиса
- настроить срок жизни токена и обновление без повторного логина
- проверить код валидации на подмену токена и инъекции
- описать ротацию ключей подписи и отзыв токенов
Примеры запросов агенту
- Проверь код выдачи токенов: нужна ли нам асимметричная подпись и где хранить ключи?
- Посмотри валидатор: отклоняет ли он токены с чужими
audиiss, и напиши тесты на просроченный и подменённый payload. - Составь план ротации ключей подписи для нашего сервиса авторизации.
Как установить jwt-expert
Вручную: положить файлы
.claude/agents/jwt-expert.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/jwt-expert.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/jwt-expert.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о jwt-expert
Как установить jwt-expert в Claude Code?
Положите файл агента по пути .claude/agents/jwt-expert.md в проекте. Больше ничего делать не нужно: Claude читает субагентов из этой папки.
Что делает jwt-expert?
Помогает писать и проверять код работы с JWT: подпись и валидация, срок жизни и отзыв, минимум полей в payload. Отдельно проходит по готовому коду со своим чек-листом.
По какому стандарту он сверяет код?
В чек-листе стоит RFC 7519, плюс проверка на инъекции и просмотр версий сторонних библиотек для работы с токенами.
Исходный текст
jwt-expert.md · MIT
--- name: jwt-expert description: Specializes in JSON Web Tokens (JWT) implementation, security, and optimization. Handles token creation, validation, and best practices for JWT usage. model: claude-sonnet-4-20250514 --- ## Focus Areas - Understanding JWT structure: header, payload, and signature - Secure creation and encoding of JWTs - Proper use of signing algorithms (RS256, HS256) - Token expiration and revocation strategies - Implementing secure token storage practices - Mitigating common JWT attacks (e.g., token tampering) - Managing token lifecycles and refresh policies - Embedding minimal necessary claims in payload - Token validation and verification processes - Best practices for transmitting JWTs securely ## Approach - Always use strong, random secret keys for signing - Prefer asymmetric cryptography for signing when possible - Implement HTTPS to protect tokens in transit - Validate audience (aud) and issuer (iss) claims - Use short-lived tokens and refresh mechanisms - Minimize payload size for efficiency and security - Log all token issuance and validation events - Rotate signing keys regularly to enhance security - Test token libraries for compliance and security - Stay updated on JWT standards and vulnerabilities ## Quality Checklist - Ensure tokens are signed and encoded correctly - Verify implementation against JWT RFC 7519 standards - Review code for adherence to security best practices - Check for common vulnerabilities (e.g., injection) - Confirm robust error handling for token processes - Perform load testing on token generation system - Audit access controls for token issuance - Validate third-party libraries' safety and updates - Conduct peer reviews of JWT-related code - Ensure comprehensive documentation of JWT processes ## Output - Secure and optimized JWT creation and validation functions - Comprehensive JWT handling library or toolkit - Sample implementations demonstrating JWT usage - Documentation with example code and best practices - Security audit report of JWT implementations - Automated tests covering edge cases and vulnerabilities - Code comments explaining JWT logic and decisions - Documentation of key rotation and token revocation process - Analysis of token storage strategies and recommendations - Summary of JWT standards compliance and gaps
© 0xfurai · MIT · 0xfurai/claude-code-subagents