Базовое Использование

Это руководство проведет вас через основные шаги по использованию инструмента JWT Parser для анализа JSON Web Token.

Шаг 1: Откройте инструмент

Перейдите к инструменту JWT Parser со страницы основных инструментов или сразу по URL /jwt-parser.

Шаг 2: Введите ваш JWT-токен

Способ 1: Ручной ввод

1. Нажмите на текстовое поле "JWT Token"
2. Вставьте или введите ваш JWT-токен
3. Инструмент автоматически разберет токен по мере ввода

Способ 2: Загрузить пример

1. Нажмите кнопку "Load Example"
2. Пример JWT-токена будет загружен автоматически
3. Это удобно для тестирования и знакомства с возможностями инструмента

Шаг 3: Просмотрите результаты разбора

После ввода корректного JWT-токена вы увидите три основных раздела:

Информация заголовка

• Алгоритм: Используемый алгоритм подписи (например, HS256, RS256)
• Тип: Тип токена (обычно "JWT")
• Дополнительные claims: Любые другие claims заголовка

Данные payload

• Стандартные claims: iss, sub, aud, exp, nbf, iat, jti
• Пользовательские claims: Любые данные, специфичные для приложения
• Срок действия: Когда токен истекает (если указано)

Подпись

• Сырая подпись: Подпись в кодировке base64url
• Примечание о проверке: Напоминание о том, что этот инструмент не проверяет подписи

Шаг 4: Используйте дополнительные возможности

Копирование результатов

1. Нажмите кнопку "Copy Result"
2. Разобранная информация будет скопирована в буфер обмена
3. Вставьте ее в предпочитаемый текстовый редактор или документацию

Очистка содержимого

1. Нажмите "Clear All", чтобы удалить все содержимое
2. Начните заново с новым токеном

Просмотр истории

• Ранее разобранные токены отображаются в разделе истории
• Нажмите на любой элемент истории, чтобы снова загрузить этот токен
• Используйте "Clear History", чтобы удалить все сохраненные токены

Понимание вывода

Пример заголовка

{
  "alg": "HS256",
  "typ": "JWT"
}

Пример payload

{
  "sub": "1234567890",
  "name": "John Doe",
  "iat": 1516239022,
  "exp": 1516242622
}

Объяснение распространенных claims

• sub (Subject): Субъект токена
• iat (Issued At): Время выпуска токена
• exp (Expiration): Время истечения токена
• aud (Audience): Предполагаемый получатель токена
• iss (Issuer): Кто выпустил токен

Обработка ошибок

Неверный формат

Если вы введете неверный формат JWT, вы увидите следующее сообщение об ошибке:

• "Invalid JWT format. JWT should have 3 parts separated by dots."

Ошибки разбора

Если токен не удается разобрать, вы увидите:

• "Failed to parse JWT token"

Распространенные проблемы

• Отсутствуют точки: JWT должен содержать ровно 2 точки, разделяющие 3 части
• Неверный base64: Каждая часть должна быть корректно закодирована в base64url
• Некорректный JSON: Заголовок и payload должны быть валидным JSON

Рекомендации

Безопасность

• Используйте этот инструмент только с тестовыми токенами или токенами, которые принадлежат вам
• Никогда не делитесь чувствительными production-токенами
• Используйте инструмент только в безопасных и приватных окружениях

Рабочий процесс разработки

1. Генерируйте тестовые токены в вашей среде разработки
2. Разбирайте их, чтобы проверить структуру и claims
3. Используйте результаты для отладки проблем аутентификации
4. Очищайте историю при переключении между проектами

Управление токенами

• Храните записи о важных тестовых токенах
• Используйте функцию истории для часто анализируемых токенов
• Регулярно очищайте историю для сохранения конфиденциальности

Следующие шаги

Теперь, когда вы понимаете основы, изучите Расширенные возможности, чтобы узнать о более сложных сценариях использования, и прочитайте Соображения безопасности для безопасной работы с токенами.