Skip to content

Latest commit

ย 

History

4 Commits

Folders and files

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

Repository files navigation

๐Ÿ›ก๏ธ CyberShield XDR Platform

AI-Powered Extended Detection & Response Platform

A modern enterprise-grade cybersecurity platform designed to centralize security monitoring, vulnerability management, threat intelligence, malware analysis, phishing detection, and incident response through a unified dashboard.

Python FastAPI React TypeScript PostgreSQL Redis Celery Docker License


๐Ÿ“Œ Overview

CyberShield XDR is a full-stack cybersecurity platform that unifies multiple security operations into a single application.

The platform enables organizations to monitor assets, detect threats, perform vulnerability assessments, analyze malware, investigate phishing attacks, and manage security incidents through an intuitive web interface.

This project demonstrates enterprise-level software architecture using modern backend, frontend, database, and asynchronous processing technologies.


โœจ Features

  • Secure JWT Authentication
  • Role-Based Access Control (RBAC)
  • Security Dashboard
  • Asset Inventory Management
  • Vulnerability Scanner
  • Threat Intelligence Module
  • Malware Analysis
  • Phishing Detection
  • Security Alerts
  • Incident Reports
  • Admin Panel
  • User Management
  • Background Task Processing (Celery)
  • Redis Integration
  • RESTful APIs
  • Swagger API Documentation
  • Docker Support

๐Ÿ— Architecture

                React + TypeScript
                        โ”‚
                        โ”‚
                 REST API (HTTPS)
                        โ”‚
                 FastAPI Backend
                        โ”‚
        โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
        โ”‚               โ”‚               โ”‚
 PostgreSQL         Redis          Celery Worker
        โ”‚               โ”‚               โ”‚
        โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                        โ”‚
            Threat Intelligence Engine

๐Ÿ›  Technology Stack

Frontend

  • React
  • TypeScript
  • Vite
  • Tailwind CSS
  • Axios

Backend

  • FastAPI
  • Python
  • SQLAlchemy
  • Alembic
  • JWT Authentication
  • Pydantic

Database

  • PostgreSQL

Background Processing

  • Celery
  • Redis

DevOps

  • Docker
  • Docker Compose

๐Ÿ“‚ Project Structure

CyberShield-XDR
โ”‚
โ”œโ”€โ”€ backend/
โ”œโ”€โ”€ frontend/
โ”œโ”€โ”€ docker/
โ”œโ”€โ”€ docs/
โ”œโ”€โ”€ screenshots/
โ”œโ”€โ”€ uploads/
โ”œโ”€โ”€ docker-compose.yml
โ”œโ”€โ”€ README.md
โ””โ”€โ”€ LICENSE

๐Ÿš€ Getting Started

Clone Repository

git clone https://github.com/johncybersage/CyberShield-XDR.git
cd CyberShield-XDR

Backend

cd backend
pip install -r requirements.txt

Run

uvicorn main:app --reload

Frontend

cd frontend
npm install
npm run dev

๐Ÿ“– API Documentation

After starting the backend:

http://127.0.0.1:8000/api/docs

๐Ÿ“ธ Screenshots

Login Page


Dashboard


Assets Management


Vulnerability Scanner


Threat Intelligence


Alerts


Settings


Admin Panel


๐Ÿ”’ Security Highlights

  • JWT Authentication
  • Secure Password Hashing
  • Role-Based Authorization
  • API Validation
  • Input Sanitization
  • SQLAlchemy ORM
  • Protected Routes
  • Secure REST APIs

๐Ÿ”ฎ Future Improvements

  • SIEM Integration
  • MITRE ATT&CK Mapping
  • Threat Hunting
  • Multi-Tenant Support
  • AI-Based Threat Correlation
  • Email Alerting
  • Real-Time Monitoring
  • Kubernetes Deployment

๐Ÿ“„ License

This project is licensed under the MIT License.


๐Ÿ‘จโ€๐Ÿ’ป Author Raj(John) K

Cybersecurity Engineering Student | Full-Stack Developer | AI & Cloud Security Enthusiast

๐Ÿ”— GitHub: https://github.com/johncybersage

๐Ÿ’ผ LinkedIn: https://www.linkedin.com/in/raj-k-cybersec/

๐Ÿ“ง Email: johnraj.kse@gmail.com

Built with โค๏ธ for cybersecurity education and research.


โญ If you found this project useful, consider giving it a star.

About

AI-Powered Extended Detection and Response (XDR) Platform built with FastAPI, React, PostgreSQL, Redis, Celery, and Docker.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages