brasstacksweb / craft-ip-blocker
IP address blocker for Craft CMS applications to bock traffic from malicious sources.
Installs: 0
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Type:craft-plugin
Requires
- php: >=8.0.2
- craftcms/cms: ^4.0
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.75
This package is auto-updated.
Last update: 2025-05-08 18:05:00 UTC
README
IP address blocker for Craft CMS applications to bock traffic from malicious sources.
Requirements
This plugin requires Craft CMS 4.0 or later, and PHP 8.0.2 or later.
Installation
You can install this plugin from the Plugin Store or with Composer.
From the Plugin Store
Go to the Plugin Store in your project’s Control Panel and search for “IP Blocker”. Then press “Install”.
With Composer
Open your terminal and run the following commands:
# go to the project directory cd /path/to/my-project.test # tell Composer to load the plugin composer require brasstacksweb/craft-ip-blocker # tell Craft to install the plugin ./craft plugin/install craft-ip-blocker
Configuration
IP Blocker supports adding one or many conditions to determine if request resulting in an HTTP exception will be recorded and if the requesters I.P. address will be blocked.
Conditions
A condition can be added in the plugin settings and must consist of the following properties:
- Pattern: A string or regular expression (excluding the surrounding /) that will be matched against the message of the top level, or previous, exception thrown by the request.
- Max Attempts: The maximum number of allowed attempts matching the pattern before the I.P. address is blocked.
- Detection Window: The window of time (in seconds) that failed requests are counted toward the maximum.
- Block Time: The duration of time (in seconds) that an I.P. address is blocked after matching the pattern and meeting the maximum attempts.
Stats
Statistics for failed attempts against a condition and I.P. addresses that have been blocked are visible in the IP Blocker section of the CMS.