proxyfile

Defaults

Everything the format has no key for is the same in every configuration the Envoy generator writes, and this page says what that is.

Fixed names

These names never follow envoy.namespace or any other key, because other programs read them. A tool that changes a runtime value, for example, looks it up by its key.

Name What it is
public The listener, its stat_prefix and the route table.
refused:dot-segment-with-parameter The first route of every virtual host, which answers 400 to a path that still holds /.;, /..;, /.%3B or /..%3B (the hex in either case) after normalisation. The request log writes it as route. No route of the file can take the name, because a route name holds no colon.
gateway.ext_authz.enabled The runtime key that switches the auth check, written with auth.ask. Its default comes from auth.enabled.
gateway.request_log.min_status The runtime key for the lowest status that is always logged, written with log. Its default comes from log.status_from.
gateway.request_log.sample The runtime key for the share of other requests that is logged, written with log. Its default comes from log.sample.
gateway.local_reply.origin_refused_status The runtime key for the status the Invalid CORS request answer is matched on. Its default is 403.
gateway.local_reply.rate_limited_status The runtime key for the status the Connect answer to a call over a rate limit is matched on, written with a rate_limit. Its default is 429.
rate_limit The rate limit filter's stat_prefix, written with a rate_limit.
otel_collector The cluster of the tracing endpoint, written with the otel provider.
jwks The cluster of the keys URL's host, written when auth.jwt.keys is an https URL.
browser-origins The one RBAC policy of each virtual host.
x-gateway-action, x-gateway-reports The question headers of an RPC route, read by the auth check.
x-gateway-timeout-ms The check's deadline in milliseconds.

One line of the generated file is meant for a tool to switch by editing the file as text: the default of the auth check. It stays on one line in flow style for that purpose. It reads {numerator: 100, denominator: HUNDRED} when the check is on and {numerator: 0, denominator: HUNDRED} when it is off:

default_value: {numerator: 100, denominator: HUNDRED}

proxyfile check fails on an edited file, as it does on any edit, so check the file before a tool edits it. To change the setting for good, change auth.enabled and render again.