Características

• Comprobar contraseñas individuales desde la línea de comandos
• Procesar contraseñas desde un archivo
• Aceptar entrada SHA-1 precalculada con -hashed
• Comprobar exportaciones cifradas de Bitwarden con -bw
• Ocultar las contraseñas en texto plano en la salida con -hide
• Mostrar diagnósticos de HIBP a nivel de solicitud con -v
• Imprimir estadísticas al final de la ejecución con -stats

Instalación

Versión precompilada

Puedes descargar un binario estático precompilado adaptado a tu sistema operativo directamente desde la página de versiones:

1. Ve a la Página de versiones.
2. Descarga el archivo correspondiente a tu Plataforma y Arquitectura:
   • 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. Extrae el contenido del archivo para obtener el ejecutable.

Ejecutar el ejecutable

Linux / macOS: Abre tu terminal dentro del directorio extraído, haz el binario ejecutable y ejecútalo:

chmod +x pwnedcheck
./pwnedcheck -h

Windows: sin probar, pero se agradece cualquier comentario

Abre PowerShell o el Símbolo del sistema dentro de la carpeta que contiene el pwnedcheck.exe extraído y ejecuta:

.\pwnedcheck.exe -h

Con Go

Instala la CLI en tu directorio bin de Go:

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

Desde el código fuente con Make

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

Esto instala el binario del host actual en tu directorio bin de Go.

Compilar binarios específicos de plataforma

Usa el Makefile para producir binarios de versión para Linux o macOS:

make build-linux
make build-macos

Los binarios se escriben en dist/ con tu arquitectura actual de Go en el nombre del archivo.

Si quieres que el binario se copie en tu directorio bin de Go con un nombre específico del sistema operativo, usa:

make install-linux
make install-macos

Esos comandos instalan como pwnedcheck.

Uso

Ejecutar desde el código fuente:

go run ./cmd/pwnedcheck -v god

O ejecutar el binario instalado:

pwnedcheck -i passwords.list -stats

Ejemplos comunes

Comprobar una sola contraseña:

pwnedcheck password123

Comprobar varias contraseñas:

pwnedcheck love sex secret god

Comprobar contraseñas desde un archivo:

pwnedcheck -i passwords.list

Comprobar valores SHA-1 precalculados:

pwnedcheck -hashed -i passwords.list

Comprobar una exportación cifrada de Bitwarden:

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

Activar el registro detallado de solicitudes HIBP:

pwnedcheck -v password123

Opciones

• -i, --input <string> : Archivo de entrada que contiene contraseñas o exportación JSON (por defecto "passwords.txt")
• -bw, --bitwarden : Tratar el archivo de entrada como una exportación JSON cifrada y protegida con contraseña de Bitwarden
• -H, --hashed : Tratar la entrada como hashes SHA-1 precalculados en lugar de texto plano
• -x, --hide : Ocultar las contraseñas en texto plano de la salida de consola
• -s, --stats : Mostrar el resumen de tiempo de ejecución y resultados al finalizar
• -v, --verbose : Imprimir cada solicitud HIBP y el estado de la respuesta para mostrar diagnósticos de la API
• -c, --credits : Mostrar créditos
• -h, --help : Mostrar ayuda

Modelo de seguridad

PwnedCheck utiliza el enfoque de k-anonimato empleado por HIBP:

• Solo se envían a la API los primeros 5 caracteres del hash SHA-1
• La contraseña completa nunca se transmite
• Las exportaciones de Bitwarden se descifran localmente en memoria antes de comprobarlas

Ejemplo de salida

[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

Estructura del repositorio

• cmd/pwnedcheck: punto de entrada de la CLI y análisis de flags
• internal/checker: bucle de ejecución y formato de salida
• internal/hibp: cliente HIBP y hashing de contraseñas
• internal/bitwarden: descifrado de exportaciones de Bitwarden

Desarrollo

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

Docs: pkg.go.dev · Cobertura: Codecov

Licencia

GNU General Public License v3.0