black-bits/laravel-firewall

A Laravel Firewall Package that can be managed remotely.

0.1.0 2018-06-19 22:32 UTC

This package is auto-updated.

Last update: 2024-10-29 04:36:39 UTC


README

Latest Version on Packagist Total Downloads StyleCI

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:

  1. Add it to the whitelist array in the config file.
  2. 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.