Хэши и пароли в браузере: что умеет Web Crypto и где нужна серверная проверка
- Какие операции Web Crypto доступны в браузере и при каких условиях они работают
- Как устроены digest, deriveBits и PBKDF2 и какие параметры проверить в коде
- Где заканчиваются возможности браузера: хранение ключей и модель угроз
- Чек-лист решений: что делать на клиенте, а что обязательно проверять на сервере
Вопрос звучит просто: можно ли хэшировать пароль прямо в браузере и не отправлять его на сервер в открытом виде? Web Crypto API действительно умеет считать хэши и производные ключи. Но между «умеет» и «безопасно закрывает задачу» лежит несколько ограничений, которые задаёт сама спецификация.
Короткий ответ: браузер может подготовить данные, но итоговую проверку пароля и учётной записи подтверждает сервер. Клиентский скрипт работает на машине пользователя, и всё, что он делает, можно обойти или подменить. Ниже — что именно даёт Web Crypto, какие параметры проверить в коде и где проходит граница ответственности.
Это редакционный чек-лист Deskforge, а не отчёт об испытании продукта и не клиентский кейс: шаги нужно адаптировать к вашему стеку и вашей модели угроз. Смежная тема — хешировать или шифровать: как хранить пароли и секреты, а варианты работ с сайтами собраны на странице контента и сайтов.
Что Web Crypto даёт браузеру и при каких условиях работает
Спецификация Web Cryptography Level 2 описывает JavaScript API для базовых криптографических операций: хэширования, генерации и проверки подписи, шифрования и расшифрования. Это низкоуровневый набор примитивов, а не готовое решение для аутентификации.
Первое условие — защищённый контекст. По документации MDN, Web Crypto API доступен только в защищённых контекстах (HTTPS) в некоторых или во всех поддерживающих браузерах. Если страница открыта по HTTP, часть методов просто не сработает. Проверить это в коде можно через window.isSecureContext.
Второе условие — набор алгоритмов. Спецификация не устанавливает обязательный набор алгоритмов, которые должны быть реализованы. Значит, конкретный браузер может поддерживать не всё, на что вы рассчитываете, и проверять доступность нужного алгоритма стоит явно, а не предполагать её по умолчанию.
Хэширование и производные ключи: digest, deriveBits и PBKDF2
Для простого хэша есть digest. Для получения ключевого материала из пароля — deriveBits. По документации MDN, deriveBits() возвращает Promise, который выполняется с ArrayBuffer, содержащим производные биты. Дальше вы сами решаете, как этот ArrayBuffer закодировать и передать.
Метод поддерживает те же алгоритмы производной, что и deriveKey(): ECDH, HKDF, PBKDF2 и X25519. Для пароля практический интерес представляет PBKDF2 — алгоритм, рассчитанный на медленное вычисление из пароля.
Три параметра стоит проверить в коде до того, как он уйдёт в продакшен. Первый — длина производных битов: для совместимости со всеми браузерами число должно быть кратно 8. Второй — число итераций: для PBKDF2 в deriveBits() промис отклоняется, если параметр iterations равен нулю, поэтому он должен быть задан явно и больше нуля.
Третий — соль. В примере MDN для PBKDF2 используется соль из 16 случайных байт, полученная через crypto.getRandomValues(), 100000 итераций и хэш SHA-256. Это параметры учебного примера, а не рекомендуемая универсальная конфигурация для продакшена: число итераций и длину соли подбирают под свою модель угроз и пересматривают со временем.
Где заканчиваются возможности браузера: хранение ключей и модель угроз
Спецификация не определяет конкретных механизмов хранения криптографических ключей. Без усилий автора по сохранению ключи, созданные через API, действительны только в течение текущей страницы — до события навигации. Если ключ нужен между переходами, его нужно явно сохранить, например через Indexed Database API.
Но и сохранение не делает ключ защищённым от всего. Спецификация не требует, чтобы реализация зануляла ключевой материал после исчезновения всех ссылок на него: он может оставаться доступным в памяти или хранилище устройства. Более того, она не гарантирует, что нижележащий ключевой материал не будет сохранён на диск, возможно, без шифрования.
Отдельный риск — внедрение сторонних скриптов. Спецификация предупреждает, что внедрение скрипта эквивалентно удалённому выполнению кода и может позволить вывести ключи или данные. Поэтому Content Security Policy и отсутствие недоверенных встроенных скриптов — не формальность, а часть модели угроз.
Почему низкоуровневые примитивы требуют осторожности
MDN прямо предупреждает: Web Crypto API предоставляет низкоуровневые криптографические примитивы, которые очень легко применить неправильно, а связанные с этим ловушки бывают очень тонкими. Это не значит, что браузерная криптография небезопасна как таковая. Это значит, что ответственность за корректность схемы лежит на разработчике.
Там же есть предупреждение о проектировании систем безопасности: ошибки в проектировании и реализации могут полностью обесценить защиту системы. Пример — соль, сгенерированная не через криптостойкий генератор, или нулевое число итераций: код формально работает, а защита уже не та, на которую вы рассчитывали.
Чек-лист решений: что делать в браузере, а что проверять на сервере
Ниже — порядок проверки, который можно пройти по своему коду. Это редакционная помощь читателю, а не отчёт об испытании продукта и не клиентский кейс.
- Итоговую проверку пароля и учётной записи подтверждает сервер, а не клиентский скрипт. Клиентская проверка — удобство, не рубеж безопасности.
- Страница открыта в защищённом контексте: window.isSecureContext истинно, сайт работает по HTTPS.
- Соль для производной ключа генерируется через crypto.getRandomValues() — проверьте вызов для массива соли перед deriveBits.
- Длина производных битов кратна 8 — аргумент length в deriveBits делится на 8 без остатка.
- Для PBKDF2 задано ненулевое число итераций — параметр больше нуля и задан явно.
- Ключи, созданные в браузере, сохраняются между переходами только через явное хранилище, например IndexedDB; без него ключ живёт в пределах текущей страницы.
- Есть Content Security Policy и нет недоверенных встроенных скриптов.
Условный пример: форма входа считает PBKDF2 в браузере и отправляет производные биты на сервер. Если сервер принимает эти биты как сам пароль и не проверяет их по своей сохранённой записи, то клиентский скрипт фактически становится проверяющим звеном. Подмена скрипта или обход страницы ломает всю схему. Поэтому серверная проверка остаётся обязательной.