Proxy Caching Advanced

Release date 2026/09/15

Feature

• Added cache_by_principal configuration option to switch cache key segmentation by Principal when using Kong Identity Directory. When enabled, the authenticated Principal’s ID is used to compose the cache key.

Bugfix

• Fixed an issue where the cache key did not correctly segment by consumer group.

Release date 2026/07/02

Bugfix

• Fixed an issue where the cache management Admin API did not work when the redis strategy configuration was provided via a partial.

Release date 2025/04/10

Bugfix

• Fixed an issue where the kong.plugins.proxy-cache-advanced.migrations module was not being loaded when upgrading to 3.8.x.y. This issue was introduced in 3.8.0.0 and Kong refuses to start if redis.timeout and redis.connect_timeout are set to different values.

Release date 2024/09/11

Deprecation

• Deprecated timeout config field in redis config in favor of connect_/send_/read_timeout (timeout field will be removed in 4.0).

• Switched to sentinel_nodes and cluster_nodes for redis configuration.

Feature

• Added Redis cluster_max_redirections configuration option.

Bugfix

• Fixed a bug where the Age header was not being updated correctly when serving cached requests

Release date 2024/02/12

Feature

• add support for consumer group scoping

Bugfix

• remove undesired proxy-cache-advanced/migrations/001_035_to_050.lua that blocks migration from OSS to EE. This is a breaking change for customers using Kong Gateway between 0.3.5 and 0.5.0.

Release date 2023/05/19

Feature

• Added wildcard and parameter match support for content_type.

• Added the configuration parameter ignore_uri_case to allow handling the cache key URI as lowercase.#10453

Release date 2022/12/06

Feature

• Added support for integrating with Redis clusters through the config.redis.cluster_addresses configuration property.

Bugfix

• The plugin now catches the error when Kong Gateway connects to Redis SSL port 6379 with config.ssl=false.

Release date 2022/03/02

Feature

• Added Redis ACL support (Redis v6.0.0+ and Redis Sentinel v6.2.0+).

• Added the redis.sentinel_username and redis.sentinel_password configuration parameters.

• Beta feature: The redis.password, redis.sentinel_username, and redis.sentinel_passwordconfiguration fields are now marked as referenceable, which means they can be securely stored as secretsin a vault. References must follow a specific format.

Bugfix

• Fixed a X-Cache-Status:Miss error that occurred when caching large files.