§Как пользоваться
На вкладке .htaccess:
- Выберите пресет или отметьте нужные правила: HTTPS, закрытие скрытых файлов, GZIP, кэш, SPA, защита от горячих ссылок.
- Скопируйте результат или скачайте файл и положите его в корень сайта.
- Откройте сайт и проверьте ответы сервера. Если появилась ошибка 500, смотрите
error_logApache: обычно на хостинге не включён нужный модуль.
На вкладке .htpasswd:
- Введите логин и пароль. Кнопка с перемешанными стрелками подставит случайный пароль из 16 символов. Пользователей можно добавить сколько угодно.
- Выберите алгоритм: bcrypt для Apache 2.4, APR1-MD5 для старых серверов и nginx.
- Укажите абсолютный путь, по которому файл будет лежать на сервере.
- Скачайте
.htpasswd, загрузите его по этому пути, а блок из нижнего поля добавьте в.htaccessпапки, которую нужно закрыть.
Пароли хешируются прямо в браузере и никуда не отправляются. Соль у каждого пароля случайная, поэтому при повторной генерации хеш будет другим. Это нормально: Apache всё равно проверит пароль правильно.
§Как устроен .htpasswd
Каждая строка файла имеет вид логин:хеш. Из-за этого двоеточие в логине недопустимо. Apache определяет алгоритм по началу хеша:
| Начало хеша | Алгоритм | Утилита htpasswd | Где работает |
|---|---|---|---|
$2y$ | bcrypt | -B, стоимость -C от 4 до 17 | Apache 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 выглядит так:
| |
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.
