Caratteristiche

• Controlla singole password dalla riga di comando
• Elabora password da un file
• Accetta input SHA-1 pre-hashato con -hashed
• Controlla export crittografati Bitwarden con -bw
• Nasconde password in chiaro nell'output con -hide
• Mostra diagnostica HIBP a livello di richiesta con -v
• Stampa statistiche di fine esecuzione con -stats

Installazione

Release precompilata

Puoi scaricare un binario statico precompilato, adatto al tuo sistema operativo, direttamente dalla pagina delle release:

1. Vai alla Pagina delle Release.
2. Scarica l'archivio corrispondente alla tua piattaforma e architettura:
   • Linux: pwnedcheck_x.x.x_linux_amd64.tar.gz (oppure arm64)
   • macOS: pwnedcheck_x.x.x_darwin_amd64.tar.gz (oppure arm64)
   • Windows: pwnedcheck_x.x.x_windows_amd64.zip
3. Estrai il contenuto dell'archivio per ottenere il file eseguibile.

Esecuzione dell'eseguibile

Linux / macOS: Apri il terminale nella directory estratta, rendi eseguibile il binario ed eseguilo:

chmod +x pwnedcheck
./pwnedcheck -h

Windows: non testato, ma il feedback è apprezzato

Apri PowerShell o il Prompt dei comandi nella cartella contenente pwnedcheck.exe estratto ed esegui:

.\pwnedcheck.exe -h

Con Go

Installa la CLI nella directory bin di Go:

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

Dal sorgente con Make

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

Questa operazione installa il binario della piattaforma corrente nella directory bin di Go.

Compilare binari specifici per piattaforma

Usa il Makefile per generare binari di release per Linux o macOS:

make build-linux
make build-macos

I binari vengono scritti in dist/ con l'architettura Go corrente nel nome del file.

Se vuoi che il binario venga copiato nella directory bin di Go con un nome specifico per il sistema operativo, usa:

make install-linux
make install-macos

Questi comandi installano come pwnedcheck.

Utilizzo

Esegui dal sorgente:

go run ./cmd/pwnedcheck -v god

Oppure esegui il binario installato:

pwnedcheck -i passwords.list -stats

Esempi comuni

Controlla una singola password:

pwnedcheck password123

Controlla più password:

pwnedcheck love sex secret god

Controlla le password da un file:

pwnedcheck -i passwords.list

Controlla valori SHA-1 pre-hashati:

pwnedcheck -hashed -i passwords.list

Controlla un export crittografato Bitwarden:

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

Abilita la registrazione dettagliata delle richieste HIBP:

pwnedcheck -v password123

Opzioni

• -i, --input <string> : File di input contenente password o export JSON (predefinito "passwords.txt")
• -bw, --bitwarden : Tratta il file di input come un export JSON crittografato protetto da password Bitwarden
• -H, --hashed : Tratta l'input come hash SHA-1 pre-calcolati invece che testo in chiaro
• -x, --hide : Nascondi le password in chiaro dall'output della console
• -s, --stats : Mostra un riepilogo di runtime e risultati al termine
• -v, --verbose : Stampa ogni richiesta HIBP e lo stato della risposta per mostrare la diagnostica API
• -c, --credits : Mostra i crediti
• -h, --help : Mostra l'aiuto

Modello di sicurezza

PwnedCheck utilizza l'approccio k-anonimato usato da HIBP:

• Solo i primi 5 caratteri dell'hash SHA-1 vengono inviati all'API
• La password completa non viene mai trasmessa
• Gli export Bitwarden vengono decrittati localmente in memoria prima del controllo

Esempio di output

[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

Struttura del repository

• cmd/pwnedcheck: entrypoint CLI e parsing dei flag
• internal/checker: ciclo di esecuzione e formattazione dell'output
• internal/hibp: client HIBP e hashing delle password
• internal/bitwarden: decrittazione degli export Bitwarden

Licenza

GNU General Public License v3.0