Related Documentation
Made by
Kong Inc.
Supported Gateway Topologies
hybrid db-less traditional
Supported Konnect Deployments
hybrid cloud-gateways serverless
Compatible Protocols
grpc grpcs http https

3.10.0.0

Release date 2025/03/27

Bugfix

  • Fixed an issue where the upstream_status field was empty in logs when using the forward-proxy plugin.

3.6.0.0

Release date 2024/02/12

Bugfix

  • forward-proxy fallback to the non-streaming proxy when the request body has already been read

  • Fixed the issue where request payload is being discarded when payload exceeded the client_body_buffer_size.

3.5.0.4

Release date 2024/05/20

Bugfix

  • forward-proxy fallback to the non-streaming proxy when the request body has already been read

3.5.0.2

Release date 2023/12/21

Bugfix

  • Fixed the issue where request payload is being discarded when payload exceeded the client_body_buffer_size.

3.4.3.5

Release date 2024/03/21

Bugfix

  • fallback to the non-streaming proxy when the request body has already been read

3.4.3.1

Release date 2023/12/15

Bugfix

  • Fixed the issue where request payload is being discarded when payload exceeded the client_body_buffer_size.

3.3.0.0

Release date 2023/05/19

Bugfix

  • Fixed an issue which caused the wrong latencies.proxy to be used in the logging plugins. This plugin now evaluates ctx.WAITING_TIME in the forward proxy instead of doing it in the subsequent phase.

3.1.0.0

Release date 2022/12/06

Feature

  • x_headers field added. This field indicates how the plugin handles the headersX-Real-IP, X-Forwarded-For, X-Forwarded-Proto, X-Forwarded-Host, and X-Forwarded-Port.

    The field can take one of the following options:

    • append: append information from this hop in the chain to those headers. This is the default setting.
    • transparent: leave the headers unchanged, as if the the Kong Gateway was not a proxy.
    • delete: remove all the headers, as if the Kong Gateway was the originating client.

    Note that all options respect the trusted IP setting, and will ignore headers from the last hop in the chain if they are not from clients with trusted IPs.

  • append: append information from this hop in the chain to those headers. This is the default setting.

  • transparent: leave the headers unchanged, as if the the Kong Gateway was not a proxy.

  • delete: remove all the headers, as if the Kong Gateway was the originating client.

3.0.0.0

Release date 2022/09/09

Bugfix

  • Fixed a proxy authentication error caused by incorrect base64 encoding.

  • Use lowercase when overwriting the Nginx request host header.

  • The plugin now allows multi-value response headers.

2.8.4.1

Release date 2023/05/25

Bugfix

  • Fixed an issue which occurred when receiving an HTTP 408 from the upstream through a forward proxy. Nginx exited the process with this code, which resulted in Nginx ending the request without any contents.

2.8.2.0

Release date 2022/10/12

Bugfix

  • If the https_proxy configuration parameter is not set, it now defaults to http_proxy to avoid DNS errors.

2.8.1.1

Release date 2022/05/27

Bugfix

  • Fixed an invalid header value error for HTTPS requests. The plugin now accepts multi-value response headers.

  • Fixed an error where basic authentication headers containing the =character weren’t forwarded.

  • Fixed request errors that occurred when a scheme had no proxy set. Thehttps proxy now falls back to the http proxy if not specified, and thehttp proxy falls back to https.

2.8.1.0

Release date 2022/04/07

Bugfix

  • Use lowercase when overwriting the host header

2.8.0.0

Release date 2022/03/02

Feature

  • Added http_proxy_host, http_proxy_port, https_proxy_host, andhttps_proxy_port configuration parameters for mTLS support.

    These parameters replace the proxy_port and proxy_host fields, which are now deprecated and planned to be removed in 3.x.x.

  • The auth_password and auth_username configuration fields are now marked as referenceable, which means they can be securely stored assecretsin a vault. References must follow a specific format.

Something wrong?

Help us make these docs great!

Kong Developer docs are open source. If you find these useful and want to make them better, contribute today!