
暗号公開鍵における一般的な脆弱性を見つけるツール
暗号化公開鍵に既知の脆弱性がないかチェックするためのツールとライブラリ
badkeys は、さまざまな形式の公開鍵に既知の脆弱性がないかチェックします。ウェブ版は badkeys.info で利用できます。
badkeys は pip 経由でインストールできます:
pip3 install badkeys
仮想環境の使用をお勧めします。さまざまなインストール方法の詳細については、公式の Python ドキュメントをご確認ください。あるいは、git リポジトリから直接 ./badkeys-cli を呼び出すこともできます。
Linux ディストリビューションやその他のオペレーティングシステム向けの badkeys パッケージの概要は Repology で確認できます。
badkeys を使用する前に、ブロックリストデータをダウンロードする必要があります:
badkeys --update-bl
その後、badkeys を呼び出し、暗号化公開鍵を含むファイルをパラメータとして渡します:
badkeys test.crt my.key
ファイル形式は自動的に検出されます。対応しているのは、PEM 形式の公開鍵および秘密鍵(PKCS #1 と PKCS #8 の両方)、X.509 証明書、証明書署名要求(CSR)、SSH 公開鍵です。テスト用の鍵は tests/data ディレクトリにあります。
デフォルトでは、badkeys は脆弱な鍵に関する情報のみを出力します。つまり、脆弱性が見つからなければ何も出力されません。-a パラメータを指定すると、すべての鍵について出力が生成されます。
コマンドラインツールは、鍵がスキャンされ、エラーが発生せず、脆弱性が検出されなかった場合に 0 を返します。アプリケーションエラーの場合は 1、入力の一部をスキャンできなかった場合(パーサーエラー、サポートされていない鍵の種類、鍵を含まないファイル)は 2、脆弱な鍵が見つかった場合は 4 を返します。戻り値はビットマスクとして組み合わせることができます。(例: 2|4=6 は、一部の鍵が脆弱で、一部がスキャンできなかったことを示します。)
badkeys は SSH および TLS ホストをスキャンし、その公開鍵を自動的にチェックできます。これはパラメータ -s(SSH)および -t(TLS)で有効にできます。デフォルトでは、SSH はポート 22 でスキャンされ、TLS は一般的なプロトコルのいくつかのポート(https/443、smtps/465、ldaps/636、ftps/990、imaps/993、pop3s/995、および非標準の https ポートとしてよく使われる 8443)でスキャンされます。
代替ポートは --tls-ports および --ssh-ports で設定できます。
TLS スキャンと SSH スキャンは組み合わせることができます:
badkeys -ts example.org
スキャンモードには制限があることに注意してください。多くの場合、他のツールを使って TLS/SSH 鍵を収集し、badkeys でローカルにスキャンする方が望ましいです。
SSH スキャンには追加の依存関係として paramiko が必要です。
TLS スキャンは、1 つのホスト上の複数の証明書(例: ECDSA と RSA)を検出できません。これは Python の ssl.get_server_certificate() 関数の制限です。
badkeys は Python モジュールとしても使用できます。ただし、現在このソフトウェアはベータ状態であり、API は頻繁に変更される可能性があります。
badkeys は Hanno Böck によって書かれました。
この作業は、2022 年に Industriens Fond から CIDI プロジェクト(Cybersecure IoT in Danish Industry)およびデンマーク・コペンハーゲンにある IT University of Copenhagen の Center for Information Security and Trust (CISAT) を通じて初期資金提供を受けました。2025/2026 年には、badkeys は NLnet の NGI0 Core Fund の支援を受けました。