github.com/hashicorp/consul

BUG FIXES:

• agent: Fixed a bug in HTTP handlers where URLs were being decoded twice [GH-13264]
• fix a bug that caused an error when creating grpc or http2 ingress gateway listeners with multiple services [GH-13127]

SECURITY:

• agent: Use SHA256 instead of MD5 to generate persistence file names.

IMPROVEMENTS:

• sentinel: (Enterprise Only) Sentinel now uses SHA256 to generate policy ids

BUG FIXES:

• Fix a bug when configuring an add_headers directive named Host the header is not set for v1/internal/ui/metrics-proxy/ endpoint. [GH-13071]
• areas: (Enterprise Only) Fixes a bug when using Yamux pool ( for servers version 1.7.3 and later), the entire pool was locked while connecting to a remote location, which could potentially take a long time. [GH-1368]
• ca: fix a bug that caused a non blocking leaf cert query after a locking leaf cert query to block [GH-12820]
• health: ensure /v1/health/service/:service endpoint returns the most recent results when a filter is used with streaming #12640 [GH-12640]
• snapshot-agent: (Enterprise only) Fix a bug where providing the ACL token to the snapshot agent via a CLI or ENV variable without a license configured results in an error during license auto-retrieval.

NOTES:

• ci: change action to pull v1 instead of main [GH-12846]

SECURITY:

• agent: Added a new check field, disable_redirects, that allows for disabling the following of redirects for HTTP checks. The intention is to default this to true in a future release so that redirects must explicitly be enabled. [GH-12685]
• connect: Properly set SNI when configured for services behind a terminating gateway. [GH-12672]

IMPROVEMENTS:

• xds: ensure that all connect timeout configs can apply equally to tproxy direct dial connections [GH-12711]

DEPRECATIONS:

• tls: With the upgrade to Go 1.17, the ordering of tls_cipher_suites will no longer be honored, and tls_prefer_server_cipher_suites is now ignored. [GH-12766]

BUG FIXES:

• connect/ca: cancel old Vault renewal on CA configuration. Provide a 1 - 6 second backoff on repeated token renewal requests to prevent overwhelming Vault. [GH-12607]
• raft: upgrade to v1.3.6 which fixes a bug where a read replica node could attempt bootstrapping raft and prevent other nodes from bootstrapping at all [GH-12496]
• replication: Fixed a bug which could prevent ACL replication from continuing successfully after a leader election. [GH-12565]
• server: fix spurious blocking query suppression for discovery chains [GH-12512]

SECURITY:

• agent: Use SHA256 instead of MD5 to generate persistence file names.

FEATURES:

• ca: support using an external root CA with the vault CA provider [GH-11910]

IMPROVEMENTS:

• connect: Update supported Envoy versions to include 1.18.6 [GH-12450]
• connect: update Envoy supported version of 1.20 to 1.20.2 [GH-12434]
• debug: reduce the capture time for trace to only a single interval instead of the full duration to make trace.out easier to open without running into OOM errors. [GH-12359]
• raft: add additional logging of snapshot restore progress [GH-12325]
• rpc: improve blocking queries for items that do not exist, by continuing to block until they exist (or the timeout). [GH-12110]
• sentinel: (Enterprise Only) Sentinel now uses SHA256 to generate policy ids
• server: conditionally avoid writing a config entry to raft if it was already the same [GH-12321]
• server: suppress spurious blocking query returns where multiple config entries are involved [GH-12362]

BUG FIXES:

• agent: Parse datacenter from Create/Delete requests for AuthMethods and BindingRules. [GH-12370]
• areas: (Enterprise Only) Fixes a bug when using Yamux pool ( for servers version 1.7.3 and later), the entire pool was locked while connecting to a remote location, which could potentially take a long time. [GH-1368]
• raft: fixed a race condition in leadership transfer that could result in reelection of the current leader [GH-12325]
• server: (Enterprise only) Namespace deletion will now attempt to delete as many namespaced config entries as possible instead of halting on the first deletion that failed.
• server: partly fix config entry replication issue that prevents replication in some circumstances [GH-12307]
• ui: Ensure we always display the Policy default preview in the Namespace editing form [GH-12316]
• xds: Fixed Envoy http features such as outlier detection and retry policy not working correctly with transparent proxy. [GH-12385]

SECURITY:

• agent: Use SHA256 instead of MD5 to generate persistence file names.

IMPROVEMENTS:

• raft: Consul leaders will attempt to transfer leadership to another server as part of gracefully leaving the cluster. [GH-11376]
• sentinel: (Enterprise Only) Sentinel now uses SHA256 to generate policy ids

BUG FIXES:

• Fix a data race when a service is added while the agent is shutting down.. [GH-12302]
• areas: (Enterprise Only) Fixes a bug when using Yamux pool ( for servers version 1.7.3 and later), the entire pool was locked while connecting to a remote location, which could potentially take a long time. [GH-1368]
• config-entry: fix a panic when creating an ingress gateway config-entry and a proxy service instance, where both providedthe same upstream and downstrem mapping. [GH-12277]
• config: include all config errors in the error message, previously some could be hidden. [GH-11918]
• connect: fixes bug where passthrough addressses for transparent proxies dialed directly weren't being cleaned up. [GH-12223]
• memberlist: fixes a bug which prevented members from joining a cluster with large amounts of churn [GH-253] [GH-12047]
• snapshot: the snapshot save command now saves the snapshot with read permission for only the current user. [GH-11918]
• xds: allow only one outstanding delta request at a time [GH-12236]
• xds: fix for delta xDS reconnect bug in LDS/CDS [GH-12174]
• xds: prevents tight loop where the Consul client agent would repeatedly re-send config that Envoy has rejected. [GH-12195]a

