kubeWAF¶
Kubernetes-native Web Application Firewall
Protect your Kubernetes workloads with ModSecurity-compatible rules and the OWASP Core Rule Set — all defined as clean, version-controlled Custom Resources.
Alpha Software
kubeWAF is currently in alpha.
The project is under active development. Core features are functional and we use them in real environments, but breaking changes to APIs, CRDs, and behavior are still possible.
We recommend it for experimentation, development, and non-critical workloads today.
Why kubeWAF?¶
-
Structured as CRDs
Write rules in readable YAML (
SecRule,SecAction) instead of opaque.conffiles. Full GitOps support. -
Powerful RuleSets
Group, reuse, and compose rules across namespaces with automatic resolution and status conditions.
-
Gateway API Native
Attach WAF policies to your HTTPRoutes and Gateways using the standard Kubernetes Gateway API (via Envoy Gateway today).
-
OWASP CRS Included
Enable the entire OWASP Core Rule Set with one boolean flag. No manual downloads or sidecar hacks.
Get Started¶
-
Deploy a protected service in under 10 minutes.
-
Helm-based operator installation (recommended).
-
Star the repo and follow development.
Current Status (Alpha)¶
While still in alpha, kubeWAF already provides solid, usable functionality for many use cases:
| Status | Feature |
|---|---|
| ✅ | SecRule + SecAction CRDs with automatic SecLang conversion |
| ✅ | RuleSet with cross-namespace references and recursive expansion |
| ✅ | WAF policy attachment for Envoy Gateway (Gateway API) |
| ✅ | One-click OWASP CRS v4 integration |
| ✅ | Automatic reference resolution + rich status conditions |
| ✅ | Prometheus metrics (waf_filter_tx_*) with cardinality controls |
Roadmap highlights:
- Full WAFInstance support (sidecar / standalone proxy)
- Validation webhooks
- Enhanced observability integrations
Next Steps¶
- Install the operator using Helm
- Follow the Quick Start to protect your first route
- Write your first rules or import the CRS
Need help? Open an issue on GitHub or reach out at hello@kubewaf.io.