Skip to content

Latest commit

ย 

History

11 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ›ก๏ธ NetShield

Network Traffic Analysis & Security Monitoring

Turn raw network captures into actionable security insights.

NetShield is a web-based network traffic analysis platform built to make packet capture investigation faster and easier to understand.

Upload a .pcap or .pcapng file and NetShield transforms raw network traffic into packets, flows, DNS activity, HTTP requests, TLS information, traffic statistics, and security alerts through a centralized dashboard.

The project combines network analysis, backend engineering, data processing, and rule-based threat detection into one practical cybersecurity application.


๐Ÿš€ Why NetShield?

Network packet captures contain a huge amount of low-level information that can be difficult to investigate manually.

NetShield simplifies that process by turning raw traffic into structured security insights:

        PCAP / PCAPNG
              โ”‚
              โ–ผ
      โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
      โ”‚ Packet Analysis โ”‚
      โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
               โ–ผ
      โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
      โ”‚  Flow Analysis  โ”‚
      โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
               โ–ผ
    โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
    โ–ผ          โ–ผ          โ–ผ
   DNS        HTTP       TLS
 Analysis   Analysis   Analysis
    โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
               โ–ผ
      โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
      โ”‚ Threat Detectionโ”‚
      โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
               โ–ผ
      โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
      โ”‚ Security Alerts โ”‚
      โ”‚   & Dashboard   โ”‚
      โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

โœจ Key Features

๐Ÿ“‚ Intelligent PCAP Analysis

  • Upload .pcap and .pcapng files
  • Parse and inspect network packets
  • Extract protocol, IP, port, and connection information
  • Group packets into meaningful network flows

๐ŸŒ Network Intelligence

  • Extract DNS queries and domains
  • Identify HTTP traffic and request details
  • Analyze available TLS SNI information
  • Examine communication between network hosts
  • Generate traffic statistics and visualizations

๐Ÿšจ Rule-Based Threat Detection

NetShield analyzes traffic patterns to identify potentially suspicious behavior, including:

Detection What NetShield Looks For
๐Ÿ”ด Port Scanning Repeated connections across multiple ports
๐ŸŸ  SYN Anomalies Repeated SYN packets without completed connections
๐ŸŸก Connection Bursts Unusual spikes in connection attempts
๐ŸŸก High Traffic Abnormally high traffic rates
๐Ÿ”ด Monitored Ports Activity involving configured suspicious ports

๐Ÿ”Ž Investigation Tools

  • Search packets and flows
  • Filter security alerts
  • Inspect individual network conversations
  • Explore traffic statistics
  • Move from high-level activity to packet-level details

๐Ÿ–ฅ๏ธ Dashboard

NetShield brings the analysis into a single investigation dashboard, allowing users to move from overall network activity to individual packets and security alerts.

Traffic Overview

NetShield Dashboard

Tip: Replace the screenshot above with your best dashboard screenshot. A strong visual here makes the project immediately more compelling to recruiters.


๐Ÿง  What This Project Demonstrates

NetShield goes beyond a basic CRUD application. It demonstrates practical experience with:

  • Network protocol analysis
  • Packet-level data processing
  • PCAP file handling
  • REST API development
  • Rule-based anomaly detection
  • Data extraction and transformation
  • Security-focused application design
  • Interactive data visualization
  • Backend architecture

The project was designed to bridge the gap between raw network data and human-readable security insights.


๐Ÿ—๏ธ System Architecture

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚            Web Dashboard            โ”‚
โ”‚  Upload โ€ข Search โ€ข Filter โ€ข Charts  โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                   โ”‚
                   โ–ผ
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚           FastAPI REST API          โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                   โ”‚
          โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
          โ–ผ                  โ–ผ
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚  PCAP Processing โ”‚ โ”‚ Threat Detectionโ”‚
โ”‚                  โ”‚ โ”‚     Engine      โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
         โ”‚                    โ”‚
         โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                    โ–ผ
       โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
       โ”‚ Structured Analysis    โ”‚
       โ”‚ Packets โ€ข Flows โ€ข DNS  โ”‚
       โ”‚ HTTP โ€ข TLS โ€ข Alerts    โ”‚
       โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

๐Ÿ› ๏ธ Tech Stack

Backend

Python โ€ข FastAPI โ€ข REST API

Network Analysis

PCAP / PCAPNG โ€ข Packet Analysis โ€ข Flow Analysis โ€ข DNS โ€ข HTTP โ€ข TLS

Security

Rule-Based Detection โ€ข Network Anomaly Detection โ€ข Traffic Analysis

Development

Git โ€ข GitHub โ€ข REST APIs


โšก Getting Started

Clone the Repository

git clone https://github.com/aishwarya983/Netsheild.git
cd Netsheild

Create a Virtual Environment

python -m venv venv

Activate the Environment

Windows

venv\Scripts\activate

macOS / Linux

source venv/bin/activate

Install Dependencies

pip install -r requirements.txt

Start NetShield

Run the FastAPI application using the project's configured startup command.

Once the backend is running, interactive API documentation is available at:

http://127.0.0.1:8000/docs

๐Ÿ“ก API

NetShield provides a FastAPI REST API that powers the network analysis workflow.

The interactive Swagger documentation makes it easy to explore and test the available endpoints:

http://127.0.0.1:8000/docs

The API supports the core analysis workflow, including:

  • PCAP processing
  • Packet extraction
  • Flow analysis
  • DNS analysis
  • Traffic statistics
  • Security alert generation

๐ŸŽฏ Example Workflow

1. Upload a PCAP file
        โ†“
2. NetShield processes the capture
        โ†“
3. Packets and flows are extracted
        โ†“
4. DNS / HTTP / TLS information is analyzed
        โ†“
5. Detection rules evaluate network behavior
        โ†“
6. Suspicious patterns generate alerts
        โ†“
7. Results are explored through the dashboard

๐Ÿ“Š Project Highlights

Packet-Level Visibility Understand what is happening inside a network capture rather than relying only on high-level statistics.

Security-Oriented Analysis Detect suspicious traffic patterns using configurable rule-based detection.

Structured Network Intelligence Convert complex packet captures into searchable packets, flows, domains, protocols, and alerts.

Developer-Focused Architecture Separate API, processing, analysis, and detection responsibilities to keep the system maintainable and extensible.


๐Ÿ”ฎ Roadmap

  • Live packet capture
  • Real-time traffic monitoring
  • Background processing for large PCAP files
  • CSV / PDF security reports
  • Additional detection rules
  • Improved IPv6 analysis
  • Dashboard-based rule configuration
  • Advanced traffic visualizations
  • Real-time security alerts

๐Ÿ‘ฉโ€๐Ÿ’ป Built By

Aishwarya Desai

Computer Science Student โ€ข Software Developer

Focused on building practical software projects across backend development, cybersecurity, network analysis, and problem solving.

GitHub ยท LinkedIn


โญ If you found NetShield interesting, consider giving the repository a star.

About

Network traffic analysis and security monitoring dashboard

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages