Composite (proto)

This extension has the qualified name envoy.filters.http.composite

Note

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:

This extension must be configured with one of the following type URLs:

Composite Filter configuration overview.

extensions.filters.http.composite.v3.Composite

[extensions.filters.http.composite.v3.Composite proto]

Composite filter config. The composite filter config allows delegating filter handling to another filter as determined by matching on the request headers. This makes it possible to use different filters or filter configurations based on the incoming request.

This is intended to be used with ExtensionWithMatcher where a match tree is specified that indicates (via ExecuteFilterAction) which filter configuration to create and delegate to.

extensions.filters.http.composite.v3.DynamicConfig

[extensions.filters.http.composite.v3.DynamicConfig proto]

Configuration for an extension configuration discovery service with name.

{
  "name": ...,
  "config_discovery": {...}
}
name

(string, REQUIRED) The name of the extension configuration. It also serves as a resource name in ExtensionConfigDS.

config_discovery

(config.core.v3.ExtensionConfigSource) Configuration source specifier for an extension configuration discovery service. In case of a failure and without the default configuration, 500(Internal Server Error) will be returned.

extensions.filters.http.composite.v3.ExecuteFilterAction

[extensions.filters.http.composite.v3.ExecuteFilterAction proto]

Composite match action (see matching docs for more info on match actions). This specifies the filter configuration of the filter that the composite filter should delegate filter interactions to.

{
  "typed_config": {...},
  "dynamic_config": {...}
}
typed_config

(config.core.v3.TypedExtensionConfig) Filter specific configuration which depends on the filter being instantiated. See the supported filters for further documentation. Only one of typed_config or dynamic_config can be set.

Tip

This extension category has the following known extensions:

The following extensions are available in contrib images only:

dynamic_config

(extensions.filters.http.composite.v3.DynamicConfig) Dynamic configuration of filter obtained via extension configuration discovery service. Only one of typed_config or dynamic_config can be set.