How corazawaf/coraza-spoa works
Coraza SPOA is a Go daemon that receives HAProxy SPOE messages, selects an application, and evaluates HTTP request and (optionally) response phases with Coraza. The principal path returns enforcement variables to HAProxy; response inspection correlates a later message to a cached request transaction. Configuration builds and reloads applications, while logging and Prometheus metrics expose outcomes. The README also documents rule-set compatibility, HAProxy integration, health/metrics endpoints, and operational deployment. Edges reflect the excerpts and README; unshown application internals are not expanded.
Main entry points: agent.go SPOE dispatcher · main.go Daemon entry · application.go Request inspection · config.go Config reload
Components 15
Daemon runtime
- Daemon entry
main.go - SPOE dispatcher
internal/agent.go
Configuration
- Config loader
config.go - Config reload
config.go
WAF processing
- WAF application
internal/application.go - Request inspection
internal/application.go - Response inspection
internal/application.go - Coraza engine
- Transaction cache
internal/ttlcache.go - Coraza rulesets
Observability
- WAF metrics
internal/metrics.go - Metrics endpoint
main.go - WAF logging
internal/application.go
Other components
- HAProxy
- Prometheus
Connections 20
- HAProxy → SPOE dispatcher: sends SPOE
README.md - Daemon entry → Config loader: loads config
main.go - Daemon entry → WAF application: builds apps
- Daemon entry → SPOE dispatcher: serves messages
main.go - Daemon entry → Metrics endpoint: starts endpoint
main.go - Daemon entry → Config reload: watches config
main.go - Config reload → Config loader: reloads file
config.go - Config reload → SPOE dispatcher: replaces apps
config.go - SPOE dispatcher → Request inspection: dispatches request
internal/agent.go - SPOE dispatcher → Response inspection: dispatches response
internal/agent.go - Request inspection → Coraza engine: evaluates request
internal/application.go - Response inspection → Coraza engine: evaluates response
internal/application.go - WAF application → Coraza rulesets: loads rules
- Request inspection → Transaction cache: stores transaction
- Response inspection → Transaction cache: correlates transaction
internal/application.go - Request inspection → WAF logging: logs matches
internal/application.go - Response inspection → WAF logging: logs matches
internal/application.go - SPOE dispatcher → WAF metrics: records handling
internal/agent.go - Metrics endpoint → Prometheus: serves metrics
main.go - SPOE dispatcher → HAProxy: returns actions
internal/agent.go