Хеширование паролей в PHP: Argon2id, bcrypt и безопасная миграция
Узнайте, как безопасно хешировать пароли в PHP с помощью Argon2id и bcrypt, выбирать надежные параметры, проверять учетные данные и переносить существующие хеши без принудительного сброса паролей.
Хэширование паролей в PHP: Argon2id, bcrypt и безопасная миграция
Хранение паролей — это один из важнейших аспектов безопасности веб-приложений. Нарушение базы данных не должно сразу же приводить к раскрытию учётных данных пользователей, но слабое хэширование паролей может сделать украденные хэши лёгкой мишенью для атак.
PHP включает встроенные функции для хэширования, проверки и обновления паролей. Задача заключается в выборе правильного алгоритма, его настройке для вашей инфраструктуры и миграции существующих учётных записей без нарушения аутентификации.
Для новых приложений Argon2id обычно является предпочтительным выбором, если ваша сборка PHP его поддерживает. Bcrypt остаётся практичным вариантом для обеспечения совместимости. Оба должны использоваться через API паролей PHP, а не через самодельную криптографию.
Это руководство охватывает реализацию, выбор параметров, миграцию устаревших систем и распространённые ошибки.
Почему SHA-256 не подходит для хранения паролей
SHA-256 разработан для высокой скорости. Это делает его полезным для проверок целостности, но неподходящим для хранения паролей в одиночку: злоумышленник с украденными хэшами может быстро протестировать множество предположений о паролях.
Специальные алгоритмы хэширования паролей намеренно потребляют больше ресурсов. Argon2id может требовать значительного объёма памяти, а также времени процессора, что делает крупномасштабное угадывание более дорогостоящим.
Безопасная система хранения требует уникального случайного солевого раствора, настраиваемого коэффициента сложности и способа увеличения коэффициента сложности по мере улучшения оборудования. PHP's password_hash() автоматически генерирует и хранит необходимую информацию о солевом растворе.
OWASP Password Storage Cheat Sheet рекомендует адаптивное хэширование паролей вместо быстрых универсальных хэш-функций.
Argon2id vs bcrypt: какой из них выбрать?
| Функция | Argon2id | Bcrypt |
|---|---|---|
| Основная защита | Затраты на память и вычисления | Затраты на вычисления |
| Требует много памяти | Да | Нет |
| Настраиваемые параметры | Память, итерации, параллелизм | Коэффициент сложности |
| Ограничение на ввод пароля | Нет ограничения в 72 байта, как у bcrypt | 72 байта |
| Доступность в PHP | Зависит от сборки | Широко доступно |
| Лучшее соответствие | Предпочтительно для нового хранения паролей | Совместимость и устаревшие системы |
Argon2id разработан для противодействия атакам, которые извлекают выгоду из масштабно параллельного оборудования. Bcrypt всё ещё является законным алгоритмом адаптивного хэширования паролей, но его ограничение на ввод требует осторожности: он рассматривает не более первых 72 байтов, а не символов.
Не предполагайте, что PASSWORD_DEFAULT выбирает Argon2id. В документации PHP password_hash в настоящее время указан bcrypt как алгоритм по умолчанию. PHP 8.4 повысил стандартную стоимость bcrypt с 10 до 12, что иллюстрирует, почему полагаться на имплицитные параметры может изменить производительность приложения после обновлений.
Шаг 1: Проверьте поддержку Argon2id
Argon2id не обязательно доступен в каждой хостинг-среде. Проверьте среду выполнения перед его выбором:
<?php
declare(strict_types=1);
if(in_array('argon2id', password_algos(), true)) {
echo 'Argon2id is available';
} else {
echo 'Argon2id is not available';
}
Доступность зависит от того, как был собран PHP. Не предполагайте, что обновление версии PHP автоматически включает Argon2id.
Шаг 2: Хэшируйте пароль с помощью Argon2id
OWASP документирует несколько приемлемых базовых конфигураций. Одна из них использует 19 МиБ памяти, две итерации и параллелизм равный одному. PHP выражает memory_cost в КиБ, поэтому 19 МиБ равны 19 * 1024 КиБ.
<?php
declare(strict_types=1);
$options = [
'memory_cost' => 19 * 1024,
'time_cost' => 2
];
$password = 'example-user-password';
$hash = password_hash(
$password,
PASSWORD_ARGON2ID,
$options
);
Параметр параллелизма threads поддерживается некоторыми бэкэндами Argon2, включая libargon2, но не каждой сборкой PHP. Если поддерживается, значение равное единице соответствует этой базовой конфигурации; пропуск этого параметра более портативен. Проконтролируйте фактическую конфигурацию.
Полученный закодированный хэш включает идентификатор алгоритма, параметры и солевый раствор. Нет необходимости сохранять эти значения в отдельных колонках базы данных. Колонка VARCHAR(255) является разумным началом для современных хэшей паролей, при условии, что она хранит все закодированное значение.
Это базовые параметры, а не универсальная конфигурация для производства. Тестируйте задержку и использование памяти при реалистичном уровне одновременной аутентификации.
Шаг 3: Правильно проверьте учётные данные

