You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: developer-support/release-notes/gateway.mdx
+32-2Lines changed: 32 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1516,8 +1516,20 @@ The Gateway and Plugin Compiler have been updated to Go 1.25, providing improved
1516
1516
For a comprehensive list of changes, please refer to the detailed [changelog](#Changelog-v5.8.14) below.
1517
1517
1518
1518
#### Breaking Changes
1519
+
**1. Query parameter handling in Tyk internal loops (tyk://) now requires explicit configuration**
1520
+
1521
+
In Tyk Gateway version 5.8.14, we have fixed inconsistent query parameter behavior in URL rewrites using Tyk internal loops (`tyk://api-id/path`). Previously, query parameters added to the `rewrite_to` URL were silently dropped, while original request parameters were automatically preserved. This behavior was inconsistent with standard HTTP URL rewrites and prevented proper parameter transformation during internal API routing.
1522
+
1523
+
**Impact**
1524
+
- Original request query parameters are no longer automatically forwarded through internal loops
1525
+
- Existing URL rewrite configurations may lose query parameters that were previously passed through automatically
1526
+
- APIs relying on automatic parameter forwarding will receive incomplete requests
1527
+
1528
+
**Migration Required**
1529
+
Update your URL rewrite configurations to explicitly include any original query parameters you want to preserve. For example:
@@ -1580,10 +1592,28 @@ Updated the Tyk Gateway and Plugin Compiler to use Go 1.25, ensuring compatibili
1580
1592
1581
1593
<AccordionGroup>
1582
1594
1583
-
(TBR!!!!)<Accordiontitle='Fixed Log Level for Client TLS Certificate Requirement Errors'>
1595
+
<Accordiontitle='Fixed Log Level for Client TLS Certificate Requirement Errors'>
1584
1596
Resolved an issue where "Client TLS certificate is required" errors were logged at WARNING level, creating unnecessary noise in production logs. Previously, these common client-side authentication failures generated excessive warning-level log entries that could trigger false alerts and obscure more critical issues. The Gateway now logs these authentication failures at INFO level, maintaining security visibility while reducing log noise and alert fatigue for operations teams.
1585
1597
</Accordion>
1586
1598
1599
+
<Accordiontitle='Fixed malformed responses from Go plugins returning error status codes'>
1600
+
Resolved an issue where Go plugins returning error status codes caused duplicate `response.WriteHeader` calls, resulting in malformed response bodies that concatenated the original plugin response with additional Gateway error messages.
1601
+
1602
+
The Gateway now properly handles plugin-generated error responses without double-writing headers, ensuring response bodies contain only the original plugin content and eliminating superfluous WriteHeader warnings in logs.
1603
+
</Accordion>
1604
+
1605
+
<Accordiontitle='Fixed query parameter handling in Tyk internal loops (tyk://)'>
1606
+
Resolved inconsistent query parameter handling in URL rewrites using Tyk internal loops (`tyk://api-id/path`). Previously, custom query parameters specified in the `rewrite_to` URL were silently dropped, while original request parameters were unexpectedly preserved.
1607
+
1608
+
**What's Fixed:**
1609
+
- Query parameters explicitly added to `rewrite_to` URLs are now correctly passed to target APIs
1610
+
- Control parameters (`method`, `loop_limit`, `check_limits`) are properly consumed and removed
1611
+
- Behavior now matches standard HTTP URL rewrites for consistency
1612
+
1613
+
Original request query parameters are no longer automatically forwarded through internal loops. Update your URL rewrite configurations to explicitly include any required parameters in the `rewrite_to` URL.
1614
+
1615
+
</Accordion>
1616
+
1587
1617
<Accordiontitle='Fixed Client mTLS Authentication Between Tyk Gateways'>
1588
1618
Resolved an issue where a Tyk Gateway acting as a client (using upstream mTLS) would fail to authenticate against another mTLS-protected Tyk Gateway or upstream server, resulting in `HTTP 403 Forbidden: "Client TLS certificate is required"` errors.
0 commit comments