Ch4120N-CVE-Pulse

Live-CVE-PoC-Aggregator (Proof-of-Concepts) mit intelligenter Suche & Threat Intelligence

📋 Inhaltsverzeichnis

• 👨‍💻 Projektersteller
• 🎯 Was es macht
• ✨ Hauptfunktionen
• 🧱 Architektur
• ⚙️ Wie es funktioniert
• 🚀 Schnellstart
• 📦 Installation
• 💻 Verwendung
  • Unterbefehle
  • Vollständige Pipeline
• 📊 Ausgabe & Website
• 🗂️ Projektstruktur
• 🔧 Konfiguration
• 📡 Datenquellen
• 📅 Automatisierung (CI/CD)
• 📈 Trending PoCs
• ⚠️ Haftungsausschluss
• 📄 Lizenz

👨‍💻 Projektersteller

Ch4120N – Sicherheitsenthusiast & Automatisierungsliebhaber.
📧 [email protected]

🎯 Was es macht

1. Ruft die neuesten EPSS-Scores und den CISA-Katalog der bekannten ausgenutzten Schwachstellen (KEV) ab.
2. Durchsucht GitHub nach Repositories, die Exploit-PoCs für CVEs enthalten (mittels Suche + GraphQL-Metadaten).
3. Bewertet jeden Kandidaten mit einem Konfidenzmodell (Stars, Aktualität, Keyword-Übereinstimmungen, Blacklist usw.).
4. Verknüpft die PoC-Daten mit EPSS und KEV und erstellt dann eine vollständige JSON-API.
5. Generiert eine statische Website mit einer leistungsstarken clientseitigen Suchmaschine.
6. Erstellt tägliche Snapshots und Diffs, damit du neue PoCs mit hoher Konfidenz verfolgen kannst.

✨ Hauptfunktionen

• 🔍 Automatisierte PoC-Entdeckung – GitHub-Code-/Repository-Suche über mehrere Zeitfenster
• 🧠 Intelligente Bewertung – Code- vs. Dokumentations-Übereinstimmungen, Star-Anzahl, Aktualität, Blacklist und Heuristiken
• 📈 EPSS- & KEV-Integration – CISAs KEV-Liste und FIRSTs EPSS-Scores werden mit PoC-Daten zusammengeführt
• 📊 Tägliche Snapshots & Diffs – sieh, was neu ist, was zu „hoher Konfidenz" hochgestuft und was entfernt wurde
• 🌐 Durchsuchbare Website – Fuzzy-Suche nach CVE-ID, Hersteller, Produkt, Keyword, mit negativen Filtern (-windows)
• 🚀 Vollständig automatisiert – GitHub-Actions-Pipelines aktualisieren alles nach Zeitplan
• 💾 Keine Serverkosten – alle Daten sind statisches JSON/HTML, gehostet auf GitHub Pages
• 🛡️ Blacklist-Unterstützung – ignorieren Sie rauschige oder irrelevante Repositories

🧱 Architektur

⚙️ Wie es funktioniert

1. fetch-epss lädt die Top 2000 CVEs nach EPSS-Score herunter.
2. fetch-kev lädt den CISA-KEV-Katalog herunter.
3. sync-cves liest data/github.txt und ruft CVE-Metadaten von der MITRE-API ab, dann werden Markdown-Dateien für jede CVE erstellt/aktualisiert.
4. pipeline (oder einzelne build-*-Befehle):
   • Erstellt einen Scope von CVEs zum Scannen (aus github.txt oder zuvor niedrig-konfidenten).
   • Verwendet die GitHub-Such-API, um Repositories zu finden, die die CVE-ID erwähnen.
   • Reichert Kandidaten mit Repository-Metadaten (Stars, Sprache, Themen) über GraphQL an.
   • Bewertet jedes Repository und weist eine Konfidenzstufe zu (hoch, mittel, niedrig).
   • Schreibt JSON-Dateien pro CVE, einen Index und eine Top-100-Liste.
   • Erstellt einen Snapshot des aktuellen Zustands und ein Diff gegenüber dem Vortag.
5. build-site generiert CVE_list.json, trending_poc.json und die statische HTML-Seite.
6. Die Website (docs/) wird auf GitHub Pages bereitgestellt.

🚀 Schnellstart```bash

Clone the repository

git clone https://github.com/Ch4120N/Ch4120N-CVE-Pulse.git cd Ch4120N-CVE-Pulse

Install dependencies

pip install -r requirements.txt

Download base data

python chCVEPulse.py fetch-epss python chCVEPulse.py fetch-kev

Sync your initial CVE list (from data/github.txt)

python chCVEPulse.py sync-cves

Run the full discovery pipeline (needs GITHUB_TOKEN for higher rate limits)

export GITHUB_TOKEN=your_token_here python chCVEPulse.py pipeline --days 7

Generate the static website

python chCVEPulse.py build-site

Open docs/index.html in your browser

(requirements.txt enthält requests, jinja2 und weitere Abhängigkeiten.)

💻 Verwendung

Alle Vorgänge laufen über das einzelne Skript chCVEPulse.py.

Unterbefehle

Beispiele:```bash

Fetch new data

python chCVEPulse.py fetch-epss --limit 2000 python chCVEPulse.py fetch-kev

Update a specific CVE

python chCVEPulse.py sync-cves --cve CVE-2025-12345

Full pipeline (daily mode)

python chCVEPulse.py pipeline --days 7 --mode daily --limit 50

Regenerate website only

python chCVEPulse.py build-site --html-mode summary

🔧 Konfiguration

Fast alle Einstellungen befinden sich in scripts/config.py:

• GITHUB_SOURCES – Pfad zu deiner data/github.txt
• EPSS_API_URL, KEV_URL, CVE_API_TEMPLATE – externe API-Endpunkte
• HIGH_EPSS_THRESHOLD – minimaler EPSS-Wert für „hohe“ Warnungen
• TOP_KEV_COUNT – wie viele KEV-Einträge behalten werden
• SNAPSHOT_RETENTION_DAYS – wie lange alte Snapshots aufbewahrt werden

📡 Datenquellen

Ein GitHub-Token wird empfohlen, um die API-Ratenlimits zu erhöhen (als Umgebungsvariable GITHUB_TOKEN festlegen).

📅 Automatisierung (CI/CD)

Drei GitHub-Actions-Workflows halten alles aktuell:

• sync_cve_pocs.yml – läuft täglich, liest data/github.txt, ruft frische CVE-Metadaten ab und aktualisiert Markdown-Dateien.
• hot_cves.yml – läuft alle 6 Stunden, aktualisiert den Abschnitt Trending PoCs in dieser README.
• site.yml – baut und deployt die statische Website auf GitHub Pages.

Alle Workflows befinden sich in .github/workflows/.

📈 Trending PoCs

Die untenstehende Tabelle Trending PoCs wird automatisch aktualisiert – alle 6 Stunden durch die CI-Pipeline.

2026 (latest 20 of 584 repos)

2025 (latest 20 of 594 repos)

2024 (latest 20 of 636 repos)

2023 (latest 20 of 531 repos)

2022 (latest 20 of 560 repos)

⚠️ Haftungsausschluss

Dieses Projekt ist für Threat Intelligence, Schwachstellenmanagement und defensive Sicherheitsforschung gedacht.
Verwende die verlinkten Repositories nicht für illegale oder unbefugte Aktivitäten.
Die Autoren hosten oder befürworten den PoC-Code nicht – sie indexieren lediglich öffentlich verfügbare Informationen.

📄 Lizenz

GPLv3-Lizenz – den vollständigen Text findest du in der Datei LICENSE.