feat: Phase 2 — metrics counters, mock Wallarm test server, stats UI, add runtime config to gitignore

This commit is contained in:
Claus Lohmar 2026-08-01 06:40:09 +00:00
parent 85d90bef1e
commit 7de515818e
5 changed files with 154 additions and 19 deletions

95
cmd/mockwallarm/main.go Normal file
View file

@ -0,0 +1,95 @@
package main
import (
"encoding/json"
"fmt"
"log"
"net/http"
"os"
"time"
)
// MockWallarm is a test server that simulates a Wallarm node.
// Usage: go run mock_wallarm.go [--mode=allow|block|slow|flaky]
//
// Modes:
// allow — always return "allow" verdict
// block — always return "block" verdict
// slow — delay 5s then allow (tests timeout)
// flaky — succeed 3 times, then fail 3 times (tests circuit breaker)
type Verdict struct {
Verdict string `json:"verdict"`
Reason string `json:"reason,omitempty"`
Score int `json:"score,omitempty"`
}
var (
requestCount int
mode string
)
func main() {
mode = "allow"
if len(os.Args) > 1 {
mode = os.Args[1]
}
// Also support --mode=block style
if len(mode) > 7 && mode[:7] == "--mode=" {
mode = mode[7:]
}
http.HandleFunc("/inspect", handleInspect)
http.HandleFunc("/health", handleHealth)
port := "8085"
if p := os.Getenv("PORT"); p != "" {
port = p
}
log.Printf("Mock Wallarm node starting on :%s (mode=%s)", port, mode)
if err := http.ListenAndServe(":"+port, nil); err != nil {
log.Fatal(err)
}
}
func handleInspect(w http.ResponseWriter, r *http.Request) {
requestCount++
switch mode {
case "block":
writeVerdict(w, "block", "SQL injection detected", 95)
case "slow":
time.Sleep(5 * time.Second)
writeVerdict(w, "allow", "clean", 0)
case "flaky":
if requestCount <= 3 {
writeVerdict(w, "allow", "clean", 0)
} else {
// Simulate failure — return 500
http.Error(w, "internal error", 500)
}
if requestCount >= 6 {
requestCount = 0 // reset cycle
}
default: // allow
writeVerdict(w, "allow", fmt.Sprintf("clean (request #%d)", requestCount), 0)
}
}
func handleHealth(w http.ResponseWriter, r *http.Request) {
writeJSON(w, http.StatusOK, map[string]string{"status": "ok"})
}
func writeVerdict(w http.ResponseWriter, verdict, reason string, score int) {
writeJSON(w, http.StatusOK, Verdict{Verdict: verdict, Reason: reason, Score: score})
}
func writeJSON(w http.ResponseWriter, status int, v interface{}) {
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(status)
json.NewEncoder(w).Encode(v)
}

15
main.go
View file

@ -116,20 +116,7 @@ func handleSaveConfig(w http.ResponseWriter, r *http.Request) {
} }
func handleGetStats(w http.ResponseWriter, r *http.Request) { func handleGetStats(w http.ResponseWriter, r *http.Request) {
state := breaker.State() writeJSON(w, http.StatusOK, metricsSnapshot())
var stateStr string
switch state {
case StateClosed:
stateStr = "closed"
case StateOpen:
stateStr = "open"
case StateHalfOpen:
stateStr = "half-open"
}
writeJSON(w, http.StatusOK, map[string]interface{}{
"circuit": stateStr,
"enabled": getConfig().Enabled,
})
} }
func handleReturnVerdict(w http.ResponseWriter, r *http.Request) { func handleReturnVerdict(w http.ResponseWriter, r *http.Request) {

View file

@ -4,27 +4,60 @@ import (
"fmt" "fmt"
"log" "log"
"net/http" "net/http"
"sync/atomic"
"zoraxy-waf/zoraxy_plugin" "zoraxy-waf/zoraxy_plugin"
) )
var breaker = newCircuitBreaker() var breaker = newCircuitBreaker()
// Metrics counters
var (
requestsTotal uint64
requestsAllowed uint64
requestsBlocked uint64
requestsBypassed uint64 // fail-open or disabled
)
func metricsSnapshot() map[string]interface{} {
return map[string]interface{}{
"total": atomic.LoadUint64(&requestsTotal),
"allowed": atomic.LoadUint64(&requestsAllowed),
"blocked": atomic.LoadUint64(&requestsBlocked),
"bypassed": atomic.LoadUint64(&requestsBypassed),
"circuit": circuitStateStr(breaker.State()),
"enabled": getConfig().Enabled,
}
}
func circuitStateStr(s CircuitState) string {
switch s {
case StateClosed:
return "closed"
case StateOpen:
return "open"
case StateHalfOpen:
return "half-open"
}
return "unknown"
}
// handleInspect is the static capture ingress handler. // handleInspect is the static capture ingress handler.
// Zoraxy proxies matching requests here. The plugin decides: // Zoraxy proxies matching requests here. The plugin decides:
// - Return 280 (CAPTURED) → block the request // - Return 280 (CAPTURED) → block the request
// - Return 284 (UNHANDLED) → forward as normal // - Return 284 (UNHANDLED) → forward as normal
func handleInspect(w http.ResponseWriter, r *http.Request) { func handleInspect(w http.ResponseWriter, r *http.Request) {
atomic.AddUint64(&requestsTotal, 1)
cfg := getConfig() cfg := getConfig()
if !cfg.Enabled { if !cfg.Enabled {
// WAF disabled — pass through. atomic.AddUint64(&requestsBypassed, 1)
w.WriteHeader(int(zoraxy_plugin.ControlStatusCode_UNHANDLED)) w.WriteHeader(int(zoraxy_plugin.ControlStatusCode_UNHANDLED))
return return
} }
state := breaker.State() state := breaker.State()
if state == StateOpen { if state == StateOpen {
// Fail-open: Wallarm is down, let traffic through. atomic.AddUint64(&requestsBypassed, 1)
log.Printf("WAF: breaker OPEN — fail-open, passing %s %s", r.Method, r.URL.Path) log.Printf("WAF: breaker OPEN — fail-open, passing %s %s", r.Method, r.URL.Path)
w.WriteHeader(int(zoraxy_plugin.ControlStatusCode_UNHANDLED)) w.WriteHeader(int(zoraxy_plugin.ControlStatusCode_UNHANDLED))
return return
@ -32,9 +65,9 @@ func handleInspect(w http.ResponseWriter, r *http.Request) {
resp, err := inspect(r) resp, err := inspect(r)
if err != nil { if err != nil {
atomic.AddUint64(&requestsBypassed, 1)
log.Printf("WAF: inspection error: %v", err) log.Printf("WAF: inspection error: %v", err)
breaker.RecordFailure() breaker.RecordFailure()
// Fail-open on error.
w.WriteHeader(int(zoraxy_plugin.ControlStatusCode_UNHANDLED)) w.WriteHeader(int(zoraxy_plugin.ControlStatusCode_UNHANDLED))
return return
} }
@ -42,14 +75,14 @@ func handleInspect(w http.ResponseWriter, r *http.Request) {
breaker.RecordSuccess() breaker.RecordSuccess()
if resp.Verdict == "block" { if resp.Verdict == "block" {
atomic.AddUint64(&requestsBlocked, 1)
log.Printf("WAF: BLOCKED %s %s — reason: %s", r.Method, r.URL.Path, resp.Reason) log.Printf("WAF: BLOCKED %s %s — reason: %s", r.Method, r.URL.Path, resp.Reason)
// Return the Zoraxy control code for "captured" (blocked).
w.Header().Set("Content-Type", "text/html") w.Header().Set("Content-Type", "text/html")
w.WriteHeader(int(zoraxy_plugin.ControlStatusCode_CAPTURED)) w.WriteHeader(int(zoraxy_plugin.ControlStatusCode_CAPTURED))
fmt.Fprintf(w, `<html><body><h1>403 Forbidden</h1><p>Request blocked by WAF.</p></body></html>`) fmt.Fprintf(w, `<html><body><h1>403 Forbidden</h1><p>Request blocked by WAF.</p></body></html>`)
return return
} }
// Allowed — let Zoraxy forward normally. atomic.AddUint64(&requestsAllowed, 1)
w.WriteHeader(int(zoraxy_plugin.ControlStatusCode_UNHANDLED)) w.WriteHeader(int(zoraxy_plugin.ControlStatusCode_UNHANDLED))
} }

View file

@ -16,6 +16,10 @@ function loadStats() {
(data.circuit === 'open' ? 'warn' : data.circuit === 'closed' ? 'ok' : 'warn')); (data.circuit === 'open' ? 'warn' : data.circuit === 'closed' ? 'ok' : 'warn'));
$('#waf-status').text(data.enabled ? 'Active' : 'Disabled').attr('class', 'stat-value ' + $('#waf-status').text(data.enabled ? 'Active' : 'Disabled').attr('class', 'stat-value ' +
(data.enabled ? 'ok' : 'off')); (data.enabled ? 'ok' : 'off'));
$('#stat-total').text(data.total || 0);
$('#stat-allowed').text(data.allowed || 0);
$('#stat-blocked').text(data.blocked || 0);
$('#stat-bypassed').text(data.bypassed || 0);
}); });
} }

View file

@ -54,6 +54,22 @@
<span class="stat-label">WAF Status:</span> <span class="stat-label">WAF Status:</span>
<span id="waf-status" class="stat-value">--</span> <span id="waf-status" class="stat-value">--</span>
</div> </div>
<div class="stat-row">
<span class="stat-label">Total Inspected:</span>
<span id="stat-total" class="stat-value">0</span>
</div>
<div class="stat-row">
<span class="stat-label">Allowed:</span>
<span id="stat-allowed" class="stat-value ok">0</span>
</div>
<div class="stat-row">
<span class="stat-label">Blocked:</span>
<span id="stat-blocked" class="stat-value warn">0</span>
</div>
<div class="stat-row">
<span class="stat-label">Bypassed (fail-open):</span>
<span id="stat-bypassed" class="stat-value">0</span>
</div>
</section> </section>
</main> </main>