Oversight (v0.5.8)

Oversight ist ein terminalbasiertes Sicherheitsintelligenz-Tool, das entwickelt wurde, um Shell-Skripte und Befehle zu prüfen, bevor sie Ihr System berühren. Es schließt die Lücke zwischen „blindem Vertrauen" und „manueller Prüfung", indem es eine schnelle, interaktive Analyse sowohl lokaler Dateien als auch entfernter Skripte über Raw-URLs bietet.

Oversight

Live-AUR-Update

Screenshot 1

Screenshot 2

Die Mission

Die meisten Systemkompromittierungen geschehen aufgrund eines Sprungs ins Vertrauen, etwa durch die Ausführung eines ungeprüften Paket-Upgrades oder das Ausführen roher Setup-Skripte. Oversight verschafft Ihnen klare Einblicke in diese Puffer, kennzeichnet bösartige Muster und erklärt Sicherheitsrisiken in einfacher Sprache, damit Sie vor der Bestätigung von Installationen eine fundierte Entscheidung treffen können.

Funktionen

• Dynamisches Multi-Stream-Tab-Layout: Analysiert automatisch vereinheitlichte Git-Stream-Header im laufenden Betrieb. Wenn ein Sammel-Update eintrifft, isoliert es den kombinierten Patch-Stream und erzeugt dedizierte, lesbare Tabs für jedes Paket, wobei zugehörige .install-Skripte und .patch-Dateien aus dem lokalen Build-Verzeichnis gezogen und geprüft werden.
• Heuristische Entropie-Engine: Implementierung von Shannon-Entropie-Berechnungen zur Identifizierung von obfuskierten Payloads, gepackten Daten und versteckten Zeichenketten, die herkömmliche Regex-Scanner übersehen.
• Verfolgung bösartiger Lebenszyklen: Fortschrittliche Verhaltensanalyse, die zusammenhängende Ereignisse innerhalb eines Skripts verknüpft, etwa die für Trojaner-Installer typische Kette Abruf -> Rechteänderung -> Ausführung.
• Sicherheits-Heatmap-Seitenleiste: Eine vertikale Spur, die eine visuelle Echtzeit-Übersicht über die Bedrohungsverteilung in der aktiven Datei bietet und sicherstellt, dass die genauen Koordinatenindikatoren für jeden einzelnen Tab-Puffer korrekt skaliert werden.
• Anti-Forensik- und Persistenz-Erkennung: Überwachung auf heimliche Verhaltensweisen, einschließlich Selbstlöschung (rm $0), stille Pipelines (> /dev/null), Nur-RAM-Ausführungspfade (/dev/shm) und Reload-Hooks (crontab, systemctl).
• Gewichtete Risikobewertung: Implementiert einen Sicherheitsindex von 0 bis 100, der Streams basierend auf flachen Makro-Metriken als Sauber, Vorsicht oder Gefährlich einstuft und so eine Aufblähung der Risikobewertung vermeidet.
• Globaler Minderungs-Schalter: Ermöglicht Benutzern, aktive Befunde über die TUI mit einem einzigen Schalter sofort zu unterdrücken. Dies bereinigt die Ansicht visuell, indem markierte Blöcke auskommentiert werden, und berechnet den globalen Risikoscore-Index in Echtzeit neu.
• Sauberer Stream-Pager-Modus: Entfernt leere Viewport-Blöcke. Wenn ein Stream die Analyse ohne einen einzigen Treffer besteht, bleibt das gesamte Terminal-Layout als funktionaler Pager geöffnet und ermöglicht eine standardmäßige zeilenweise manuelle Code-Überprüfung.
• Dynamische Regeln-Engine: Muster werden in einem unabhängigen Regeln-Modul ausgelagert, was modulare Aktualisierungen verschiedener Mustersignaturen ermöglicht, ohne die TUI-Parsing-Schleife zu unterbrechen.
• Remote-Abruf-Engine: Prüft Skripte direkt von GitHub, Gist oder Raw-URLs sicher über eine reine Speicheranalyse.
• Lehrreiche Prüfung: Jeder Sicherheitshinweis enthält eine detaillierte Erklärung und externe Referenzen, um Benutzern zu helfen, bösartige Skriptmuster zu erkennen.
• Schwachstellen-Intelligenz: Integrierter Echtzeit-Scan nach bekannten CVEs über die OSV.dev-API, der automatisch ausgelöst wird, wenn unterstützte Paketinstallationsbefehle erkannt werden.

