
badkeys v0.0.20
Инструмент для поиска распространённых уязвимостей в криптографических открытых ключах
badkeys
Инструмент и библиотека для проверки криптографических открытых ключей на известные уязвимости
что это?
badkeys проверяет открытые ключи в различных форматах на известные уязвимости. Веб-версию можно найти на badkeys.info.
установка
badkeys можно установить через pip:
pip3 install badkeys
Возможно, вы захотите использовать виртуальное окружение. Подробности о различных вариантах установки см. в официальной документации Python. В качестве альтернативы можно напрямую вызывать ./badkeys-cli прямо из git-репозитория.
Обзор пакетов badkeys для дистрибутивов Linux и других операционных систем можно найти на 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 и 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. Однако в настоящее время программное обеспечение находится в стадии бета-тестирования, и API может регулярно меняться.
о проекте
badkeys был написан Hanno Böck.
Эта работа была первоначально профинансирована в 2022 году Industriens Fond через проект CIDI (Cybersecure IoT in Danish Industry) и Center for Information Security and Trust (CISAT) в IT-университете Копенгагена, Дания. В 2025/2026 badkeys поддерживался фондом NGI0 Core фонда NLnet.