Como encontrar listas fixas de grupos TLS que impedem as aplicações de adotar os padrões híbridos

Objetivo

Situação em 25 de outubro de 2026. Encontrar configurações que prendem uma aplicação a um conjunto antigo de grupos de troca de chaves TLS, restaurar uma política revisada e verificar a negociação real. Conferir novamente os padrões do ambiente de execução, as restrições do provedor e as configurações que a aplicação sobrepõe para a compilação exata implantada. Atualizar uma biblioteca não substitui necessariamente uma lista de grupos fornecida pelo código que a chama.

Pré-requisitos

Obter o código-fonte da aplicação, a configuração de implantação gerada, os argumentos de execução e um par de teste autorizado. Registrar a biblioteca realmente usada pela aplicação. Classificar cada restrição explícita como política obrigatória, exceção de compatibilidade ativa ou configuração histórica sem explicação. Não remover uma restrição obrigatória apenas porque os padrões mudaram.

Passos

1. Pesquisar nos diretórios da aplicação e da implantação, incluindo templates e scripts auxiliares de inicialização. Por exemplo:

   rg -n -e 'CurvePreferences|tlsmlkem|jdk[.]tls[.]namedGroups|setNamedGroups' \
     -e 'ssl_ecdh_curve|ssl_conf_command|SSL_CTX_set1_groups|SSL_set1_groups' .
   

   Inspecionar separadamente Groups e seu alias antigo Curves na configuração do OpenSSL que é efetivamente carregada. Registrar o responsável e o motivo de cada sobreposição efetiva; uma busca no código-fonte, por si só, não revela configurações injetadas durante a implantação.

2. Para Go, as notas da versão 1.24 habilitam X25519MLKEM768 quando Config.CurvePreferences é nil. Uma lista preenchida determina as trocas permitidas, enquanto o pacote escolhe internamente sua ordem. Remover uma atribuição desnecessária para restaurar os padrões, ou atualizar deliberadamente uma lista de permissão obrigatória. Verificar a opção documentada de desativação GODEBUG=tlsmlkem=0. Recompilar e implantar a aplicação antes de verificar o resultado.

3. Para Java, inspecionar tanto jdk.tls.namedGroups quanto chamadas a SSLParameters.setNamedGroups. O anúncio da Oracle de 17 de maio de 2026 associa a mudança ao JEP 527 nas compilações de acesso antecipado do JDK 27; o guia do Java SE 27 documenta X25519MLKEM768 como o padrão preferido. Testar a remoção de sobreposições obsoletas no ambiente de execução pretendido. A disponibilidade de ML-KEM apenas como primitiva criptográfica não é evidência suficiente de integração com TLS em outra versão ou outro provedor Java.

4. Para nginx, comparar configurações explícitas de ssl_ecdh_curve com seu padrão documentado auto, que usa a lista interna do OpenSSL. Inspecionar também as configurações herdadas e as sobreposições de ssl_conf_command. Preservar a compatibilidade necessária dos certificados: o nginx avisa que uma lista explícita deve incluir as curvas usadas pelos certificados ECDSA. Validar a configuração completa antes da recarga controlada normal.

5. Para aplicações que usam a configuração do OpenSSL, inspecionar Groups/Curves e sobreposições feitas pela API. A lista de grupos documentada usa dois-pontos como separadores; a propriedade Java usa vírgulas. Não copiar a sintaxe de um produto para outro. Confirmar que o grupo necessário está implementado antes de habilitá-lo.

6. Comparar novas conexões da aplicação antes e depois da mudança, usando pares representativos com suporte a híbridos e os pares mais antigos que precisam ser atendidos. Registrar o grupo selecionado, o resultado da autenticação e qualquer falha de handshake. O $ssl_curve do nginx informa a curva selecionada quando o OpenSSL ao qual ele está vinculado oferece suporte; $ssl_curves descreve a lista oferecida pelo cliente e responde a outra pergunta.

Resultado esperado

As listas fixas desnecessárias são removidas, as restrições necessárias têm responsáveis e as conexões observadas demonstram a política pretendida. As mudanças de configuração têm mudanças correspondentes na implantação e uma reversão documentada.

Limites e base de verificação

Este é um procedimento de auditoria proposto com base na documentação dos fornecedores; não se afirma ter testado aplicações. Restaurar os padrões permite a negociação, sem exigir que todos os pares usem um híbrido. Recomenda-se que as exceções de compatibilidade mantenham um escopo delimitado e sejam passíveis de revisão. Não desativar a validação de certificados nem restrições de segurança sem relação com o problema para fazer um handshake funcionar.