orangecat/checkip

Prevent crawlers and IPs reported from creating a session

1.0.3 2025-04-26 00:11 UTC

Requires

• php: ^7.4 || ^8.1
• jaybizzle/crawler-detect: ^1.2
• magento/framework: *

OSL-3.0

README

Block sessions for Bots and IPs that have been reported

This module has been developed for Magento => 2.4.6

This module allows you to download form "iplists.firehol.org" a list of reported IP addresses and compare the client IP addresses with this list. If there is a match, we can pause the request and/or reject it, preventing the creation of a PHP session.

The list will be downloaded every certain time established by a cron job.

From the Magento OS administration panel, you can view the list of IPs with which there has been a match.

The list of matches is saved in TXT format in a daily log that is deleted every few days.

Additionally, you can also check for crawler visits. For this, we use the "Crawler-Detect" package (https://github.com/JayBizzle/Crawler-Detect/) as a dependency.

Installation

The extension must be installed via composer. To proceed, run these commands in your terminal:

composer require orangecat/checkip
bin/magento setup:upgrade

Configuration IP

Stores > Configuration > Security > Check IP

• Enable IP Check
• Cron settings
• IPs blacklist file download URL
• Mode (Block / Pause)
• Log retention days
• Aditional Blacklist
• Whitelist

Configuration Bot

Stores > Configuration > Security > Check IP

• Enable Bot Check
• Mode (Block / Pause)
• Log retention days
• Aditional Blacklist
• Whitelist

Check IP logs

System > IP Blacklist Log

Check Bot logs

System > Bot Blacklist Log

Log IP folder

var/ipblacklist

Log Bot folder

var/botblacklist