●Change8

Migrating to Consul Connect v1.22.0

Version v1.22.0 introduces 1 breaking change. This guide details how to update your code.

Released: 10/27/2025

1
Breaking Changes
1
Migration Steps
11
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

Envoy (bundled)Consul KV endpointevent endpointkey/value endpointDisableKVKeyValidation/v1/operator/utilizationconsul operator utilizationsnapshot agentagent/self APIupstream.local_bind_addressproxy.local_service_address

Breaking Changes

●Issue #1

Key name validation is now added on the key/value endpoint. If you were relying on path traversal behavior or had misconfigured ACLs, this may break existing operations. To disable this new validation, use the `DisableKVKeyValidation` config.

Migration Steps

  1. 1
    If you rely on path traversal in the KV endpoint or have misconfigured ACLs, review your configuration in light of the new key name validation introduced on the KV endpoint. Consider setting `DisableKVKeyValidation` if necessary.

Release Summary

Consul 1.22.0 delivers significant security enhancements, including DoS mitigations and key validation on the KV endpoint, alongside new features like multi-port service registration and OIDC JWT assertion support.

Need More Details?

View the full release notes and all changes for Consul Connect v1.22.0.

View Full Changelog