solution-forest/filament-firewall

This is a middleware for whitelisting/blacklisting for Filament Admin

3.0.1 2025-08-13 02:38 UTC

README

Important

Please note that we will only be updating to version 2.x or 3.x, excluding any bug fixes.

About Solution Forest

Solution Forest Web development agency based in Hong Kong. We help customers to solve their problems. We Love Open Soruces.

We have built a collection of best-in-class products:

  • InspireCMS: A full-featured Laravel CMS with everything you need out of the box. Build smarter, ship faster with our complete content management solution.
  • Filaletter: Filaletter - Filament Newsletter Plugin
  • Website CMS Management: A hands-on Filament CMS plugin for those who prefer more manual control over their website content management.

Filament Firewall

Latest Version on Packagist Total Downloads

This package provides a whitelist and blacklist feature to restrict access to your Laravel application and Filament admin panel. For additional functionality, please refer to the Laravel Firewall package.

filament-firewall-package-1 filament-firewall-package-2

Getting Started

  1. Install the package using the composer require command:

    composer require solution-forest/filament-firewall
  2. To publish the configuration files and migrations files for this plugin, as well as automatically run migration, enter the following command:

    php artisan filament-firewall:install
  3. This package comes with WhitelistRangeMiddleware. You need to register it in $middleware:

    For Laravel version 11.x and above:

    // in bootstrap/app.php
    ->withMiddleware(function (Middleware $middleware) {
         $middleware->append(\SolutionForest\FilamentFirewall\Middleware\WhitelistRangeMiddleware::class);
    })

    For Laravel versions below 11.x:

    // in app/Http/Kernel.php
    protected $middleware = [
         ...
         \SolutionForest\FilamentFirewall\Middleware\WhitelistRangeMiddleware::class,
    ];
  4. You can change the setting in the config/filament-firewall.php file to skip the middleware WhitelistRangeMiddleware check.

  5. For additional configuration options, you can refer to the Laravel Firewall configuration file to customize more firewall settings. Some key configuration options include:

    • config('firewall.enabled') - Controls whether the firewall is enabled (default: true)
    • config('firewall.middleware') - Middleware configuration settings
  6. Register the plugin in your Panel provider:

    Important: Register the plugin in your Panel provider after version 2.x

     use SolutionForest\FilamentFirewall\FilamentFirewallPlugin;
    
     public function panel(Panel $panel): Panel
     {
         return $panel
             ->plugin(FilamentFirewallPlugin::make());
     }

Usage

  • On the IP Firewall page, you have the ability to add IPs to either a whitelist or a blocklist. The WhitelistRangeMiddleware middleware will automatically handle whitelist IP access. If you need to block a range of IPs while allowing a specific IP, such as blocking 172.19.0.0/24 except for 172.19.0.1, you'll need to create a new Deny access record and specify the IP and prefix as '172.19.0.0' and '24'. Additionally, you'll need to add an Allow access record for the specific IP '172.19.0.1'.

filament-firewall-package-2

  • Get whitelist / blacklist records

    // whitelist
    \SolutionForest\FilamentFirewall\Facade\FilamentFirewall::getWhiteList();
    
    // blacklist
    \SolutionForest\FilamentFirewall\Facade\FilamentFirewall::getBlackList();
  • Determine whether an IP address is included in a whitelist or blacklist

    // whitelist
    \SolutionForest\FilamentFirewall\Facade\FilamentFirewall::withinWhiteList($ip);
    
    // blacklist
    \SolutionForest\FilamentFirewall\Facade\FilamentFirewall::withinBlackList($ip);

Publishing translations

php artisan vendor:publish --tag=filament-firewall-translations

Security Vulnerabilities

If you discover any security related issues, please email info+package@solutionforest.net instead of using the issue tracker.

License

Please see License File for more information.

Credits