Freemius

ITCS

Welcome to the ProActive Security Suite Plugin Wiki
 Enhance your WordPress website’s security with the ProActive Security Suite. This powerful plugin offers advanced security features including automatic IP blocking, an advanced rule builder, traffic analysis, and seamless integration with services like Cloudflare, AbuseIPDB, and Whatismybrowser.com. ProActive Security Suite provides proactive defense mechanisms to protect your site from malicious traffic and potential threats before they reach your server. 
 Table of Contents 
<ul>
<li><a href="#introduction" rel="nofollow ugc">Introduction</a></li>
<li><a href="#features" rel="nofollow ugc">Features</a></li>
</ul>
<ul>
<li><a href="#free-features" rel="nofollow ugc">Free Features</a></li>
<li><a href="#premium-features" rel="nofollow ugc">Premium Features</a></li>
</ul>
<li><a href="#installation" rel="nofollow ugc">Installation</a></li>
<li><a href="#configuration" rel="nofollow ugc">Configuration</a></li>
<ul>
<li><a href="#cloudflare-settings" rel="nofollow ugc">Cloudflare Settings</a></li>
<li><a href="#abuseipdb-integration" rel="nofollow ugc">AbuseIPDB Integration</a></li>
<li><a href="#whatismybrowsercom-integration" rel="nofollow ugc">WhatIsMyBrowser.com Integration</a></li>
</ul>
<li><a href="#usage" rel="nofollow ugc">Usage</a></li>
<ul>
<li><a href="#automatic-ip-synchronization" rel="nofollow ugc">Automatic IP Synchronization</a></li>
<li><a href="#manual-synchronization" rel="nofollow ugc">Manual Synchronization</a></li>
<li><a href="#captured-traffic-data" rel="nofollow ugc">Captured Traffic Data</a></li>
<li><a href="#advanced-rule-builder" rel="nofollow ugc">Advanced Rule Builder</a></li>
<li><a href="#rule-details-in-blocked-ips" rel="nofollow ugc">Rule Details in Blocked IPs</a></li>
</ul>
<li><a href="#advanced-settings" rel="nofollow ugc">Advanced Settings</a></li>
<li><a href="#faq" rel="nofollow ugc">Frequently Asked Questions</a></li>
<li><a href="#support" rel="nofollow ugc">Support and Contribution</a></li>
<li><a href="#license" rel="nofollow ugc">License</a></li>
Introduction
 Welcome to the ProActive Security Suite plugin! This comprehensive security solution enhances your website’s protection by combining advanced threat detection, automated rule-based actions, and integration with services like Cloudflare and AbuseIPDB. By proactively analyzing traffic and applying custom security rules, ProActive Security Suite stops malicious traffic before it reaches your server, reducing load and enhancing performance. 
<a href="https://github.com/itcssec/ProActiveSecuritySuite/releases" rel="nofollow ugc">Download Latest Release</a>
Features
<h3>Free Features</h3>
<ul>
<li>Automatic IP Synchronization: Effortlessly sync blocked IPs to Cloudflare’s firewall.</li>
<li>Customizable Settings: Tailor the plugin to your needs with adjustable settings:
<ul>
<li>Blocked Hits Threshold</li>
<li>Block Scope (Domain or Account)</li>
<li>Block Mode (e.g., Block, Managed Challenge)</li>
<li>Cron Interval</li>
</ul>
</li>
<li>Manual Synchronization: Trigger synchronization manually when immediate action is needed.</li>
<li>AbuseIPDB Integration: Optional integration to fetch detailed information about IPs:
<ul>
<li>Country Code</li>
<li>Usage Type</li>
<li>ISP Information</li>
<li>Confidence Score</li>
</ul>
</li>
</ul>
<h3>Premium Features</h3>
<ul>
<li>Advanced Rule Builder: Create custom security rules based on various criteria such as confidence score, whitelisted status, abusive status, and more. Automate actions like blocking or challenging IPs based on these rules.</li>
<li>Rule Priorities: Assign priorities to your rules to control the order of evaluation. Higher priority numbers are evaluated first, allowing critical rules to take precedence.</li>
<li>Automatic Action Application: The plugin automatically applies actions to IPs that match your defined rules immediately after capturing traffic data.</li>
<li>Rule Details in Blocked IPs: View detailed information about which rules caused IPs to be blocked, including criteria and actions taken.</li>
<li>Captured Traffic Data: Log and analyze incoming traffic for enhanced security insights.</li>
<li>Exclude User Roles: Exclude specific WordPress user roles from traffic logging.</li>
<li>WhatIsMyBrowser.com API Integration: Advanced user agent analysis and detection capabilities.</li>
<li>Enhanced AbuseIPDB Integration: Automatic updates for all entries with the same IP address.</li>
<li>Priority Support: Access dedicated support for assistance and troubleshooting.</li>
<li>Cloudflare Custom WAF Rule & List Management: Optionally create a Cloudflare custom list and associated WAF rule. Manage entries directly from the plugin and get notified if Cloudflare reports issues such as a full list.</li>
</ul>
 Note: The premium features require an active premium license. Upgrade to access these advanced functionalities. 
