機能

• コマンドラインから単一のパスワードを確認
• ファイルからパスワードを処理
• -hashedで事前にハッシュ化されたSHA-1入力を受け入れる
• -bwでBitwarden暗号化エクスポートを確認
• -hideで出力内の平文パスワードを非表示
• -vでリクエストレベルのHIBP診断情報を表示
• -statsで実行終了時の統計情報を出力

インストール

ビルド済みリリース

releasesページから、お使いのオペレーティングシステムに合わせたコンパイル済みの静的バイナリを直接ダウンロードできます：

1. Releases Pageに移動します。
2. お使いのプラットフォームとアーキテクチャに対応するアーカイブをダウンロードします：
   • Linux: pwnedcheck_x.x.x_linux_amd64.tar.gz（またはarm64）
   • macOS: pwnedcheck_x.x.x_darwin_amd64.tar.gz（またはarm64）
   • Windows: pwnedcheck_x.x.x_windows_amd64.zip
3. アーカイブの内容を展開して実行ファイルを取得します。

実行ファイルの実行

Linux / macOS: 展開したディレクトリ内でターミナルを開き、バイナリに実行権限を付与して実行します：

chmod +x pwnedcheck
./pwnedcheck -h

Windows: 未テストですが、フィードバックを歓迎します

展開したpwnedcheck.exeを含むフォルダ内でPowerShellまたはコマンドプロンプトを開き、実行します：

.\pwnedcheck.exe -h

Goを使用する場合

CLIをGoのbinディレクトリにインストールします：

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

Makeを使用してソースから

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

これにより、現在のホスト用バイナリがGoのbinディレクトリにインストールされます。

プラットフォーム固有のバイナリをビルド

Makefileを使用して、LinuxまたはmacOS用のリリースバイナリを生成します：

make build-linux
make build-macos

バイナリはdist/に書き込まれ、ファイル名に現在のGoアーキテクチャが含まれます。

OS固有の名前でバイナリをGoのbinディレクトリにコピーしたい場合は、次を使用します：

make install-linux
make install-macos

これらのコマンドはpwnedcheckとしてインストールされます。

使用方法

ソースから実行：

go run ./cmd/pwnedcheck -v god

またはインストール済みのバイナリを実行：

pwnedcheck -i passwords.list -stats

一般的な例

単一のパスワードを確認：

pwnedcheck password123

複数のパスワードを確認：

pwnedcheck love sex secret god

ファイルからパスワードを確認：

pwnedcheck -i passwords.list

事前にハッシュ化されたSHA-1値を確認：

pwnedcheck -hashed -i passwords.list

Bitwarden暗号化エクスポートを確認：

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

詳細なHIBPリクエストログを有効化：

pwnedcheck -v password123

オプション

• -i, --input <string> : パスワードまたはJSONエクスポートを含む入力ファイル（デフォルト "passwords.txt"）
• -bw, --bitwarden : 入力ファイルをBitwardenのパスワード保護された暗号化JSONエクスポートとして扱う
• -H, --hashed : 入力を平文ではなく事前計算されたSHA-1ハッシュとして扱う
• -x, --hide : コンソール出力から平文パスワードを非表示にする
• -s, --stats : 完了後に実行時間と結果の概要を表示
• -v, --verbose : 各HIBPリクエストとレスポンスのステータスを出力してAPI診断情報を表示
• -c, --credits : クレジットを表示
• -h, --help : ヘルプを表示

セキュリティモデル

PwnedCheckはHIBPで使用されているk-匿名性アプローチを使用しています：

• SHA-1ハッシュの最初の5文字のみがAPIに送信されます
• 完全なパスワードは送信されません
• Bitwardenエクスポートは確認前にメモリ内でローカルに復号されます

出力例

[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

リポジトリ構成

• cmd/pwnedcheck: CLIエントリポイントとフラグ解析
• internal/checker: 実行ループと出力フォーマット
• internal/hibp: HIBPクライアントとパスワードハッシュ
• internal/bitwarden: Bitwardenエクスポートの復号

開発

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

ドキュメント: pkg.go.dev · カバレッジ: Codecov

ライセンス

GNU General Public License v3.0