secret-stripper

Standard-Tastenkombination: Ctrl+Alt+X.

macOS - benötigt einen einmalig einzurichtenden Global-Hotkey-Helfer (skhd oder Hammerspoon). Siehe macOS-Einrichtung für Berechtigungen und Fehlerbehebung.

Standard-Tastenkombination: Cmd+Shift+C.

Windows (PowerShell) - benötigt AutoHotkey v2. Siehe Windows-Einrichtung für den vollständigen Ablauf.

Standard-Tastenkombination: Ctrl+Alt+C.

Von crates.io (Rust) - es gelten die gleichen betriebssystemspezifischen Voraussetzungen (skhd unter macOS, AutoHotkey unter Windows):

Aus dem Quellcode (git):

Nach der Installation Text markieren und die Tastenkombination drücken. Unter Linux wird die PRIMARY-Auswahl direkt gelesen, sodass Sie das Ctrl+C überspringen können. Einfügen mit Ctrl+V (Cmd+V unter macOS).

Führen Sie secret-stripper menu aus, um Einstellungen anzupassen, oder secret-stripper --help für alle Befehle.

Unterstützte Betriebssysteme

Plattform-Einrichtung

macOS-Einrichtung

Ein echter globaler Hotkey lässt sich unter macOS nicht ohne Installation und ohne residenten Prozess registrieren. Secret Stripper selbst bleibt ein One-Shot-Tool und delegiert die Hotkey-Erfassung daher an einen von zwei bekannten Helfern: skhd (leichtgewichtig, empfohlen) oder Hammerspoon (umfangreicher, skriptbar). Ist keines installiert, gibt init als Fallback manuelle Bindungsanweisungen aus.

1. skhd über Homebrew installieren:

   root@kitploit:~

   brew install koekeishiya/formulae/skhd
   

2. secret-stripper init ausführen. Es schreibt ~/.skhdrc, den launchd-LaunchAgent für den täglichen Update-Check und die Konfigurationsdatei. Die Ausgabe enthält eine Zeile "DE binding": OK, wenn skhd / Hammerspoon erkannt wurde, FAILED mit Installationshinweisen, wenn nicht.

3. skhd die Bedienungshilfen-Berechtigung erteilen. skhd benötigt diese, um globale Hotkeys abzufangen; andernfalls erfasst es stillschweigend nichts. Öffnen Sie Systemeinstellungen -> Datenschutz & Sicherheit -> Bedienungshilfen, klicken Sie auf +, fügen Sie /usr/local/bin/skhd hinzu und aktivieren Sie es. Falls skhd bereits ausgeführt wurde, starten Sie es neu, damit die neue Berechtigung wirksam wird:

   root@kitploit:~

   skhd --restart-service
   

4. Die Tastenkombination testen:

   root@kitploit:~

   echo "[email protected]" | pbcopy
   # Press your chord (default: Cmd+Shift+C)
   pbpaste     # expect: [REDACTED]
   

Hammerspoon-Alternative: brew install --cask hammerspoon, öffnen Sie es einmal, um die Bedienungshilfen-Berechtigung zu erteilen, und führen Sie dann secret-stripper init aus - es schreibt die Bindung in ~/.hammerspoon/init.lua statt in ~/.skhdrc.

