Upstream pull mirror of https://github.com/8b-is/securaye.git
  • Python 82.3%
  • Shell 14.9%
  • Rust 2.8%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
dependabot[bot] be21dc3ea3
chore(deps): bump python-dotenv from 1.0.0 to 1.2.2 (#1)
Bumps [python-dotenv](https://github.com/theskumar/python-dotenv) from 1.0.0 to 1.2.2.
- [Release notes](https://github.com/theskumar/python-dotenv/releases)
- [Changelog](https://github.com/theskumar/python-dotenv/blob/main/CHANGELOG.md)
- [Commits](https://github.com/theskumar/python-dotenv/compare/v1.0.0...v1.2.2)

---
updated-dependencies:
- dependency-name: python-dotenv
  dependency-version: 1.2.2
  dependency-type: direct:production
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-11-08 09:19:46 -05:00
scripts 🚀 Rename project from NetWatch to SecurAye and update related configurations. Trademark 2025-08-07 01:33:33 -04:00
sec_audit feat(ultrafoldpop): add E2E 3-pass call-graph folding orchestrator and bilingual EN/JA JPCERT/CC & IPA early-warning generator 2026-10-31 18:56:30 +01:00
tests feat(ultrafoldpop): add E2E 3-pass call-graph folding orchestrator and bilingual EN/JA JPCERT/CC & IPA early-warning generator 2026-10-31 18:56:30 +01:00
.env.example 🚀 Rename project from NetWatch to SecurAye and update related configurations. Trademark 2025-08-07 01:33:33 -04:00
.gitignore 🚀 Rename project from NetWatch to SecurAye and update related configurations. Trademark 2025-08-07 01:33:33 -04:00
CLAUDE.md 🚀 Rename project from NetWatch to SecurAye and update related configurations. Trademark 2025-08-07 01:33:33 -04:00
LICENSE 🚀 Rename project from NetWatch to SecurAye and update related configurations. Trademark 2025-08-07 01:33:33 -04:00
network_analyzer.py 🚀 Rename project from NetWatch to SecurAye and update related configurations. Trademark 2025-08-07 01:33:33 -04:00
README.md 🚀 Rename project from NetWatch to SecurAye and update related configurations. Trademark 2025-08-07 01:33:33 -04:00
requirements.txt chore(deps): bump python-dotenv from 1.0.0 to 1.2.2 (#1) 2026-11-08 09:19:46 -05:00
securaye.sh 🚀 Add main script for SecurAye - Live Network Port Monitor with command line options and AI integration 2025-08-07 01:34:47 -04:00
security_advisor.py 🚀 Rename project from NetWatch to SecurAye and update related configurations. Trademark 2025-08-07 01:33:33 -04:00

🌐 SecurAye - Network Security Monitor

"Because Trish in Accounting said our network security reports were boring!" - Aye & Hue

A colorful, comprehensive network port analyzer and security scanner that makes network monitoring actually fun (and secure). Built with love by Aye for Hue, with Trish's seal of approval for maximum sparkle ✨

🚀 Features

🔥 Security Analysis

  • Critical Port Detection - Identifies high-risk services (Redis, MongoDB, Telnet)
  • Risk Assessment - Evaluates each service's security implications
  • Security Scoring - Get a 0-100 score for your network's security posture
  • External Connection Tracking - Monitor outbound connections to external IPs
  • Root Service Monitoring - Track services running with elevated privileges

📊 Network Intelligence

  • Service Categorization - Groups services by type (system, development, browsers, etc.)
  • Port Conflict Detection - Identifies multiple services on the same port
  • Development Service Detection - Spots dev servers that shouldn't be in production
  • Well-Known Port Mapping - Instantly recognize standard services

🎨 Beautiful Output

  • Color-Coded Severity - Red for critical, yellow for warnings, green for all-clear
  • Organized Reports - Clean, structured output that's easy to read
  • Live Monitoring - Watch mode for real-time network changes
  • Export Options - Save reports for documentation or analysis

📦 Installation

Prerequisites

  • Python 3.6+
  • lsof command (pre-installed on most Unix systems)
  • sudo access for complete network visibility

Quick Setup

# Clone the repository
git clone https://github.com/yourusername/securaye.git
cd securaye

# Make the shell script executable
chmod +x securaye.sh

# You're ready to go!

🎯 Usage

Quick Security Check

# One-time security scan
./securaye.sh -q

# Full analysis with Python analyzer
sudo lsof -i -n -P | python3 network_analyzer.py

Live Monitoring

# Watch all ports with 2-second refresh
./securaye.sh -w

# Custom refresh interval (5 seconds)
./securaye.sh -w -i 5

Filtered Scans

# Only show listening services
./securaye.sh -l

# Only show established connections
./securaye.sh -e

# Specific port range
./securaye.sh -p 8000-9000

Export Reports

# Save output to file
./securaye.sh -o network_report.txt

# Combine with other options
./securaye.sh -w -l -o listening_services.log

🔍 Understanding the Output

Security Score Breakdown

  • 100-80: GOOD 👍 - Your network is well-configured
  • 79-60: MODERATE ⚠️ - Some improvements recommended
  • 59-0: NEEDS ATTENTION 🚨 - Critical security issues detected

Risk Levels

  • CRITICAL: Services with known security vulnerabilities or no authentication
  • HIGH: Remote access services and databases
  • MEDIUM: Standard system services
  • LOW: High-port services with limited exposure

🛡️ Security Best Practices

The tool provides specific recommendations based on your network configuration:

  1. Bind to localhost - Services should listen on 127.0.0.1 when possible
  2. Add authentication - Especially for databases like Redis and MongoDB
  3. Use SSH keys - Disable password authentication for SSH
  4. Enable firewalls - Use pf (macOS) or iptables (Linux) to restrict access
  5. Regular audits - Run SecurAye periodically to catch new issues

📝 Example Output

🌐 Network Analysis Report - Aye & Hue's Network Detective 🔍
================================================================================

📊 Summary Statistics:
  • Total Listening Services: 42
  • Active Connections: 31
  • Closed Connections: 8
  • Unique Processes: 28

🔥 SECURITY ANALYSIS - THE HOT STUFF! 🔥

  🚨 CRITICAL - Services Exposed to ALL Networks:
    • Redis (port 6379, user: root) - CRITICAL
    • PostgreSQL (port 5432, user: wraith) - HIGH

  📊 Security Score:
    Score: 65/100 - MODERATE ⚠️

  🛡️ Security Recommendations:
    1. Bind services to localhost/127.0.0.1 when possible
    2. Add authentication to Redis (requirepass)
    3. Ensure database has strong authentication

🤝 Contributing

Found a bug? Have a feature request? Trish has a suggestion? We'd love to hear from you!

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (with lots of comments, as Aye would!)
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

📜 License

This project is open source and available under the MIT License.

🎉 Credits

  • Aye - The AI who loves commenting everything
  • Hue - The human who needed better network monitoring
  • Trish from Accounting - Chief Sparkle Officer and security enthusiast

"Remember, a secure network is a happy network!" - Trish 💜

Made with 🎉 at 8b.is