Network Security Scanner

A Python-based network vulnerability scanner that identifies open ports, services, and potential security weaknesses. Performs host discovery, service enumeration, and generates security reports. Designed for authorized security assessments and penetration testing exercises.

Features

• Port Scanning - Scan for open ports using multiple techniques
• Service Detection - Identify running services and versions
• Vulnerability Assessment - Check for common vulnerabilities
• Report Generation - Generate detailed security reports
• Host Discovery - Discover hosts on the network

Requirements

• Python 3.8+
• Nmap (must be installed separately)
• Root/Administrator privileges (for advanced scanning)

Installation

# Install Nmap first
# Windows: Download from https://nmap.org/download.html
# Linux: sudo apt-get install nmap
# macOS: brew install nmap

pip install -r requirements.txt

Usage

Basic Port Scan

python scanner.py --target 192.168.1.0/24

Scan Specific Ports

python scanner.py --target 192.168.1.100 --ports 80,443,22,21

Full Service Detection

python scanner.py --target 192.168.1.100 --service-detection

Generate Report

python scanner.py --target 192.168.1.100 --report

Example Output

[*] Starting network scan...
[*] Scanning target: 192.168.1.100
[*] Port 22/tcp   open  ssh
[*] Port 80/tcp   open  http
[*] Port 443/tcp  open  https
[+] Scan complete: 3 ports open
[+] Report generated: scan_report_192.168.1.100_20250101.txt

Project Structure

network-security-scanner/
├── scanner.py             # Main scanning script
├── port_scanner.py         # Port scanning utilities
├── service_detector.py     # Service detection
├── report_generator.py     # Report generation
├── requirements.txt        # Python dependencies
├── README.md              # This file
└── .gitignore

Security Notice

⚠️ This tool is for authorized security testing only. Always ensure you have written permission before scanning networks. Unauthorized scanning is illegal.

License

MIT License

Author

John Bustamante - Cybersecurity Professional