Продвинутые возможности
Это руководство описывает расширенные возможности инструмента JWT Parser для опытных пользователей и разработчиков.
Управление историей
Автоматическое сохранение истории
Инструмент автоматически сохраняет разобранные токены в локальное хранилище браузера:
- Постоянное хранение: история сохраняется даже после перезапуска браузера
- Ориентация на приватность: данные остаются только в вашем браузере
- Автоматическая очистка: хранится не более 50 последних токенов
Операции с историей
- Загрузка из истории: нажмите на любой элемент, чтобы снова загрузить токен
- Очистка истории: удалите все сохраненные токены сразу
- Выборочная загрузка: выбирайте отдельные токены для повторного анализа
Информация в истории
Каждая запись истории показывает:
- Алгоритм: используемый алгоритм подписи
- Срок действия: когда токен истекает
- Метка времени: когда токен был разобран
- Предпросмотр токена: первые 50 символов токена
Возможности анализа токенов
Определение алгоритма
Инструмент автоматически определяет и показывает:
- Симметричные алгоритмы: HS256, HS384, HS512
- Асимметричные алгоритмы: RS256, RS384, RS512, ES256, ES384, ES512
- Алгоритм none: незащищенные токены (только для разработки)
Анализ срока действия
- Время истечения: преобразует Unix timestamp в читаемую дату и время
- Часовой пояс: показывает значения в вашем локальном часовом поясе
- Просроченные токены: явно указывает, истек ли токен
Анализ claims
- Стандартные claims: автоматически распознает стандартные claims RFC 7519
- Пользовательские claims: показывает claims, специфичные для приложения
- Вложенные объекты: обрабатывает сложные структуры payload
Функции копирования и экспорта
Структурированное копирование
При копировании результата вы получаете структурированный вывод вида:
Header:
{
"alg": "HS256",
"typ": "JWT"
}
Payload:
{
"sub": "1234567890",
"name": "John Doe",
"iat": 1516239022,
"exp": 1516242622
}
Signature:
SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c
Сценарии использования копирования
- Документация: включение в API-документацию
- Отладка: обмен результатами анализа с командой
- Тестирование: использование в автоматизированных тестах
- Отчеты: добавление в отчеты по безопасности и аудиту
Обработка ошибок и валидация
Проверка формата
Инструмент выполняет полную проверку формата:
- Проверка структуры: убеждается, что JWT состоит ровно из 3 частей, разделенных точками
- Проверка Base64URL: проверяет, что каждая часть является корректным base64url
- Проверка JSON: убеждается, что header и payload содержат валидный JSON
Сообщения об ошибках
Понятные и полезные сообщения включают:
- Неверный формат: конкретные подсказки по структуре JWT
- Ошибки разбора: подробности о причине сбоя
- Проблемы кодирования: помощь при ошибках base64url
Сценарии интеграции
Интеграция в процесс разработки
- Тестирование API: разбор токенов из ответов API
- Отладка аутентификации: анализ токенов во время разработки
- Code review: проверка структуры токенов в pull request
- Документация: подготовка примеров для API-документации
Интеграция с тестами
- Unit-тесты: использование разобранных данных в assertions
- Интеграционные тесты: проверка структуры токенов в сценариях тестирования
- Тесты безопасности: анализ токенов на потенциальные риски
Вопросы производительности
Обработка на стороне клиента
- Без сетевых запросов: весь разбор выполняется в браузере
- Быстрая обработка: для большинства токенов результат появляется мгновенно
- Экономное использование памяти: минимальная нагрузка на память
- Работа офлайн: инструмент работает без подключения к интернету
Работа с большими токенами
- Ограничения размера: поддерживаются токены в пределах памяти браузера
- Производительность: оптимизировано для типичных размеров JWT
- Обработка ошибок: слишком большие токены обрабатываются корректно
Совместимость с браузерами
Поддерживаемые браузеры
- Chrome: полная поддержка (рекомендуется)
- Firefox: полная поддержка
- Safari: полная поддержка
- Edge: полная поддержка
Необходимые возможности
- Local Storage: для функции истории
- Clipboard API: для функции копирования
- JSON Parsing: для анализа токенов
Лучшие практики безопасности
Работа с токенами
- Никогда не логируйте токены: не записывайте чувствительные токены в логи
- Безопасная среда: используйте инструмент только в безопасной приватной среде
- Регулярная очистка: регулярно удаляйте историю
- Контроль доступа: убедитесь, что инструмент доступен только авторизованным пользователям
Конфиденциальность данных
- Только локальное хранение: данные не отправляются на внешние серверы
- Изоляция браузера: данные остаются в вашем браузере
- Очистка при смене контекста: удаляйте данные при переключении задач
Устранение неполадок
Частые проблемы
- Токен не разбирается: проверьте формат и кодировку
- История не сохраняется: убедитесь, что браузер поддерживает локальное хранилище
- Копирование не работает: проверьте разрешения буфера обмена
- Проблемы с отображением: попробуйте обновить страницу
Советы по отладке
- Проверьте консоль: ищите ошибки JavaScript
- Проверьте формат: убедитесь, что структура токена корректна
- Тестируйте на примерах: используйте встроенный пример токена
- Очистите кэш: при необходимости очистите кэш браузера
Справочник API
Структура токена
interface ParsedJWT {
header: string; // Отформатированная JSON-строка
payload: string; // Отформатированная JSON-строка
signature: string; // Сырая подпись
}
interface JWTInfo {
algorithm: string; // Алгоритм подписи
type: string; // Тип токена
expires: string; // Время истечения
}
Структура истории
interface HistoryRecord {
id: string; // Уникальный идентификатор
token: string; // Полный JWT-токен
algorithm: string; // Алгоритм подписи
expires: string; // Время истечения
timestamp: number; // Время разбора
}
Что дальше
Ознакомьтесь с разделом Вопросы безопасности, чтобы изучить важные рекомендации, или перейдите к Примерам, чтобы увидеть реальные сценарии использования.