A lightweight, real-time Endpoint Detection and Response (EDR) agent with an integrated SIEM-like graphical dashboard. Built entirely in Python, this project demonstrates core SOC/Blue Team concepts including network traffic analysis, event correlation, and automated active response.
This project simulates an Enterprise Security Stack consisting of three main layers:
- The Sensor (EDR Agent): Silently sniffs network traffic using
scapy, correlating packets to detect malicious behavior (e.g., Nmap TCP SYN Stealth Scans). - The Automation (SOAR): Automatically triggers Active Response by injecting inbound block rules directly into the Windows Defender Firewall.
- The Console (SIEM Dashboard): A modern, dark-themed GUI built with
customtkinterthat parses JSON logs in real-time, allowing security analysts to monitor threats, unblock IPs, and manage trusted whitelists.
- Real-Time Threat Detection: Detects rapid port scanning anomalies using time-window analysis.
- Active Response: Instantly blocks attacker IP addresses via Windows Firewall (
netsh). - Hardware Timestamping & Anti-Lag: Drops stale packets from the buffer to prevent false positives and alert fatigue.
- Inter-Process Communication (IPC): Seamless state synchronization between the Agent and the GUI using queue files.
- Whitelist Management: Analysts can define trusted IPs that the EDR will monitor but never block (Log Only).
- Auto-Elevation: Built-in UAC prompt handler to automatically launch the suite with required Administrator privileges.
- Language: Python 3.x
- Network Analysis:
scapy - GUI Framework:
customtkinter - OS Integration:
subprocess,ctypes, Windows Firewall API
Prerequisites (Windows):
- Python 3.8+ installed.
- Npcap installed (Required for
scapyto sniff packets on Windows. Make sure to check "Install Npcap in WinPcap API-compatible Mode" during installation).
Installation:
git clone https://github.com/nysch3n/EDR_Project1.git
cd EDR_Project1
pip install -r requirements.txtTo start the entire security suite, simply run the launcher. The script will automatically request Administrator privileges (required for packet sniffing and firewall management).
python launcher.py- Testing the EDR: Run an Nmap scan against your machine from another device (or VM) on the network (e.g., nmap -sS -p 1-1000 <YOUR_IP>).
- Managing Threats: Use the SIEM Dashboard to view real-time alerts, manage the Whitelist, and unblock IPs with a single click.
This tool is built for educational purposes and home-lab environments to demonstrate Blue Team methodologies. Do not deploy this in a production corporate environment without extensive testing, as automated firewall modifications can cause network disruptions.