Skip to content

Commit 34284cd

Browse files
authored
Update gateway.mdx
1 parent 552e2bf commit 34284cd

1 file changed

Lines changed: 32 additions & 2 deletions

File tree

developer-support/release-notes/gateway.mdx

Lines changed: 32 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1516,8 +1516,20 @@ The Gateway and Plugin Compiler have been updated to Go 1.25, providing improved
15161516
For a comprehensive list of changes, please refer to the detailed [changelog](#Changelog-v5.8.14) below.
15171517

15181518
#### 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:
1530+
- **Before:** `"rewrite_to": "tyk://api-123/endpoint"` (original params auto-forwarded)
1531+
- **After:** `"rewrite_to": "tyk://api-123/endpoint?param1=$tyk_context.request_data.param1"`
15191532

1520-
There are no breaking changes in this release.
15211533

15221534
#### Dependencies
15231535
<a id="dependencies-5.8.14"></a>
@@ -1580,10 +1592,28 @@ Updated the Tyk Gateway and Plugin Compiler to use Go 1.25, ensuring compatibili
15801592

15811593
<AccordionGroup>
15821594

1583-
(TBR!!!!)<Accordion title='Fixed Log Level for Client TLS Certificate Requirement Errors'>
1595+
<Accordion title='Fixed Log Level for Client TLS Certificate Requirement Errors'>
15841596
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.
15851597
</Accordion>
15861598

1599+
<Accordion title='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+
<Accordion title='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+
15871617
<Accordion title='Fixed Client mTLS Authentication Between Tyk Gateways'>
15881618
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.
15891619

0 commit comments

Comments
 (0)