WAF mit HAProxy und Coraza Rocky: Unterschied zwischen den Versionen

Aus Xinux Wiki
Zur Navigation springen Zur Suche springen
Die Seite wurde neu angelegt: „= WAF-Demo: HAProxy mit Coraza auf Rocky Linux = == Ziel == Diese Übung zeigt eine minimale Web Application Firewall auf Basis von '''HAProxy''' und '''Coraz…“
 
Konsolidiert: Rocky-Coraza-Fassung als kanonische Seite (bisher drei Fast-Duplikate)
 
(29 dazwischenliegende Versionen von einem anderen Benutzer werden nicht angezeigt)
Zeile 1: Zeile 1:
= WAF-Demo: HAProxy mit Coraza auf Rocky Linux =
== WAF-Demo: HAProxy mit Coraza auf Rocky Linux ==


== Ziel ==
* Animation: [https://xinux.org/waf-haproxy-coraza.html WAF: HAProxy mit Coraza] ([https://xinux.org/waf-haproxy-coraza-einfach.html einfach])
Diese Übung zeigt eine minimale Web Application Firewall auf Basis von '''HAProxy''' und '''Coraza''' (OWASP CRS) vor einem einfachen Webserver. Gleichzeitig demonstriert der Aufbau, dass Rocky Linux bereits von Haus aus durch '''firewalld''' und '''SELinux''' gehärtet ist, bevor überhaupt eine WAF ins Spiel kommt. Bewusst nur eine einzige Komponente pro Aufgabe, ein Backend, eine Fehlerseite.


== Topologie ==
WAF mit HAProxy und Coraza (OWASP CRS) vor web.it2XX.xinmen.de, TLS-Terminierung auf waf.it2XX.xinmen.de.
;Beschreibung
Ein einzelner Rocky-Linux-Host waf01.it2XX.int übernimmt alle Rollen.


* HAProxy lauscht extern auf Port 80
==Maschine==
* coraza-spoa (WAF-Engine) lauscht nur auf 127.0.0.1:9000
*Wir klonen das Rocky Template
* httpd (Backend) lauscht nur auf 127.0.0.1:8888


Nur Port 80 (und SSH für die Administration) ist von außen erreichbar. Die interne Kommunikation zwischen HAProxy, Coraza und dem Backend bleibt vollständig auf Loopback.
==Vorgaben==
{| class="wikitable"
! Einstellung !! Wert
|-
| '''Name''' || waf.it2XX.xinmen.de
|-
| '''IP-Adresse''' || 10.88.2XX.5/24
|-
| '''Gateway''' || 10.88.2XX.1
|-
| '''Nameserver''' || 1.1.1.1
|-
| '''Search-Domain''' || it2XX.xinmen.de
|-
| '''Benutzername''' || kit
|-
| '''Benutzerpasswort''' || kit
|-
| '''Administrator''' || root
|-
| '''Administratorpasswort''' || radler
|-
| '''Netz''' || DMZ
|}


== Backend-Webserver vorbereiten ==
==Einstellungen==
;httpd installieren
;Selbterklärend
*dnf install -y httpd
*rocky-setup.sh -f waf.it2XX.xinmen.de -a 10.88.2XX.5/24 -g 10.88.2XX.1 -n 1.1.1.1


;Backend auf einen unüblichen Port legen
==Zertifikate besorgen==
Wir nutzen bewusst Port 8888 statt 80, um später mit SELinux arbeiten zu müssen statt uns auf den Standard-Kontext zu verlassen.
*wget https://xinux.de/downloads/script/get-cert.sh
*sudo bash get-cert.sh


<pre>
== Topologie ==
# /etc/httpd/conf.d/backend.conf
* waf.it2XX.xinmen.de (10.88.2XX.5) – HAProxy terminiert TLS auf Port 443, coraza-spoa läuft lokal auf 127.0.0.1:9000
Listen 127.0.0.1:8888
* web.it2XX.xinmen.de (10.88.2XX.2) – bestehender Backend-Webserver, TLS auf Port 443
<VirtualHost 127.0.0.1:8888>
    DocumentRoot /var/www/backend
</VirtualHost>
</pre>


;Testseite anlegen
== HAProxy installieren ==
*mkdir -p /var/www/backend
*dnf install -y haproxy git
*echo "Backend erreichbar" > /var/www/backend/index.html


== Härtung mit firewalld ==
== Zertifikat auf dem Reverse Proxy vorbereiten ==
;Beschreibung
;Beschreibung
Von außen darf ausschließlich HTTP (Port 80) und SSH erreichbar sein. Die internen Ports 8888 und 9000 hängen am Loopback und benötigen daher gar keine Freigabe.
HAProxy erwartet Zertifikat und Key als eine gemeinsame PEM-Datei.
 
*cat /etc/ssl/own.crt /etc/ssl/own.key > /etc/haproxy/own-combined.pem
*chmod 600 /etc/haproxy/own-combined.pem


*firewall-cmd --permanent --add-service=http
==Härtung SELinux-Kontext setzen==
*firewall-cmd --permanent --add-service=ssh
*semanage fcontext -a -t cert_t "/etc/haproxy/own-combined\.pem"
*restorecon -v /etc/haproxy/own-combined.pem
 
== Härtung mit firewalld (revproxy) ==
*firewall-cmd --permanent --add-service=https
*firewall-cmd --reload
*firewall-cmd --reload


;Kontrolle
;Kontrolle
*firewall-cmd --list-all
*firewall-cmd --list-services


== Härtung mit SELinux ==
== Härtung mit SELinux (revproxy) ==
;Beschreibung
;Kontrolle der Kontexte
httpd läuft standardmäßig unter dem Typ httpd_t. Port 8888 gehört aber nicht zur Standardliste von http_port_t, daher blockiert SELinux den Start zunächst, obwohl firewalld gar nicht betroffen ist – ein guter Anlass, den Unterschied zwischen Netzwerkfilter und Mandatory Access Control zu zeigen.
 
;Prüfen, welche Ports http_port_t bereits enthält
*semanage port -l | grep http_port_t
*semanage port -l | grep http_port_t
*ls -Z /etc/haproxy/own-combined.pem
unconfined_u:object_r:'''cert_t''':s0 /etc/haproxy/own-combined.pem


;Port 8888 korrekt zu http_port_t hinzufügen
== Härtung - Haproxy ausgehende Verbindungen erlauben ==
*semanage port -a -t http_port_t -p tcp 8888
*setsebool -P haproxy_connect_any on
 
*systemctl restart haproxy
Damit kann sowohl httpd auf 8888 binden als auch HAProxy (Typ haproxy_t) sich dorthin verbinden, ohne die pauschale Boolean haproxy_connect_any aktivieren zu müssen. Bewusst kein chcon, sondern die persistente Policy-Änderung über semanage.
 
;httpd starten und aktivieren
*systemctl enable --now httpd
 
== HAProxy installieren ==
*dnf install -y haproxy


== Coraza (coraza-spoa) installieren ==
== Coraza (coraza-spoa) installieren ==
;Beschreibung
;coraza-spoa Binary installieren
coraza-spoa ist ein eigenständiger Go-Daemon, der als SPOE-Agent für HAProxy arbeitet. Es gibt kein Rocky-Paket, aber ein fertiges Release-Binary, sodass kein Compiler auf dem System nötig ist.
*dnf install -y golang git
*git clone --depth=1 https://github.com/corazawaf/coraza-spoa /usr/local/src/coraza-spoa
*cd /usr/local/src/coraza-spoa
*go run mage.go build
*cp build/coraza-spoa /usr/local/bin/coraza-spoa
*chmod +x /usr/local/bin/coraza-spoa


*mkdir -p /etc/coraza-spoa
*curl -L -o /usr/local/bin/coraza-spoa https://github.com/corazawaf/coraza-spoa/releases/latest/download/coraza-spoa_linux_amd64
*chmod +x /usr/local/bin/coraza-spoa


;OWASP Core Rule Set und Basisregeln laden
;OWASP Core Rule Set und Basisregeln laden
*mkdir -p /etc/coraza-spoa
*git clone --depth=1 https://github.com/coreruleset/coreruleset /etc/coraza-spoa/coreruleset
*git clone --depth=1 https://github.com/coreruleset/coreruleset /etc/coraza-spoa/coreruleset
*curl -L -o /etc/coraza-spoa/coraza.conf https://raw.githubusercontent.com/corazawaf/coraza/main/coraza.conf-recommended
*curl -L -o /etc/coraza-spoa/coraza.conf https://raw.githubusercontent.com/corazawaf/coraza/main/coraza.conf-recommended
Zeile 76: Zeile 93:


;Coraza-Konfiguration
;Coraza-Konfiguration
*vim /etc/coraza-spoa/config.yaml
<pre>
<pre>
# /etc/coraza-spoa/config.yaml
# /etc/coraza-spoa/config.yaml
bind: 127.0.0.1:9000
bind: 127.0.0.1:9000
loglevel: info
log_level: info
log_file: /dev/stdout
log_format: console


applications:
applications:
   waf01:
   - name: revproxy
    log_level: info
    log_file: /dev/stdout
    log_format: console
     directives: |
     directives: |
       Include /etc/coraza-spoa/coraza.conf
       Include @coraza.conf-recommended
      SecRuleEngine On
       Include /etc/coraza-spoa/crs-setup.conf
       Include /etc/coraza-spoa/crs-setup.conf
       Include /etc/coraza-spoa/coreruleset/rules/*.conf
       Include /etc/coraza-spoa/coreruleset/rules/*.conf
      SecRuleEngine On
    response_check: false
    transaction_ttl_ms: 5000                           
</pre>
</pre>


;systemd-Unit
;systemd-Unit
*vim /etc/systemd/system/coraza-spoa.service
<pre>
<pre>
# /etc/systemd/system/coraza-spoa.service
# /etc/systemd/system/coraza-spoa.service
Zeile 109: Zeile 135:


== HAProxy-Konfiguration ==
== HAProxy-Konfiguration ==
;SPOE-Filter einbinden und Backend definieren
;Konfiguration
*vim /etc/haproxy/haproxy.cfg
<pre>
<pre>
# /etc/haproxy/haproxy.cfg
# /etc/haproxy/haproxy.cfg
Zeile 121: Zeile 148:
     timeout client 30s
     timeout client 30s
     timeout server 30s
     timeout server 30s
    errorfile 403 /etc/haproxy/errors/403-waf.http


frontend fe_web
frontend fe_web
     bind *:80
     bind 10.88.2XX.5:443 ssl crt /etc/haproxy/own-combined.pem
     filter spoe engine coraza config /etc/haproxy/coraza.cfg
     filter spoe engine coraza config /etc/haproxy/coraza.cfg
     http-request deny deny_status 403 if { var(txn.coraza.action) -m str deny }
     http-request deny deny_status 403 if { var(txn.coraza.action) -m str deny }
Zeile 129: Zeile 157:


backend backend_web
backend backend_web
     server web01 127.0.0.1:8888 check
     server web01 10.88.2XX.2:443 check ssl verify none


backend coraza-spoa
backend coraza-spoa
Zeile 138: Zeile 166:


== SPOE-Konfiguration für Coraza ==
== SPOE-Konfiguration für Coraza ==
*vim /etc/haproxy/coraza.cfg
<pre>
<pre>
# /etc/haproxy/coraza.cfg
[coraza]
[coraza]
spoe-agent coraza-agent
spoe-agent coraza-agent
Zeile 152: Zeile 180:


spoe-message coraza-req
spoe-message coraza-req
     args app=str(waf01) src-ip=src src-port=src_port dst-ip=dst dst-port=dst_port method=method path=path query=query version=req.ver headers=req.hdrs body=req.body
     args app=str(revproxy) src-ip=src src-port=src_port dst-ip=dst dst-port=dst_port method=method path=path query=query version=req.ver headers=req.hdrs body=req.body
     event on-frontend-http-request
     event on-frontend-http-request
</pre>
</pre>


== Eigene Fehlerseite ==
== Eigene Fehlerseite ==
;Beschreibung
*mkdir -p /etc/haproxy/errors
Genau eine Fehlerseite für alle von der WAF geblockten Requests, kein zusätzliches Fehlerseiten-Set.
*vim /etc/haproxy/errors/403-waf.http
 
<pre>
<pre>
# /etc/haproxy/errors/403-waf.http
HTTP/1.1 403 Forbidden
HTTP/1.1 403 Forbidden
Content-Type: text/html
Content-Type: text/html
Zeile 167: Zeile 193:
<html><body><h1>Anfrage blockiert</h1><p>Diese Anfrage wurde von der Web Application Firewall abgelehnt.</p></body></html>
<html><body><h1>Anfrage blockiert</h1><p>Diese Anfrage wurde von der Web Application Firewall abgelehnt.</p></body></html>
</pre>
</pre>
 
*haproxy -c -f /etc/haproxy/haproxy.cfg
;Fehlerseite in haproxy.cfg einbinden
*systemctl restart haproxy
In den defaults-Block ergänzen:
 
<pre>
errorfile 403 /etc/haproxy/errors/403-waf.http
</pre>
 
*systemctl enable --now haproxy
*systemctl enable --now haproxy


== Test ==
== Test ==
;Normale Anfrage
*curl -ik https://waf.it2XX.xinmen.de/
*curl -i http://waf01.it2XX.int/
*curl -ik "https://waf.it2XX.xinmen.de/?id=1' OR '1'='1"
 
;Angriffsversuch, der von Coraza/OWASP CRS erkannt werden sollte
*curl -i "http://waf01.it2XX.int/?id=1' OR '1'='1"
 
Die erste Anfrage liefert die Backend-Testseite mit Status 200, die zweite die eigene 403-Fehlerseite, ohne dass die Anfrage überhaupt das Backend erreicht.


== Zusammenfassung ==
Erste Anfrage: Status 200 von web.it2XX.xinmen.de. Zweite Anfrage: 403-Fehlerseite, web.it2XX.xinmen.de wird nicht erreicht.
* firewalld lässt von außen ausschließlich HTTP und SSH zu
* SELinux verhindert, dass httpd oder HAProxy Ports außerhalb der freigegebenen Policy nutzen, unabhängig von firewalld
* HAProxy mit Coraza blockiert bekannte Angriffsmuster, bevor sie das Backend erreichen
* Genau eine Fehlerseite für alle WAF-Blocks

Aktuelle Version vom 31. Oktober 2026, 15:14 Uhr

WAF-Demo: HAProxy mit Coraza auf Rocky Linux

WAF mit HAProxy und Coraza (OWASP CRS) vor web.it2XX.xinmen.de, TLS-Terminierung auf waf.it2XX.xinmen.de.

Maschine

  • Wir klonen das Rocky Template

Vorgaben

Einstellung Wert
Name waf.it2XX.xinmen.de
IP-Adresse 10.88.2XX.5/24
Gateway 10.88.2XX.1
Nameserver 1.1.1.1
Search-Domain it2XX.xinmen.de
Benutzername kit
Benutzerpasswort kit
Administrator root
Administratorpasswort radler
Netz DMZ

Einstellungen

Selbterklärend
  • rocky-setup.sh -f waf.it2XX.xinmen.de -a 10.88.2XX.5/24 -g 10.88.2XX.1 -n 1.1.1.1

Zertifikate besorgen

Topologie

  • waf.it2XX.xinmen.de (10.88.2XX.5) – HAProxy terminiert TLS auf Port 443, coraza-spoa läuft lokal auf 127.0.0.1:9000
  • web.it2XX.xinmen.de (10.88.2XX.2) – bestehender Backend-Webserver, TLS auf Port 443

HAProxy installieren

  • dnf install -y haproxy git

Zertifikat auf dem Reverse Proxy vorbereiten

Beschreibung

HAProxy erwartet Zertifikat und Key als eine gemeinsame PEM-Datei.

  • cat /etc/ssl/own.crt /etc/ssl/own.key > /etc/haproxy/own-combined.pem
  • chmod 600 /etc/haproxy/own-combined.pem

Härtung SELinux-Kontext setzen

  • semanage fcontext -a -t cert_t "/etc/haproxy/own-combined\.pem"
  • restorecon -v /etc/haproxy/own-combined.pem

Härtung mit firewalld (revproxy)

  • firewall-cmd --permanent --add-service=https
  • firewall-cmd --reload
Kontrolle
  • firewall-cmd --list-services

Härtung mit SELinux (revproxy)

Kontrolle der Kontexte
  • semanage port -l | grep http_port_t
  • ls -Z /etc/haproxy/own-combined.pem
unconfined_u:object_r:cert_t:s0 /etc/haproxy/own-combined.pem

Härtung - Haproxy ausgehende Verbindungen erlauben

  • setsebool -P haproxy_connect_any on
  • systemctl restart haproxy

Coraza (coraza-spoa) installieren

coraza-spoa Binary installieren
  • dnf install -y golang git
  • git clone --depth=1 https://github.com/corazawaf/coraza-spoa /usr/local/src/coraza-spoa
  • cd /usr/local/src/coraza-spoa
  • go run mage.go build
  • cp build/coraza-spoa /usr/local/bin/coraza-spoa
  • chmod +x /usr/local/bin/coraza-spoa


OWASP Core Rule Set und Basisregeln laden
Coraza-Konfiguration
  • vim /etc/coraza-spoa/config.yaml
# /etc/coraza-spoa/config.yaml
bind: 127.0.0.1:9000
log_level: info
log_file: /dev/stdout
log_format: console

applications:
  - name: revproxy
    log_level: info
    log_file: /dev/stdout
    log_format: console
    directives: |
      Include @coraza.conf-recommended
      Include /etc/coraza-spoa/crs-setup.conf
      Include /etc/coraza-spoa/coreruleset/rules/*.conf
      SecRuleEngine On
    response_check: false
    transaction_ttl_ms: 5000                             
systemd-Unit
  • vim /etc/systemd/system/coraza-spoa.service
# /etc/systemd/system/coraza-spoa.service
[Unit]
Description=Coraza SPOA für HAProxy
After=network.target

[Service]
ExecStart=/usr/local/bin/coraza-spoa -config /etc/coraza-spoa/config.yaml
Restart=on-failure

[Install]
WantedBy=multi-user.target
  • systemctl daemon-reload
  • systemctl enable --now coraza-spoa

HAProxy-Konfiguration

Konfiguration
  • vim /etc/haproxy/haproxy.cfg
# /etc/haproxy/haproxy.cfg
global
    log /dev/log local0
    maxconn 2000

defaults
    mode http
    timeout connect 5s
    timeout client 30s
    timeout server 30s
    errorfile 403 /etc/haproxy/errors/403-waf.http

frontend fe_web
    bind 10.88.2XX.5:443 ssl crt /etc/haproxy/own-combined.pem
    filter spoe engine coraza config /etc/haproxy/coraza.cfg
    http-request deny deny_status 403 if { var(txn.coraza.action) -m str deny }
    default_backend backend_web

backend backend_web
    server web01 10.88.2XX.2:443 check ssl verify none

backend coraza-spoa
    mode tcp
    option spop-check
    server spoa1 127.0.0.1:9000 check

SPOE-Konfiguration für Coraza

  • vim /etc/haproxy/coraza.cfg
[coraza]
spoe-agent coraza-agent
    messages         coraza-req
    option var-prefix coraza
    option set-on-error error
    timeout hello     2s
    timeout idle      2m
    timeout processing 500ms
    use-backend       coraza-spoa
    log               global

spoe-message coraza-req
    args app=str(revproxy) src-ip=src src-port=src_port dst-ip=dst dst-port=dst_port method=method path=path query=query version=req.ver headers=req.hdrs body=req.body
    event on-frontend-http-request

Eigene Fehlerseite

  • mkdir -p /etc/haproxy/errors
  • vim /etc/haproxy/errors/403-waf.http
HTTP/1.1 403 Forbidden
Content-Type: text/html

<html><body><h1>Anfrage blockiert</h1><p>Diese Anfrage wurde von der Web Application Firewall abgelehnt.</p></body></html>
  • haproxy -c -f /etc/haproxy/haproxy.cfg
  • systemctl restart haproxy
  • systemctl enable --now haproxy

Test

Erste Anfrage: Status 200 von web.it2XX.xinmen.de. Zweite Anfrage: 403-Fehlerseite, web.it2XX.xinmen.de wird nicht erreicht.