Commit Graph

17 Commits

Author SHA1 Message Date
cschantz 25a5098063 Multi-panel support for 500-error-tracker.sh (Class C refactoring)
MAJOR REFACTORING:
Fast 500 error tracking tool that scans Apache access logs for 500 errors,
filters out bot traffic, and diagnoses root causes. Now supports all control panels.

KEY CHANGES:

1. Added Required Sources (lines 12-14):
   - source system-detect.sh (for SYS_CONTROL_PANEL, SYS_LOG_DIR)
   - source user-manager.sh (for future get_user_domains if needed)
   - Already had common-functions.sh and ip-reputation.sh

2. Configuration (lines 61-63):
   - Changed DOMLOGS_DIR from hardcoded "/var/log/apache2/domlogs" to "${SYS_LOG_DIR}"
   - Added CONTROL_PANEL="${SYS_CONTROL_PANEL}"

3. Domain→User Lookup (lines 85-99):
   - Replaced cPanel-only /var/cpanel/users lookup
   - Multi-panel case statement:
     * cPanel: /etc/userdatadomains
     * InterWorx: vhost config + SuexecUserGroup
     * Plesk: plesk bin subscription --info
   - Fallback to "unknown" if lookup fails

4. Log Discovery (lines 189-210):
   - Complete multi-panel rewrite using case statement

   cPanel (line 192-195):
   - Uses $DOMLOGS_DIR (from SYS_LOG_DIR)
   - Maintains existing exclusion filters

   InterWorx (line 196-199):
   - Searches /home/*/var/*/logs/access_log
   - Per-domain logs in user home directories

   Plesk (line 200-203):
   - Searches /var/www/vhosts/system/*/logs/
   - Includes both access_log and access_ssl_log

   Standalone (line 204-208):
   - Tries /var/log/httpd/access_log
   - Tries /var/log/apache2/access.log

IMPACT:
- Critical diagnostic tool now works on cPanel, InterWorx, Plesk, standalone
- Properly detects logs based on control panel structure
- Domain→user mapping works across all panels
- No hardcoded paths remain

COMPLIANCE: Class C 
-  Uses system-detect.sh variables (SYS_CONTROL_PANEL, SYS_LOG_DIR)
-  Multi-panel case statements for user lookup and log discovery
-  No hardcoded panel-specific paths
-  Syntax verified with bash -n
2025-11-19 23:31:22 -05:00
cschantz 11de58beaa Add cancel/back options to all user input prompts
Changes:
- Added "0) Cancel" option to all menu prompts
- Added "(or 0 to cancel)" to all text input prompts
- Ensures users can back out of any operation at any time
- Scripts affected:
  - website-error-analyzer.sh (scope selection, time range)
  - 500-error-tracker.sh (time range selection)
  - wordpress-cron-manager.sh (all domain/user input prompts, status checks)

User Experience Improvements:
- No more being trapped in prompts
- Clear cancel instructions on every input
- Consistent "Operation cancelled" messaging
- Proper exit codes (0 for user cancellation)

Tested:
✓ website-error-analyzer.sh - cancel on scope selection
✓ 500-error-tracker.sh - cancel on time selection
✓ wordpress-cron-manager.sh - cancel on domain/user input
✓ All cancellations return cleanly to menu

https://claude.com/claude-code
2025-11-07 17:42:11 -05:00
cschantz 4ff98033f2 Add centralized IP reputation tracking system
Created a comprehensive IP reputation system that tracks IPs across all
toolkit scripts with tags/attack types, scores, and detailed analytics.

NEW FILES:
- lib/ip-reputation.sh: Core reputation library with optimized database
  * Fast lookup using pipe-delimited file format
  * Attack type tagging system (bitmask: SQL, XSS, RCE, Bot, Scanner, etc.)
  * Reputation scoring (0-100) based on hits and attack severity
  * GeoIP country lookup integration
  * Automatic cleanup of old entries
  * Thread-safe with file locking

- modules/security/ip-reputation-manager.sh: Interactive management tool
  * Query individual IPs with full details
  * View top malicious/active IPs
  * Database statistics and analytics
  * Manual IP flagging/whitelisting
  * Import IPs from logs
  * Export to readable reports
  * Live monitoring mode

INTEGRATION:
All security and analysis scripts now use the centralized reputation system:

- modules/website/500-error-tracker.sh:
  * Tracks IPs generating 500 errors
  * Tags bots/scanners with BOT/SCANNER flags
  * Background processing for performance

- modules/security/live-attack-monitor.sh:
  * Maps attack types to reputation flags
  * Tracks SSH bruteforce, SQL injection, XSS, DDoS, etc.
  * Real-time reputation updates

- modules/website/website-error-analyzer.sh:
  * Tags filtered bots in error analysis
  * Builds IP reputation from website errors

- launcher.sh:
  * Added IP Reputation Manager to Bot & Traffic Analysis menu
  * Menu option 4 in Security > Analysis > Bot & Traffic Analysis

KEY FEATURES:
✓ Centralized IP tracking across ALL scripts
✓ Multi-tag system (IP can have multiple attack types)
✓ Reputation scores increase with more tags/attacks
✓ Country tracking via GeoIP
✓ Optimized for high-volume traffic (attacks with 1000s of IPs)
✓ Fast lookups even during DDoS
✓ Background processing doesn't slow down analysis
✓ Database cleanup/maintenance tools
✓ Export for reports and sharing

BENEFITS:
- Single source of truth for IP reputation
- Scripts share intelligence (bot detected in one script = flagged for all)
- Track IPs across time and multiple attack vectors
- Identify repeat offenders with multiple attack types
- Make blocking decisions based on comprehensive data
- Performance optimized with file locking and background updates
2025-11-05 18:45:55 -05:00
cschantz f128219f05 Fix 500 error tracker diagnostic output bugs
Fixed three issues in the diagnostic output display:

1. Integer expression error: Changed from grep -c to wc -l with sanitization
   to prevent "integer expression expected" errors from newlines

2. ANSI escape codes: Added -e flag to echo statement so color codes
   render properly instead of showing as raw \033[2m sequences

3. Duplicate domains: Implemented two-pass deduplication system using
   sort -u to show unique domains per issue pattern, preventing repetitive
   output like showing the same domain 5 times
2025-11-05 18:22:38 -05:00
cschantz 9064606b12 Improve diagnostics display: group by issue pattern, not by domain
Problem: Showing 86 "unique issues" when actually many domains have the
same .htaccess error was overwhelming and hard to read. For example,
14 airmarkoverhaul.com subdomains all had identical .htaccess issues.

Solution: Reorganize to group by issue pattern, showing affected domains:

New format:
  Issue: PHP directives incompatible with FPM; Malformed RewriteRule...
  Affected (14): airmarkengines.com, airmarkinc.com, airmarkoh.com, ...

Benefits:
- Shows actual unique issue patterns (not domain+issue combos)
- Lists up to 5 affected domains per issue
- Shows domain count for each issue pattern
- Limits to 10 issue patterns per cause type
- Much more readable and actionable

Instead of scrolling through 86 nearly-identical lines, you now see
the unique problems and which domains are affected by each.
2025-11-03 21:59:01 -05:00
cschantz 902ac18c80 Performance: Remove slow php -l check and add progress indicator
Issues:
- Script was running php -l (syntax checker) on every file with 500 error
- With 7555 errors, this meant running php -l thousands of times
- Each php -l takes 100-500ms, causing multi-minute delays

Changes:
- Removed php -l syntax checking (was causing major slowdown)
- Added progress indicator showing "Analyzed X / Y errors..."
- Progress updates every 500 errors to show script is working
- Completion message when diagnosis finishes

Result: Diagnosis now completes in seconds instead of minutes.
Users still get comprehensive checks for .htaccess, permissions,
file existence, docroot, PHP handler, and WordPress issues.
2025-11-03 21:44:29 -05:00
cschantz be4314dde9 Add comprehensive automatic diagnostics for 500 errors
Added 10+ new automated checks that run when no PHP error is found in error_log:

New checks added:
1. .htaccess issues:
   - Invalid PHP directives (php_value/php_flag with FPM)
   - Malformed RewriteRule syntax
   - Missing RewriteBase with relative paths

2. File validation:
   - File exists check (FILE_NOT_FOUND)
   - File readable check (PERMISSION_ERROR)
   - PHP syntax validation using php -l (PHP_SYNTAX_ERROR)

3. Directory permissions:
   - Document root exists (DOCROOT_MISSING)
   - Document root permissions (755/750/711)

4. PHP handler issues:
   - PHP handler configured for domain
   - .htaccess AddHandler/SetHandler misconfig (PHP_HANDLER_ERROR)

5. WordPress-specific:
   - wp-config.php readable
   - WP_DEBUG_DISPLAY causing 500s (WP_DEBUG_ERROR)

Flow: When error_log has no matching errors, script now runs ALL checks
sequentially until it finds an issue, providing specific diagnosis instead
of generic "NO_PHP_ERROR_LOGGED".

This should catch most common 500 error causes automatically.
2025-11-03 21:36:28 -05:00
cschantz 9dba9c7642 Improve diagnosis: check .htaccess even when error_log exists
Problem: Only diagnosing 4 unique issues out of 7555 errors because script
was only checking .htaccess when error_log didn't exist. Most errors had
error_log files but no matching PHP errors, so fell through to
"NO_PHP_ERROR_LOGGED" without further investigation.

Solution: Added fallback .htaccess checking in two scenarios:
1. When error_log exists but has no matching errors for this URL
2. When error_log exists but grep finds no relevant PHP errors

Now checks for common .htaccess issues in all cases:
- Invalid php_value/php_flag directives (incompatible with FPM)
- Malformed RewriteRule syntax

This should dramatically increase the number of diagnosed issues by catching
.htaccess problems even when PHP error_log exists.
2025-11-03 21:34:22 -05:00
cschantz abdcb906d8 Add IP filtering and reorganize Website Management menu
IP Filtering enhancements to 500 error tracker:
- Filter localhost/internal IPs (127.x, 10.x, 172.16-31.x, 192.168.x)
- Detect cloud scanner IPs from AWS, GCP, Azure with user agent validation
- Skip known bot network IP ranges to reduce noise
- More aggressive filtering of non-relevant traffic

Website Management menu reorganization:
Reduced from 16 options to 7 logical categories:

Main menu now has:
1. Website Error Analyzer
2. Fast 500 Error Tracker
3. Debug Log Analyzer
4. Health & Maintenance → (5 tools: health check, DB optimizer, cache, plugin/theme audit)
5. WP-Cron Management → (3 tools: status, mass fix, system cron setup)
6. Mass Updates → (3 tools: core, plugins, themes updates)
7. Security & Compliance → (3 tools: malware scanner, permissions, login audit)

Benefits:
- Cleaner, more organized menu structure
- Related tools grouped together
- Easier navigation with logical subcategories
- Reduced cognitive load (7 vs 16 options)
2025-11-03 21:21:44 -05:00
cschantz 222dc08415 Fix: Scan logs in subdirectories to catch all domain errors
Issue: Was missing 500 errors from logs stored in subdirectories like
/var/log/apache2/domlogs/username/domain.com

Changed from simple glob (domlogs/*) to recursive find command that:
- Scans all files in domlogs directory AND subdirectories
- Excludes system files (bytes_log, offset, error_log, ftpxferlog, ssl_log)
- Finds ALL domain access logs regardless of location

This ensures we catch errors like "GET /ay.php HTTP/1.1" 500 that were
previously missed in subdirectory logs.
2025-11-03 21:17:45 -05:00
cschantz c36ba42333 Fix duplicate diagnostics and integer expression error in 500 tracker
Issues fixed:
- Removed duplicate diagnostic messages (was showing same error 169+ times)
- Fixed bash integer expression error at line 552
- Deduplicate diagnostics by domain+url+issue combination using sort -u
- Only save diagnostics when we have an actual identified cause
- Skip displaying UNKNOWN causes (these are now categorized as NO_PHP_ERROR_LOGGED)
- Show "X unique issues" instead of raw count to reflect deduplication

Now shows each unique domain+issue combination once, with proper counts.
2025-11-03 21:06:18 -05:00
cschantz 9b7cdc704d Enhance 500 error tracker: bot filtering, comprehensive validation, specific diagnostics
Major improvements to provide actionable, specific diagnostics instead of generic advice:

- Add bot/scanner filtering to reduce noise (monitors, SEO tools, security scanners, HTTP clients)
- Track and display filtered bot count in summary
- Remove all emojis from output
- Fix ANSI escape codes with echo -e for proper color rendering

Comprehensive file/permission validation:
- Resolve URLs to actual file paths being requested
- Test .htaccess readability by Apache (nobody user)
- Validate .htaccess syntax with apache2ctl -t
- Detect invalid PHP directives (php_value/php_flag without mod_php)
- Find malformed RewriteRule and orphaned RewriteCond
- Check document root and specific file permissions
- Test if files are readable by Apache user

Enhanced error extraction:
- Extract exact file paths from PHP errors
- Get line numbers for syntax errors
- Extract function names for missing function errors
- Get database usernames/names from DB errors
- Show current memory limits for memory exhaustion
- Identify specific files with permission issues

Add detailed per-URL diagnostics section:
- Show domain + URL + specific issue + file path + exact problem
- Group by error type with up to 20 examples per type
- Examples: "example.com/wp-admin - Permission denied on: /home/user/wp-config.php (perms: 600, owner: root:root) - NOT readable by Apache"
2025-11-03 21:00:27 -05:00
cschantz 037885011f Fix color variable display in 500 tracker output
ISSUE: Example text was showing raw ANSI codes like:
  \033[2mExample: domain.com...\033[0m

FIX: Added DIM and BOLD color variable definitions
  - These weren't being loaded from common-functions.sh
  - Now examples display properly with dim gray text
2025-11-03 20:44:45 -05:00
cschantz 85a17d7b4c Filter out cPanel system logs from 500 error tracker
FILTERED LOG FILES:
- proxy (Apache reverse proxy logs)
- localhost (local connections)
- default (default vhost)
- cpanel, webmail, whm (cPanel services)
- cpcalendars, cpcontacts, webdisk (cPanel apps)

These are cPanel system services, not actual customer domains.
They were showing as 'unknown' user and cluttering results.

Now only tracks actual customer domain 500 errors.
2025-11-03 20:42:56 -05:00
cschantz 472a9f3f88 Enhance 500 tracker error log detection and .htaccess diagnosis
IMPROVED ERROR LOG DETECTION:
- Now checks 5 different locations for error logs:
  • /home/USER/public_html/error_log
  • /home/USER/logs/error_log
  • /home/USER/error_log
  • /var/log/apache2/domlogs/DOMAIN-error_log
  • /usr/local/apache/domlogs/DOMAIN
- Increased tail from 100 to 500 lines for better error capture

NEW .HTACCESS DETECTION:
- If no error_log found, checks for .htaccess file
- Looks for RewriteRules, php_value, php_flag directives
- If found, classifies as 'HTACCESS_LIKELY' instead of 'NO_ERROR_LOG_FILE'
- Provides specific .htaccess troubleshooting steps

BETTER ROOT CAUSE CATEGORIES:
- HTACCESS_LIKELY: Has .htaccess with rules, likely syntax error
- NO_ERROR_LOG_FILE: Checked all locations, truly not found
- NO_PHP_ERROR_LOGGED: Error log exists but empty (Apache/config issue)

This should catch most of the 'NO_ERROR_LOG_FILE' cases and
correctly identify them as .htaccess syntax errors.
2025-11-03 20:42:19 -05:00
cschantz adce5ab148 Add 30-day option to Fast 500 Error Tracker
- Added time range selection: 24 hours, 7 days, 30 days
- Default still 24 hours for speed
- Uses same time filtering as full analyzer
2025-11-03 20:33:27 -05:00
cschantz 4843e163aa Add Fast 500 Error Tracker + Fix awk error in analyzer
NEW SCRIPT: modules/website/500-error-tracker.sh
- FAST-ONLY 500 error detection (no menus, no options)
- Scans access logs for 500 errors
- Maps domains to cPanel usernames
- Automatically diagnoses root causes by checking error_log files
- Shows actual PHP errors causing the 500s

ROOT CAUSE DETECTION:
- PHP Memory Exhausted (shows current limit)
- PHP Fatal Errors
- PHP Syntax Errors
- Missing PHP Functions/Extensions
- Database Connection Failures
- .htaccess Issues
- Shows ACTUAL error examples, not just suggestions

FIXES:
- Fixed awk error in website-error-analyzer.sh:
  • Changed "next" in END block to "if (length > 0)"
  • "next" cannot be used in END block in awk

- Added option 2 in Website Management menu
- Renumbered all WordPress tools (3-16)

DIFFERENCE FROM FULL ANALYZER:
Full Analyzer: All errors, filters, time ranges, user choices
Fast Tracker: ONLY 500s, auto-diagnosis, shows WHY not suggestions

Use Fast Tracker when you need to quickly find which domains
are getting 500 errors and the exact PHP errors causing them.
2025-11-03 20:32:19 -05:00