Standard-Tastenkombination: Cmd+Shift+C. macOS-Apps beanspruchen häufig Tastenkombinationen mit der Cmd-Taste. Wenn die Kombination also mit etwas kollidiert, das Sie verwenden (Browser-DevTools, Finder „Copy Path" usw.), binden Sie sie über secret-stripper menu -> Rebind Hotkey neu. Zwei sicherere Optionen, falls Sie vorausplanen möchten: Cmd+Option+X oder Cmd+Ctrl+X.

Windows-Einrichtung

Windows bietet keine Möglichkeit ohne Installation, einen echten globalen Hotkey zu registrieren. Gleiche Einschränkung wie unter macOS - Secret Stripper delegiert die Hotkey-Erfassung an AutoHotkey v2 (das Windows-Pendant zu skhd). AutoHotkey verwendet unter der Haube die Win32-RegisterHotKey-API und ist der einzige Mechanismus, der die Tastenkombination zuverlässig über fokussierte Fenster, Vollbild-Apps und Prozesse mit erhöhten Rechten hinweg liefert. AutoHotkey ist erforderlich - init bricht mit einem Installationshinweis ab, wenn AutoHotkey nicht gefunden wird.

1. AutoHotkey über winget installieren:

   root@kitploit:~

   winget install AutoHotkey.AutoHotkey
   

   Das Paket installiert AutoHotkey v2 in C:\Program Files\AutoHotkey\v2\.

2. secret-stripper init ausführen. Es schreibt %APPDATA%\secret-stripper\secret-stripper.ahk, legt eine Autostart-.lnk an, damit AHK das Skript bei jeder Anmeldung neu startet, und startet den AHK-Prozess sofort, sodass die Tastenkombination ohne Abmeldung aktiv ist.

3. Die Tastenkombination testen:

   root@kitploit:~

   Set-Clipboard "[email protected]"
   # Press your chord (default: Ctrl+Alt+C)
   Get-Clipboard    # expect: [REDACTED]
   

• Die Tastenkombination ist auf Ctrl+Alt+<key> beschränkt (optional mit Shift); andere Kombinationen werden abgelehnt.
• Keine PRIMARY-Auswahl: Der Ablauf besteht aus zwei Schritten (Ctrl+C, dann die Tastenkombination).
• Das AHK-Skript führt die Redigierung mit einer versteckten Konsole aus, sodass bei jeder Auslösung kein Fenster aufblitzt.
• Der tägliche Update-Check läuft als tägliche schtasks-Aufgabe um 11:00 Uhr.
• Deinstallation beendet den an unser Skript gebundenen AHK-Prozess und entfernt die .ahk-Datei sowie die Autostart-.lnk. Andere AHK-Skripte, die Sie ausführen, bleiben unberührt.

Was erkannt wird

Die vollständige Liste der Buckets, Schweregrade und Muster finden Sie in DETECTION_COVERAGE.md.

Redigierungsstile

Wählen Sie unter secret-stripper menu -> Redaction Style, wie erkannte Geheimnisse ersetzt werden:

Dieselbe Einstellung gilt für die Hotkey-Auslösung, den Pipeline-Unterbefehl redact und den KI-TUI-Wrapper paste-guard.

Screenshots redigieren

Geheimnisse befinden sich oft in Screenshots, nicht nur in Text - ein Terminal-Schnappschuss, ein Konfigurationsbereich, ein API-Dashboard. Wenn Sie die Tastenkombination auslösen und die Zwischenablage statt Text ein Bild enthält, führt Secret Stripper eine OCR auf dem Bild durch, verwendet denselben Detektor wie für Text und zeichnet einen durchgehend schwarzen Kasten nur über die Wörter, die ein Geheimnis enthalten. Das redigierte Bild wird zurück in die Zwischenablage geschrieben. Saubere Bildteile bleiben unberührt - der gesamte Screenshot wird nie geschwärzt.

Nur unter Linux unterstützt - sowohl X11 als auch Wayland. Unter macOS und Windows redigiert die Tastenkombination weiterhin Text; ein Bild in der Zwischenablage bleibt unberührt.

Befindet sich ein Bild in der Zwischenablage, redigiert die Tastenkombination das Bild, auch wenn Sie Text markiert haben - Screenshot -> Tastenkombination funktioniert also einfach.

Es wird die tesseract-OCR-CLI im PATH benötigt. Sie ist eine optionale Laufzeitabhängigkeit: alles andere funktioniert ohne sie.

Es greift das Fail-Closed-Prinzip: Wenn tesseract fehlt, das Bild nicht gelesen werden kann oder ein erkanntes Geheimnis nicht lokalisiert werden kann, bleibt die Zwischenablage unberührt und Sie erhalten eine Benachrichtigung - das Originalbild wird niemals stillschweigend durchgereicht und niemals gelöscht. OCR macht diesen Pfad langsamer als den sofortigen Textpfad (etwa eine halbe Sekunde bis einige Sekunden für einen vollständigen Screenshot). Warten Sie also auf die Benachrichtigung, bevor Sie einfügen.

Die Bildredigierung ist standardmäßig deaktiviert. Aktivieren Sie sie über secret-stripper menu -> Detection Settings -> Screenshot redaction oder setzen Sie enable_image_scan = true in config.toml.

Automatisches Redigieren beim Einfügen in KI-TUIs

secret-stripper init sucht nach installierten KI-Terminal-Tools (Claude Code, Codex CLI, aider, Gemini CLI, Continue, opencode) und gibt einen kopierfertigen Shell-Alias-Block aus. Jeder Alias leitet das Tool über paste-guard, einen PTY-Wrapper, der Zwischenablage-Einfügungen abfängt und Geheimnisse redigiert, bevor sie die Eingabeaufforderung der KI erreichen - Tippen und normale Ausgabe bleiben unberührt. Kopieren Sie den Ausschnitt in Ihre Shell-Konfiguration (~/.zshrc, ~/.bashrc, ~/.config/fish/config.fish oder Ihr PowerShell-Profil) und öffnen Sie eine neue Shell:

Secret Stripper schreibt niemals von sich aus in Ihre Shell-rc-Datei. Um die Weiterleitung über paste-guard zu beenden, löschen Sie den Block zwischen den Kommentarzeilen mit den Strichen.

Umfang. paste-guard ist ein Wrapper pro Prozess - er filtert nur Einfügungen in den einen Befehl, mit dem Sie ihn ausgeführt haben. Die tägliche Nutzung von ssh, psql, vim, kubectl, der nackten Shell-Eingabeaufforderung, GUI-Apps und der System-Zwischenablage - alles völlig unberührt. Sie können auch von Hand Aliase für Nicht-KI-Tools hinzufügen (Live-Demos gegen psql / mysql, Bildschirmaufnahmen) - das Umwickeln von Blattbefehlen ist in Ordnung, das Umwickeln einer ganzen Shell meist nicht.

Sie können auch beliebigen Text durch dieselbe Engine leiten:

Einschränkungen. Bracketed Paste muss von Ihrem Terminal unterstützt werden (jeder moderne Emulator unterstützt dies, einschließlich des integrierten VSCode-Terminals und des tmux-Passthrough); getippte Geheimnisse werden nie verändert, sondern nur eingefügte; Einfüge-Nutzdaten über 1 MiB werden unredigiert durchgereicht.

Mitwirken

Siehe CONTRIBUTING.md für Build-, Test-, Lint- und Commit-Konventionen.

Star-Verlauf

Lizenz

MIT