Funzionalità

• Verifica singole password dalla riga di comando
• Elabora password da un file
• Accetta input SHA-1 pre-hash con -hashed
• Verifica esportazioni Bitwarden crittografate con -bw
• Nasconde le password in chiaro nell'output con -hide
• Mostra la diagnostica HIBP a livello di richiesta con -v
• Stampa le 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 (o arm64)
   • macOS: pwnedcheck_x.x.x_darwin_amd64.tar.gz (o 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 e avvialo:

chmod +x pwnedcheck
./pwnedcheck -h

Windows: non testato, ma il feedback è apprezzato

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

.\pwnedcheck.exe -h

Con Go

Installa la CLI nella tua 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

Questo installa il binario dell'host corrente nella tua directory bin di Go.

Compilare binari specifici per piattaforma

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

make build-linux
make build-macos

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

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

make install-linux
make install-macos

Quei 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

Verifica una singola password:

pwnedcheck password123

Verifica più password:

pwnedcheck love sex secret god

Verifica le password da un file:

pwnedcheck -i passwords.list

Verifica valori SHA-1 pre-hash:

pwnedcheck -hashed -i passwords.list

Verifica un'esportazione Bitwarden crittografata:

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

Abilita il logging dettagliato delle richieste HIBP:

pwnedcheck -v password123

Opzioni

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

Modello di Sicurezza

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

• Solo i primi 5 caratteri dell'hash SHA-1 vengono inviati all'API
• La password completa non viene mai trasmessa
• Le esportazioni Bitwarden vengono decrittografate localmente in memoria prima della verifica

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 della CLI e parsing dei flag
• internal/checker: ciclo di esecuzione e formattazione dell'output
• internal/hibp: client HIBP e hashing delle password
• internal/bitwarden: decrittografia delle esportazioni Bitwarden

Sviluppo

make test    # run unit tests
make cover   # run tests with coverage summary

Docs: pkg.go.dev · Coverage: Codecov

Licenza

GNU General Public License v3.0