
badkeys v0.0.20
Ferramenta para encontrar vulnerabilidades comuns em chaves públicas criptográficas
badkeys
Ferramenta e biblioteca para verificar chaves públicas criptográficas em busca de vulnerabilidades conhecidas
o quê?
O badkeys verifica chaves públicas em vários formatos em busca de vulnerabilidades conhecidas. Uma versão web pode ser encontrada em badkeys.info.
instalação
O badkeys pode ser instalado via pip:
pip3 install badkeys
Você pode querer usar um ambiente virtual. Para detalhes sobre as diferentes opções de instalação, consulte a documentação oficial do Python. Alternativamente, você pode chamar diretamente ./badkeys-cli a partir do repositório git.
Você pode encontrar uma visão geral dos pacotes badkeys para distribuições Linux e outros sistemas operacionais no Repology.
uso
Antes de usar o badkeys, você precisa baixar os dados da blocklist:
badkeys --update-bl
Depois disso, você pode chamar o badkeys e passar arquivos com chaves públicas criptográficas como parâmetro:
badkeys test.crt my.key
Ele tentará detectar automaticamente o formato do arquivo. São suportadas chaves públicas e privadas no formato PEM (tanto PKCS #1 quanto PKCS #8), certificados X.509, solicitações de assinatura de certificado (CSRs) e chaves públicas SSH. Você pode encontrar algumas chaves de teste no diretório tests/data.
Por padrão, o badkeys só exibirá informações sobre chaves vulneráveis, ou seja, nenhuma saída será gerada se nenhuma vulnerabilidade for encontrada. O parâmetro -a gera saída para todas as chaves.
A ferramenta de linha de comando retornará 0 se as chaves foram verificadas, nenhum erro ocorreu e nenhuma vulnerabilidade foi detectada. Ela retorna 1 para erros de aplicação, 2 se alguma entrada não pôde ser verificada (erros de parser, tipos de chave não suportados, arquivos sem chave) e 4 se uma chave vulnerável foi encontrada. Os códigos de retorno podem ser combinados como uma bitmask. (Por exemplo, 2|4=6 indica que algumas chaves eram vulneráveis e outras não puderam ser verificadas.)
verificação
O badkeys pode verificar hosts SSH e TLS e checar automaticamente suas chaves públicas. Isso pode ser habilitado com os parâmetros -s (SSH) e -t (TLS). Por padrão, o SSH será verificado na porta 22 e o TLS será verificado em várias portas para protocolos comuns (https/443, smtps/465, ldaps/636, ftps/990, imaps/993, pop3s/995 e 8443, que é comumente usado como porta https não padrão).
Portas alternativas podem ser configuradas com --tls-ports e --ssh-ports.
A verificação TLS e SSH pode ser combinada:
badkeys -ts example.org
Observe que os modos de verificação têm limitações. Muitas vezes é mais desejável usar outras ferramentas para coletar chaves TLS/SSH e verificá-las localmente com o badkeys.
A verificação SSH precisa do paramiko como dependência adicional.
A verificação TLS não consegue detectar múltiplos certificados em um único host (por exemplo, ECDSA e RSA). Esta é uma limitação da função ssl.get_server_certificate() do Python.
Módulo Python e API
O badkeys também pode ser usado como um módulo Python. No entanto, atualmente o software está em estado beta e a API pode mudar regularmente.
sobre
O badkeys foi escrito por Hanno Böck.
Este trabalho foi inicialmente financiado em 2022 pela Industriens Fond através do projeto CIDI (Cybersecure IoT in Danish Industry) e pelo Center for Information Security and Trust (CISAT) na IT University of Copenhagen, Dinamarca. Em 2025/2026, o badkeys foi apoiado pelo NGI0 Core Fund da NLnet.