Zum Hauptinhalt springen

ADR-004: WAF-Strategie (Detection → Tuning → WAF-Policy → Prevention)

🤖 Generated with Claude Code

⚠️ Not yet reviewed

Co-Authored-By: Claude (noreply@anthropic.com)

Status: Accepted Datum: 2026-09

Kontext​

Die WAF (OWASP CRS 3.2) am Application Gateway TIS-PROD-CCA_Weblight-AppGw lief im Detect-Only-Modus. Die Log-Analyse zeigte, dass ~73 % der Requests, die den Anomaly-Block-Schwellwert erreichten, False Positives aus legitimem App-Traffic waren (OData-Query-Parameter, ASP.NET-Cookies, fehlende Header, SCEP-Enrollment). Ein sofortiges Umschalten auf Prevention hätte die SaaS für echte Kunden gestört.

Entscheidung​

Stufenweises Vorgehen statt sofortigem Prevention-Modus:

  1. Detection beibehalten und False Positives per Exclusions/Disabled Rules eliminieren (Runde 1 + 2 — umgesetzt & verifiziert)
  2. Migration Inline-Config → WAF-Policy am 2026-10-13 (Wartungsfenster CCA-Host-It) — nötig für die RequestArgKeys-Exclusion (Regel 942360, $select) und Custom Rules
  3. Custom Rule zum Blocken bekannter Scanner (34.145.202.189, + Rate-Limit)
  4. Umstellung auf Prevention pro Host, beginnend mit einem Low-Traffic-Tenant

Evaluierte Optionen​

OptionBewertungEntscheidung
Sofort Prevention (ohne Tuning)Bricht OData-/API-/SCEP-Traffic der Tenants❌ Abgelehnt
WAF komplett deaktivierenKein Schutz gegen reales Scanning/RCE❌ Abgelehnt
Detection + Tuning → WAF-Policy → PreventionSchrittweise, risikoarm, messbar✅ Gewählt

Konsequenzen​

  • Inline-Config kann ARGS_NAMES-Treffer ($select) nicht sauber ausschließen und kennt keine Custom Rules → die Migration auf eine WAF-Policy ist Voraussetzung für Prevention
  • Die Migration erfolgt im geplanten Wartungsfenster, um das Betriebsrisiko zu minimieren
  • Der aktuelle Regel-Stand und die geplanten Policy-Schritte sind in operations/waf/rules-reference.md dokumentiert (Findings/Status: operations/waf/README.md)