Laravel middleware to grant access based on a local IP white/black list config or an API
, (*1)
This Laravel package provides you with a simple IP based white and black list functionality., (*2)
It installs a global middleware that checks the visitors IP at every request if enabled (disabled by default)., (*3)
Blacklisted IPs are always blocked, whitelisted IPs are always granted access except when they are also blacklisted., (*4)
All other IPs get checked against an API endpoint of the Laravel Firewall Service, (*5)
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., (*6)
Disclaimer
This package is currently in development and is not production ready., (*7)
Installation
You can install the package via composer, (*8)
composer require black-bits/laravel-firewall
Next you can publish the config and view, (*9)
php artisan vendor:publish --provider="BlackBits\LaravelFirewall\LaravelFirewallServiceProvider"
Usage
To enable the plugin simply publish the config and set FIREWALL_ENABLED=true
in your .env
file., (*10)
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, (*11)
You can use the blacklist
config array to always block access to specific IPs., (*12)
Changelog
Please see CHANGELOG for more information on what has changed recently., (*13)
Security
If you discover any security related issues, please email hello@blackbits.io instead of using the issue tracker., (*14)
Credits
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., (*15)
License
The MIT License (MIT). Please see License File for more information., (*16)