mirror of
https://github.com/8b-is/securaye.git
synced 2026-11-22 00:40:01 +01:00
Upstream pull mirror of https://github.com/8b-is/securaye.git
- Python 82.3%
- Shell 14.9%
- Rust 2.8%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
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> |
||
| scripts | ||
| sec_audit | ||
| tests | ||
| .env.example | ||
| .gitignore | ||
| CLAUDE.md | ||
| LICENSE | ||
| network_analyzer.py | ||
| README.md | ||
| requirements.txt | ||
| securaye.sh | ||
| security_advisor.py | ||
🌐 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+
lsofcommand (pre-installed on most Unix systems)sudoaccess 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:
- Bind to localhost - Services should listen on 127.0.0.1 when possible
- Add authentication - Especially for databases like Redis and MongoDB
- Use SSH keys - Disable password authentication for SSH
- Enable firewalls - Use pf (macOS) or iptables (Linux) to restrict access
- 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!
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (with lots of comments, as Aye would!)
- Push to the branch (
git push origin feature/AmazingFeature) - 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