Поскольку каждый хэш пароля использует случайный солевый раствор, создание нового хэша и сравнение строк не сработает. Используйте password_verify():
<?php
declare(strict_types=1);
$submittedPassword = (string)($_POST['password'] ?? '');
$storedHash = (string)$user['password_hash'];
if(!password_verify($submittedPassword, $storedHash)) {
// Reject authentication without disclosing account existence.
return;
}
// The password is valid. Continue with secure session handling.
Документация PHP указывает, что password_verify() защищен от атак на основе времени выполнения. Он считывает алгоритм и параметры сложности из сохраненного хэша.
Проверка пароля не заменяет ограничение логина, безопасные сессии, HTTPS, надлежащую обработку ошибок или многофакторную аутентификацию.
Шаг 4: Обновите существующие хэши паролей во время входа в систему
password_needs_rehash() обнаруживает, когда сохраненный хэш использует устаревший алгоритм или параметры. Это позволяет постепенно мигрировать без принуждения каждого активного пользователя сбрасывать свой пароль.
<?php
declare(strict_types=1);
$options = [
'memory_cost' => 19 * 1024,
'time_cost' => 2
];
if(password_verify($submittedPassword, $storedHash)) {
if(password_needs_rehash(
$storedHash,
PASSWORD_ARGON2ID,
$options
)) {
$newHash = password_hash(
$submittedPassword,
PASSWORD_ARGON2ID,
$options
);
// Persist with a prepared statement.
// Prefer a conditional UPDATE to avoid overwriting
// a newer hash from a concurrent request.
}
// Finish authentication and rotate the session identifier.
}
Перехэшируйте только после успешной проверки представленного пароля. Условное обновление может обеспечить, что сохраненный хэш всё ещё соответствует значению, которое было только что проверено. Например, обновите хэш пароля только там, где совпадают идентификатор пользователя и старый хэш.
См. PHP password_needs_rehash() для подробностей API.
Шаг 5: Миграция устаревших хэшей MD5 или SHA-1
Старые приложения могут содержать MD5, SHA-1 или пользовательские форматы паролей. Такие хэши не всегда могут быть проверены с помощью password_verify().
Миграция должна выполняться в контролируемой последовательности:
- Определите устаревший формат с помощью доверенных метаданных или однозначного, задокументированного формата.
- Проверьте представленный пароль с использованием исходной устаревшей схемы только для учётных записей, которые всё ещё требуют этого.
- После успешной проверки немедленно создайте современный хэш с помощью
password_hash(). - Замените сохранённый устаревший хэш с помощью безопасного обновления базы данных.
- Отключите устаревшую проверку, когда миграция будет завершена.
Не угадывайте алгоритм только по длине хэша, когда возможно несколько форматов. Не пытайтесь расшифровать хэши паролей: хэширование — это не шифрование.
Для учётных записей, которые никогда не входа в систему, рассмотрите политику сброса пароля вместо хранения слабых хэшей вечно. Не вводите небезопасный резервный путь, который принимает слабые хэши для новых зарегистрированных пользователей.
Шаг 6: Проконтролируйте хэширование на вашей инфраструктуре
Правильные параметры стоимости зависят от вашего оборудования, объёма одновременных входов и требований к задержке.
<?php
declare(strict_types=1);
$options = [
'memory_cost' => 19 * 1024,
'time_cost' => 2
];
$start = hrtime(true);
$hash = password_hash(
'benchmark-password',
PASSWORD_ARGON2ID,
$options
);
$milliseconds = (hrtime(true) - $start) / 1_000_000;
echo round($milliseconds, 2) . ' ms';

