Skip to content

[DOCS#EV-7238]: Add optional Kibana WAF step to web console gateway access - #3156

Open
electricjesus wants to merge 2 commits into
tigera:mainfrom
electricjesus:seth/docs-manager-gateway-waf
Open

electricjesus wants to merge 2 commits into
tigera:mainfrom
electricjesus:seth/docs-manager-gateway-waf

Conversation

@electricjesus

@electricjesus electricjesus commented Oct 22, 2026 •

Copy link
Copy Markdown
Member

Product Version(s):
Calico Enterprise, next (calico-enterprise/ only, like #3110).

Issue:
https://tigera.atlassian.net/browse/EV-7238

Link to docs preview:

  • Calico Ingress Gateway tab: /calico-enterprise/next/operations/cnx/access-the-manager
  • WAF troubleshooting, 403 section: /calico-enterprise/next/threat/gateway-waf/troubleshooting

SME review:

  • An SME has approved this change (I'm the SME)

DOCS review:

  • A member of the docs team has approved this change.

Additional information:
When a WAF policy with the Core Rule Set covers the web console, Kibana Discover gets a 403. This PR adds one optional step to the gateway tab of the web console access page. The step shows the smallest GlobalWAFPlugin that fixes it. The WAF troubleshooting page now links to it.

This supersedes #3110. It keeps the same reviewed fix. It is 20 lines, not 94. And it sits where users set up the gateway.

Test plan: I compiled both pages with MDX 3. I checked that each relative link resolves. I did not run a full site build. The Netlify preview covers that.

AI assistance: This PR was written in part with the assistance of generative AI.

Merge checklist:

  • Deploy preview inspected wherever changes were made
  • Build completed successfully
  • Test have passed

Kibana Discover returns 403 when a Gateway WAF policy with the Core
Rule Set covers the web console gateway. Add one optional step with the
smallest GlobalWAFPlugin that fixes it, and point the WAF troubleshooting
403 section at it.

EV-7238
@electricjesus
electricjesus requested a review from a team as a code owner October 22, 2026 13:04
Copilot AI lite review requested due to automatic review settings October 22, 2026 13:04
@netlify

netlify Bot commented Oct 22, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for calico-docs-preview-next ready!

Name Link
🔨 Latest commit 3a44df4
🔍 Latest deploy log https://app.netlify.com/projects/calico-docs-preview-next/deploys/6ada360f7db15f632ad009de
😎 Deploy Preview https://deploy-preview-3156--calico-docs-preview-next.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@netlify

netlify Bot commented Oct 22, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview succeeded!

Built without sensitive environment variables

Name Link
🔨 Latest commit 3a44df4
🔍 Latest deploy log https://app.netlify.com/projects/tigera/deploys/6ada360f921187305342bc00
😎 Deploy Preview https://deploy-preview-3156--tigera.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 98 (🟢 up 32 from production)
Accessibility: 98 (no change from production)
Best Practices: 92 (no change from production)
SEO: 100 (no change from production)
PWA: -
View the detailed breakdown and full score reports
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Changes recommended

Unresolved documentation clarifications are needed for rule scope, ID ranges, and tab navigation.

1 open issue
What changed in this PR

This pull request adds optional Gateway WAF guidance to prevent Kibana Discover 403 responses when the web console is protected by the OWASP Core Rule Set.

Changes:

  • Adds a host- and path-scoped GlobalWAFPlugin example for Kibana requests.
  • Documents attaching the plugin to the default GlobalWAFPolicy.
  • Links Kibana-specific troubleshooting to the web console access procedure.
File Description
calico-enterprise/​threat/​gateway-waf/​troubleshooting.mdx Links Kibana Discover 403 troubleshooting to the web console access instructions.
calico-enterprise/​operations/​cnx/​access-the-manager.mdx Adds the optional Kibana WAF exception step to the Calico Ingress Gateway setup.

Review effort: Lite

Comment thread calico-enterprise/operations/cnx/access-the-manager.mdx Outdated
Comment thread calico-enterprise/threat/gateway-waf/troubleshooting.mdx

@ctauchen ctauchen left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @electricjesus, a few suggestions here

Comment thread calico-enterprise/operations/cnx/access-the-manager.mdx Outdated
Comment thread calico-enterprise/operations/cnx/access-the-manager.mdx Outdated
Comment thread calico-enterprise/operations/cnx/access-the-manager.mdx Outdated
…e Kibana WAF step

Per review: name the hostname placeholder and define it after the YAML,
show only the spec.plugins entry to add to the existing default
GlobalWAFPolicy, and say that the url argument exception covers every
Kibana request, not just search.

EV-7238

1. Point your hostname at that address in DNS.

1. Optional: if you protect the web console with a [Gateway WAF](../../threat/gateway-waf/overview.mdx) policy that uses the Core Rule Set, Kibana Discover fails with HTTP `403`. The Core Rule Set reads Kibana's search requests as attacks. To allow them, create this `GlobalWAFPlugin`:

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
1. Optional: if you protect the web console with a [Gateway WAF](../../threat/gateway-waf/overview.mdx) policy that uses the Core Rule Set, Kibana Discover fails with HTTP `403`. The Core Rule Set reads Kibana's search requests as attacks. To allow them, create this `GlobalWAFPlugin`:
1. Optional: If you also use [Gateway WAF](../../threat/gateway-waf/overview.mdx), you need to add a WAF exception to prevent traffic to the web console from being blocked. Create a `GlobalWAFPlugin` resource like the following:

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.

3 participants