IP Scanner Web App Project

---

🌟 Project Overview

The IP Scanner Web App is a powerful web-based platform that enables users to scan systems or networks for vulnerabilities. It integrates advanced scanning tools with a user-friendly interface, allowing users to input target systems (e.g., IP addresses), initiate scans, and generate detailed, actionable reports.

---

🚀 Core Features and Functionalities

1. User Input for Targets

• Input Options:
  • Individual IP addresses.
  • CIDR ranges (e.g., 192.168.1.0/24).
• Validation:
  • Ensures inputs are correctly formatted before scanning.

2. Run Vulnerability Scans

• Libraries Used:
  • nmap: For network scanning to identify open ports and services.
  • python-vulners: To fetch known vulnerabilities for identified software/services.
• Custom Scan Options:
  • Scan intensity: Quick scan, deep scan, network scan, vulnerabilities scan, or regular scan.
  • Specify ports or services to target.

3. Reports and Analysis

• Detailed Reports:
  • Summary of scanned targets.
  • Open ports and discovered services.
  • Known vulnerabilities associated with services.

4. Save and Compare Scan Histories

• Database Integration:
  • Store scan results in a database (Django ORM).

5. User Authentication

• User Accounts:
  • Users can securely manage their own scans and data.

---

📚 Libraries and Tools

The project leverages the following Python libraries:

• nmap - For scanning targets.
• ipaddress - For IP address validation.
• python-vulners - To discover vulnerabilities.

---

🛠️ Installation

Prerequisites

• Python 3.x
• Django framework

Steps

1. Clone the repository:

   git clone https://github.com/alanhasn/IP-Vulnerability-Web-App-Scanner.git
   cd IP-Vulnerability-Web-App-Scanner

2. Install the dependencies:

   pip install -r requirements.txt

3. Create and activate a virtual environment:

   python -m venv venv
   source venv/bin/activate  # On Windows use: venv\Scripts\activate

4. Apply database migrations:

   python manage.py migrate

5. Run the development server:

   python manage.py runserver

6. Access the app at: http://127.0.0.1:8000

---

📂 Project Structure

- vulnerability_scanner_nmap
  - authentication/
  - ip_scan/
  - templates/
  - vulnerability_scanner_nmap/
  - db.sqlite3
  - manage.py
  - ping_test.py
  - requirements.txt
  - nmap_scan_test.py
  - pyvenv.cfg

---

📝 Usage

1. Log in or create an account.
2. Choose your Scan Types
3. Enter target IPs, CIDR ranges
4. Run the scan and view the results.
5. Save your scan in your Dashboard and Share it with others

---

🔍 Scan Information Displayed in Reports

After performing a scan, the following information will be included in the output:

1. Status:

• Whether the system is reachable (up) or not (down).

2. Open Ports:

• Port Number: Identify open ports (e.g., 80, 443, 22).
• Protocol: Determine the protocol (e.g., TCP, UDP).
• Service Running: The service associated with the port (e.g., HTTP, SSH, HTTPS).

3. Operating System Detection:

• Identify the OS running on the target system (e.g., Windows 10, Ubuntu 20.04).

4. Scan Range:

• The range of ports scanned (e.g., 22-443).

5. Vulnerability Information:

• Description: Provide a brief explanation of the vulnerability.
• Severity: Categorize vulnerabilities as Low, Medium, High, or Critical.

6. Scan Date/Time:

• Record the timestamp of when the scan was completed.

7. Scan Duration:

• How long the scan took to complete.

---

🛡️ License

This project is licensed under the MIT License.

---

🤝 Contributing

We welcome contributions! Feel free to fork the repository, make changes, and submit a pull request.

---

📧 Contact

For questions or feedback, contact us at:

• Email: whoamialan11@gmail.com
• GitHub: @alanhasn