HTTP CDN-Loop Filter

This extension may be referenced by the qualified name envoy.filters.http.cdn_loop

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:

extensions.filters.http.cdn_loop.v3.CdnLoopConfig

[extensions.filters.http.cdn_loop.v3.CdnLoopConfig proto]

CDN-Loop Header filter config. See the configuration overview for more information.

  1. {
  2. "cdn_id": "...",
  3. "max_allowed_occurrences": "..."
  4. }

cdn_id

(string, REQUIRED) The CDN identifier to use for loop checks and to append to the CDN-Loop header.

RFC 8586 calls this the cdn-id. The cdn-id can either be a pseudonym or hostname the CDN is in control of.

cdn_id must not be empty.

max_allowed_occurrences

(uint32) The maximum allowed count of cdn_id in the downstream CDN-Loop request header.

The default of 0 means a request can transit the CdnLoopFilter once. A value of 1 means that a request can transit the CdnLoopFilter twice and so on.