PHPackages                             orangecat/checkip - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Security](/categories/security)
4. /
5. orangecat/checkip

ActiveMagento2-module[Security](/categories/security)

orangecat/checkip
=================

Prevent Bots and IPs reported from creating a session

1.0.7(7mo ago)10386OSL-3.0LessPHP ^7.4 || ^8.1

Since Apr 24Pushed 7mo ago2 watchersCompare

[ Source](https://github.com/olivertar/m2_checkip)[ Packagist](https://packagist.org/packages/orangecat/checkip)[ RSS](/packages/orangecat-checkip/feed)WikiDiscussions main Synced today

READMEChangelog (8)Dependencies (3)Versions (10)Used By (0)

M2 Check IP Module
==================

[](#m2-check-ip-module)

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 () as a dependency.

You also have the option to enable/disable IP or bot protection via API and receive email notifications when the API is accessed. This is especially usefu:

- GET /V1/checkip/enableip?enabled=true:false
- GET /V1/checkip/enablebot?enabled=true:false
- GET /V1/checkip/enableall?enabled=true:false

Installation
------------

[](#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
----------------

[](#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
-----------------

[](#configuration-bot)

Stores > Configuration > Security > Check IP

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

Check IP logs
-------------

[](#check-ip-logs)

System > IP Blacklist Log

Check Bot logs
--------------

[](#check-bot-logs)

System > Bot Blacklist Log

Log IP folder
-------------

[](#log-ip-folder)

var/ipblacklist

Log Bot folder
--------------

[](#log-bot-folder)

var/botblacklist

Configuration API
-----------------

[](#configuration-api)

Stores > Configuration > Security > Check IP

- Only Email Notification?
- Emails Notification
- Enable API IP
- Enable API BOT
- Clear Full Page Cache after status change
- Whitelist

###  Health Score

39

—

LowBetter than 84% of packages

Maintenance63

Regular maintenance activity

Popularity20

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 90.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~26 days

Recently: every ~52 days

Total

9

Last Release

222d ago

PHP version history (3 changes)1.0.0PHP ^7.4

1.0.1PHP ^7.4||^8.0

1.0.3PHP ^7.4 || ^8.1

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/959440?v=4)[Oliverio Gombert](/maintainers/olivertar)[@olivertar](https://github.com/olivertar)

---

Top Contributors

[![olivertar](https://avatars.githubusercontent.com/u/959440?v=4)](https://github.com/olivertar "olivertar (10 commits)")[![manuelcanepa](https://avatars.githubusercontent.com/u/10290593?v=4)](https://github.com/manuelcanepa "manuelcanepa (1 commits)")

### Embed Badge

![Health badge](/badges/orangecat-checkip/health.svg)

```
[![Health](https://phpackages.com/badges/orangecat-checkip/health.svg)](https://phpackages.com/packages/orangecat-checkip)
```

###  Alternatives

[october/rain

October Rain Library

1601.7M83](/packages/october-rain)[fastly/magento2

Fastly CDN Module for Magento 2.4.x

1564.4M1](/packages/fastly-magento2)[imi/magento2-friendly-captcha

Friendly Captcha integration for Magento2

19131.4k](/packages/imi-magento2-friendly-captcha)[veriteworks/cookiefix

Magento2 extension for Cookie SameSite attribute.

65482.5k1](/packages/veriteworks-cookiefix)[sansec/magento2-module-shield

15190.4k](/packages/sansec-magento2-module-shield)[myparcelnl/magento

A Magento 2 module that creates MyParcel labels

1860.2k](/packages/myparcelnl-magento)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)