§Как пользоваться

На вкладке .htaccess:

  1. Выберите пресет или отметьте нужные правила: HTTPS, закрытие скрытых файлов, GZIP, кэш, SPA, защита от горячих ссылок.
  2. Скопируйте результат или скачайте файл и положите его в корень сайта.
  3. Откройте сайт и проверьте ответы сервера. Если появилась ошибка 500, смотрите error_log Apache: обычно на хостинге не включён нужный модуль.

На вкладке .htpasswd:

  1. Введите логин и пароль. Кнопка с перемешанными стрелками подставит случайный пароль из 16 символов. Пользователей можно добавить сколько угодно.
  2. Выберите алгоритм: bcrypt для Apache 2.4, APR1-MD5 для старых серверов и nginx.
  3. Укажите абсолютный путь, по которому файл будет лежать на сервере.
  4. Скачайте .htpasswd, загрузите его по этому пути, а блок из нижнего поля добавьте в .htaccess папки, которую нужно закрыть.

Пароли хешируются прямо в браузере и никуда не отправляются. Соль у каждого пароля случайная, поэтому при повторной генерации хеш будет другим. Это нормально: Apache всё равно проверит пароль правильно.

§Как устроен .htpasswd

Каждая строка файла имеет вид логин:хеш. Из-за этого двоеточие в логине недопустимо. Apache определяет алгоритм по началу хеша:

Начало хешаАлгоритмУтилита htpasswdГде работает
$2y$bcrypt-B, стоимость -C от 4 до 17Apache 2.4.4 и новее
$apr1$APR1-MD5, 1000 итераций MD5-mлюбой Apache, nginx
{SHA}один проход SHA-1 без соли-sне используйте
13 символовDES crypt, только первые 8 символов пароля-dне используйте

Стоимость bcrypt задаёт число раундов как степень двойки: каждая единица удваивает время расчёта. Сам htpasswd по умолчанию ставит 5, но для современного сервера разумно 10–12. Слишком высокая стоимость замедлит каждый запрос, ведь при Basic-авторизации браузер отправляет пароль заново с каждым запросом, и сервер каждый раз проверяет хеш.

bcrypt учитывает только первые 72 байта пароля. Кириллическая буква в UTF-8 занимает 2 байта, поэтому для русского пароля предел около 36 символов. Генератор предупредит, если пароль длиннее.

§Как подключить защиту паролем

Блок для .htaccess выглядит так:

1
2
3
4
AuthType Basic
AuthName "Restricted"
AuthUserFile /home/user/.htpasswd
Require valid-user
  • AuthUserFile принимает абсолютный путь от корня файловой системы сервера, а не от корня сайта. Путь к домашней папке есть в панели хостинга или в выводе PHP __DIR__.
  • Если файл всё же лежит внутри сайта, его нужно закрыть от скачивания. Генератор добавляет для этого блок <Files ".htpasswd">, а правило «Закрыть скрытые файлы» на вкладке .htaccess закрывает все файлы на .ht.
  • Basic-авторизация передаёт логин и пароль в base64, то есть по сути открытым текстом. Закрывайте папку только на HTTPS: включите правило «Принудительный HTTPS» в том же .htaccess.
  • Чтобы пустить по паролю только одного пользователя, замените Require valid-user на Require user логин.

В nginx тот же файл подключается директивами auth_basic и auth_basic_user_file. Формат APR1-MD5 nginx понимает всегда, bcrypt только если его поддерживает системная функция crypt().

Источники: htpasswd и форматы паролей в документации Apache, mod_auth_basic, ngx_http_auth_basic_module.