Apache APISIX 3.21.0 upgrades APISIX Runtime to 1.4.3, protects credentials in forwarded requests and logs, and improves upstream recovery and log delivery.
Runtime and security fixes
APISIX Runtime 1.4.3 uses the NGINX 1.31.9 core in its OpenResty 1.31.8.1 build. It incorporates ten upstream security fixes. Their relevance to a deployment depends on the enabled modules and configuration. Runtime upgrade #14223 · NGINX security advisories
| Component | CVEs |
|---|---|
| HTTP/2 | CVE-2026-123007, CVE-2026-123633 |
| HTTP/3 | CVE-2026-121810 |
| TLS request bodies | CVE-2026-118899 |
| DNS resolution | CVE-2026-123634 |
| Stream TLS and PROXY protocol | CVE-2026-123640, CVE-2026-120967, CVE-2026-120993 |
| Static file handling | CVE-2026-125283 |
| Mail proxy (disabled in the standard Runtime build) | CVE-2026-113425 |
Gateway and plugin changes
- With
normalize_uri_like_servletenabled, upstream requests now use the query arguments left by rewrite and access plugins. This preserves credential removal bykey-authandjwt-auth. Mirrored requests honor explicit upstream URI overrides, anddata-maskapplies query masking rules toupstream_uriin access logs. #14163 - APISIX stops logging sensitive configuration values during etcd validation and plugin execution. Admin API errors for invalid plugin configuration types report the type without echoing the submitted value. #14157
- Recovered round-robin nodes restart their slow-start ramp. New health checkers observe health transitions during initialization, and Redis cluster probes reuse TLS and authentication settings when checking for recovery. #14188 · #14215 · #14181
- Logger batch processors preserve active batches during cleanup and correct backlog counts after failures or filtering. The Elasticsearch logger isolates batches by plugin configuration so each Route uses its own endpoints and credentials. TCP and Splunk loggers also improve error handling. #14192 · #14004 · #14012
- Prometheus includes the first session's bytes in
apisix_stream_bandwidthfor a new service. The host-based router includes the referring Route ID when it cannot load a Service. #14101 · #13723
Before upgrading from 3.20.0
- Admin API keys. When
admin_key_requiredis enabled, set an explicitadminorviewerrole on every configured key and quote numeric-looking keys in YAML. Check traditional and control-plane configurations, including traditional deployments with the Admin API disabled. #14203 - Encrypted configuration. Newly encrypted plugin configuration and metadata values carry a
$ENC$v1$prefix. Back up etcd before upgrading and avoid Admin API writes during a rolling upgrade. If encrypted resources have been re-saved, restore the pre-upgrade data before rolling back to the official 3.20.0 source release or another build without marker support. #14162 - HTTP parsing and source installs. The new NGINX core rejects header lines missing a colon, returning 400 for client requests or 502 for upstream responses. It also rejects chunked request bodies with excessive framing overhead. When installing from the source archive, install APISIX Runtime 1.4.3 separately, then run
make deps APISIX_RUNTIME=1.4.3. #14223