fastcgi_pass_header

Описание

Директива 'fastcgi_pass_header' позволяет определить, какие HTTP-заголовки, полученные от FastCGI сервера, должны быть включены в ответ, отправляемый клиенту. Эта директива может быть задана несколько раз в одном и том же контексте, что позволяет передавать несколько заголовков. Когда запрос обрабатывается и FastCGI сервер возвращает заголовки, NGINX фильтрует эти заголовки на основе конфигурации, заданной с помощью 'fastcgi_pass_header'. В итоговый ответ клиенту будут включены только те заголовки, которые соответствуют указанным в этой директиве; все остальные заголовки будут проигнорированы. Это особенно полезно для контроля того, какая метаинформация или директивы возвращаются клиенту, повышая безопасность или позволяя сосредоточиться только на релевантных данных. Директива 'fastcgi_pass_header' может быть определена в контекстах 'http', 'server' и 'location', что делает ее гибкой для различных конфигураций. С помощью этой директивы администраторы могут гарантировать, что чувствительные заголовки не будут раскрыты, или что нерелевантные заголовки не будут засорять ответы. Важно отметить, что эта директива используется совместно с конфигурацией FastCGI и требует директивы 'fastcgi_pass' для направления трафика на FastCGI сервер. Важный аспект ее настройки заключается в том, что имена заголовков нечувствительны к регистру, тогда как значения могут быть чувствительны к регистру в зависимости от приложения. Поэтому при указании заголовков для передачи убедитесь, что точное написание и регистр значений остаются последовательными для корректной работы.

Пример конфига

location /some_location {
    fastcgi_pass 127.0.0.1:9000;
    fastcgi_pass_header X-My-Custom-Header;
}