Sage Infrastructure Solutions Group IncSage Infrastructure Solutions Group IncLoading…

Sage Infrastructure Solutions Group Inc

How NullWard works

NullWard is a reverse proxy with a web application firewall built in. You point your domains at NullWard, tell it where each application lives, and every request is checked before it reaches your application.

The request pipeline

Each request that arrives on the HTTP or HTTPS port goes through these steps, in order:

  1. Routing. The Host header picks the service: one application, with one or more hostnames and one or more backend destinations.
  2. IP checks. Per-service IP allowlists run first. Then come the global blocklist, threat feed blocks, and IP reputation lookups if you turned them on for the service.
  3. Bot challenge (optional). Visitors complete a Cloudflare Turnstile, Google reCAPTCHA or hCaptcha challenge before reaching the application.
  4. Authentication (optional). Visitors sign in with OIDC, LDAP, an emailed one-time code, Basic auth or a trusted header before they can reach the application.
  5. Access limits (optional). Path access rules, the waiting room (licensed) and per-service rate limits. Visitors over a rate limit get HTTP 429.
  6. Malware scanning (optional). Uploaded files are scanned with ClamAV.
  7. Web application firewall. The OWASP Core Rule Set and any custom rule sets inspect the request headers and body. Matching rules add to an anomaly score, and the request is blocked when the score reaches the threshold.
  8. ML WAF (licensed, optional). A machine-learning model scores the request for anomalies the rules don't catch.
  9. Proxy. The request is forwarded to a healthy backend over HTTP, HTTPS or HTTP/3, directly or through an application tunnel.
  10. Response inspection. Response headers are always checked. Text and HTML response bodies can also be checked for data leaks such as SQL errors and stack traces.

A blocked visitor sees a block page that you can brand under Administration > Block Pages. Every block is recorded, and repeated bad behaviour from one IP address adds to that address's behaviour score. When the score reaches the threshold, the address is blocked automatically.

Components

ComponentRole
NullWardThe proxy, WAF and admin dashboard: one container.
SurrealDB v2Stores all configuration: services, rules, users and settings. Nearly every setting is changed in the dashboard and applied without a restart.
ValkeyML WAF training data, rate-limit counters and caches.
ClamAV (optional)Malware scanning of uploads.

Ports

PortProtocolPurposeWho needs to reach it
7050TCPProxy, HTTPEveryone (publish as port 80)
7443TCPProxy, HTTPSEveryone (publish as port 443)
7443UDPHTTP/3 (QUIC), only when turned onEveryone (publish as 443/udp)
7052TCPManagement: admin dashboard and APIAdministrators only, from trusted IP addresses
7055UDPApplication tunnels (WireGuard), only when usedYour tunnel connectors
7059TCP and UDPCluster (SurrealHA, mutual TLS 1.3), only when clusteredOther NullWard nodes
7057UDPCluster mesh (WireGuard), only for clusters formed before 0.6.109 that haven't moved to SurrealHAOther NullWard nodes

The management port is deliberately separate from the public proxy ports, so it can be firewalled off from the internet. See Deploy with Docker Compose.

Licensing

NullWard is free to use, for both commercial and personal use, without a license. The paid features require a license, and any valid license unlocks all of them: the ML WAF, application tunnels, the waiting room (queue), high availability (clustering) and HTTP/3.

See License.