uwsgi_pass_header

Директива `uwsgi_pass_header` используется для указания заголовков, передаваемых от приложений uWSGI в ответ клиенту. — NGINX HTTP Core

uwsgi_pass_header
httpserverlocation
Синтаксисuwsgi_pass_header header_name;
По умолчаниюnone
Контекстhttp, server, location
МодульNGINX HTTP Core
Аргументы1

Описание

Директива `uwsgi_pass_header` — это параметр конфигурации в модуле uWSGI для NGINX, который позволяет указывать определённые заголовки, возвращаемые приложением uWSGI, чтобы они передавались клиенту в ответе. Эту директиву можно задавать в контекстах `http`, `server` или `location`, что обеспечивает гибкую настройку для разных частей сервера NGINX. В качестве аргумента директива принимает одно имя заголовка, которое должно совпадать с именем заголовка, включённого приложением uWSGI в его ответ. При использовании директивы `uwsgi_pass_header` будут пересылаться только указанные заголовки, что помогает контролировать, какая информация раскрывается, и гарантирует, что соответствующие заголовки последовательно возвращаются. Это особенно полезно для заголовков, передающих данные, специфичные для приложения, такие как информация о версии, токены безопасности или пользовательские сообщения о состоянии приложения. Избирательная передача заголовков позволяет администраторам повысить безопасность и сократить ненужную передачу данных. Если необходимо передать несколько заголовков, директиву `uwsgi_pass_header` можно объявлять несколько раз в одном и том же блоке конфигурации, каждый раз указывая другой заголовок для пересылки. Общая работа также зависит от конфигурации сервера uWSGI, чтобы гарантировать, что указанные заголовки действительно присутствуют в ответе до того, как NGINX попытается переслать их клиенту.

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

location /app {
    include uwsgi_params;
    uwsgi_pass my_app;
    uwsgi_pass_header X-My-Custom-Header;
}

Убедитесь, что указанное имя заголовка точно соответствует тому, как оно появляется в ответе uWSGI, включая учет регистра.

Если заголовок не устанавливается приложением uWSGI, он не будет доступен для передачи через `uwsgi_pass_header`, что может привести к путанице.