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.zipAfter copying the files, activate the module in WHMCS:
text
Admin Area → Setup → Addon Modules → IPAbuse Firewall → ActivateConfigure
Open the configuration screen:
text
Admin Area → Setup → Addon Modules → IPAbuse Firewall → Configure| Setting | Default | Description |
|---|---|---|
| API Key | — | Your IPAbuse API key (required). Get one free at ipabuse.org. |
| Enable Plugin | off | Master on/off switch for all blocking and reporting. |
| Block Malicious IPs | off | Block IPs found in the IPAbuse reputation database. |
| Report Failed Logins | off | Report failed WHMCS client and admin login attempts to IPAbuse. |
| Minimum Score | 75 | Block IPs with an abuse score ≥ this value (0–100). |
| IPs per Sync | 1000 | How 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:
- Archive: ipabuse-whmcs-1.0.0.zip
- Manifest: latest.json