Installation
<ol>
<li>Download the Plugin: Clone the repository or <a href="https://github.com/itcssec/ProActiveSecuritySuite/releases" rel="nofollow ugc">download the latest release</a>.</li>
<li>Upload to WordPress: Upload the `proactive-security-suite` directory to `/wp-content/plugins/`.</li>
<li>Activate the Plugin: In your WordPress dashboard, navigate to Plugins and activate ProActive Security Suite.</li>
</ol>
Configuration
<h3>Cloudflare Settings</h3>
<ol>
<li>Obtain Cloudflare Credentials:
<ul>
<li>Email: Your Cloudflare account email.</li>
<li>API Key: Your Global API Key or an API Token with necessary permissions.</li>
<li>Zone ID: Found in your Cloudflare dashboard under the domain’s overview.</li>
<li>Account ID: Located in your Cloudflare profile settings.</li>
</ul>
</li>
<li>Configure Plugin Settings:
<ul>
<li>Navigate to Settings > ProActive Security Suite.</li>
<li>Enter your Cloudflare credentials securely.</li>
<li>Adjust settings like Blocked Hits Threshold, Block Scope, and Block Mode.</li>
<li>Enable Custom WAF Rule and supply a rule name to allow the plugin to create and maintain a Cloudflare custom list and matching WAF rule. List entries can be viewed, added, or removed from within the plugin.</li>
</ul>
</li>
</ol>
<h3>AbuseIPDB Integration</h3>
<ol>
<li>Sign Up for AbuseIPDB: Visit <a href="https://www.abuseipdb.com/" rel="nofollow ugc">AbuseIPDB</a> and sign up for an API key.</li>
<li>Enable Integration:
<ul>
<li>In the plugin settings, enter your AbuseIPDB API key.</li>
<li>Enable the AbuseIPDB Lookup option.</li>
</ul>
</li>
</ol>
<h3>WhatIsMyBrowser.com Integration (Premium)</h3>
<ol>
<li>Obtain API Key: Register at <a href="https://developers.whatismybrowser.com/api/" rel="nofollow ugc">WhatIsMyBrowser.com</a> for an API key.</li>
<li>Configure Integration:
<ul>
<li>Enter the API key in the plugin’s settings under WhatIsMyBrowser API Key.</li>
<li>Enable the integration features as desired.</li>
</ul>
</li>
</ol>
Usage
<h3>Automatic IP Synchronization</h3>
 The plugin automatically syncs blocked IPs based on your configured cron interval. IPs exceeding the Blocked Hits Threshold are added to Cloudflare’s firewall or acted upon based on your defined rules. 
<h3>Manual Synchronization</h3>
 Navigate to Settings > ProActive Security Suite and click the Run Process button to trigger synchronization and rule evaluation immediately. 
<h3>Captured Traffic Data (Premium)</h3>
 Access detailed logs under the Captured Traffic Data tab. Analyze user agents, request methods, and more. Exclude specific user roles from logging in the settings. 
<h3>Advanced Rule Builder (Premium)</h3>
 The plugin features a powerful Rule Builder that allows you to create custom security rules based on various criteria. You can define rules using conditions such as: 