---

Abhängigkeiten

Oversight ist in Rust für Leistung und Binärisolation gebaut. Für die Kompilierung sind die folgenden nativen Komponenten erforderlich:

• Rust-Toolchain: cargo und rustc (Edition 2021) zum Kompilieren der nativen Engine.
• OpenSSL: Systembibliothek, die von reqwest für sichere Remote-TLS/SSL-Abrufvorgänge benötigt wird.
• Kern-Crates: ratatui, crossterm, tokio, reqwest, clap und regex.

---

Installation & Einrichtung

1. Über AUR (für Arch Linux empfohlen) Die stabile Version wird im AUR gepflegt. Installieren Sie sie mit Ihrem bevorzugten Helfer:

yay -S oversight-git

2. Oder manuell bauen:

git clone [https://aur.archlinux.org/oversight-git.git](https://aur.archlinux.org/oversight-git.git)
cd oversight-git
makepkg -si

3. Aus dem Quellcode:

git clone https://github.com/Rakosn1cek/oversight.git cd oversight

4. Führen Sie das automatisierte Installationsskript aus: Das Installationsskript übernimmt die Kompilierung, verschiebt die Binärdatei nach ~/.local/bin und fügt die erforderlichen Hooks in Ihre Shell-Konfiguration ein (.zshrc, .bashrc oder config.fish).

chmod +x install.sh
./install.sh

4. Laden Sie Ihre Shell neu:

source ~/.zshrc oder Ihre jeweilige Shell-Konfiguration

---

Dateien & Speicherorte

• Binärdatei: ~/.local/bin/oversight
• Regeln-Datenbank: ~/.local/share/oversight/rules.json (respektiert $XDG_DATA_HOME)
• Shell-Hooks: ~/.local/share/oversight/oversight.[zsh|bash|fish]

---

Verwendung

• Lokales Skript prüfen: oversight ./install.sh
• Remote-URL prüfen: oversight https://raw.githubusercontent.com/...
• Lokale Konfigurationsdatei prüfen: oversight ~/.local/share/oversight/rules.json
• Live-Schutz: Fängt eigenständige Befehle wie curl https://... oder riskante Muster wie rm -rf / automatisch ab, um ein Triage-Menü mit mehreren Optionen anzubieten, und untersucht vor der Ausführung eingehend die nachgelagerten AUR-Cache-Profile.

---

Integration in die Shell-Konfiguration

Um Oversight dauerhaft als Ihren primären Text- und Upgrade-Pager bereitzustellen, fügen Sie eine der beiden Konfigurationsregeln zu Ihrem Shell-Profil hinzu (z. B. ~/.zshrc, ~/.bashrc oder ~/.config/fish/config.fish):

Option A: Dedizierte AUR-Helfer-Integration (gezielt)

Zwingt Ihren Helfer, Oversight gezielt für Paket-Upgrades zu verwenden, ohne andere Systembefehle zu beeinträchtigen:

Für yay (~/.zshrc oder ~/.bashrc): alias yay="yay --diffpager oversight"

Für paru (~/.config/paru/paru.conf): Fügen Sie diese Zeilen zu Ihrer ~/.config/paru/paru.conf hinzu. Sie müssen die Option CombinedUpgrade einfügen, da paru sonst die ANSI-Farbcodes entfernt, bevor der Text an Oversight übergeben wird, sodass Sie nur schwarz-weißen Text erhalten:

[options]
Pager = oversight
CombinedUpgrade

Für andere Helfer wie Shelly Wenn Sie einen anderen Helfer verwenden, müssen Sie Oversight mithilfe der Variable AUDIT_HELPER mitteilen, wo sich die Cache-Dateien befinden. Sie können es beispielsweise so ausführen:

AUDIT_HELPER=shelly shelly -Sua | oversight