SECURITY:

• namespaces: (Enterprise only) Creating or editing namespaces that include default ACL policies or ACL roles now requires acl:write permission in the default namespace. This change fixes CVE-2021-41805.

FEATURES:

• ui: Adds visible Consul version information [GH-11803]

BUG FIXES:

• Mutate NodeService struct properly to avoid a data race. [GH-11940]
• Upgrade to raft 1.3.3 which fixes a bug where a read replica node can trigger a raft election and become a leader. [GH-11958]
• ca: fixes a bug that caused non blocking leaf cert queries to return the same cached response regardless of ca rotation or leaf cert expiry [GH-11693]
• ca: fixes a bug that caused the SigningKeyID to be wrong in the primary DC, when the Vault provider is used, after a CA config creates a new root. [GH-11672]
• ca: fixes a bug that caused the intermediate cert used to sign leaf certs to be missing from the /connect/ca/roots API response when the Vault provider was used. [GH-11671]
• cli: Display assigned node identities in output of consul acl token list. [GH-11926]
• cli: when creating a private key, save the file with mode 0600 so that only the user has read permission. [GH-11781]
• snapshot: (Enterprise only) fixed a bug where the snapshot agent would ignore the license_path setting in config files
• structs: (Enterprise only) Remove partition field parsing from 1.10 to prevent further 1.11 upgrade compatibility issues.
• ui: Differentiate between Service Meta and Node Meta when choosing search fields in Service Instance listings [GH-11774]
• ui: Ensure we show a readonly designed page for readonly intentions [GH-11767]
• ui: Fix an issue where attempting to delete a policy from the policy detail page when attached to a token would result in the delete button disappearing and no deletion being attempted [GH-11868]
• ui: Fix visual issue with slight table header overflow [GH-11670]
• ui: Fixes an issue where once a 403 page is displayed in some circumstances its diffcult to click back to where you where before receiving a 403 [GH-11891]
• ui: Fixes an issue where under some circumstances after logging we present the data loaded previous to you logging in. [GH-11681]
• ui: Include Service.Namespace into available variables for dashboard_url_templates [GH-11640]
• ui: Revert to depending on the backend, 'post-user-action', to report permissions errors rather than using UI capabilities 'pre-user-action' [GH-11520]
• ui: Temporarily remove KV pre-flight check for KV list permissions [GH-11968]
• windows: Fixes a bug with empty log files when Consul is run as a Windows Service [GH-11960]
• xds: fix a deadlock when the snapshot channel already have a snapshot to be consumed. [GH-11924]

SECURITY:

• ci: Upgrade golang.org/x/net to address CVE-2021-44716 [GH-11856]

SECURITY:

• ci: Upgrade to Go 1.16.12 to address CVE-2021-44716 [GH-11808]

BUG FIXES:

• agent: (Enterprise only) fix bug where 1.10.x agents would deregister serf checks from 1.11.x servers [GH-11700]

SECURITY:

• agent: Use SHA256 instead of MD5 to generate persistence file names. [GH-11491]
• namespaces: (Enterprise only) Creating or editing namespaces that include default ACL policies or ACL roles now requires acl:write permission in the default namespace. This change fixes CVE-2021-41805.

IMPROVEMENTS:

• ci: Artifact builds will now only run on merges to the release branches or to main [GH-11417]
• ci: The Linux packages are now available for all supported Linux architectures including arm, arm64, 386, and amd64 [GH-11417]
• ci: The Linux packaging service configs and pre/post install scripts are now available under [.release/linux] [GH-11417]
• connect/ca: Return an error when querying roots from uninitialized CA. [GH-11514]
• telemetry: Add new metrics for the count of connect service instances and configuration entries. [GH-11222]

BUG FIXES:

• acl: fixes the fallback behaviour of down_policy with setting extend-cache/async-cache when the token is not cached. [GH-11136]
• api: fixed backwards compatibility issue with AgentService SocketPath field. [GH-11318]
• connect/ca: Allow secondary initialization to resume after being deferred due to unreachable or incompatible primary DC servers. [GH-11514]
• connect: fix issue with attempting to generate an invalid upstream cluster from UpstreamConfig.Defaults. [GH-11245]
• raft: do not trigger an election if not part of the servers list. [GH-11375]
• rpc: only attempt to authorize the DNSName in the client cert when verify_incoming_rpc=true [GH-11255]
• server: (Enterprise only) Ensure that servers leave network segments when leaving other gossip pools
• snapshot: (Enterprise only) snapshot agent no longer attempts to refresh its license from the server when a local license is provided (i.e. via config or an environment variable)
• telemetry: Consul Clients no longer emit Autopilot metrics. [GH-11241]
• telemetry: fixes a bug with Prometheus consul_autopilot_failure_tolerance metric where 0 is reported instead of NaN on follower servers. [GH-11399]
• telemetry: fixes a bug with Prometheus consul_autopilot_healthy metric where 0 is reported instead of NaN on servers. [GH-11231]
• ui: (Enterprise only) When no namespace is selected, make sure to default to the tokens default namespace when requesting permissions [GH-11472]
• ui: Ensure we check intention permissions for specific services when deciding whether to show action buttons for per service intention actions [GH-11270]
• ui: Fixed styling of Role remove dialog on the Token edit page [GH-11298]
• xds: fixes a bug where replacing a mesh gateway node used for WAN federation (with another that has a different IP) could leave gateways in the other DC unable to re-establish the connection [GH-11522]

BUG FIXES:

• Fixing SOA record to return proper domain when alt domain in use. [GH-10431]

FEATURES:

• sso/oidc: (Enterprise only) Add support for providing acr_values in OIDC auth flow [GH-11026]

IMPROVEMENTS:

• audit-logging: (Enterprise Only) Audit logs will now include select HTTP headers in each logs payload. Those headers are: Forwarded, Via, X-Forwarded-For, X-Forwarded-Host and X-Forwarded-Proto. [GH-11107]
• connect: update supported envoy versions to 1.18.4, 1.17.4, 1.16.5 [GH-10961]
• telemetry: Add new metrics for the count of KV entries in the Consul store. [GH-11090]

BUG FIXES:

• api: Revert early out errors from license APIs to allow v1.10+ clients to manage licenses on older servers [GH-10952]
• connect: Fix upstream listener escape hatch for prepared queries [GH-11109]
• grpc: strip local ACL tokens from RPCs during forwarding if crossing datacenters [GH-11099]
• tls: consider presented intermediates during server connection tls handshake. [GH-10964]
• ui: (Enterprise Only) Fix saving intentions with namespaced source/destination [GH-11095]
• ui: Don't show a CRD warning for read-only intentions [GH-11149]
• ui: Ensure routing-config page blocking queries are cleaned up correctly [GH-10915]
• ui: Ignore reported permissions for KV area meaning the KV is always enabled for both read/write access if the HTTP API allows. [GH-10916]
• ui: hide create button for policies/roles/namespace if users token has no write permissions to those areas [GH-10914]
• xds: ensure the active streams counters are 64 bit aligned on 32 bit systems [GH-11085]
• xds: fixed a bug where Envoy sidecars could enter a state where they failed to receive xds updates from Consul [GH-10987]

KNOWN ISSUES:

• tls: The fix for CVE-2021-37219 introduced an issue that could prevent TLS certificate validation when intermediate CA certificates used to sign server certificates are transmitted in the TLS session but are not present in all Consul server's configured CA certificates. This has the effect of preventing Raft RPCs between the affected servers. As a work around until the next patch releases, ensure that all intermediate CA certificates are present in all Consul server configurations prior to using certificates that they have signed.

SECURITY:

• rpc: authorize raft requests CVE-2021-37219 [GH-10931]

FEATURES:

• connect: add support for unix domain socket config via API/CLI [GH-10758]
• ui: Adding support in Topology view for Routing Configurations [GH-10872]
• ui: Create Routing Configurations route and page [GH-10835]
• ui: Splitting up the socket mode and socket path in the Upstreams Instance List [GH-10581]

IMPROVEMENTS:

• areas: (Enterprise only) Add 15s timeout to opening streams over pooled connections.
• areas: (Enterprise only) Apply backpressure to area gossip packet ingestion when more than 512 packets are waiting to be ingested.
• areas: (Enterprise only) Make implementation of WriteToAddress non-blocking to avoid slowing down memberlist's packetListen routine.
• checks: Add Interval and Timeout to API response. [GH-10717]
• ci: make changelog-checker only validate PR number against main base [GH-10844]
• ci: upgrade to use Go 1.16.7 [GH-10856]
• deps: update to gogo/protobuf v1.3.2 [GH-10813]
• proxycfg: log correlation IDs for the proxy configuration snapshot's blocking queries. [GH-10689]

BUG FIXES:

• acl: fixes a bug that prevented the default user token from being used to authorize service registration for connect proxies. [GH-10824]
• ca: fixed a bug when ca provider fail and provider state is stuck in INITIALIZING state. [GH-10630]
• ca: report an error when setting the ca config fail because of an index check. [GH-10657]
• cli: Ensure the metrics endpoint is accessible when Envoy is configured to use a non-default admin bind address. [GH-10757]
• cli: Fix a bug which prevented initializing a watch when using a namespaced token. [GH-10795]
• cli: Fix broken KV import command on Windows. [GH-10820]
• connect: ensure SAN validation for prepared queries validates against all possible prepared query targets [GH-10873]
• connect: fix crash that would result from multiple instances of a service resolving service config on a single agent. [GH-10647]
• connect: proxy upstreams inherit namespace from service if none are defined. [GH-10688]
• dns: fixes a bug with edns truncation where the response could exceed the size limit in some cases. [GH-10009]
• grpc: ensure that streaming gRPC requests work over mesh gateway based wan federation [GH-10838]
• http: log cancelled requests as such at the INFO level, instead of logging them as errored requests. [GH-10707]
• streaming: set the default wait timeout for health queries [GH-10707]
• txn: fixes Txn.Apply to properly authorize service registrations. [GH-10798]
• ui: Disabling policy form fields from users with 'read' permissions [GH-10902]
• ui: Fix Health Checks in K/V form Lock Sessions Info section [GH-10767]
• ui: Fix dropdown option duplication in the new intentions form [GH-10706]
• ui: Hide all metrics for ingress gateway services [GH-10858]
• ui: Properly encode non-URL safe characters in OIDC responses [GH-10901]
• ui: fixes a bug with some service failovers not showing the routing tab visualization [GH-10913]

KNOWN ISSUES:

• The change to enable streaming by default uncovered an incompatibility between streaming and WAN federation over mesh gateways causing traffic to fall back to attempting a direct WAN connection rather than transiting through the gateways. We currently suggest explicitly setting use_streaming_backend=false if using WAN federation over mesh gateways when upgrading to 1.10.1 and are working to address this issue in a future patch release.

SECURITY:

• xds: ensure envoy verifies the subject alternative name for upstreams CVE-2021-32574 [GH-10621]
• xds: ensure single L7 deny intention with default deny policy does not result in allow action CVE-2021-36213 [GH-10619]

FEATURES:

• cli: allow running redirect-traffic command in a provided Linux namespace. [GH-10564]
• sdk: allow applying iptables rules in a provided Linux namespace. [GH-10564]

IMPROVEMENTS:

• acl: Return secret ID when listing tokens if accessor has acl:write [GH-10546]
• structs: prevent service-defaults upstream configs from using wildcard names or namespaces [GH-10475]
• ui: Move all CSS icons to use standard CSS custom properties rather than SASS variables [GH-10298]

DEPRECATIONS:

• connect/ca: remove the RotationPeriod field from the Consul CA provider, it was not used for anything. [GH-10552]

BUG FIXES:

• agent: fix a panic on 32-bit platforms caused by misaligned struct fields used with sync/atomic. [GH-10515]
• ca: Fixed a bug that returned a malformed certificate chain when the certificate did not having a trailing newline. [GH-10411]
• checks: fixes the default ServerName used with TLS health checks. [GH-10490]
• connect/proxy: fixes logic bug preventing builtin/native proxy from starting upstream listeners [GH-10486]
• streaming: fix a bug that was preventing streaming from being enabled. [GH-10514]
• ui: (Enterprise only) Ensure permissions are checked based on the actively selected namespace [GH-10608]
• ui: Ensure in-folder KVs are created in the correct folder [GH-10569]
• ui: Fix KV editor syntax highlighting [GH-10605]
• ui: Send service name down to Stats to properly call endpoint for Upstreams and Downstreams metrics [GH-10535]
• ui: Show ACLs disabled page at Tokens page instead of 403 error when ACLs are disabled [GH-10604]
• ui: Use the token's namespace instead of the default namespace when not specifying a namespace in the URL [GH-10503]

BREAKING CHANGES:

• connect: Disallow wildcard as name for service-defaults. [GH-10069]
• connect: avoid encoding listener info in ingress and terminating gateway listener stats names. [GH-10404]
• licensing: (Enterprise Only) Consul Enterprise 1.10 has removed API driven licensing of servers in favor of license loading via configuration. The PUT and DELETE methods on the /v1/operator/license endpoint will now return 405s, the consul license put and consul license reset CLI commands have been removed and the LicensePut and LicenseReset methods in the API client have been altered to always return an error. [GH-10211]
• licensing: (Enterprise Only) Consul Enterprise client agents now require a valid non-anonymous ACL token for retrieving their license from the servers. Additionally client agents rely on the value of the start_join and retry_join configurations for determining the servers to query for the license. Therefore one must be set to use license auto-retrieval. [GH-10248]
• licensing: (Enterprise Only) Consul Enterprise has removed support for temporary licensing. All server agents must have a valid license at startup and client agents must have a license at startup or be able to retrieve one from the servers. [GH-10248]

FEATURES:

• checks: add H2 ping health checks. [GH-8431]
• cli: Add additional flags to the consul connect redirect-traffic command to allow excluding inbound and outbound ports, outbound CIDRs, and additional user IDs from traffic redirection. [GH-10134]
• cli: Add new consul connect redirect-traffic command for applying traffic redirection rules when Transparent Proxy is enabled. [GH-9910]
• cli: Add prefix option to kv import command [GH-9792]
• cli: Automatically exclude ports from envoy_prometheus_bind_addr, envoy_stats_bind_addr, and ListenerPort from Expose config from inbound traffic redirection rules if proxy-id flag is provided to the consul connect redirect-traffic command. [GH-10134]
• cli: snapshot inspect command provides KV usage breakdown [GH-9098]
• cli: snapshot inspect command supports JSON output [GH-9006]
• connect: Add local_request_timeout_ms to allow configuring the Envoy request timeout on local_app [GH-9554]
• connect: add support for unix domain sockets addresses for service upstreams and downstreams [GH-9981]
• connect: add toggle to globally disable wildcard outbound network access when transparent proxy is enabled [GH-9973]
• connect: generate upstream service labels for terminating gateway listener stats. [GH-10404]
• sdk: Add new iptables package for applying traffic redirection rules with iptables. [GH-9910]
• sdk: Allow excluding inbound and outbound ports, outbound CIDRs, and additional user IDs from traffic redirection in the iptables package. [GH-10134]
• ui: Add Unix Domain Socket support [GH-10287]
• ui: Create a collapsible notices component for the Topology tab [GH-10270]
• ui: Read-only ACL Auth Methods view [GH-9617]
• ui: Transparent Proxy - Service mesh visualization updates [GH-10002]
• xds: emit a labeled gauge of connected xDS streams by version [GH-10243]
• xds: exclusively support the Incremental xDS protocol when using xDS v3 [GH-9855]

IMPROVEMENTS:

• acl: extend the auth-methods list endpoint to include MaxTokenTTL and TokenLocality fields. [GH-9741]
• acl: use the presence of a management policy in the state store as a sign that we already migrated to v2 acls [GH-9505]
• agent: Save exposed Envoy ports to the agent's state when Expose.Checks is true in proxy's configuration. [GH-10173]
• api: Add ExposedPort to the health check API resource. [GH-10173]
• api: Enable setting query options on agent endpoints. [GH-9903]
• api: The Content-Type header is now always set when a body is present in a request. [GH-10204]
• cli: snapshot inspect command can now inspect raw snapshots from a server's data dir. [GH-10089]
• cli: the consul connect envoy --envoy_statsd_url flag will now resolve the $HOST_IP environment variable, as part of a full url. [GH-8564]
• command: Exclude exposed Envoy ports from traffic redirection when providing -proxy-id and Expose.Checks is set. [GH-10173]
• connect: Add support for transparently proxying traffic through Envoy. [experimental] [GH-9894]
• connect: Allow per-upstream configuration to be set in service-defaults. [experimental] [GH-9872]
• connect: Ensures passthrough tproxy cluster is created even when mesh config doesn't exist. [GH-10301]
• connect: Support dialing individual service IP addresses through transparent proxies. [GH-10329]
• connect: The builtin connect proxy no longer advertises support for h2 via ALPN. [GH-4466]. [GH-9920]
• connect: Update the service mesh visualization to account for transparent proxies. [GH-10016]
• connect: adds new flags prometheus-backend-port and prometheus-scrape-port to consul connect envoy to support envoy_prometheus_bind_addr pointing to the merged metrics port when using Consul Connect on K8s. [GH-9768]
• connect: allow exposing duplicate HTTP paths through a proxy instance. [GH-10394]
• connect: rename cluster config entry to mesh. [GH-10127]
• connect: restrict transparent proxy mode to only match on the tagged virtual IP address. [GH-10162]
• connect: update supported envoy versions to 1.18.2, 1.17.2, 1.16.3, 1.15.4 [GH-10101]
• connect: update supported envoy versions to 1.18.3, 1.17.3, 1.16.4, and 1.15.5 [GH-10231]
• debug: capture a single stream of logs, and single pprof profile and trace for the whole duration [GH-10279]
• grpc: move gRPC INFO logs to be emitted as TRACE logs from Consul [GH-10395]
• licensing: (Enterprise Only) Consul Enterprise has gained the consul license inspect CLI command for inspecting a license without applying it..
• licensing: (Enterprise Only) Consul Enterprise has gained the ability to autoload a license via configuration. This can be specified with the license_path configuration, the CONSUL_LICENSE environment variable or the CONSUL_LICENSE_PATH environment variable [GH-10210]
• licensing: (Enterprise Only) Consul Enterprise has gained the ability update its license via a configuration reload. The same environment variables and configurations will be used to determine the new license. [GH-10267]
• monitoring: optimize the monitoring endpoint to avoid losing logs when under high load. [GH-10368]
• raft: allow reloading of raft trailing logs and snapshot timing to allow recovery from some replication failure modes. telemetry: add metrics and documentation for monitoring for replication issues. [GH-10129]
• streaming: change use_streaming_backend to default to true so that streaming is used by default when it is supported. [GH-10149]
• ui: Add 'optional route segments' and move namespaces to use them [GH-10212]
• ui: Adding a notice about how TransparentProxy mode affects the Upstreams list at the top of tab view [GH-10136]
• ui: Improve loader centering with new side navigation [GH-10181]
• ui: Move to a sidebar based main navigation [GH-9553]
• ui: Show a message to explain that health checks may be out of date if the serf health check is in a critical state [GH-10194]
• ui: Updating the wording for the banner and the popover for a service with an upstream that is not explicitly defined. [GH-10133]
• ui: Use older (~2016) native ES6 features to reduce transpilation and UI JS payload [GH-9729]
• ui: add permanently visible indicator when ACLs are disabled [GH-9864]
• ui: improve accessibility of modal dialogs [GH-9819]
• ui: restrict the viewing/editing of certain UI elements based on the users ACL token [GH-9687]
• ui: updates the ui with the new consul brand assets [GH-10081]
• xds: add support for envoy 1.17.0 [GH-9658]
• xds: default to speaking xDS v3, but allow for v2 to be spoken upon request [GH-9658]
• xds: ensure that all envoyproxy/go-control-plane protobuf symbols are linked into the final binary [GH-10131]
• xds: remove deprecated usages of xDS and drop support for envoy 1.13.x [GH-9602]

BUG FIXES:

• checks: add TLSServerName field to allow setting the TLS server name for HTTPS health checks. [GH-9475]
• config: Fixed a bug where rpc_max_conns_per_client could not be changed by reloading the config. [GH-8696]
• connect: Fix bug that prevented transparent proxies from working when mesh config restricted routing to catalog destinations. [GH-10365]
• memberlist: fixes a couple bugs which allowed malformed input to cause a crash in a Consul client or server. [GH-10161]
• monitor: fix monitor to produce json format logs when requested [GH-10358]
• proxycfg: Ensure that endpoints for explicit upstreams in other datacenters are watched in transparent mode. [GH-10391]
• proxycfg: avoid panic when transparent proxy upstream is added and then removed. [GH-10423]
• streaming: fixes a bug that would cause context cancellation errors when a cache entry expired while requests were active. [GH-10112]
• streaming: lookup in health properly handle case-sensitivity and perform filtering based on tags and node-meta [GH-9703]
• telemetry: fixes a bug with Prometheus metrics where Gauges and Summaries were incorrectly being expired. [GH-10161]
• ui: Adding conditional to prevent Service Mesh from breaking when there are no Upstreams [GH-10122]
• ui: Fix text searching through upstream instances. [GH-10151]
• ui: Update conditional for topology empty state [GH-10124]
• ui: ensure proxy instance API requests perform blocking queries correctly [GH-10039]
• xds: (beta-only) ensure that dependent xDS resources are reconfigured during primary type warming [GH-10381]

NOTES:

• legal: (Enterprise only) Enterprise binary downloads will now include a copy of the EULA and Terms of Evaluation in the zip archive

SECURITY:

• agent: Added a new check field, disable_redirects, that allows for disabling the following of redirects for HTTP checks. The intention is to default this to true in a future release so that redirects must explicitly be enabled. [GH-12685]
• connect: Properly set SNI when configured for services behind a terminating gateway. [GH-12672]