Выполняйте это только в контролируемой среде, а не в качестве публичного веб-конечного пункта. Измеряйте также проверку и повторяйте при репрезентативной нагрузке. Настройка, которая выглядит быстро в изоляции, может истощить ОЗУ, когда многие запросы поступают вместе.
OWASP рекомендует балансировать безопасность с оперативными возможностями и обычно держать индивидуальные операции хэширования ниже одной секунды.
Распространённые ошибки хэширования паролей
Добавление фиксированного солевого раствора вручную. PHP уже генерирует безопасные солевые растворы для своего API паролей. Фиксированный солевый раствор устраняет важную защиту.
Использование необработанных MD5, SHA-1 или SHA-256. Эти алгоритмы слишком быстры для хранения паролей в одиночку.
Игнорирование ограничения в 72 байта у bcrypt. Многобайтовые UTF-8 символы могут достичь этого ограничения раньше, чем ожидают пользователи.
Выбор экстремальных настроек стоимости. Чрезмерные требования к памяти или процессору могут создать риск отказа в обслуживании в точках аутентификации.
Регистрация представленных паролей. Избегайте раскрытия учётных данных через отладочные логи, системы мониторинга или отчёты об ошибках.
Предполагать, что хэширование паролей решает проблему безопасности аутентификации. Ограничение скорости, реагирование на утечки, безопасность сессий и многофакторная аутентификация всё ещё важны.
Нужно ли использовать перец?
Перец — это дополнительный общий секрет, хранимый вне базы данных паролей. В отличие от солевого раствора, он не хранится вместе с каждым хэшем.
Правильно разработанный перец может обеспечить дополнительную защиту, если злоумышленник украдёт только базу данных. Но использование перца вводит сложность управления ключами и ротации: потеря или ротация перца может потребовать сброса паролей.
Не импровизируйте, конкатенируя фиксированный секрет к каждому паролю. Следуйте задокументированной стратегии, храните секреты отдельно и планируйте ротацию. OWASP обсуждает подходы к пре-хэшированию и пост-хэшированию перца.
Практическая политика хэширования паролей
Для нового PHP-приложения предпочтите Argon2id, когда он доступен, начните с конфигурации, соответствующей OWASP, проконтролируйте её и храните полный закодированный хэш. Когда Argon2id недоступен, bcrypt через API паролей PHP является практической альтернативой, если его стоимость и ограничение на ввод понятны.
Для существующего приложения продолжайте проверять поддерживаемые устаревшие хэши и обновляйте их после успешной аутентификации. Избегайте разрушительных миграций, когда исходный пароль недоступен.
Разрабатывайте систему с возможностью обновлений с самого начала. Оборудование и рекомендации меняются; ваша система аутентификации должна быть способна принимать лучшие параметры и алгоритмы без изменения пароля каждого пользователя сразу.
Часто задаваемые вопросы
Лучше ли Argon2id, чем bcrypt?
Argon2id предлагает настраиваемую память-внедрённость и является предпочтительным выбором OWASP для новых реализаций хранения паролей.
Использует ли PHP Argon2id по умолчанию?
Нет. PHP's PASSWORD_DEFAULT в настоящее время выбирает bcrypt. Используйте PASSWORD_ARGON2ID явно, когда поддерживается.
Могу ли я мигрировать хэши bcrypt без сброса паролей?
Да. Проверьте существующий хэш, затем перехэшируйте представленный пароль после успешного входа.
Нужно ли хранить солевый раствор отдельно?
Нет. API хэширования паролей PHP генерирует солевый раствор и хранит необходимую информацию в закодированном хэше.
Безопасен ли SHA-256 для паролей?
Не сам по себе. Используйте специальный адаптивный алгоритм хэширования паролей, а не необработанный SHA-256.