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(5mo ago)102401OSL-3.0LessPHP ^7.4 || ^8.1

Since Apr 24Pushed 5mo ago2 watchersCompare

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

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

41

—

FairBetter than 89% of packages

Maintenance70

Regular maintenance activity

Popularity21

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity51

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

176d 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://www.gravatar.com/avatar/2b0424a2b27fcf1f5c4362f5ab7f4fc78b56dfffe4897c4fd8177623b50fb953?d=identicon)[olivertar](/maintainers/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

[veriteworks/cookiefix

Magento2 extension for Cookie SameSite attribute.

65455.3k1](/packages/veriteworks-cookiefix)[imi/magento2-friendly-captcha

Friendly Captcha integration for Magento2

18116.2k](/packages/imi-magento2-friendly-captcha)[basecom/magento2-csp-split-header

Magento 2 module to split oversized CSP headers into multiple headers.

5256.6k](/packages/basecom-magento2-csp-split-header)[pixelopen/magento-cloudflare-turnstile

Protect your store from spam messages and spam user accounts with Cloudflare Turnstile

5325.4k1](/packages/pixelopen-magento-cloudflare-turnstile)[yireo/magento2-csp-whitelist-inline-js

Magento module to automatically add inline JS script to CSP whitelist

2974.7k](/packages/yireo-magento2-csp-whitelist-inline-js)[sansec/magento2-module-shield

14111.8k](/packages/sansec-magento2-module-shield)

PHPackages © 2026

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