機能

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

インストール

ビルド済みリリース

リリースページから、お使いの OS に合わせたプリコンパイル済み静的バイナリを直接ダウンロードできます:

1. リリースページ に移動します。
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 : API 診断のために各 HIBP リクエストとレスポンスステータスを表示する
• -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 エクスポートの復号化

ライセンス

GNU General Public License v3.0