Nginx auth_basic: закрыть каталог паролем

Категория: Nginx · Обновлено:

auth_basic включает HTTP Basic-аутентификацию для location или сервера. Браузер показывает окно входа и затем отправляет логин и пароль в заголовке Authorization с каждым запросом. Это простой способ закрыть админку или внутренний каталог, но только поверх HTTPS: в HTTP учётные данные передаются почти открытым текстом.

Защитить админку паролем

Текст
location /admin/ {
    auth_basic "Admin area";
    auth_basic_user_file /etc/nginx/.htpasswd;

    proxy_pass http://backend;
    proxy_set_header X-Forwarded-User $remote_user;
}

Файл .htpasswd создают через htpasswd -c /etc/nginx/.htpasswd admin или openssl passwd -apr1. Nginx понимает хеши crypt, apr1, {SHA} и {PLAIN}; не используйте {PLAIN} в production. Права на файл должны быть минимальными, а сам файл — вне web-root.

$remote_user доступен после успешной проверки; его можно передать бэкенду отдельным заголовком. Не доверяйте входящему X-Forwarded-User от клиента — перезаписывайте его, как в примере. Basic auth не даёт выхода из системы: браузер кеширует credentials до закрытия окна.

Для комбинации с ограничением по IP используйте satisfy any; и allow/deny, но помните, что satisfy any разрешает доступ при выполнении любого условия. Для API лучше токены или OAuth: Basic auth шлёт пароль на каждый запрос и плохо сочетается с SSO.

Закройте .htpasswd и .git от прямого доступа, включите HTTPS и rate limit на форму входа. После изменения конфигурации выполните nginx -t и проверьте ответы 401/200 через curl -u.

Документация: ngx_http_auth_basic_module, htpasswd.