<ul>
<li>Confidence Score: Set thresholds using operators like greater than, less than, equal to, etc.</li>
<li>Is Whitelisted: Check if an IP is marked as whitelisted in AbuseIPDB.</li>
<li>Is Abusive: Determine if an IP is associated with abusive behavior.</li>
<li>Custom Criteria: Add other criteria based on the data captured.</li>
</ul>
 Each rule can be assigned an Action (e.g., Block, Managed Challenge) that will be applied to IPs matching the rule. You can also assign a Priority to control the order in which rules are evaluated. 
<h3>Rule Details in Blocked IPs (Premium)</h3>
 The Blocked IPs tab now includes a Rule Details column that displays comprehensive information about the rules that caused IPs to be blocked. This includes: 
<ul>
<li>Criteria: The specific conditions that were met, such as confidence score thresholds, whitelisted status, and more.</li>
<li>Action: The action taken by the rule (e.g., Block, Managed Challenge).</li>
</ul>
 This enhancement allows administrators to easily identify which rules are triggering blocks and understand the reasons behind each IP being blocked. It provides greater transparency and aids in fine-tuning security settings. 
Advanced Settings
<ul>
<li>Blocked Hits Threshold: Define the minimum number of blocked hits before an IP is synchronized or evaluated by rules.</li>
<li>Block Scope: Choose between domain-specific or account-wide blocking.</li>
<li>Block Mode: Select the action for Cloudflare to take (e.g., Block, Challenge).</li>
<li>Cron Interval: Set how frequently the plugin checks for new blocked IPs and evaluates rules.</li>
<li>Rule Priorities: Assign priorities to your rules to control the order of evaluation. Higher priority numbers are evaluated first.</li>
<li>User Role Exclusions: Exclude specific WordPress user roles from traffic logging and rule evaluation.</li>
</ul>
Frequently Asked Questions
<h3>How do I obtain my Cloudflare Zone ID and Account ID?</h3>
 Zone ID: Log into Cloudflare, select your domain, and find the Zone ID on the Overview page. Account ID: Click on your profile in Cloudflare; the Account ID is listed there. 
<h3>Can I use an API Token instead of the Global API Key?</h3>
 Yes, ensure the API Token has the necessary permissions for firewall access. 
<h3>Is the plugin compatible with IPv6 addresses?</h3>
 Absolutely, the plugin supports both IPv4 and IPv6 addresses. 
<h3>How does the plugin handle my API keys?</h3>
 All API keys are securely stored using WordPress’s options API and are never exposed in plain text. 
<h3>How do rule priorities work?</h3>
 Rule priorities determine the order in which your rules are evaluated. Rules with higher priority numbers are evaluated first. If traffic data matches a rule, the corresponding action is applied, and no further rules are evaluated for that IP address. 
<h3>Can I see which rule blocked an IP?</h3>
 Yes, with the Rule Details in Blocked IPs feature, you can view the exact rule criteria and action that caused an IP to be blocked. This information is displayed in the Blocked IPs tab under the Rule Details column. 
<h3>How does the automatic action application work?</h3>
 When traffic data is captured, the plugin immediately evaluates it against your defined rules. If a rule matches, the specified action is applied to the IP address without any manual intervention. 
Support and Contribution
 Support: For assistance, please open an issue on our <a href="https://github.com/itcssec/ProActiveSecuritySuite/issues" rel="nofollow ugc">GitHub Issues</a> page or contact us at <a href="mailto:info@itcs.services" rel="nofollow ugc">info@itcs.services</a>. 
License
 This project is licensed under the <a href="https://www.gnu.org/licenses/gpl-3.0.html" rel="nofollow ugc">GNU General Public License v3.0</a>. 
 Thank you for using ProActive Security Suite! 
<h3>External Services</h3>
Cloudflare 
– Usage: We send visitor IPs (and optionally country/ISP data) to create Firewall rules. 
– Data Sent: IP address, associated rule details. 
– <a href="https://www.cloudflare.com/terms/" rel="nofollow ugc">Cloudflare Terms of Service</a> | <a href="https://www.cloudflare.com/privacypolicy/" rel="nofollow ugc">Cloudflare Privacy Policy</a>
AbuseIPDB 
– Usage: We check IP reputation, fetching country code, ISP, and confidence score. 
– Data Sent: IP address. 
– <a href="https://www.abuseipdb.com/legal" rel="nofollow ugc">AbuseIPDB Terms of Service</a> | <a href="https://www.abuseipdb.com/privacy" rel="nofollow ugc">Privacy Policy</a>
WhatIsMyBrowser 
– Usage: We send user agent strings to detect software (browser), OS, and if it’s abusive. 
– Data Sent: User agent strings. 
– <a href="https://developers.whatismybrowser.com/api/about/legal/" rel="nofollow ugc">WhatIsMyBrowser Terms of Service</a> | 
 <a href="https://developers.whatismybrowser.com/api/about/legal/" rel="nofollow ugc">Legal</a>
