Description
Secure Owl Firewall is a fast, lightweight firewall plugin with an advanced rule engine featuring PCRE pattern matching, a transformation pipeline, and JSON-based rule configuration.
Key features:
- JSON-based rules — 100+ default rules covering SQLi, XSS, RCE, LFI, SSRF, Log4Shell, and more
- Transformation pipeline — URL decode, lowercase, normalize path, remove whitespace, HTML entity decode, trim
- Inspection targets — REQUEST_URI, QUERY_STRING, USER_AGENT, REFERER, COOKIE, and POST
- MU-Plugin loader — runs before regular plugins for earliest protection
- Rate limiting — optional transient-based IP and subnet banning
- Login protection — PIN field, speed limit and honeypot on the login form and on login forms embedded in pages to stop brute-force attacks; with a PIN set, repeated failed logins pause logins to that account for a few minutes
- IP whitelist — CIDR/subnet support for both IPv4 and IPv6
- IP blacklist — CIDR/subnet support for both IPv4 and IPv6
- Per-rule toggle — disable individual rules from the admin panel without editing files
- File-based logging — 10MB cap with auto-rotation and protected storage
- Log retention — clears the log after 1, 3 or 6 months, which helps with data minimization (e.g. GDPR)
- IP anonymization — masks visitor IP addresses in the log for privacy
Filter Hooks
The firewall runs before regular plugins and the theme load, so add filters that change how requests are checked (lists, proxies, rules, logging, blocking) in a must-use plugin.
sswaf_ip_whitelist— array of IPs or CIDR ranges that bypass the firewallsswaf_ip_blacklist— array of IPs or CIDR ranges to block before any rules run (the whitelist still wins)sswaf_trusted_proxies— array of trusted proxy IPs for X-Forwarded-Forsswaf_post_scanning— enable POST data inspection (default: true)sswaf_json_scanning— enable JSON request body inspection (default: true)sswaf_json_max_body— request body size limit for inspection, in bytessswaf_json_skip_authenticated— whether trusted logged-in users are exempt from request body inspectionsswaf_json_skip_capability— capability that marks a logged-in user as trustedsswaf_rules_file— path to the rules JSON filesswaf_log_dir— directory of the log filesswaf_log_file— path to the log filesswaf_log_max_size— log size in bytes at which the log is rotated (default: 10 MB, at most 32 MB)sswaf_header_status— HTTP status header for blocked requestssswaf_header_connection— Connection header for blocked requestssswaf_block_on_engine_error— block requests the rule engine cannot fully check (default: true); return false to only log themsswaf_speed_limit_skip— return true to turn the login speed limit off, for login forms that cannot include its hidden fieldssswaf_before_block— action hook fired before blocking a requestsswaf_rate_limit_ip_threshold— override IP hit thresholdsswaf_rate_limit_ip_duration— override IP ban durationsswaf_rate_limit_ip_window— override IP counting windowsswaf_rate_limit_subnet_threshold— override subnet hit thresholdsswaf_rate_limit_subnet_duration— override subnet ban durationsswaf_rate_limit_subnet_window— override subnet counting window
Rate-limit values from filters are kept within the ranges of the settings page.
Installation
- Upload the
secure-owl-firewallfolder to/wp-content/plugins/ - Activate through the Plugins menu
- The MU-Plugin loader is installed automatically for early execution
- Configure settings under Settings > Secure Owl Firewall
Changelog
1.0.0
- Initial release.
1.0.1
- Updated security rules.
- Updated log file cap to 24MB.
1.0.2
- Added IP whitelist with CIDR/subnet support (IPv4 + IPv6).
- File-based storage for zero database overhead.
- Settings UI with validation.
1.0.3
- Removed metadata from a JSON rules file.
- Small CSS admin tweak.
1.0.4
- Added configurable log retention policy to automatically purge old data.
- Added option to anonymize user IP addresses for privacy.
- Rework plugin update mechanism.
- Improved coding standards to align better with WordPress guidelines.
1.0.5
- Updated log file cap to 64MB.
- Fixed a small bug in admin panel log viewer.
1.0.6
- Added rate-limited PIN authentication to the login page to mitigate brute-force attacks.
- Added a honeypot trap to the login form to catch unsophisticated bots.
1.0.7
- Removed a few overly aggressive rules.
1.0.8
- Added IP blacklist with CIDR/subnet support (IPv4 + IPv6).
1.0.9
- Fixed a small bug in log viewer.
1.1.0
- Updated security rules.
- Added a speed limit protection layer to the login page.
1.1.1
- Updated security rules.
2.0.0
- Added JSON request body scanning.
- Raised maximum request and referrer length limits.
2.0.1
- Updated security rules.
2.0.2
- Updated security rules.
2.0.3
- Updated security rules.
2.0.4
- Updated security rules.
2.0.5
- Updated security rules.
2.0.6
- Updated security rules.
2.0.7
- Small text update in admin UI.
- Updated security rules.
2.0.8
- Updated security rules.
2.0.9
- Updated security rules.
- Ensured WordPress compatibility.
2.1.0
- Improved path normalization.
- Hardened request decoding against resource exhaustion.
- Faster rule matching for large requests.
- Fixed client IP resolution behind trusted proxies; trusted proxies now accept CIDR ranges.
- Removed an over-broad cookie rule that caused false positives.
- Fixed log export.
- Updated security rules.
3.0.0
- Stronger request inspection: form, JSON and XML-RPC request data are checked more thoroughly.
- Improved detection and fewer false positives.
- Hardened the rule engine against oversized and malformed requests.
- Faster rule matching for large requests.
- New login lockout: with a PIN set, repeated failed logins to an account are paused for a few minutes.
- Login protection now also works on login forms embedded in pages.
- Hardened login PIN checks.
- IP entries are validated, invalid ones are listed with the reason, and the lists are stored more securely.
- More precise rate limiting under heavy traffic.
- All settings are validated before saving.
- Multisite: the firewall and its settings apply only to sites where the plugin is active.
- More reliable early loading, also for copied sites and symlinked plugin folders.
- Log: compact entries, a clearer log viewer, a 10 MB size cap, and a warning when the log cannot be written.
- Uninstall removes all plugin data, on every site of a network.
- Updated security rules.
