📖 Über das Projekt

Dieses Repository enthält eine eingehende technische Analyse der kritischen Use-After-Free (UAF)-Schwachstelle CVE-2025-21082, die im Xiaomi HyperOS AVCodec Medienverarbeitungs-Framework entdeckt wurde, sowie eine Simulation des Angriffsmechanismus und Lösungsvorschläge.

Die Hauptursache der Schwachstelle liegt darin, dass der Codec-Kontext im asynchronen Callback-Mechanismus von AVCodec freigegeben wird, während die Worker-Threads noch aktiv sind. Dies führt zu einer klassischen Use-After-Free Race Condition und bietet theoretisch die Möglichkeit zur Remote Code Execution (RCE).

Das Projekt umfasst eine sichere UAF-Simulation in Rust, umfassende technische Dokumentation, GitHub Actions CI-Pipeline-Automatisierung sowie eine browserbasierte interaktive Visualisierung.

---

📂 Repository-Struktur

HyperOS-Directory-Traversal-Analysis/
│
├── 📁 .github/                     # GitHub-Community- und CI/CD-Workflows
│   ├── 📁 ISSUE_TEMPLATE/          # Vorlagen für Fehler- und Funktionsanfragen
│   │   ├── 📄 config.yml           # Issue-Vorlagenkonfiguration und Links
│   │   ├── 📄 hata-raporu.yml      # Fehlerberichtsformular (YAML Forms)
│   │   └── 📄 ozellik-istegi.yml   # Funktionsanfrageformular (YAML Forms)
│   ├── 📁 workflows/
│   │   ├── 📄 rust.yml             # Rust CI — Build-, Test- und Lint-Pipeline
│   │   ├── 📄 pages.yml            # Automatische Veröffentlichung auf GitHub Pages
│   │   ├── 📄 security.yml         # Sicherheitsscan (cargo-audit, CodeQL)
│   │   └── 📄 docs.yml             # Dokumentations-Lint und Link-Check
│   ├── 📄 dependabot.yml           # Automatische Abhängigkeitsaktualisierung
│   ├── 📄 FUNDING.yml              # GitHub Sponsors Konfiguration
│   ├── 📄 mlc_config.json          # Markdown-Link-Checker-Einstellungen
│   ├── 📄 PULL_REQUEST_TEMPLATE.md
│   └── 📄 SECURITY.md              # Sicherheitsrichtlinie
│
├── 📁 assets/                      # Logo- und Bilddateien
│   └── 🖼️ isu-logo.png             # Logo der İstinye Universität
│
│
├── 📁 docs/                        # Technische Dokumentation
│   ├── 📄 zafiyet-analizi.md       # Schwachstellenanalyse und CVSS-Bewertung
│   ├── 📄 mimari-analiz.md         # HyperOS AVCodec Architekturdiagramm
│   ├── 📄 cozum-onerileri.md       # Lösungsvorschläge und C++-Patches
│   └── 📄 README.md                # Dokumentationsleitfaden-Index
│
├── 📁 research_results/            # Ergebnisse der Aufgabenforschung
│   ├── 📄 Cevaplarım.md            # Antworten auf 10 fortgeschrittene Fragen
│   ├── 📄 SORULAR.md               # Aufgabenfragen
│   ├── 📄 yorum.md                 # Persönliche Analyse und Kommentare
│   ├── 📄 simple.md                # Einfache Erklärungen (50 Schritte)
│   ├── 🌐 infographic.html         # Visueller Schwachstellenleitfaden
│   └── 📄 README.md                # Index der Forschungsergebnisse
│
├── 📁 poc_python/                  # Python-Analysetools (Referenz)
│   ├── 📄 exploit.py               # CVE-2025-2844 Directory Traversal PoC
│   └── 📄 requirements.txt
│
├── 📁 poc_rust/                    # Rust UAF-Simulation (Haupt-PoC)
│   ├── 📁 src/
│   │   └── 📄 main.rs              # Unsafe Rust UAF-Simulationslogik
│   └── 📄 Cargo.toml
│
├── 🌐 simulation.html              # Interaktives Web-Simulationspanel (5 Szenen)
├── 📄 README.md                    # Diese Datei
├── 📄 CODE_OF_CONDUCT.md           # Verhaltenskodex der Gemeinschaft
├── 📄 CONTRIBUTING.md              # Beitragsleitfaden
├── 📄 TODO.md                      # Aufgabenliste
└── ⚖️  LICENSE                      # MIT-Lizenz

---

🧠 Zusammenfassung der Schwachstelle

Eigenschaft	Detail
CVE-Nummer	CVE-2025-21082
Schwachstellentyp	Use-After-Free (CWE-416)
Betroffene Komponente	Xiaomi HyperOS AVCodec Framework
CVSS v3.1-Score	8.1 (High)
Angriffsvektor	Netzwerk
Auswirkung	Potenzial für Remote Code Execution (RCE)
Entdeckungsdatum	10. Februar 2025
Patch-Datum	20. Februar 2025

Kern der Schwachstelle

[Hauptthread]    processFrameAsync() → Worker-Thread wird gestartet
                      ↓
                release() wird aufgerufen → Speicher wird FREIGEGEBEN ⚠️
                      ↓
[Worker-Thread] Greift weiterhin auf freigegebenen Speicher zu → UAF 💥

---

🎬 Demo

Sie können unten eine Bildschirmaufnahme ansehen, die den Build-Prozess, die Ausführung und die Ausgabe der Use-After-Free-Simulation zeigt:

---

🚀 Schnellstart

Anforderungen

• Rust 1.70 oder höher → rustup.rs
• Python 3.8 oder höher
• Ein moderner Webbrowser (Chrome, Firefox, Edge)

1. Rust PoC — UAF-Simulation

# Repository klonen
git clone https://github.com/kkaanozturk/HyperOS-Directory-Traversal-Analysis.git
cd HyperOS-Directory-Traversal-Analysis/poc_rust

# Im Release-Modus kompilieren
cargo build --release

🔴 Verwundbares Szenario (Race Condition & UAF-Demonstration)

# Windows
.\target\release\cve_2025_21082_uaf_poc.exe --mode vulnerable --verbose

# Linux / macOS
./target/release/cve_2025_21082_uaf_poc --mode vulnerable --verbose

Erwartete Ausgabe:

🔬 CVE-2025-21082: HyperOS AVCodec UAF PoC
Mode: vulnerable

⚠️  Running vulnerable scenario...
CodecContext allocated in Arc<Mutex<T>>
🧵 Starting worker thread...
🗑️  Main thread releasing codec context (UAF trigger)...
Memory corrupted to simulate UAF
🔄 Worker thread accessing codec context...
🚨 UAF detected! Magic number corrupted: 0xFEEDFACE
💥 UAF vulnerability triggered on frame 0!

🚨 Vulnerable scenario completed - UAF demonstrated!
⚠️  In a real exploit, this could lead to RCE

🟢 Gepatchtes Szenario (Sichere Synchronisierung)

# Windows
.\target\release\cve_2025_21082_uaf_poc.exe --mode patched --verbose

# Linux / macOS
./target/release/cve_2025_21082_uaf_poc --mode patched --verbose

Erwartete Ausgabe:

🔬 CVE-2025-21082: HyperOS AVCodec UAF PoC
Mode: patched