Skip to content

About

🛡️ Lightweight EDR Agent & SIEM Console. Detects Nmap scans in real-time and automatically neutralizes threats using Windows Defender Firewall. Built with Python for Blue Team enthusiasts.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

19 Commits

Folders and files

Repository files navigation

🛡️ Python EDR & SIEM Dashboard

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.

Architecture Overview

This project simulates an Enterprise Security Stack consisting of three main layers:

  1. The Sensor (EDR Agent): Silently sniffs network traffic using scapy, correlating packets to detect malicious behavior (e.g., Nmap TCP SYN Stealth Scans).
  2. The Automation (SOAR): Automatically triggers Active Response by injecting inbound block rules directly into the Windows Defender Firewall.
  3. The Console (SIEM Dashboard): A modern, dark-themed GUI built with customtkinter that parses JSON logs in real-time, allowing security analysts to monitor threats, unblock IPs, and manage trusted whitelists.

Key Features

  • 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.

Technology Stack

  • Language: Python 3.x
  • Network Analysis: scapy
  • GUI Framework: customtkinter
  • OS Integration: subprocess, ctypes, Windows Firewall API

Installation & Setup

Prerequisites (Windows):

  1. Python 3.8+ installed.
  2. Npcap installed (Required for scapy to 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.txt

Usage

To 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.

Disclaimer

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.

About

🛡️ Lightweight EDR Agent & SIEM Console. Detects Nmap scans in real-time and automatically neutralizes threats using Windows Defender Firewall. Built with Python for Blue Team enthusiasts.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages