Nginx add_header: security-заголовки без потерь

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

add_header добавляет заголовок к ответу, но по умолчанию только для успешных статусов. Флаг always включает его и для 4xx/5xx. Главная ловушка — наследование: если в location есть свой add_header, заголовки из server туда не попадают. Поэтому security-заголовки приходится повторять или выносить в include.

Выдать security-заголовки и кеш

Текст
server {
    listen 80;

    add_header X-Content-Type-Options nosniff always;
    add_header X-Frame-Options DENY always;
    add_header Referrer-Policy strict-origin-when-cross-origin always;

    location /assets/ {
        add_header X-Content-Type-Options nosniff always;
        add_header X-Frame-Options DENY always;
        add_header Cache-Control "public, max-age=31536000, immutable" always;
        root /var/www;
    }
}

В /assets/ заголовки повторены, потому что собственный add_header отключает наследование родительских. Если не повторить, ответ на статику потеряет X-Frame-Options и Referrer-Policy. always важен для страниц ошибок: без него 404 может уйти без защиты.

Для одинаковых наборов используйте include /etc/nginx/snippets/security-headers.conf; в каждом location. Не добавляйте add_header внутрь if: это работает нестабильно. Для HSTS (Strict-Transport-Security) нужен HTTPS и понимание последствий: браузер запомнит требование на месяцы.

CSP лучше выдавать осознанно: Content-Security-Policy может сломать inline-скрипты и сторонние виджеты. Начните с Content-Security-Policy-Report-Only, соберите отчёты, затем включайте блокировку. Не ставьте X-Frame-Options: DENY на страницы, которые должны встраиваться в iframe.

Проверьте ответы через curl -I для 200, 301 и 404. add_header не заменяет заголовки, которые уже прислал upstream; для управления используйте proxy_hide_header и add_header. После изменения конфигурации выполните nginx -t.

Документация: ngx_http_headers_module: add_header, OWASP Secure Headers.