PHPackages                             black-bits/laravel-firewall - 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. black-bits/laravel-firewall

AbandonedLibrary[Security](/categories/security)

black-bits/laravel-firewall
===========================

A Laravel Firewall Package that can be managed remotely.

0.1.0(7y ago)011MITPHPPHP ^7.1

Since Jun 19Pushed 7y ago1 watchersCompare

[ Source](https://github.com/black-bits/laravel-firewall)[ Packagist](https://packagist.org/packages/black-bits/laravel-firewall)[ Docs](https://github.com/black-bits/laravel-firewall)[ RSS](/packages/black-bits-laravel-firewall/feed)WikiDiscussions master Synced 2mo ago

READMEChangelogDependencies (4)Versions (2)Used By (0)

Laravel middleware to grant access based on a local IP white/black list config or an API
========================================================================================

[](#laravel-middleware-to-grant-access-based-on-a-local-ip-whiteblack-list-config-or-an-api)

[![Latest Version on Packagist](https://camo.githubusercontent.com/b7e695a3dd396ce413dfc3571f063ca017d95e8a63271c0487d42a6b9a8b4714/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f626c61636b2d626974732f6c61726176656c2d6669726577616c6c2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/black-bits/laravel-firewall)[![Total Downloads](https://camo.githubusercontent.com/8b6444828702ca09fb1ad84717e9bc4de829484b28bed08eb4f1b19cc2408331/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f626c61636b2d626974732f6c61726176656c2d6669726577616c6c2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/black-bits/laravel-firewall)[![StyleCI](https://camo.githubusercontent.com/a1088fae9998eecece50743d54309e892698f4daf6fbd910970e5734e24284fe/68747470733a2f2f7374796c6563692e696f2f7265706f732f3133373932333435332f736869656c64)](https://styleci.io/repos/137923453)

This Laravel package provides you with a simple IP based white and black list functionality.

It installs a global middleware that checks the visitors IP at every request if enabled (disabled by default).

Blacklisted IPs are always blocked, whitelisted IPs are always granted access except when they are also blacklisted.

All other IPs get checked against an API endpoint of the [Laravel Firewall Service](https://laravel-firewall.io)

The API's intended use is the protection of development and staging environments, while granting convenient, centrally maintained access to e.g. your employees or clients.

### Disclaimer

[](#disclaimer)

*This package is currently in development and is not production ready.*

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

[](#installation)

You can install the package via composer

```
composer require black-bits/laravel-firewall
```

Next you can publish the config and view

```
php artisan vendor:publish --provider="BlackBits\LaravelFirewall\LaravelFirewallServiceProvider"
```

Usage
-----

[](#usage)

To enable the plugin simply publish the config and set `FIREWALL_ENABLED=true` in your `.env` file.

There are two ways to grant access to an IP:

1. Add it to the `whitelist` array in the config file.
2. Register the IP for your app with our [Laravel Firewall Service](https://laravel-firewall.io)

You can use the `blacklist` config array to always block access to specific IPs.

### Changelog

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

### Security

[](#security)

If you discover any security related issues, please email  instead of using the issue tracker.

Credits
-------

[](#credits)

- [Oliver Heck](https://github.com/oheck)
- [Andreas Przywara](https://github.com/aprzywara)
- [Adrian Raeuchle](https://github.com/araeuchle)
- [All Contributors](../../contributors)

Support us
----------

[](#support-us)

Black Bits, Inc. is a web and consulting agency specialized in Laravel and AWS based in Grants Pass, Oregon. You'll find an overview of what we do [on our website](https://blackbits.io).

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

22

—

LowBetter than 23% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity5

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 75% 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

Unknown

Total

1

Last Release

2880d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/c5817559bd224c59f893745c3bbfa308db2786b67e16c4c44cc4472826e9d571?d=identicon)[aprzywara](/maintainers/aprzywara)

![](https://www.gravatar.com/avatar/12f99b0d20f4c0281e21cd28d12a44d2789c673a5bacade150d0e1150bdd9464?d=identicon)[oheck](/maintainers/oheck)

---

Top Contributors

[![aprzywara](https://avatars.githubusercontent.com/u/10901792?v=4)](https://github.com/aprzywara "aprzywara (3 commits)")[![oheck](https://avatars.githubusercontent.com/u/10670394?v=4)](https://github.com/oheck "oheck (1 commits)")

---

Tags

blackbitslaravel firewall

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/black-bits-laravel-firewall/health.svg)

```
[![Health](https://phpackages.com/badges/black-bits-laravel-firewall/health.svg)](https://phpackages.com/packages/black-bits-laravel-firewall)
```

###  Alternatives

[illuminate/encryption

The Illuminate Encryption package.

9229.7M278](/packages/illuminate-encryption)[tzsk/otp

A secure, database-free One-Time Password (OTP) generator and verifier for PHP and Laravel.

241641.4k1](/packages/tzsk-otp)[genealabs/laravel-governor

Managing policy and control in Laravel.

201262.8k](/packages/genealabs-laravel-governor)[dgtlss/warden

A Laravel package that proactively monitors your dependencies for security vulnerabilities by running automated composer audits and sending notifications via webhooks and email

8745.6k](/packages/dgtlss-warden)[ercsctt/laravel-file-encryption

Secure file encryption and decryption for Laravel applications

642.6k](/packages/ercsctt-laravel-file-encryption)[laragear/poke

Keep your forms alive, avoid TokenMismatchException by gently poking your Laravel app

2211.5k](/packages/laragear-poke)

PHPackages © 2026

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