Coraza dans FrankenPHP : ce que ça coûte vraiment d’embarquer un WAF
Publié le 16 novembre 2026
La question revient souvent chez nos clients qui tournent sous FrankenPHP : peut-on se passer d’un WAF externe (reverse-proxy dédié, service managé) en embarquant directement la protection dans l’application ? Sur le papier, Coraza, l’implémentation Go de ModSecurity compatible avec l’OWASP Core Rule Set, le permet. FrankenPHP est lui-même un module Caddy, et Coraza s’ajoute comme un second module, compilé dans le même binaire. Pas de sidecar, pas de hop réseau supplémentaire. Avant de le recommander en production, on a voulu vérifier deux choses : est-ce vraiment aussi simple à mettre en place, et quel est l’impact réel sur les performances ? On a aussi comparé cette approche à l’alternative la plus courante, ModSecurity directement sur l’Ingress Kubernetes.

Le principe : un module Caddy de plus
Compiler Coraza dans FrankenPHP se fait avec xcaddy, l’outil standard pour construire des binaires Caddy sur mesure :
FROM dunglas/frankenphp:builder AS builder
COPY --from=caddy:builder /usr/bin/xcaddy /usr/bin/xcaddy
RUN CGO_ENABLED=1 \
XCADDY_GO_BUILD_FLAGS="-ldflags='-w -s' -tags=nobadger,nomysql,nopgx" \
xcaddy build \
--with github.com/dunglas/frankenphp=./ \
--with github.com/dunglas/frankenphp/caddy=./caddy/ \
--with github.com/corazawaf/coraza-caddy/v2
Le Caddyfile déclare ensuite le WAF comme un middleware classique, avant php_server :
coraza_waf {
load_owasp_crs
directives `
Include @coraza.conf-recommended
Include @crs-setup.conf.example
Include @owasp_crs/*.conf
SecRuleEngine On
`
}
Et ça fonctionne immédiatement : une injection SQL ou un payload XSS sont bloqués en 403 par le CRS, sans configuration supplémentaire. Ajouter un fichier d’exclusion est tout aussi simple. La syntaxe étant identique à celle de ModSecurity, on reprend ses exclusions existantes sans les réécrire.
Le benchmark : c’est sur Kubernetes que ça se voit
En local, le surcoût correspond à ce qu’on attend d’un moteur de règles CPU-bound : quelques millisecondes fixes par requête, largement absorbées par le reste du traitement applicatif. Rien d’alarmant.
Sur un cluster Kubernetes, avec load-balancing et HPA actifs, les chiffres sont plus parlants. À charge identique (60 utilisateurs concurrents), le p95 passe de 36,7 ms sans WAF à 79,6 ms avec Coraza. Pour l’utilisateur, l’écart se compte en dizaines de millisecondes et reste sous le seuil de gêne. Le CPU, lui, explose : pour absorber ce même trafic, l’application est passée d’un seul pod à 5, soit environ 8 à 9 fois plus de CPU consommé au total.
Ces tests ont été menés sur une application web vide. Sur une application réelle, dont la logique métier consomme déjà du CPU, le surcoût relatif de Coraza sera plus faible, même si son empreinte brute ne change pas. Le HPA fait son travail et la latence reste stable, mais ça se traduit directement par plus de pods, donc plus de nœuds, et une facture d’infrastructure plus salée.
Le premier moyen de réduire ce coût, c’est d’inspecter moins de requêtes. Exempter du WAF les routes qui ne lisent aucune entrée utilisateur (healthchecks, métriques, assets statiques) a divisé par 3 la latence sur ces endpoints, sans rien lâcher côté sécurité. Le critère est simple : la route manipule-t-elle de la donnée ?
Et face à ModSecurity sur l’Ingress ?
L’alternative historique consiste à activer ModSecurity directement sur le controller ingress-nginx, d’un coup pour toutes les applications du cluster. ingress-nginx étant désormais déprécié, cette option a moins de sens pour un nouveau projet, mais on a rejoué le même protocole pour comparer les deux architectures à égalité.
Le coût CPU par requête est du même ordre pour les deux moteurs, environ 8 fois plus de CPU dans les deux cas : évaluer les règles demande le même travail, en Go comme en C. La différence se joue sur l’architecture. Avec Coraza dans l’application, le coût est isolé par service : chaque application qui active le WAF dimensionne son propre budget CPU, indépendamment des autres. Avec ModSecurity sur l’Ingress, ce coût pèse sur une ressource partagée par tout le cluster.
C’est ce qu’on a observé en charge. Le HPA du controller ingress-nginx a atteint son plafond de réplicats, avec à la clé des requêtes en échec et un pic de latence à 30 secondes. Dans les mêmes conditions, Coraza gardait de la marge sur son propre HPA applicatif et n’a subi aucun échec. ModSecurity n’est pas moins performant pour autant : à budget CPU équivalent, il tient aussi bien. Mais un WAF mutualisé doit être dimensionné pour le pic cumulé de tous les tenants, pas pour une application isolée. Une seule app qui reçoit un trafic WAF-intensif, légitime ou malveillant, peut dégrader la latence de tout le cluster.
Ce qu’on en retient
Embarquer un WAF dans FrankenPHP fonctionne : la configuration par défaut bloque déjà les attaques courantes, et la latence reste raisonnable tant que le scaling suit. Mais « ça marche » ne veut pas dire « gratuit ». Le vrai prix se paie en CPU, et il faut le dimensionner au niveau de chaque application avec Coraza, ou du contrôleur partagé avec ModSecurity. Avec la fin de vie d’ingress-nginx, Coraza devient l’option la plus solide pour garder un WAF sur un cluster Kubernetes, par exemple derrière une Gateway API.
Vous vous posez la même question sur votre architecture FrankenPHP ou Kubernetes ? Parlons-en.