DEPRECATIONS:

• tls: With the upgrade to Go 1.17, the ordering of tls_cipher_suites will no longer be honored, and tls_prefer_server_cipher_suites is now ignored. [GH-12767]

BUG FIXES:

• connect/ca: cancel old Vault renewal on CA configuration. Provide a 1 - 6 second backoff on repeated token renewal requests to prevent overwhelming Vault. [GH-12607]
• memberlist: fixes a bug which prevented members from joining a cluster with large amounts of churn [GH-253] [GH-12046]
• replication: Fixed a bug which could prevent ACL replication from continuing successfully after a leader election. [GH-12565]

FEATURES:

• ca: support using an external root CA with the vault CA provider [GH-11910]

IMPROVEMENTS:

• sentinel: (Enterprise Only) Sentinel now uses SHA256 to generate policy ids
• server: conditionally avoid writing a config entry to raft if it was already the same [GH-12321]

BUG FIXES:

• agent: Parse datacenter from Create/Delete requests for AuthMethods and BindingRules. [GH-12370]
• areas: (Enterprise Only) Fixes a bug when using Yamux pool ( for servers version 1.7.3 and later), the entire pool was locked while connecting to a remote location, which could potentially take a long time. [GH-1368]
• server: (Enterprise only) Namespace deletion will now attempt to delete as many namespaced config entries as possible instead of halting on the first deletion that failed.
• server: partly fix config entry replication issue that prevents replication in some circumstances [GH-12307]
• ui: Ensure we always display the Policy default preview in the Namespace editing form [GH-12316]

IMPROVEMENTS:

• sentinel: (Enterprise Only) Sentinel now uses SHA256 to generate policy ids

BUG FIXES:

• Fix a data race when a service is added while the agent is shutting down.. [GH-12302]
• areas: (Enterprise Only) Fixes a bug when using Yamux pool ( for servers version 1.7.3 and later), the entire pool was locked while connecting to a remote location, which could potentially take a long time. [GH-1368]
• config-entry: fix a panic when creating an ingress gateway config-entry and a proxy service instance, where both provided the same upstream and downstream mapping. [GH-12277]
• config: include all config errors in the error message, previously some could be hidden. [GH-11918]
• snapshot: the snapshot save command now saves the snapshot with read permission for only the current user. [GH-11918]

SECURITY:

• namespaces: (Enterprise only) Creating or editing namespaces that include default ACL policies or ACL roles now requires acl:write permission in the default namespace. This change fixes CVE-2021-41805.

BUG FIXES:

• ca: fixes a bug that caused non blocking leaf cert queries to return the same cached response regardless of ca rotation or leaf cert expiry [GH-11693]
• ca: fixes a bug that caused the intermediate cert used to sign leaf certs to be missing from the /connect/ca/roots API response when the Vault provider was used. [GH-11671]
• cli: Display assigned node identities in output of consul acl token list. [GH-11926]
• cli: when creating a private key, save the file with mode 0600 so that only the user has read permission. [GH-11781]
• snapshot: (Enterprise only) fixed a bug where the snapshot agent would ignore the license_path setting in config files
• ui: Differentiate between Service Meta and Node Meta when choosing search fields in Service Instance listings [GH-11774]
• ui: Fixes an issue where under some circumstances after logging we present the data loaded previous to you logging in. [GH-11681]
• ui: Fixes an issue where under some circumstances the namespace selector could become 'stuck' on the default namespace [GH-11830]
• ui: Include Service.Namespace into available variables for dashboard_url_templates [GH-11640]
• ui: Prevent disconnection notice appearing with auth change on certain pages [GH-11905]
• xds: fix a deadlock when the snapshot channel already have a snapshot to be consumed. [GH-11924]

SECURITY:

• ci: Upgrade golang.org/x/net to address CVE-2021-44716 [GH-11858]

SECURITY:

• ci: Upgrade to Go 1.16.12 to address CVE-2021-44716 [GH-11807]

SECURITY:

• agent: Use SHA256 instead of MD5 to generate persistence file names. [GH-11491]
• namespaces: (Enterprise only) Creating or editing namespaces that include default ACL policies or ACL roles now requires acl:write permission in the default namespace. This change fixes CVE-2021-41805.

IMPROVEMENTS:

• ci: Artifact builds will now only run on merges to the release branches or to main [GH-11417]
• ci: The Linux packages are now available for all supported Linux architectures including arm, arm64, 386, and amd64 [GH-11417]
• ci: The Linux packaging service configs and pre/post install scripts are now available under [.release/linux] [GH-11417]
• telemetry: Add new metrics for the count of connect service instances and configuration entries. [GH-11222]

BUG FIXES:

• acl: fixes the fallback behaviour of down_policy with setting extend-cache/async-cache when the token is not cached. [GH-11136]
• rpc: only attempt to authorize the DNSName in the client cert when verify_incoming_rpc=true [GH-11255]
• server: (Enterprise only) Ensure that servers leave network segments when leaving other gossip pools
• ui: Fixed styling of Role remove dialog on the Token edit page [GH-11298]
• xds: fixes a bug where replacing a mesh gateway node used for WAN federation (with another that has a different IP) could leave gateways in the other DC unable to re-establish the connection [GH-11522]

FEATURES:

• sso/oidc: (Enterprise only) Add support for providing acr_values in OIDC auth flow [GH-11026]

IMPROVEMENTS:

• audit-logging: (Enterprise Only) Audit logs will now include select HTTP headers in each logs payload. Those headers are: Forwarded, Via, X-Forwarded-For, X-Forwarded-Host and X-Forwarded-Proto. [GH-11107]
• connect: update supported envoy versions to 1.16.5 [GH-10961]
• telemetry: Add new metrics for the count of KV entries in the Consul store. [GH-11090]

BUG FIXES:

• tls: consider presented intermediates during server connection tls handshake. [GH-10964]
• ui: (Enterprise Only) Fix saving intentions with namespaced source/destination [GH-11095]

KNOWN ISSUES:

• tls: The fix for CVE-2021-37219 introduced an issue that could prevent TLS certificate validation when intermediate CA certificates used to sign server certificates are transmitted in the TLS session but are not present in all Consul server's configured CA certificates. This has the effect of preventing Raft RPCs between the affected servers. As a work around until the next patch releases, ensure that all intermediate CA certificates are present in all Consul server configurations prior to using certificates that they have signed.

SECURITY:

• rpc: authorize raft requests CVE-2021-37219 [GH-10932]

IMPROVEMENTS:

• areas: (Enterprise only) Add 15s timeout to opening streams over pooled connections.
• areas: (Enterprise only) Apply backpressure to area gossip packet ingestion when more than 512 packets are waiting to be ingested.
• areas: (Enterprise only) Make implementation of WriteToAddress non-blocking to avoid slowing down memberlist's packetListen routine.
• deps: update to gogo/protobuf v1.3.2 [GH-10813]

BUG FIXES:

• acl: fixes a bug that prevented the default user token from being used to authorize service registration for connect proxies. [GH-10824]
• ca: fixed a bug when ca provider fail and provider state is stuck in INITIALIZING state. [GH-10630]
• ca: report an error when setting the ca config fail because of an index check. [GH-10657]
• cli: Ensure the metrics endpoint is accessible when Envoy is configured to use a non-default admin bind address. [GH-10757]
• cli: Fix a bug which prevented initializing a watch when using a namespaced token. [GH-10795]
• connect: proxy upstreams inherit namespace from service if none are defined. [GH-10688]
• dns: fixes a bug with edns truncation where the response could exceed the size limit in some cases. [GH-10009]
• txn: fixes Txn.Apply to properly authorize service registrations. [GH-10798]
• ui: Fix dropdown option duplication in the new intentions form [GH-10706]
• ui: Hide all metrics for ingress gateway services [GH-10858]
• ui: Properly encode non-URL safe characters in OIDC responses [GH-10901]
• ui: fixes a bug with some service failovers not showing the routing tab visualization [GH-10913]

SECURITY:

• xds: ensure envoy verifies the subject alternative name for upstreams CVE-2021-32574 [GH-10621]
• xds: ensure single L7 deny intention with default deny policy does not result in allow action CVE-2021-36213 [GH-10619]

BUG FIXES:

• ca: Fixed a bug that returned a malformed certificate chain when the certificate did not having a trailing newline. [GH-10411]
• ui: Send service name down to Stats to properly call endpoint for Upstreams and Downstreams metrics [GH-10535]

IMPROVEMENTS:

• debug: capture a single stream of logs, and single pprof profile and trace for the whole duration [GH-10279]
• licensing: (Enterprise Only) In order to have forward compatibility with Consul Enterprise v1.10, the ability to parse licenses from the configuration or environment has been added. This can be specified with the license_path configuration, the CONSUL_LICENSE environment variable or the CONSUL_LICENSE_PATH environment variable. On server agents this configuration will be ignored. Client agents and the snapshot agent will use the configured license instead of automatically retrieving one. [GH-10441]
• monitoring: optimize the monitoring endpoint to avoid losing logs when under high load. [GH-10368]

BUG FIXES:

• license: (Enterprise only) Fixed an issue that would cause client agents on versions before 1.10 to not be able to retrieve the license from a 1.10+ server. [GH-10432]
• monitor: fix monitor to produce json format logs when requested [GH-10358]

IMPROVEMENTS:

• acl: Give more descriptive error if auth method not found. [GH-10163]
• areas: (Enterprise only) Use server agent's gossip_wan config when setting memberlist configuration for network areas. Previously they used memberlists WAN defaults.
• cli: added a -force-without-cross-signing flag to the ca set-config command. connect/ca: The ForceWithoutCrossSigning field will now work as expected for CA providers that support cross signing. [GH-9672]
• connect: update supported envoy versions to 1.16.3, 1.15.4, 1.14.7, 1.13.7 [GH-10105]
• connect: update supported envoy versions to 1.16.4, 1.15.5, 1.14.6, and 1.13.7 [GH-10232]
• telemetry: Add new metrics for status of secondary datacenter replication. [GH-10073]
• telemetry: The usage data in the metrics API now includes cluster member counts, reporting clients on a per segment basis. [GH-10340]
• ui: Added CRD popover 'informed action' for intentions managed by CRDs [GH-10100]
• ui: Added humanized formatting to lock session durations [GH-10062]
• ui: Only show a partial list of intention permissions, with the option to show all [GH-10174]
• ui: updates the ui with the new consul brand assets [GH-10090]

BUG FIXES:

• agent: ensure we hash the non-deprecated upstream fields on ServiceConfigRequest [GH-10240]
• agent: fix logging output by removing leading whitespace from every log line [GH-10338]
• api: include the default value of raft settings in the output of /v1/agent/self [GH-8812]
• areas: (Enterprise only) Revert to the 10s dial timeout used before connection pooling was introduced in 1.7.3.
• areas: (Enterprise only) Selectively merge gossip_wan config for network areas to avoid attempting to enable gossip encryption where it was not intended or necessary.
• autopilot: (Enterprise only) Fixed an issue where autopilot could cause a new leader to demote the wrong voter when redundancy zones are in use and the previous leader failed. [GH-10306]
• cli: removes the need to set debug_enabled=true to collect debug data from the CLI. Now the CLI behaves the same way as the API and accepts either an ACL token with operator:read, or debug_enabled=true. [GH-10273]
• cli: snapshot inspect command would panic on invalid input. [GH-10091]
• envoy: fixes a bug where a large envoy config could cause the consul connect envoy command to deadlock when attempting to start envoy. [GH-10324]
• http: fix a bug that caused the X-Consul-Effective-Consistency header to be missing on request for service health [GH-10189]
• local: agents will no longer persist the default user token along with a service or check. [GH-10188]
• namespaces: (Enterprise only) fixes a problem where the logs would contain many warnings about namespaces not being licensed.
• server: ensure that central service config flattening properly resets the state each time [GH-10239]
• ui: Add conditionals to lock sessions tab [GH-10121]
• ui: De-duplicate tags in rendered tag listings [GH-10186]
• ui: Don't render a DOM element for empty namespace descriptions [GH-10157]
• ui: Reflect the change of Session API response shape for Checks in post 1.7 Consul [GH-10225]
• ui: Removes the extra rendering of namespace in service upstream list [GH-10152]

SECURITY:

• Add content-type headers to raw KV responses to prevent XSS attacks CVE-2020-25864 [GH-10023]
• audit-logging: Parse endpoint URL to prevent requests from bypassing the audit log CVE-2021-28156

IMPROVEMENTS:

• api: AutopilotServerHelath now handles the 429 status code returned by the v1/operator/autopilot/health endpoint and still returned the parsed reply which will indicate server healthiness [GH-8599]
• client: when a client agent is attempting to dereigster a service, anddoes not have access to the ACL token used to register a service, attempt to use the agent token instead of the default user token. If no agent token is set, fall back to the default user token. [GH-9683]
• connect: Automatically rewrite the Host header for Terminating Gateway HTTP services [GH-9042]
• ui: support stricter content security policies [GH-9847]

BUG FIXES:

• api: ensure v1/health/ingress/:service endpoint works properly when streaming is enabled [GH-9967]
• areas: Fixes a bug which would prevent newer servers in a network areas from connecting to servers running a version of Consul prior to 1.7.3.
• audit-logging: (Enterprise only) Fixed an issue that resulted in usage of the agent master token or managed service provider tokens from being resolved properly. [GH-10013]
• cache: fix a bug in the client agent cache where streaming could potentially leak resources. [GH-9978]. [GH-9978]
• cache: fix a bug in the client agent cache where streaming would disconnect every 20 minutes and cause delivery delays. [GH-9979]. [GH-9979]
• command: when generating envoy bootstrap configs to stdout do not mix informational logs into the json [GH-9980]
• config: correct config key from advertise_addr_ipv6 to advertise_addr_wan_ipv6 [GH-9851]
• http: fix a bug in Consul Enterprise that would cause the UI to believe namespaces were supported, resulting in warning logs and incorrect UI behaviour. [GH-9923]
• snapshot: fixes a bug that would cause snapshots to be missing all but the first ACL Auth Method. [GH-10025]
• ui: Fix intention form cancel button [GH-9901]

IMPROVEMENTS:

• connect: if the token given to the vault provider returns no data avoid a panic [GH-9806]
• connect: update supported envoy point releases to 1.16.2, 1.15.3, 1.14.6, 1.13.7 [GH-9737]
• xds: only try to create an ipv6 expose checks listener if ipv6 is supported by the kernel [GH-9765]

BUG FIXES:

• api: Remove trailing periods from the gateway internal HTTP API endpoint [GH-9752]
• cache: Prevent spamming the logs for days when a cached request encounters an "ACL not found" error. [GH-9738]
• connect: connect CA Roots in the primary datacenter should use a SigningKeyID derived from their local intermediate [GH-9428]
• proxycfg: avoid potential deadlock in delivering proxy snapshot to watchers. [GH-9689]
• replication: Correctly log all replication warnings that should not be suppressed [GH-9320]
• streaming: fixes a bug caused by caching an incorrect snapshot, that would cause clients to error until the cache expired. [GH-9772]
• ui: Exclude proxies when showing the total number of instances on a node. [GH-9749]
• ui: Fixed a bug in older browsers relating to String.replaceAll and fieldset w/flexbox usage [GH-9715]
• xds: deduplicate mesh gateway listeners by address in a stable way to prevent some LDS churn [GH-9650]
• xds: prevent LDS flaps in mesh gateways due to unstable datacenter lists; also prevent some flaps in terminating gateways as well [GH-9651]

FEATURES:

• ui: Add additional search/filter status pills for viewing and removing current filters in listing views [GH-9442]

IMPROVEMENTS:

• cli: Add new -cluster-id and common-name to consul tls ca create to support creating a CA for Consul Connect. [GH-9585]
• license: (Enterprise only) Temporary client license duration was increased from 30m to 6h.
• server: (Enterprise Only) Validate source namespaces in service-intentions config entries. [GH-9527]
• server: use the presence of stored federation state data as a sign that we already activated the federation state feature flag [GH-9519]

BUG FIXES:

• autopilot: Fixed a bug that would cause snapshot restoration to stop autopilot on the leader. [GH-9626]
• server: When wan federating via mesh gateways after initial federation default to using the local mesh gateways unless the heuristic indicates a bypass is required. [GH-9528]
• server: When wan federating via mesh gateways only do heuristic primary DC bypass on the leader. [GH-9366]
• ui: Fixed a bug that would cause missing or duplicate service instance healthcheck listings. [GH-9660]