# Network External Authorization¶

This extension may be referenced by the qualified name envoy.filters.network.ext_authz

Note

This extension is intended to be robust against untrusted downstream traffic. It assumes that the upstream is trusted.

The network layer external authorization service configuration configuration overview.

## config.filter.network.ext_authz.v2.ExtAuthz¶

[config.filter.network.ext_authz.v2.ExtAuthz proto]

External Authorization filter calls out to an external service over the gRPC Authorization API defined by CheckRequest. A failed check will cause this filter to close the TCP connection.

{
"stat_prefix": "...",
"grpc_service": "{...}",
"failure_mode_allow": "...",
"include_peer_certificate": "..."
}

stat_prefix

(string, REQUIRED) The prefix to use when emitting statistics.

grpc_service

(core.GrpcService) The external authorization gRPC service configuration. The default timeout is set to 200ms by this filter.

failure_mode_allow

(bool) The filter’s behaviour in case the external authorization service does not respond back. When it is set to true, Envoy will also allow traffic in case of communication failure between authorization service and the proxy. Defaults to false.

include_peer_certificate

(bool) Specifies if the peer certificate is sent to the external service.

When this field is true, Envoy will include the peer X.509 certificate, if available, in the certificate.