Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CyberSentinel - AI-Powered Cybersecurity Platform

A production-grade SaaS-style web platform for AI-powered phishing detection, security awareness training, and organizational risk analytics.

🏗️ Architecture Overview

cybersentinel/
│
├── frontend/          # Next.js 14.2.1 + TypeScript
├── backend/           # FastAPI + Python
├── database/          # SQL Schema & Seeds
└── docs/              # Technical Documentation

🚀 Quick Start

Prerequisites

  • Node.js 18+
  • Python 3.10+
  • PostgreSQL (or SQLite for development)

Frontend Setup

cd frontend
npm install
npm run dev
# Runs on http://localhost:4000

Backend Setup

cd backend
pip install -r requirements.txt
uvicorn app.main:app --reload --port 8000
# API available at http://localhost:8000

🎯 Features

1. Dashboard

  • Awareness Score Statistics
  • Weekly Threat Trends
  • Risk Category Breakdown
  • Real-time Detection Feed

2. Detection Engine

  • Email/URL phishing analysis
  • AI-powered risk scoring
  • Suspicious phrase highlighting
  • Explainable AI results

3. Training & Gamification

  • Phishing simulation challenges
  • XP-based progression system
  • Level tracking (Beginner → Expert)
  • Adaptive difficulty algorithm

4. Analytics

  • Weakness category analysis
  • Accuracy trends
  • Risk breakdown visualization
  • Improvement tracking

5. Admin Panel

  • User management
  • Aggregate awareness metrics
  • Threat frequency monitoring

🔐 Security Features

  • JWT-based authentication
  • bcrypt password hashing
  • Role-based access control (User/Admin)
  • Privacy-preserving metadata storage

🤖 Machine Learning

  • Logistic Regression baseline model
  • Feature extraction:
    • Domain mismatch detection
    • Urgency keyword analysis
    • Suspicious link patterns
    • Generic greeting detection
  • Explainable AI with feature importance

📊 Gamification System

Action XP Reward
Correct Answer +10 XP
Incorrect Answer 0 XP
Level Up Every 100 XP

Levels

  1. Beginner (0-99 XP)
  2. Aware (100-199 XP)
  3. Defender (200-299 XP)
  4. Expert (300+ XP)

🛠️ Tech Stack

Frontend

  • Next.js 14.2.1
  • TypeScript 5+
  • TailwindCSS 3.4.1
  • Recharts
  • Lucide React Icons

Backend

  • FastAPI
  • Python 3.10+
  • SQLAlchemy
  • Pydantic
  • scikit-learn

📁 Environment Variables

Frontend (.env.local)

NEXT_PUBLIC_API_URL=http://localhost:8000

Backend (.env)

DATABASE_URL=sqlite:///./cybersentinel.db
SECRET_KEY=your-secret-key-here
ALGORITHM=HS256
ACCESS_TOKEN_EXPIRE_MINUTES=30

📖 Documentation

📄 License

MIT License - Built for enterprise cybersecurity training and awareness.


CyberSentinel - Protecting organizations through intelligent security awareness.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages