xss_output_type

Директива `xss_output_type` задаёт MIME-тип для JSONP-ответов в NGINX.

Синтаксисxss_output_type type [type...];
По умолчаниюnone
Контекстhttp, server, location, if in location
Аргументы1+

Описание

Директива xss_output_type в модуле Native XSS для NGINX используется для установки MIME-типа выходных ответов при включённом JSONP (JSON with Padding). Эта директива позволяет разработчикам определить тип содержимого, который будет использоваться при отправке JavaScript-ответов на кросс-доменные запросы. Когда клиент выполняет кросс-доменный GET-запрос с включённой директивой xss_get, к ответу будет применён тип вывода, указанный в xss_output_type, что позволит корректно интерпретировать его на стороне клиентского JavaScript.

Пользователи могут указывать один или несколько MIME-типов в качестве аргументов этой директивы, что позволяет NGINX возвращать разные типы ответов в зависимости от контекста запроса. Тип application/x-javascript часто используется по умолчанию, но разработчики могут выбрать другие типы, например application/json, или определить собственные типы в соответствии со своими потребностями. Такая гибкость облегчает обработку различных сценариев кросс-доменных AJAX-запросов, где важна корректная идентификация содержимого.

Важно убедиться, что указанный MIME-тип соответствует содержимому, которое отправляется, чтобы избежать проблем с выполнением на стороне клиента. Неверный MIME-тип может привести к тому, что браузер не сможет правильно выполнить скрипты, что повлечёт за собой сбои в работе веб-приложений, зависящих от JSONP для кросс-доменных запросов.

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

server {
    location /foo {
        xss_get on;
        xss_output_type 'application/x-javascript';
        # other configurations...
    }
}

Убедитесь, что указанный MIME-тип соответствует содержимому, которое отдается, чтобы избежать некорректной обработки клиентами.

Использование нескольких MIME-типов требует тщательного продумывания логики обработки ответов, чтобы избежать конфликтов.

Всегда устанавливайте директиву xss_get в on, если вы планируете использовать xss_output_type для ответов JSONP.

← Ко всем директивам