black-bits / laravel-firewall
A Laravel Firewall Package that can be managed remotely.
Requires
- php: ^7.1
- illuminate/support: 5.1.*|5.2.*|5.3.*|5.4.*|5.5.*|5.6.*
- kitetail/zttp: ^0.3.0
Requires (Dev)
- larapack/dd: ^1.0
- phpunit/phpunit: ^7.0
This package is auto-updated.
Last update: 2024-10-29 04:36:39 UTC
README
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
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
This package is currently in development and is not production ready.
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
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:
- Add it to the
whitelist
array in the config file. - Register the IP for your app with our Laravel Firewall Service
You can use the blacklist
config array to always block access to specific IPs.
Changelog
Please see CHANGELOG for more information on what has changed recently.
Security
If you discover any security related issues, please email hello@blackbits.io instead of using the issue tracker.
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.
License
The MIT License (MIT). Please see License File for more information.