Skip to content

tanush-0/sentinelite

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

2 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ›ก SentinelLite

A Lightweight Endpoint Security Analyzer with Risk Scoring & Interactive Dashboard

SentinelLite is a Python-based security analysis tool that inspects your local system for potential risks and presents a structured security assessment through an interactive web dashboard. It is designed to demonstrate practical concepts in system security, risk modeling, and monitoring.


๐Ÿš€ Overview

Modern systems often run multiple services and processes that can unintentionally expose vulnerabilities. SentinelLite helps identify these risks by analyzing:

  • Open network ports
  • Running processes
  • Firewall status
  • Privilege levels

It then converts this data into a quantified risk score, along with actionable recommendations.


โœจ Key Features

๐Ÿ” System Inspection

  • Detects open/listening ports
  • Identifies privilege level (user vs admin/root)
  • Checks firewall status
  • Flags potentially suspicious processes

๐Ÿง  Risk Scoring Engine

  • Context-aware scoring model
  • Differentiates between common and suspicious ports
  • Includes process-based risk signals
  • Produces a structured risk breakdown

๐Ÿ›ก Security Recommendations

  • Generates targeted hardening suggestions
  • Based directly on detected system conditions

๐Ÿ“Š Interactive Dashboard

  • Real-time risk score display
  • Category-wise breakdown visualization
  • Recommendations panel
  • Clean and minimal UI powered by Flask + Chart.js

๐Ÿ“ธ Screenshots

Dashboard Overview

Dashboard

Risk Breakdown

Chart

Recommendations

Recommendations


๐Ÿ— Project Structure

SentinelLite/
โ”‚
โ”œโ”€โ”€ agent.py          # Collects system data
โ”œโ”€โ”€ risk.py           # Risk scoring engine
โ”œโ”€โ”€ hardening.py      # Recommendation generator
โ”œโ”€โ”€ dashboard.py      # Flask backend
โ”‚
โ”œโ”€โ”€ templates/
โ”‚   โ””โ”€โ”€ index.html    # Frontend UI
โ”‚
โ”œโ”€โ”€ screenshots/      # Project visuals
โ”œโ”€โ”€ requirements.txt
โ””โ”€โ”€ README.md

โš™๏ธ Installation

Clone the repository and install dependencies:

git clone https://github.com/tanush-0/sentinelite.git
cd sentinelite
pip install -r requirements.txt

โ–ถ๏ธ Usage

1. Collect System Data

python agent.py

2. Launch Dashboard

python dashboard.py

3. Open in Browser

http://127.0.0.1:5000

๐Ÿง  How Risk Scoring Works

The total risk score (0โ€“100) is derived from multiple weighted factors:

Category Description
Privilege Elevated privileges increase risk
Ports Suspicious ports carry higher weight
Firewall Disabled firewall significantly increases risk
Processes Suspicious processes raise risk
Services Higher system exposure increases score

โš ๏ธ Limitations

  • Snapshot-based analysis (no real-time monitoring yet)
  • Limited OS-specific recommendations
  • No external vulnerability (CVE) integration
  • Basic process detection using keyword matching

๐Ÿ”ฎ Future Roadmap

  • Real-time monitoring and alert system
  • Advanced process behavior analysis
  • Integration with threat intelligence sources
  • Authentication for dashboard access
  • OS-specific security hardening automation

๐Ÿ‘จโ€๐Ÿ’ป Author

Tanush


๐Ÿ“„ License

This project is licensed under the MIT License.

About

๐Ÿ” Analyze. ๐Ÿ“Š Score. ๐Ÿ›ก Secure. โ€” A minimal endpoint risk analyzer with real-time insights.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors