Skip to content

fix: clarify ingress mode header warning#2128

Open
immanuwell wants to merge 1 commit into
linkerd:mainfrom
immanuwell:fix/clarify-ingress-header-warning
Open

fix: clarify ingress mode header warning#2128
immanuwell wants to merge 1 commit into
linkerd:mainfrom
immanuwell:fix/clarify-ingress-header-warning

Conversation

@immanuwell

Copy link
Copy Markdown
Contributor

Fixes #1837

Bug
The live ingress docs say ingress mode must remove l5d-dst-override, but the same page later tells Traefik to add it. Kinda mixed signals, and easy to read the wrong way.

Fix
Clarify that ingress mode must strip l5d-dst-override from incoming client traffic, while still allowing the ingress controller to add its own header for in-cluster routing.

Repro

  1. Open https://linkerd.io/docs/tasks/using-ingress/
  2. Read the warning in the ingress mode section
  3. Scroll to the Traefik examples
  4. See the warning says remove the header, while the examples add it

Checks

  • make lint
  • PATH="/tmp/bin:/tmp/linkerd-tools/node_modules/.bin:$PATH" make check

Problem\n\nThe ingress mode warning says to remove the  header, but the same page later shows Traefik and other ingress examples adding that header for internal routing. That contradiction is live on linkerd.io and confuses readers about the actual security requirement.\n\nSolution\n\nClarify that ingress mode must strip untrusted incoming  headers from client traffic, while still allowing the ingress controller to add its own header for requests to in-cluster services. Apply the wording fix to the current docs, edge docs, and 2.18 docs.\n\nFixes linkerd#1837

Signed-off-by: immanuwell <pchpr.00@list.ru>
@travisbeckham travisbeckham requested a review from alpeb June 14, 2026 20:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Misleading documentation on meshing with ingress mode

1 participant