README

FilamentWatchdog

Advanced security monitoring and intrusion detection plugin for FilamentPHP

Features

🛡️ Real-time Protection

Real-time file integrity monitoring
Automated malware detection with signature scanning
Activity logging and anomaly detection

🚨 Alert System

Email alerts for security events
Customizable notification thresholds
Real-time dashboard notifications

🔍 Forensic Tools

Detailed forensic analysis tools
Quarantine system for suspicious files
Emergency lockdown system

Installation

Install the package via Composer:

composer require mkwebdesign/filament-watchdog:^1.0

Publish the configuration file:

php artisan vendor:publish --tag=filament-watchdog-config

Optionally, publish the views (if you want to customize them):

php artisan vendor:publish --tag=filament-watchdog-views

Then run the auto-installer script from your Laravel root directory:

bash install-filament-watchdog.sh

And migrate the database:

php artisan migrate

Configuration

After publishing the config file, you can customize the settings in config/filament-watchdog.php:

return [
    'monitoring' => [
        'enabled' => true,
        'scan_interval' => 'everyMinute', // How often to run scans
    ],
    'alerts' => [
        'email' => [
            'enabled' => true,
            'recipients' => ['admin@yoursite.com'],
        ],
    ],
    'emergency' => [
        'auto_publish_views' => true,
        'lockdown_enabled' => true,
    ],
    // ... more settings
];

Cronjob Setup (Required)

FilamentWatchdog requires the Laravel scheduler to run automated security scans. Add the standard Laravel cronjob to your server:

# Edit your crontab
crontab -e

# Add this line (standard Laravel scheduler - runs every minute)
* * * * * cd /path/to/your/laravel/project && php artisan schedule:run >> /dev/null 2>&1

Example with full path:

* * * * * php /home/username/domains/yoursite.com/public_html/artisan schedule:run >> /dev/null 2>&1

Note: This is the standard Laravel scheduler cronjob that should run every minute. FilamentWatchdog will automatically schedule its security scans within this framework.

Manual scan commands:

# Run file integrity scan
php artisan watchdog:scan-integrity

# Run malware detection scan
php artisan watchdog:scan-malware

# Create new file baseline
php artisan watchdog:create-baseline

# Run complete security scan
php artisan watchdog:scan-all

Panel Registration

use MKWebDesign\FilamentWatchdog\FilamentWatchdogPlugin;

// Inside the panel() method:
->plugin(FilamentWatchdogPlugin::make());

Usage

After installation, visit:

/admin/security/dashboard

to access the security monitoring interface.

Key Features:

Security Dashboard - Overview of system security status
File Monitoring - Real-time detection of file changes
Malware Scanner - Automated scanning for malicious files
Alert System - Email notifications for security events
Emergency Lockdown - Immediate site protection in case of threats
Quarantine System - Safe isolation of suspicious files

Requirements

PHP 8.1 or higher
Laravel 10.x or 11.x
FilamentPHP 3.x
Cronjob access on your server

Troubleshooting

Config Not Published?

If the configuration file doesn't appear in config/filament-watchdog.php, try:

# Clear caches first
php artisan config:clear
php artisan cache:clear

# Then publish again
php artisan vendor:publish --tag=filament-watchdog-config --force

# Verify the file exists
ls -la config/filament-watchdog.php

Cronjob Not Working?

Check if the Laravel scheduler is configured correctly
Verify the path to your Laravel project in the cronjob
Ensure PHP is in your server's PATH
Check cronjob logs: grep CRON /var/log/syslog

Permission Issues?

Make sure the web server user has write permissions to:

storage/app/ directory
storage/logs/ directory
storage/app/quarantine/ directory

Support

Need help? Feel free to:

Open an issue on GitHub
Contact us directly via email

Author

Martin Knops | MKWebDesign

License

The MIT License (MIT). Please see License File for more information.

Made with ❤️ by MKWebDesign

mkwebdesign / filament-watchdog

Maintainers

Details