Tls Termination

Accept HTTPS connections and forward decrypted requests to an HTTP backend.

Category: Setup-dependent integration
Task: Terminate TLS at the proxy

Prerequisites: Praxis runtime; Generate ./localhost+1.pem and ./localhost+1-key.pem with mkcert; the source snapshot does not include them; An HTTP backend

Expected outcome: The listener accepts HTTPS and forwards the request to its configured upstream.

This configuration comes from the selected release. The example has not been run here; external services are not bundled.

Download the source file.

# TLS Termination
#
# HTTPS on the listener; plain HTTP to the backend.
#
#   Client -> TLS -> Praxis :8443 -> HTTP -> Backend :3000
#
# Usage:
#   mkcert -install && mkcert localhost 127.0.0.1
#   cargo run -p praxis-proxy -- -c examples/configs/protocols/tls-termination.yaml
#   curl https://localhost:8443/

listeners:
  - name: default
    address: "127.0.0.1:8443"
    filter_chains:
      - main
    tls:
      certificates:
        - cert_path: ./localhost+1.pem
          key_path: ./localhost+1-key.pem

filter_chains:
  - name: main
    filters:
      - filter: router
        routes:
          - path_prefix: "/"
            cluster: backend

      - filter: load_balancer
        clusters:
          - name: backend
            endpoints:
              - "127.0.0.1:3000"

insecure_options:
  allow_private_endpoints: true # example proxies to local backends