.. _envoy_v3_api_file_envoy/type/matcher/v3/http_inputs.proto: Common HTTP inputs (proto) ========================== .. _envoy_v3_api_msg_type.matcher.v3.HttpRequestHeaderMatchInput: type.matcher.v3.HttpRequestHeaderMatchInput ------------------------------------------- :repo:`[type.matcher.v3.HttpRequestHeaderMatchInput proto] ` Match input indicates that matching should be done on a specific request header. The resulting input string will be all headers for the given key joined by a comma, e.g. if the request contains two 'foo' headers with value 'bar' and 'baz', the input string will be 'bar,baz'. .. _extension_envoy.matching.inputs.request_headers: This extension has the qualified name ``envoy.matching.inputs.request_headers`` .. note:: This extension is functional but has not had substantial production burn time, use only with this caveat. This extension has an unknown security posture and should only be used in deployments where both the downstream and upstream are trusted. .. tip:: This extension extends and can be used with the following extension category: - :ref:`envoy.matching.http.input ` This extension must be configured with one of the following type URLs: - :ref:`type.googleapis.com/envoy.type.matcher.v3.HttpRequestHeaderMatchInput ` .. code-block:: json :force: { "header_name": ... } .. _envoy_v3_api_field_type.matcher.v3.HttpRequestHeaderMatchInput.header_name: header_name (`string `_) The request header to match on. .. _envoy_v3_api_msg_type.matcher.v3.HttpRequestTrailerMatchInput: type.matcher.v3.HttpRequestTrailerMatchInput -------------------------------------------- :repo:`[type.matcher.v3.HttpRequestTrailerMatchInput proto] ` Match input indicates that matching should be done on a specific request trailer. The resulting input string will be all headers for the given key joined by a comma, e.g. if the request contains two 'foo' headers with value 'bar' and 'baz', the input string will be 'bar,baz'. .. _extension_envoy.matching.inputs.request_trailers: This extension has the qualified name ``envoy.matching.inputs.request_trailers`` .. note:: This extension is functional but has not had substantial production burn time, use only with this caveat. This extension has an unknown security posture and should only be used in deployments where both the downstream and upstream are trusted. .. tip:: This extension extends and can be used with the following extension category: - :ref:`envoy.matching.http.input ` This extension must be configured with one of the following type URLs: - :ref:`type.googleapis.com/envoy.type.matcher.v3.HttpRequestTrailerMatchInput ` .. code-block:: json :force: { "header_name": ... } .. _envoy_v3_api_field_type.matcher.v3.HttpRequestTrailerMatchInput.header_name: header_name (`string `_) The request trailer to match on. .. _envoy_v3_api_msg_type.matcher.v3.HttpResponseHeaderMatchInput: type.matcher.v3.HttpResponseHeaderMatchInput -------------------------------------------- :repo:`[type.matcher.v3.HttpResponseHeaderMatchInput proto] ` Match input indicating that matching should be done on a specific response header. The resulting input string will be all headers for the given key joined by a comma, e.g. if the response contains two 'foo' headers with value 'bar' and 'baz', the input string will be 'bar,baz'. .. _extension_envoy.matching.inputs.response_headers: This extension has the qualified name ``envoy.matching.inputs.response_headers`` .. note:: This extension is functional but has not had substantial production burn time, use only with this caveat. This extension has an unknown security posture and should only be used in deployments where both the downstream and upstream are trusted. .. tip:: This extension extends and can be used with the following extension category: - :ref:`envoy.matching.http.input ` This extension must be configured with one of the following type URLs: - :ref:`type.googleapis.com/envoy.type.matcher.v3.HttpResponseHeaderMatchInput ` .. code-block:: json :force: { "header_name": ... } .. _envoy_v3_api_field_type.matcher.v3.HttpResponseHeaderMatchInput.header_name: header_name (`string `_) The response header to match on. .. _envoy_v3_api_msg_type.matcher.v3.HttpResponseTrailerMatchInput: type.matcher.v3.HttpResponseTrailerMatchInput --------------------------------------------- :repo:`[type.matcher.v3.HttpResponseTrailerMatchInput proto] ` Match input indicates that matching should be done on a specific response trailer. The resulting input string will be all headers for the given key joined by a comma, e.g. if the request contains two 'foo' headers with value 'bar' and 'baz', the input string will be 'bar,baz'. .. _extension_envoy.matching.inputs.response_trailers: This extension has the qualified name ``envoy.matching.inputs.response_trailers`` .. note:: This extension is functional but has not had substantial production burn time, use only with this caveat. This extension has an unknown security posture and should only be used in deployments where both the downstream and upstream are trusted. .. tip:: This extension extends and can be used with the following extension category: - :ref:`envoy.matching.http.input ` This extension must be configured with one of the following type URLs: - :ref:`type.googleapis.com/envoy.type.matcher.v3.HttpResponseTrailerMatchInput ` .. code-block:: json :force: { "header_name": ... } .. _envoy_v3_api_field_type.matcher.v3.HttpResponseTrailerMatchInput.header_name: header_name (`string `_) The response trailer to match on.