.. _envoy_v3_api_file_envoy/extensions/filters/http/cache/v3/cache.proto: HTTP Cache Filter (proto) ========================= .. _envoy_v3_api_msg_extensions.filters.http.cache.v3.CacheConfig: extensions.filters.http.cache.v3.CacheConfig -------------------------------------------- :repo:`[extensions.filters.http.cache.v3.CacheConfig proto] ` .. _extension_envoy.filters.http.cache: This extension has the qualified name ``envoy.filters.http.cache`` .. note:: This extension is work-in-progress. Functionality is incomplete and it is not intended for production use. This extension is intended to be robust against both untrusted downstream and upstream traffic. .. tip:: This extension extends and can be used with the following extension category: - :ref:`envoy.filters.http ` This extension must be configured with one of the following type URLs: - :ref:`type.googleapis.com/envoy.extensions.filters.http.cache.v3.CacheConfig ` .. code-block:: json :force: { "typed_config": {...}, "allowed_vary_headers": [] } .. _envoy_v3_api_field_extensions.filters.http.cache.v3.CacheConfig.typed_config: typed_config (`Any `_) Config specific to the cache storage implementation. .. _extension_category_envoy.http.cache: .. tip:: This extension category has the following known extensions: - :ref:`envoy.extensions.http.cache.simple ` .. _envoy_v3_api_field_extensions.filters.http.cache.v3.CacheConfig.allowed_vary_headers: allowed_vary_headers (**repeated** :ref:`type.matcher.v3.StringMatcher `) List of matching rules that defines allowed ``Vary`` headers. The ``vary`` response header holds a list of header names that affect the contents of a response, as described by https://httpwg.org/specs/rfc7234.html#caching.negotiated.responses. During insertion, ``allowed_vary_headers`` acts as a allowlist: if a response's ``vary`` header mentions any header names that aren't matched by any rules in ``allowed_vary_headers``, that response will not be cached. During lookup, ``allowed_vary_headers`` controls what request headers will be sent to the cache storage implementation.