🛡️ SentinelScan

A Multi-threaded Network Vulnerability Scanner built in Python

SentinelScan is a Python-based network vulnerability scanner developed for educational purposes and authorized security testing. It performs concurrent port scanning, banner grabbing, service detection, and CVE matching to identify potential security vulnerabilities on target systems.

---

✨ Features

• ⚡ Multi-threaded port scanning
• 🔍 Banner grabbing
• 🖥️ Service detection
• 🛡️ CVE matching
• 📊 Real-time scan progress
• 🚀 Fast concurrent scanning
• 📝 Detailed scan results
• 🐍 Built entirely in Python

---

📂 Project Structure

SentinelScan/
│
├── vuln_scanner.py          # Main vulnerability scanner
├── README.md                # Project documentation
├── .gitignore               # Git ignored files
├── requirements.txt         # Python dependencies (optional)
└── LICENSE                  # License (optional)

---

🚀 Getting Started

Prerequisites

• Python 3.13.14
• Internet connection
• Windows, Linux, or macOS

---

📦 Installation

Clone the repository

git clone https://github.com/hari-krish-cmd/SentinelScan.git

Move into the project folder

cd SentinelScan

Install dependencies (if a requirements.txt file is present)

pip install -r requirements.txt

---

▶️ Usage

Run the scanner using:

python vuln_scanner.py <target>

Example

python vuln_scanner.py scanme.nmap.org

---

🔍 Scanner Workflow

          Target
             │
             ▼
     Port Scanning
             │
             ▼
     Banner Grabbing
             │
             ▼
    Service Detection
             │
             ▼
       CVE Matching
             │
             ▼
        Scan Report

---

🛠️ Technologies Used

• Python 3.13.14
• Socket Programming
• ThreadPoolExecutor
• Banner Grabbing
• CVE Database Matching
• Concurrent Networking

---

📋 Current Capabilities

✅ Concurrent Port Scanning

✅ Banner Grabbing

✅ Service Detection

✅ CVE Matching

✅ Fast Multi-threading

✅ Command-Line Interface

---

🚧 Planned Features

• Operating System Detection
• Version Detection
• HTML Reports
• PDF Reports
• JSON Output
• CVSS Severity Scoring
• Plugin Support
• Web Dashboard
• Scheduled Scans
• IPv6 Support

---

⚠️ Disclaimer

SentinelScan is intended only for educational purposes and authorized security testing.

Never scan systems or networks without explicit permission from the owner. The author is not responsible for any misuse of this software.

---

👨‍💻 Author

Harikrishnan

GitHub: https://github.com/hari-krish-cmd

---

🤝 Contributing

Contributions, suggestions, and improvements are welcome.

If you'd like to contribute:

1. Fork the repository
2. Create a new branch
3. Commit your changes
4. Submit a Pull Request

---

⭐ Support

If you found this project useful, consider giving it a ⭐ on GitHub.

---

📄 License

This project is released under the MIT License.