Funktionen

• Einzelne Passwörter über die Kommandozeile prüfen
• Passwörter aus einer Datei verarbeiten
• Vorgehashte SHA-1-Eingabe mit -hashed akzeptieren
• Verschlüsselte Bitwarden-Exporte mit -bw prüfen
• Klartextpasswörter in der Ausgabe mit -hide ausblenden
• HIBP-Diagnosen auf Anfrageebene mit -v anzeigen
• Statistiken am Ende des Durchlaufs mit -stats ausgeben

Installation

Vorgefertigtes Release

Du kannst ein vorkompiliertes statisches Binary, das auf dein Betriebssystem zugeschnitten ist, direkt von der Releases-Seite herunterladen:

1. Gehe zur Releases-Seite.
2. Lade das Archiv herunter, das zu deiner Plattform und Architektur passt:
   • 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. Entpacke den Inhalt des Archivs, um die ausführbare Datei zu erhalten.

Ausführen der ausführbaren Datei

Linux / macOS: Öffne dein Terminal im entpackten Verzeichnis, mache das Binary ausführbar und führe es aus:

chmod +x pwnedcheck
./pwnedcheck -h

Windows: ungetestet, aber Feedback ist willkommen

Öffne PowerShell oder die Eingabeaufforderung im Ordner, der die entpackte pwnedcheck.exe enthält, und führe aus:

.\pwnedcheck.exe -h

Mit Go

Installiere die CLI in dein 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

Dadurch wird das aktuelle Host-Binary in dein Go-bin-Verzeichnis installiert.

Plattformspezifische Binaries bauen

Verwende das Makefile, um Release-Binaries für Linux oder macOS zu erzeugen:

make build-linux
make build-macos

Die Binaries werden in dist/ geschrieben, wobei deine aktuelle Go-Architektur im Dateinamen enthalten ist.

Wenn du das Binary mit einem betriebssystemspezifischen Namen in dein Go-bin-Verzeichnis kopieren möchtest, verwende:

make install-linux
make install-macos

Diese Befehle installieren als pwnedcheck.

Verwendung

Aus dem Quellcode ausführen:

go run ./cmd/pwnedcheck -v god

Oder das installierte Binary ausführen:

pwnedcheck -i passwords.list -stats

Häufige Beispiele

Ein einzelnes Passwort prüfen:

pwnedcheck password123

Mehrere Passwörter prüfen:

pwnedcheck love sex secret god

Passwörter aus einer Datei prüfen:

pwnedcheck -i passwords.list

Vorgehashte SHA-1-Werte prüfen:

pwnedcheck -hashed -i passwords.list

Einen verschlüsselten Bitwarden-Export prüfen:

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

Ausführliches HIBP-Anfrage-Logging aktivieren:

pwnedcheck -v password123

Optionen

• -i, --input <string> : Eingabedatei mit Passwörtern oder JSON-Export (Standard "passwords.txt")
• -bw, --bitwarden : Eingabedatei als passwortgeschützten, verschlüsselten Bitwarden-JSON-Export behandeln
• -H, --hashed : Eingabe als vorberechnete SHA-1-Hashes statt als Klartext behandeln
• -x, --hide : Klartextpasswörter in der Konsolenausgabe ausblenden
• -s, --stats : Laufzeit- und Ergebniszusammenfassung nach Abschluss anzeigen
• -v, --verbose : Jede HIBP-Anfrage und den Antwortstatus ausgeben, um API-Diagnosen anzuzeigen
• -c, --credits : Credits anzeigen
• -h, --help : Hilfe anzeigen

Sicherheitsmodell

PwnedCheck verwendet den von HIBP genutzten k-Anonymitäts-Ansatz:

• Nur die ersten 5 Zeichen des SHA-1-Hashes werden an die API gesendet
• Das vollständige Passwort wird niemals übertragen
• Bitwarden-Exporte werden vor der Prü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: Entschlüsselung von Bitwarden-Exporten

Entwicklung

make test    # Unit-Tests ausführen
make cover   # Tests mit Coverage-Zusammenfassung ausführen

Docs: pkg.go.dev · Coverage: Codecov

Lizenz

GNU General Public License v3.0