IPAbuse Developers

WHMCS Plugin

The IPAbuse WHMCS plugin protects your billing portal and client area from malicious IPs. It automatically blocks high-risk visitors and reports failed login attempts back to the IPAbuse reputation database.

Requirements

  • WHMCS 8.0 or later
  • PHP 8.1 or later
  • IPAbuse API key
  • Outbound HTTPS access from your server to api.ipabuse.org

Install

cURL
# 1. Download the archive
curl -fsSL https://downloads.ipabuse.org/plugins/whmcs/ver/ipabuse-whmcs-1.0.0.zip -o ipabuse-whmcs.zip

# 2. Extract into your WHMCS modules/addons directory
unzip ipabuse-whmcs.zip -d /path/to/whmcs/modules/addons/ipabuse

# 3. Remove the archive
rm ipabuse-whmcs.zip

After copying the files, activate the module in WHMCS:

text
Admin Area → Setup → Addon Modules → IPAbuse Firewall → Activate

Configure

Open the configuration screen:

text
Admin Area → Setup → Addon Modules → IPAbuse Firewall → Configure
SettingDefaultDescription
API Key—Your IPAbuse API key (required). Get one free at ipabuse.org.
Enable PluginoffMaster on/off switch for all blocking and reporting.
Block Malicious IPsoffBlock IPs found in the IPAbuse reputation database.
Report Failed LoginsoffReport failed WHMCS client and admin login attempts to IPAbuse.
Minimum Score75Block IPs with an abuse score ≥ this value (0–100).
IPs per Sync1000How many IPs to fetch per daily blocklist sync (100–10000).

How it works

The plugin registers four WHMCS hooks:

  • ClientAreaPage — checks and blocks malicious IPs on every client area request.
  • AdminAreaHeadOutput — checks and blocks malicious IPs on every admin area request.
  • FailedLogin — reports failed client login attempts to the IPAbuse API as BRUTE_FORCE.
  • AdminAreaLoginFailed — reports failed admin login attempts with elevated severity.

A DailyCronJob hook syncs the latest blocklist from IPAbuse each day, caching the IP list locally so blocking decisions require no live API call.

The plugin resolves the real client IP from CF-Connecting-IP, X-Real-IP, and REMOTE_ADDR in that order, making it compatible with Cloudflare and other reverse proxies.

Download

The latest release is always available at:

Next steps