
badkeys v0.0.20
Outil pour détecter les vulnérabilités courantes dans les clés publiques cryptographiques
badkeys
Outil et bibliothèque pour vérifier les clés publiques cryptographiques à la recherche de vulnérabilités connues
quoi ?
badkeys vérifie les clés publiques dans divers formats à la recherche de vulnérabilités connues. Une version web est disponible sur badkeys.info.
installation
badkeys peut être installé via pip :
pip3 install badkeys
Vous pouvez souhaiter utiliser un environnement virtuel. Pour plus de détails sur les différentes options d'installation, veuillez consulter la documentation officielle de Python. Alternativement, vous pouvez appeler directement ./badkeys-cli depuis le dépôt git.
Vous pouvez trouver un aperçu des paquets badkeys pour les distributions Linux et autres systèmes d'exploitation sur Repology.
utilisation
Avant d'utiliser badkeys, vous devez télécharger les données de liste de blocage :
badkeys --update-bl
Ensuite, vous pouvez appeler badkeys et passer des fichiers contenant des clés publiques cryptographiques comme paramètre :
badkeys test.crt my.key
Il tentera automatiquement de détecter le format du fichier. Sont pris en charge les clés publiques et privées au format PEM (à la fois PKCS #1 et PKCS #8), les certificats X.509, les demandes de signature de certificat (CSR) et les clés publiques SSH. Vous pouvez trouver quelques clés de test dans le répertoire tests/data.
Par défaut, badkeys n'affichera que des informations sur les clés vulnérables, ce qui signifie qu'aucune sortie ne sera générée si aucune vulnérabilité n'est trouvée. Le paramètre -a génère une sortie pour toutes les clés.
L'outil en ligne de commande renverra 0 si des clés ont été analysées, qu'aucune erreur ne s'est produite et qu'aucune vulnérabilité n'a été détectée. Il renvoie 1 pour les erreurs d'application, 2 si une entrée n'a pas pu être analysée (erreurs d'analyseur, types de clés non pris en charge, fichiers sans clé), et 4 si une clé vulnérable a été trouvée. Les codes de retour peuvent être combinés sous forme de masque de bits. (Par exemple, 2|4=6 indique que certaines clés étaient vulnérables et que d'autres n'ont pas pu être analysées.)
analyse
badkeys peut analyser les hôtes SSH et TLS et vérifier automatiquement leurs clés publiques. Cela peut être activé avec les paramètres -s (SSH) et -t (TLS). Par défaut, SSH sera analysé sur le port 22 et TLS sera analysé sur plusieurs ports pour les protocoles courants (https/443, smtps/465, ldaps/636, ftps/990, imaps/993, pop3s/995 et 8443, qui est couramment utilisé comme port https non standard).
Des ports alternatifs peuvent être configurés avec --tls-ports et --ssh-ports.
L'analyse TLS et SSH peut être combinée :
badkeys -ts example.org
Notez que les modes d'analyse ont des limitations. Il est souvent plus souhaitable d'utiliser d'autres outils pour collecter les clés TLS/SSH et de les analyser localement avec badkeys.
L'analyse SSH nécessite paramiko comme dépendance supplémentaire.
L'analyse TLS ne peut pas détecter plusieurs certificats sur un même hôte (par exemple ECDSA et RSA). Il s'agit d'une limitation de la fonction ssl.get_server_certificate() de Python.
module Python et API
badkeys peut également être utilisé comme module Python. Cependant, actuellement le logiciel est en état bêta et l'API peut changer régulièrement.
à propos
badkeys a été écrit par Hanno Böck.
Ce travail a été initialement financé en 2022 par Industriens Fond via le projet CIDI (Cybersecure IoT in Danish Industry) et le Center for Information Security and Trust (CISAT) de l'IT University of Copenhagen, Danemark. En 2025/2026, badkeys a été soutenu par le NGI0 Core Fund de NLnet.