Генератор JWT-секрета

Секрет, которым можно подписывать

JWT с подписью HMAC настолько надёжен, насколько надёжен его секрет. Тот, кто его угадает, сможет выпускать токены, которым ваш сервер доверяет, а короткие или придуманные человеком секреты утилиты для взлома перебирают в первую очередь, причём офлайн. Этот генератор берёт ключ из криптографического генератора случайных чисел вашего браузера, нужной для алгоритма длины.

Какой длины должен быть секрет

• HS256 требует не менее 32 байт (256 бит). Более короткий ключ слабее хеша, с которым он используется, и многие библиотеки его отвергают.
• HS384 требует не менее 48 байт (384 бит).
• HS512 требует не менее 64 байт (512 бит).
• Длиннее можно. Ключ длиннее блока хеша сначала хешируется, поэтому свыше 64 байт для HS256 и 128 байт для HS512 выигрыша нет.

Как использовать секрет

• Не храните его в коде. Поместите его в переменную окружения или менеджер секретов. Кнопка «Копировать как .env» даёт готовую строку для вставки.
• Учитывайте кодировку. Одни библиотеки принимают секрет как текст, другие ждут сырые байты в Base64. Если вы декодируете его в байты, выберите здесь Base64 или Base64URL, а если библиотека использует строку как есть, надёжнее всего hex.
• Смена секрета разлогинит всех. Все токены, подписанные старым секретом, перестанут проходить проверку, поэтому планируйте ротацию заранее, а не делайте её в спешке.
• Проверьте до развёртывания. Кнопка «Проверить в JWT-декодере» открывает декодер с примером токена, подписанного этим секретом, чтобы вы увидели, как выглядит корректная подпись.

Часто задаваемые вопросы

Как сгенерировать секретный ключ JWT?

Выберите алгоритм, который использует ваш сервер, и секрет нужной длины будет создан сразу. Выберите кодировку, которую ожидает ваша библиотека, и скопируйте секрет или готовую строку .env. Нажмите «Создать заново», чтобы получить новый.

Какой длины должен быть JWT-секрет для HS256?

Не менее 32 байт, то есть 256 бит: 64 символа hex или 43 символа Base64URL. Более короткий секрет слабее хеша SHA-256, с которым он используется.

Безопасно ли генерировать секрет в браузере?

Да. Ключ берётся из crypto.getRandomValues, того же криптографического генератора, который браузеры используют для TLS, и создаётся на вашем устройстве. Он не отправляется на сервер, не журналируется и не сохраняется.

Что выбрать для JWT-секрета: hex или Base64?

Оба варианта содержат одни и те же случайные байты. Hex надёжнее, если ваша библиотека воспринимает секрет как обычный текст. Base64 или Base64URL подойдёт, если библиотека сначала декодирует секрет в сырые байты, как этого требуют многие параметры конфигурации.

Можно ли использовать пароль как JWT-секрет?

Это плохая идея. Пароли коротки и предсказуемы по сравнению с 32 случайными байтами, а любой, у кого есть один из ваших токенов, может подбирать секрет офлайн так быстро, как позволяет его оборудование.