HttpFilter#

Действие HttpFilter предназначено для отправки сообщения, полученного на любом этапе преобразования в цепочке во внешний HTTP фильтр.

Параметры:

Название

Обязательность

Допустимые значения

Описание

filter_url

+

Строковое значение. Должно начинаться с "http", "https", либо с символа "/".

Url внешнего сервиса.

connect_timeout

-

Число с суффиксом: ms - миллисекунды; s - секунды; m - минуты; h - часы; d - дни; w - недели; M - месяцы, 30 дней; y - годы, 365 дней

Время ожидания подключения к фильтру, по умолчанию параметр не задан

read_timeout

-

Число с суффиксом: ms - миллисекунды; s - секунды; m - минуты; h - часы; d - дни; w - недели; M - месяцы, 30 дней; y - годы, 365 дней

Время ожидания между двумя последовательными попытками чтения, по умолчанию параметр не задан.

write_timeout

-

Число с суффиксом: ms - миллисекунды; s - секунды; m - минуты; h - часы; d - дни; w - недели; M - месяцы, 30 дней; y - годы, 365 дней

Время ожидания между двумя последовательными попытками записи, по умолчанию параметр не задан.

service_id

-

Текстовое значение

Задает ID сервиса.

service_type

+

Текстовое значение: service_main_proxy; service_http_proxy; service_http_kafka_proxy; service_http_mq_proxy; service_gost_proxy; service_sowa_ipa; service_static.

Задает ID сервиса.

request_method

-

Строковое значение: "put"; "post"; "options"; "get"; "delete"; "trace".

Содержит HTTP-метод, который будет использоваться для отправки запроса на внешний фильтр, по умолчанию POST.

protocol_version

-

Строковое значение: "HTTP/1.0", "HTTP/1.1", "HTTP2"

Содержит версию протокола, который будет использоваться для отправки запроса на внешний фильтр, по умолчанию HTTP/1.1.

headers

-

Последовательность вида "name: имя заголовка, value: значение заголовка"

Содержит последовательность заголовков , которые будут сформированы для отправки на фильтрацию, в value можно использовать переменные.

response_header_set_variable

-

Последовательность вида "header: имя заголовка, var: название переменной"

Позволяет пробрасывать заголовки ответа от внешнего фильтра в значения переменной. В значении header задается название заголовка, в var название переменной.

conditions

-

Последовательность вида "var: имя_переменной, val: значение_переменной, operator: оператор".

Список условий по которым определяется, заблокировал фильтр запрос или нет. По умолчанию: 'filter_status < 400'. В качестве условий могут использоваться дополнительные переменные. filter_status - HTTP статус ответа от фильтра MDS; filter_hdr_имя_заголовка - заголовок ответа от фильтра (важно - в отличии от стандартного NGinx поведения в именах заголовков в названиях переменных, здесь символы "-" не преобразуются в "_", а сохраняются как есть.

proxy_ssl

-

Допустимые значения описаны в разделе "Параметр upstream_ssl".

Параметры SSL/TLS соединения для взаимодействия с upstream'ом.