Funktionen

• Einzelne Passwörter von der Kommandozeile aus überprüfen
• Passwörter aus einer Datei verarbeiten
• Vor-gehashte SHA-1-Eingabe mit -hashed akzeptieren
• Verschlüsselte Bitwarden-Exporte mit -bw überprüfen
• Klartext-Passwörter in der Ausgabe mit -hide verbergen
• Diagnose auf Anfrageebene von HIBP mit -v anzeigen
• Statistiken nach dem Durchlauf mit -stats ausgeben

Installation

Vorab erstellte Version

Sie können eine vorkompilierte statische Binärdatei, die für Ihr Betriebssystem zugeschnitten ist, direkt von der Release-Seite herunterladen:

1. Gehen Sie zur Release-Seite.
2. Laden Sie das Archiv herunter, das Ihrer Plattform und Architektur entspricht:
   • Linux: pwnedcheck_x.x.x_linux_amd64.tar.gz (oder arm64)
   • macOS: pwnedcheck_x.x.x_darwin_amd64.tar.gz (oder arm64)
   • Windows: pwnedcheck_x.x.x_windows_amd64.zip
3. Extrahieren Sie den Archivinhalt, um die ausführbare Datei zu erhalten.

Ausführen der ausführbaren Datei

Linux / macOS: Öffnen Sie Ihr Terminal im extrahierten Verzeichnis, machen Sie die Binärdatei ausführbar und führen Sie sie aus:

chmod +x pwnedcheck
./pwnedcheck -h

Windows: nicht getestet, aber Feedback wird geschätzt

Öffnen Sie PowerShell oder die Eingabeaufforderung im Ordner mit der extrahierten pwnedcheck.exe und führen Sie aus:

.\pwnedcheck.exe -h

Mit Go

Installieren Sie das CLI in Ihr Go-Bin-Verzeichnis:

go install github.com/mohamedation/PwnedCheck/cmd/pwnedcheck@latest

Aus dem Quellcode mit Make

git clone https://github.com/mohamedation/PwnedCheck.git
cd PwnedCheck
make install

Das installiert die aktuelle Binärdatei für den Host in Ihr Go bin-Verzeichnis.

Plattformspezifische Binärdateien erstellen

Verwenden Sie das Makefile, um Release-Binärdateien für Linux oder macOS zu erstellen:

make build-linux
make build-macos

Die Binärdateien werden mit Ihrer aktuellen Go-Architektur im Dateinamen nach dist/ geschrieben.

Wenn Sie die Binärdatei mit einem betriebssystemspezifischen Namen in Ihr Go-Bin-Verzeichnis kopieren möchten, verwenden Sie:

make install-linux
make install-macos

Diese Befehle installieren als pwnedcheck.

Verwendung

Aus dem Quellcode ausführen:

go run ./cmd/pwnedcheck -v god

Oder die installierte Binärdatei ausführen:

pwnedcheck -i passwords.list -stats

Häufige Beispiele

Ein einzelnes Passwort überprüfen:

pwnedcheck password123

Mehrere Passwörter überprüfen:

pwnedcheck love sex secret god

Passwörter aus einer Datei überprüfen:

pwnedcheck -i passwords.list

Vor-gehashte SHA-1-Werte überprüfen:

pwnedcheck -hashed -i passwords.list

Einen verschlüsselten Bitwarden-Export überprüfen:

pwnedcheck -bw -i bitwarden_encrypted_export.json -hide -stats

Ausführliches HIBP-Anforderungsprotokollierung aktivieren:

pwnedcheck -v password123

Optionen

• -i, --input <string> : Eingabedatei mit Passwörtern oder JSON-Export (Standard "passwords.txt")
• -bw, --bitwarden : Behandle die Eingabedatei als einen passwortgeschützten verschlüsselten Bitwarden-JSON-Export
• -H, --hashed : Behandle die Eingabe als vorberechnete SHA-1-Hashes anstelle von Klartext
• -x, --hide : Verberge Klartext-Passwörter in der Konsolenausgabe
• -s, --stats : Zeige Laufzeit- und Ergebniszusammenfassung nach Abschluss
• -v, --verbose : Gib jeden HIBP-Anfrage- und Antwortstatus aus, um API-Diagnose anzuzeigen
• -c, --credits : Zeige Credits
• -h, --help : Zeige Hilfe

Sicherheitsmodell

PwnedCheck verwendet den von HIBP verwendeten k-Anonymitätsansatz:

• Nur die ersten 5 Zeichen des SHA-1-Hashes werden an die API gesendet
• Das vollständige Passwort wird nie übertragen
• Bitwarden-Exporte werden vor der Überprüfung lokal im Speicher entschlüsselt

Beispielausgabe

[1/2] Checking...
BAD PASSWORD — BREACH DETECTED (item #1)
	Password: 123456

Total runtime: 1.5s
Total passwords checked: 2
Bad passwords found: 1
Good passwords: 1

Repository-Struktur

• cmd/pwnedcheck: CLI-Einstiegspunkt und Flag-Parsing
• internal/checker: Ausführungsschleife und Ausgabeformatierung
• internal/hibp: HIBP-Client und Passwort-Hashing
• internal/bitwarden: Bitwarden-Exportentschlüsselung

Lizenz

GNU General Public License v3.0