
badkeys v0.0.20
用于发现加密公钥中常见漏洞的工具
badkeys
用于检查加密公钥是否存在已知漏洞的工具和库
是什么?
badkeys 可检查各种格式的公钥是否存在已知漏洞。网页版可在 badkeys.info 找到。
安装
badkeys 可以通过 pip 安装:
pip3 install badkeys
你可能需要使用虚拟环境。有关不同安装选项的详细信息,请查阅官方 Python 文档。或者,你可以直接从 git 仓库调用 ./badkeys-cli。
你可以在 Repology 上找到适用于 Linux 发行版和其他操作系统的 badkeys 软件包概览。
用法
在使用 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 以及 8443,后者通常用作非标准 https 端口)。
替代端口可以通过 --tls-ports 和 --ssh-ports 配置。
TLS 和 SSH 扫描可以组合使用:
badkeys -ts example.org
请注意,扫描模式存在局限性。通常更可取的做法是使用其他工具收集 TLS/SSH 密钥,并在本地使用 badkeys 进行扫描。
SSH 扫描需要 paramiko 作为附加依赖项。
TLS 扫描无法检测一台主机上的多个证书(例如 ECDSA 和 RSA)。这是 Python 的 ssl.get_server_certificate() 函数的限制。
Python 模块和 API
badkeys 也可以作为 Python 模块使用。但是,目前该软件处于 beta 状态,API 可能会定期更改。
关于
badkeys 由 Hanno Böck 编写。
这项工作最初于 2022 年由 Industriens Fond 通过 CIDI 项目(丹麦工业网络安全物联网)以及丹麦哥本哈根 IT 大学的信息安全与信任中心(CISAT)资助。在 2025/2026 年,badkeys 获得了 NLnet 的 NGI0 Core 基金的支持。