proxyfile

tls

tls makes the public listener serve HTTPS on the listen port, with a certificate and its key. Without it the listener serves plain HTTP. With clients, the gateway also asks every client for a certificate of its own (mutual TLS).

listen: 8443
tls:
  certificate: /etc/gateway/tls/certificate.pem   # the certificate chain, PEM
  key: /etc/gateway/tls/key.pem                   # its private key, PEM
  clients: {ca: /etc/gateway/tls/clients-ca.pem}  # optional: the CA a client's certificate must chain to

examples/tls holds this gateway in YAML and HOCON, each beside the envoy.yaml it gives.

Key Meaning Rule Class
tls The public listener serves HTTPS with this certificate and key; without it, plain HTTP. A mapping. The proxy reads the files when it starts. core
tls.certificate The certificate chain, PEM, a file on the proxy's host. Required. An absolute path. core
tls.key The private key, PEM, a file on the proxy's host. Required. An absolute path. core
tls.clients Require a client certificate on every connection (mutual TLS). A mapping. core
tls.clients.ca The CA bundle, PEM, that a client's certificate must chain to. Required. An absolute path. core