Building 70 Projects ranging from beginner to advanced so anyone can β learn from, build upon, use as a reference, or even copy directly. Owned by my cybersecurity company π
Go aicertificationcloud-engineeringcybercybersecuritycybersecurity-analystcybersecurity-certificationcybersecurity-certificationscybersecurity-educationcybersecurity-jobscybersecurity-portfoliocybersecurity-projectscybersecurity-toolsgrchackinglearningpentestingproject-repositoryprojetcspython
fix: update READMEs for ebpf tracer & dlp scanner
CarterPerez-devd3fa5ea1326d
diff --git a/PROJECTS/beginner/linux-ebpf-security-tracer/README.md b/PROJECTS/beginner/linux-ebpf-security-tracer/README.mdindex c562ea44..b6ceabcc 100644--- a/PROJECTS/beginner/linux-ebpf-security-tracer/README.md+++ b/PROJECTS/beginner/linux-ebpf-security-tracer/README.md@@ -1,68 +1,52 @@-# Linux eBPF Security Tracer+```ruby+βββββββββββββββ βββββββ ββββββββ ββββββββββββββββ ββββββ ββββββββββββββββββββββ+ββββββββββββββββββββββββββββββββ βββββββββββββββββββββββββββββββββββββββββββββββββ+ββββββ ββββββββββββββββββββββ βββ βββββββββββββββββββ ββββββ ββββββββ+ββββββ βββββββββββββββ ββββββ βββ βββββββββββββββββββ ββββββ ββββββββ+βββββββββββββββββββ βββ βββ βββ ββββββ ββββββββββββββββββββββ βββ+βββββββββββββββ βββ βββ βββ βββ ββββββ βββ ββββββββββββββββββ βββ+```++[](https://github.com/CarterPerez-dev/Cybersecurity-Projects/tree/main/PROJECTS/beginner/linux-ebpf-security-tracer)+[](https://python.org)+[](https://ebpf.io)+[](https://www.gnu.org/licenses/agpl-3.0)++> Real-time syscall tracing tool using eBPF for security observability β monitors process execution, file access, network connections, privilege changes, and system operations to detect suspicious behavior.-Real-time syscall tracing tool using eBPF for security observability. Monitors process execution, file access, network connections, privilege changes, and system operations to detect suspicious behavior patterns.+*This is a quick overview β security theory, architecture, and full walkthroughs are in the [learn modules](#learn).*-## Features+## What It Does-- Real-time syscall monitoring via eBPF tracepoints+- Real-time syscall monitoring via eBPF tracepoints (process, file, network, privilege, system)- 10 built-in detection rules mapped to MITRE ATT&CK techniques-- Correlated event analysis (reverse shell detection, privilege escalation)+- Correlated event analysis for multi-step attacks (reverse shell detection, privilege escalation chains)- Multiple output formats: live color-coded stream, JSON, table summary- Configurable severity filtering (LOW, MEDIUM, HIGH, CRITICAL)-- Process, file, network, privilege, and system event categories-- Event enrichment from /proc filesystem+- Event enrichment from /proc filesystem (parent process, username)- Clean signal handling and eBPF program cleanup-## Prerequisites--- Linux kernel 5.8+ (ring buffer support)-- Root privileges (required for eBPF)-- Python 3.10+-- BCC (BPF Compiler Collection) with Python bindings-## Quick Start```bash-# Install system dependencies and Python packages./install.sh--# Start tracing all syscallssudo uv run ebpf-tracer--# JSON output, only MEDIUM+ severity-sudo uv run ebpf-tracer -f json -s MEDIUM--# Only network events-sudo uv run ebpf-tracer -t network--# Only show detection alerts-sudo uv run ebpf-tracer --detections--# Filter by process name-sudo uv run ebpf-tracer -c nginx--# Write events to file while streaming-sudo uv run ebpf-tracer -o events.jsonl```+> [!TIP]+> This project uses [`just`](https://github.com/casey/just) as a command runner. Type `just` to see all available commands.+>+> Install: `curl -sSf https://just.systems/install.sh | bash -s -- --to ~/.local/bin`+## Usage-```-ebpf-tracer [OPTIONS]--Options:- -f, --format Output format: json, table, live [default: live]- -s, --severity Minimum severity: LOW, MEDIUM, [default: LOW]- HIGH, CRITICAL- -p, --pid Filter by specific PID- -c, --comm Filter by process name- -t, --type Event category: process, file, [default: all]- network, privilege, system, all- --no-enrich Disable /proc enrichment- -o, --output Also write events to file- --detections Show only detection alerts- --version Show version- --help Show help+```bash+sudo uv run ebpf-tracer # trace all syscalls (live mode)+sudo uv run ebpf-tracer -f json -s MEDIUM # JSON output, MEDIUM+ severity+sudo uv run ebpf-tracer -t network # only network events+sudo uv run ebpf-tracer --detections # only show detection alerts+sudo uv run ebpf-tracer -c nginx # filter by process name+sudo uv run ebpf-tracer -o events.jsonl # write events to file while streaming```## Detection Rules@@ -80,106 +64,18 @@ Options:| D009 | Log Tampering | MEDIUM | T1070.002 | Log file deletion/truncation || D010 | Suspicious Mount | HIGH | T1611 | mount syscall |-## Architecture--```-User Space-βββββββββββ ββββββββββββββββ βββββββββββββββββββ-β CLI ββββΆβ Event Engine ββββΆβ Output Renderer β-β (Typer) β β (Processor + β β (JSON / Table / β-β β β Detector) β β Live Stream) β-βββββββββββ ββββββββ¬ββββββββ βββββββββββββββββββ- β- ββββββββ΄ββββββββ- β BPF Loader β- β (BCC/Python)β- ββββββββ¬ββββββββ-ββββββββββββββββββββββΌββββββββββββββββββββββββββββββ-Kernel Space β- ββββββββ΄ββββββββ- β Ring Buffer β- ββββββββ¬ββββββββ- βββββββββββββββββΌββββββββββββββββββββ- β eBPF C Tracepoint Programs β- β ββββββββββββββββββββββββββββββββ β- β β Process ββ File ββ Network β β- β ββββββββββββββββββββββββββββββββ β- β ββββββββββββββββββββββ β- β βPrivilege ββ System β β- β ββββββββββββββββββββββ β- βββββββββββββββββββββββββββββββββββββ-```--## Monitored Syscalls--| Category | Syscalls | Purpose |-|----------|----------|---------|-| Process | execve, clone | New process creation |-| File | openat, unlinkat, renameat2 | File access and manipulation |-| Network | connect, accept4, bind, listen | Network activity |-| Privilege | setuid, setgid | Privilege changes |-| System | ptrace, mount, init_module | System-level operations |--## Project Structure--```-src/-βββ main.py # CLI entrypoint (Typer)-βββ config.py # Constants, event types, detection rules-βββ loader.py # BCC program loader and ring buffer setup-βββ processor.py # Event parsing, enrichment, filtering-βββ detector.py # Detection engine with stateless and stateful rules-βββ renderer.py # Output formatters (JSON, live, table)-βββ ebpf/- βββ process_tracer.c # execve, clone tracepoints- βββ file_tracer.c # openat, unlinkat, renameat2 tracepoints- βββ network_tracer.c # connect, accept4, bind, listen tracepoints- βββ privilege_tracer.c # setuid, setgid tracepoints- βββ system_tracer.c # ptrace, mount, init_module tracepoints-```--## Example Output--### Live Mode (default)--```-[14:30:01] LOW execve pid=1234 comm=bash /usr/bin/curl-[14:30:01] CRITICAL connect pid=1234 comm=nc 10.0.0.1:4444 [Reverse Shell]-[14:30:02] MEDIUM openat pid=5678 comm=python3 /etc/shadow [Sensitive File Read]-[14:30:03] HIGH init_module pid=9012 comm=insmod [Kernel Module Load]-```--### JSON Mode--```json-{"timestamp":"2026-04-08T14:30:01+00:00","event_type":"connect","pid":1234,"comm":"nc","severity":"CRITICAL","detection":"Reverse Shell","mitre_id":"T1059.004","dest_ip":"10.0.0.1","dest_port":4444}-```--## Development--```bash-# Install dev dependencies-uv sync--# Run unit tests-just test--# Lint-just lint--# Format-just format-```+## Learn-## How It Works+This project includes step-by-step learning materials covering security theory, architecture, and implementation.-1. **eBPF C programs** attach to kernel tracepoints for specific syscalls-2. When a traced syscall fires, the eBPF program captures event data (PID, UID, filename, etc.) and pushes it to a shared ring buffer-3. **Python (BCC)** polls the ring buffer and deserializes events via ctypes-4. The **processor** enriches events with data from /proc (parent process, username)-5. The **detection engine** evaluates each event against stateless rules (single-event patterns) and stateful rules (correlated event sequences)-6. The **renderer** outputs events in the selected format with severity-based color coding+| Module | Topic |+|--------|-------|+| [00 - Overview](learn/00-OVERVIEW.md) | Prerequisites and quick start |+| [01 - Concepts](learn/01-CONCEPTS.md) | eBPF theory and security observability |+| [02 - Architecture](learn/02-ARCHITECTURE.md) | System design and data flow |+| [03 - Implementation](learn/03-IMPLEMENTATION.md) | Code walkthrough |+| [04 - Challenges](learn/04-CHALLENGES.md) | Extension ideas and exercises |## License-MIT+AGPL 3.0diff --git a/PROJECTS/intermediate/dlp-scanner/README.md b/PROJECTS/intermediate/dlp-scanner/README.mdindex 4bcedf04..f6b1cf6f 100644--- a/PROJECTS/intermediate/dlp-scanner/README.md+++ b/PROJECTS/intermediate/dlp-scanner/README.md@@ -7,7 +7,7 @@βββββββ βββββββββββ ββββββββ ββββββββββ ββββββ βββββ```-[](https://github.com/CarterPerez-dev/Cybersecurity-Projects/tree/main/PROJECTS/intermediate/dlp-scanner)+[](https://github.com/CarterPerez-dev/Cybersecurity-Projects/tree/main/PROJECTS/intermediate/dlp-scanner)[](https://python.org)[](https://www.gnu.org/licenses/agpl-3.0)@@ -31,6 +31,11 @@ bash install.shdlp-scan file ./data```+> [!TIP]+> This project uses [`just`](https://github.com/casey/just) as a command runner. Type `just` to see all available commands.+>+> Install: `curl -sSf https://just.systems/install.sh | bash -s -- --to ~/.local/bin`+## Usage```bashdiff --git a/PROJECTS/intermediate/dlp-scanner/justfile b/PROJECTS/intermediate/dlp-scanner/justfilenew file mode 100644index 00000000..577732af--- /dev/null+++ b/PROJECTS/intermediate/dlp-scanner/justfile@@ -0,0 +1,27 @@+# Β©AngelaMos | 2026+# justfile++default:+ @just --list++lint:+ uv run ruff check .+ uv run mypy src/++format:+ uv run yapf -r -i src/ tests/++check-format:+ uv run yapf -r -d src/ tests/++test:+ uv run pytest tests/ -m "unit"++test-all:+ uv run pytest tests/++run *ARGS:+ uv run dlp-scan {{ARGS}}++install:+ bash install.shdiff --git a/README.md b/README.mdindex e792ecc3..2d1ccbbe 100644--- a/README.md+++ b/README.md@@ -25,11 +25,11 @@<h2 align="center"><strong>View Complete Projects:</strong></h2><div align="center"><a href="https://github.com/CarterPerez-dev/Cybersecurity-Projects/tree/main/PROJECTS">- <img src="https://img.shields.io/badge/Full_Source_Code-21/67-blue?style=for-the-badge&logo=github" alt="Projects"/>+ <img src="https://img.shields.io/badge/Full_Source_Code-23/67-blue?style=for-the-badge&logo=github" alt="Projects"/></a></div>-<p align="center"><sub><em>Currently building: project #22</em></sub></p>+<p align="center"><sub><em>Currently building: project #24</em></sub></p>---@@ -70,7 +70,7 @@ Tools, courses, certifications, communities, and frameworks for cybersecurity pr| **[Base64 Encoder/Decoder](./SYNOPSES/beginner/Base64.Encoder.Decoder.md)**<br>Multi-format encoding tool |    | Base64/32 encoding β’ URL encoding β’ Auto-detection<br>[Source Code](./PROJECTS/beginner/base64-tool) \| [Docs](./PROJECTS/beginner/base64-tool/learn) || **[Linux CIS Hardening Auditor](./SYNOPSES/beginner/Linux.CIS.Hardening.Auditor.md)**<br>CIS benchmark compliance checker |    | CIS benchmarks β’ System hardening β’ Compliance scoring β’ Shell scripting<br>[Learn More](./SYNOPSES/beginner/Linux.CIS.Hardening.Auditor.md) || **[Systemd Persistence Scanner](./SYNOPSES/beginner/Systemd.Persistence.Scanner.md)**<br>Hunt Linux persistence mechanisms |    | Persistence techniques β’ Systemd internals β’ Cron analysis β’ Threat hunting<br>[Learn More](./SYNOPSES/beginner/Systemd.Persistence.Scanner.md) |-| **[Linux eBPF Security Tracer](./SYNOPSES/beginner/Linux.eBPF.Security.Tracer.md)**<br>Real-time syscall tracing with eBPF |     | eBPF programs β’ Syscall tracing β’ BCC framework β’ Security observability<br>[Learn More](./SYNOPSES/beginner/Linux.eBPF.Security.Tracer.md) |+| **[Linux eBPF Security Tracer](./PROJECTS/beginner/linux-ebpf-security-tracer)**<br>Real-time syscall tracing with eBPF |     | eBPF programs β’ Syscall tracing β’ BCC framework β’ Security observability<br>[Source Code](./PROJECTS/beginner/linux-ebpf-security-tracer) \| [Docs](./PROJECTS/beginner/linux-ebpf-security-tracer/learn) || **[Trojan Application Builder](./SYNOPSES/beginner/Trojan.Application.Builder.md)**<br>Educational malware lifecycle demo |    | Trojan anatomy β’ Data exfiltration β’ File encryption β’ Attack lifecycle<br>[Learn More](./SYNOPSES/beginner/Trojan.Application.Builder.md) || **[DNS Sinkhole](./SYNOPSES/beginner/DNS.Sinkhole.md)**<br>Pi-hole-style malware domain blocker |    | DNS protocol β’ Blocklist management β’ Query logging β’ Network defense<br>[Learn More](./SYNOPSES/beginner/DNS.Sinkhole.md) || **[Firewall Rule Engine](./PROJECTS/beginner/firewall-rule-engine)**<br>Parse and validate iptables/nftables rules |    | Firewall internals β’ Rule parsing β’ iptables/nftables β’ V language<br>[Source Code](./PROJECTS/beginner/firewall-rule-engine) \| [Docs](./PROJECTS/beginner/firewall-rule-engine/learn) |@@ -96,7 +96,7 @@ Tools, courses, certifications, communities, and frameworks for cybersecurity pr| **[Self-Hosted Shodan Clone](./SYNOPSES/intermediate/Self.Hosted.Shodan.Clone.md)**<br>Internet-connected device search engine |     | Service fingerprinting β’ Network scanning β’ OSINT β’ Search engine design<br>[Learn More](./SYNOPSES/intermediate/Self.Hosted.Shodan.Clone.md) || **[JA3/JA4 TLS Fingerprinting Tool](./SYNOPSES/intermediate/JA3.JA4.TLS.Fingerprinting.Tool.md)**<br>Fingerprint TLS clients by handshake |    | TLS handshake analysis β’ JA3/JA4 hashing β’ Bot detection β’ Malware C2 identification<br>[Learn More](./SYNOPSES/intermediate/JA3.JA4.TLS.Fingerprinting.Tool.md) || **[Mobile App Security Analyzer](./SYNOPSES/intermediate/Mobile.App.Security.Analyzer.md)**<br>Decompile and analyze mobile apps |    | APK/IPA analysis β’ Reverse engineering β’ OWASP Mobile<br>[Learn More](./SYNOPSES/intermediate/Mobile.App.Security.Analyzer.md) |-| **[DLP Scanner](./SYNOPSES/intermediate/DLP.Scanner.md)**<br>Data Loss Prevention for files, DBs, and traffic |    | PII detection β’ GDPR/HIPAA compliance β’ Pattern matching β’ Data classification<br>[Learn More](./SYNOPSES/intermediate/DLP.Scanner.md) |+| **[DLP Scanner](./PROJECTS/intermediate/dlp-scanner)**<br>Data Loss Prevention for files, DBs, and traffic |    | PII detection β’ GDPR/HIPAA compliance β’ Pattern matching β’ Data classification<br>[Source Code](./PROJECTS/intermediate/dlp-scanner) \| [Docs](./PROJECTS/intermediate/dlp-scanner/learn) || **[Lua/Nginx Edge Backend](./SYNOPSES/intermediate/Lua.Nginx.Edge.Backend.md)**<br>Full CRUD backend via Lua in Nginx |     | Edge computing β’ OpenResty β’ Lua scripting β’ WAF β’ JWT at the edge<br>[Learn More](./SYNOPSES/intermediate/Lua.Nginx.Edge.Backend.md) || **[Privesc Playground](./SYNOPSES/intermediate/Privesc.Playground.md)**<br>20+ privilege escalation paths to exploit |    | SUID exploitation β’ Sudo abuse β’ Cron hijacking β’ GTFOBins β’ Capability abuse<br>[Learn More](./SYNOPSES/intermediate/Privesc.Playground.md) || **[SBOM Generator & Vulnerability Matcher](./SYNOPSES/intermediate/SBOM.Generator.md)**<br>Software Bill of Materials with CVE matching |    | SPDX/CycloneDX formats β’ Dependency analysis β’ CVE databases β’ EO 14028 compliance<br>[Learn More](./SYNOPSES/intermediate/SBOM.Generator.md) |@@ -141,4 +141,4 @@ Tools, courses, certifications, communities, and frameworks for cybersecurity pr## License-AGPL 3.0\ No newline at end of file+AGPL 3.0