IPData 
– Usage: We fetch detailed threat intelligence (Tor, proxy, known attacker, etc.). 
– Data Sent: IP address. 
– <a href="https://ipdata.co/terms-of-service.html" rel="nofollow ugc">IPData Terms</a> | 
 <a href="https://ipdata.co/privacy.html" rel="nofollow ugc">Privacy Policy</a>

Proactive Security Suite

Welcome to the ProActive Security Suite Plugin Wiki      Enhance your WordPress website's security with the ProActive Security Suite.

SiMULA

Simula Security Telemetry for Wordfence exports Wordfence security telemetry in two forms:
<ul>
<li>Prometheus metrics for the node_exporter textfile collector that can be scraped by Prometheus</li>
<li>A local incident log containing blocked Wordfence requests that can be shipped with Grafana-Alloy</li>
</ul>
This plugin is intended for WordPress sites that already use Wordfence and Prometheus-based infrastructure. Instead of exposing a public metrics endpoint from WordPress, the plugin writes local files that node_exporter and log-based tooling can consume.
By default, the plugin runs a fast collector every 15 minutes and a slow collector hourly using WP-Cron. It supports:
<ul>
<li>Exporter health and plugin metadata metrics</li>
<li>Configurable cron interval</li>
<li>Separate fast and slow collector intervals</li>
<li>Per-metric-family enable or disable controls</li>
<li>Blocked event counters and recent activity windows</li>
<li>Blocked event counts by HTTP status code over the last 24 hours</li>
<li>Failed login, rate-limited, and brute-force activity windows</li>
<li>Current lockout counts for IPs and users</li>
<li>Wordfence two-factor status and protected user counts</li>
<li>Scan issue counts by severity</li>
<li>Malware, file change, and vulnerable component findings</li>
<li>Top blocked attack sources by country and normalized IP range</li>
<li>Incident log export for newly observed blocked requests</li>
<li>Incident privacy controls for IPs, URLs, referers, user agents, and internal traffic</li>
<li>Manual export and incident cursor reset from the admin UI</li>
<li>Current exporter and incident state visibility in the admin UI</li>
<li>Optional JSON Lines incident output</li>
<li>WP-CLI exports for system cron</li>
<li>Source freshness and WordPress/Wordfence posture metrics</li>
<li>A ready-to-import Grafana dashboard and sample Prometheus alert rules</li>
</ul>
Blocked events are currently identified from the Wordfence hits table where:
<ul>
<li>action matches blocked:*</li>
<li>or the HTTP status code is 403 or 503</li>
</ul>
The plugin includes an admin settings screen under Settings > Security Telemetry, where you can:
<ul>
<li>Enable or disable the exporter master switch</li>
<li>Choose the export cron interval</li>
<li>Choose the slow collector interval</li>
<li>Set the .prom output path</li>
<li>Set a custom metric prefix</li>
<li>Set a custom site label</li>
<li>Enable or disable individual metric families</li>
<li>Enable or disable incident log export</li>
<li>Set the incident log path</li>
<li>Choose text or JSON Lines incident output</li>
<li>Limit the number of incidents appended per run</li>
<li>Configure incident IP privacy and field-dropping filters</li>
<li>Add an optional retention note to emitted incident events</li>
<li>Trigger a manual export</li>
<li>Reset the incident cursor for backfill</li>
<li>Review current exporter and incident state</li>
</ul>

Simula Security Telemetry for Wordfence

Export metrics from Wordfence into a node_exporter textfile collector .prom file and append incidents detected by wordfence to a local log file.

Proactive Security Suite vs Simula Security Telemetry for Wordfence