Secrets Manager usando TLS híbrido com ML-KEM para proteger a leitura de segredos

Secrets Manager com TLS híbrido: o que mudou em 2026

Os clientes do Secrets Manager passaram a preferir a troca de chaves híbrida com ML-KEM em abril de 2026. Se o seu cliente está atualizado, ele já busca segredos com proteção pós-quântica. Se não está, ele continua funcionando, só que no TLS clássico.

Esse é o problema: nenhum erro avisa quando um cliente cai no TLS clássico. Neste artigo você vê quais clientes negociam ML-KEM sozinhos, o que checar na função Lambda de rotação e como provar no CloudTrail que o handshake híbrido está ativo.

TL;DR

  • Desde 14/04/2026, clientes atualizados do Secrets Manager preferem a troca de chaves híbrida X25519 + ML-KEM, na maioria dos casos sem mudar código.
  • Cliente antigo cai no TLS clássico sem erro. A prova está no campo tlsDetails.keyExchange do CloudTrail: X25519MLKEM768 indica o modo híbrido.
  • Python (boto3) exige OpenSSL 3.5 ou superior. Java v2 exige o cliente HTTP AWS CRT com postQuantumTlsEnabled(true).
  • A função Lambda de rotação é um cliente seu, então o runtime dela precisa passar pela mesma checagem.
  • A proteção cobre a chamada à API. A conexão da função com o banco de dados segue o protocolo do próprio banco.

Por que o Secrets Manager entrou na migração pós-quântica

Cada segredo fica criptografado com uma chave do AWS KMS, então o dado em repouso já tem proteção. O risco novo está no trânsito: um atacante pode gravar hoje o tráfego TLS e decifrá-lo quando existir um computador quântico capaz, o ataque harvest now, decrypt later.

Uma senha capturada hoje só tem valor no futuro se continuar válida até lá. Por isso a rotação reduz o risco, desde que o valor mude antes do dia em que a captura puder ser decifrada. Isso é raciocínio meu, não afirmação da AWS.

A AWS chegou aqui em duas etapas. Em 2025, os endpoints de KMS, ACM e Secrets Manager passaram a aceitar ML-KEM, segundo o AWS Security Blog. Em 14/04/2026, o anúncio do Secrets Manager estendeu o suporte aos clientes, que agora oferecem ML-KEM por padrão.

Como funciona o TLS híbrido com ML-KEM

O TLS híbrido combina uma troca de chaves clássica (X25519) com o ML-KEM, um método pós-quântico de encapsulamento de chaves. A chave de sessão continua protegida se pelo menos um dos dois algoritmos resistir. O grupo negociado aparece como X25519MLKEM768.

O endpoint só escolhe ML-KEM quando o cliente o oferece. Clientes antigos que anunciam apenas o CRYSTALS-Kyber, versão pré-padrão do algoritmo, voltam ao TLS clássico em vez de falhar. A AWS está removendo o suporte ao Kyber dos endpoints em 2026.

O custo de desempenho é pequeno. No benchmark da AWS com o KMS, o handshake híbrido adiciona cerca de 1.600 bytes e de 80 a 150 microssegundos de CPU, uma vez por conexão.

Com reuso de conexão, a vazão caiu 0,05%. Sem reuso, caiu 2,3%. O teste mediu o KMS com SDK Java, não o serviço de segredos, então meça no seu ambiente.

Quais clientes negociam ML-KEM sem mudar código

A AWS lista as versões mínimas no anúncio e no post de segurança da AWS. Os componentes de cache e as extensões habilitam o ML-KEM automaticamente nas versões abaixo.

ClienteVersão mínimaObservação
Workload Credentials Provider2.0.0O anúncio de abril o chama de Secrets Manager Agent
Extensão Lambda19Habilitado automaticamente
ASCP (Secrets and Configuration Provider)2.0.0Citado no anúncio
Secrets Manager CSI Driver2.0.0Citado no post de segurança
SDK GoGo 1.24
SDK Node.js22.20 ou 24.9.0
SDK RustReleases após 29/08/2025
SDK Kotlin1.5.78Somente Linux
SDK Python (boto3)OpenSSL 3.5 no hostDepende do sistema, não só da biblioteca
SDK Java v22.35.11Exige cliente AWS CRT com flag

As bibliotecas de cache em Java e o driver JDBC herdam o comportamento do SDK, mas cada um precisa de uma flag própria. Consulte a documentação de cada um antes de assumir que está ativo.

No Java, o ML-KEM só entra com o cliente HTTP AWS CRT:

java

SdkAsyncHttpClient awsCrtHttpClient = AwsCrtAsyncHttpClient.builder()
    .postQuantumTlsEnabled(true)
    .build();

SecretsManagerAsyncClient client = SecretsManagerAsyncClient.builder()
    .httpClient(awsCrtHttpClient)
    .build();

Rotação de segredos: o cliente que importa é a sua Lambda

A rotação automática roda em uma função Lambda com a role dela. Segundo o guia de funções de rotação, a função tem quatro etapas: createSecret, setSecret, testSecret e finishSecret. O guia descreve essas etapas com chamadas do boto3.

Cada etapa que toca o segredo passa pela API do Secrets Manager. A createSecret chama get_secret_value, get_random_password e put_secret_value com o rótulo AWSPENDING. A finishSecret usa update_secret_version_stage para mover o rótulo AWSCURRENT.

Isso coloca a decisão no runtime da função. Se ela usa boto3, o ML-KEM depende do OpenSSL 3.5 ou superior. Não encontrei na documentação consultada a versão de OpenSSL de cada runtime do Lambda, então meça no seu:

python

import ssl


def lambda_handler(event, context):
    # boto3 precisa de OpenSSL 3.5 ou superior para negociar ML-KEM
    print(ssl.OPENSSL_VERSION)

Não imprima o conteúdo do segredo em nenhum log. A própria documentação alerta que mensagens de depuração vão para o CloudWatch Logs.

Depois de atualizar a função, force uma rotação em um segredo de teste e confira os eventos. A rotação troca a credencial de verdade, então não faça isso primeiro em produção:

bash

aws secretsmanager rotate-secret --secret-id <SECRET_ID>

A proteção tem um limite. O TLS híbrido cobre a chamada da função à API do Secrets Manager. Na etapa setSecret, a função altera a senha no banco ou serviço de destino por outra conexão, que segue o protocolo desse destino.

Como validar o TLS híbrido no CloudTrail

O CloudTrail registra o método de troca de chaves no campo tlsDetails.keyExchange. Segundo a referência de eventos do CloudTrail, o valor X25519MLKEM768 indica TLS 1.3 pós-quântico e x25519 indica TLS 1.3 clássico. O campo não aparece quando um serviço da AWS faz a chamada em seu nome.

Depois de uma chamada, espere cerca de 5 minutos para o evento aparecer. Se o valor for X25519, o cliente não está oferecendo ML-KEM: revise a versão e a configuração dele.

Eventos do Secrets Manager na linha de comando

Esta consulta lista quem chamou GetSecretValue e qual troca de chaves cada chamada usou:

bash

aws cloudtrail lookup-events \
  --lookup-attributes AttributeKey=EventName,AttributeValue=GetSecretValue \
  --max-results 50 \
  --query 'Events[].CloudTrailEvent' --output json \
| jq -r '.[] | fromjson
    | [.eventTime, .userIdentity.arn, (.tlsDetails.keyExchange // "sem tlsDetails")]
    | @tsv'

Para a rotação, troque o nome do evento por PutSecretValue e por UpdateSecretVersionStage. A AWS documenta o teste com GetSecretValue. Confirme no seu ambiente que os eventos da função de rotação trazem o campo.

Contagem por tipo de troca no Logs Insights

Se o CloudTrail envia logs para o CloudWatch Logs, uma consulta no Logs Insights mostra quais identidades ainda usam o modo clássico:

filter eventSource = "secretsmanager.amazonaws.com"
| stats count(*) as total by tlsDetails.keyExchange, userIdentity.arn
| sort total desc

Armadilhas em produção

O primeiro risco é o fallback silencioso. O cliente antigo funciona, o segredo chega, e nada indica que a proteção não está ativa. Só o CloudTrail mostra a diferença.

O segundo é o Python. O boto3 depende do OpenSSL do host, então uma imagem de contêiner ou um runtime com OpenSSL mais antigo mantém o TLS clássico mesmo com o SDK atualizado.

O terceiro é a rede. O handshake híbrido é maior, e a AWS avisa que equipamentos com inspeção profunda de pacotes podem bloquear os novos handshakes. Se o tráfego passa por firewall ou proxy corporativo, teste de ponta a ponta antes de atualizar a frota inteira.

Mais três pontos para conferir:

  • Regiões: a documentação diz que o TLS pós-quântico do serviço existe em todas as regiões, exceto as da China.
  • Endpoints FIPS: o post de 2025 trata dos endpoints sem FIPS. Se você usa endpoints FIPS, confirme o suporte antes de assumir.
  • Kyber: SDKs que só anunciam Kyber perdem o modo híbrido ao longo de 2026.

Custo, segurança e observabilidade

A página do anúncio não trata de preço. Confirme na página de preços do Secrets Manager antes de afirmar que não há custo adicional. O impacto prático está no tráfego extra do handshake, de cerca de 1.600 bytes por conexão nova.

Na segurança, mantenha permissões mínimas. A role de quem consulta o histórico precisa de cloudtrail:LookupEvents, e a role da função de rotação não deve ganhar mais permissões por causa dessa checagem.

Na observabilidade, rode a consulta do Logs Insights toda semana e trate cada identidade com x25519 como pendência. A AWS também recomenda manter um inventário criptográfico do ambiente, para achar outros usos de chave pública que precisarão migrar.

Conclusão

O Secrets Manager já oferece a troca de chaves híbrida, mas a proteção só vale para o cliente que a negocia. Atualize SDKs, extensões e providers para as versões da tabela, revise o runtime da função de rotação e prove o resultado no campo tlsDetails.keyExchange.

O próximo passo é concreto: escolha os cinco segredos mais acessados do ambiente, rode a consulta do CloudTrail e liste quem ainda aparece com x25519. Esse é o seu backlog de atualização do Secrets Manager.

Referências:

Quer uma solução personalizada para seu negócio?

Nossos especialistas em cloud computing analisam seu caso e criam uma estratégia sob medida.

Compartilhe essa publicação
Sobre o autor
Foto de Haniel Maia

Haniel Maia

Haniel Maia é Técnico NOC na KXC Tecnologia, onde atua no monitoramento e observabilidade, e na operação de ambientes em nuvem. Estudante de Redes de Computadores no IFPB, desenvolve projetos práticos com AWS, Terraform, Docker, Kubernetes e CI/CD, e é um participante ativo em comunidades locais AWS. Escreve sobre Cloud, DevOps e operações com foco no que funciona em produção. Seu objetivo é atuar como Engenheiro DevOps/SRE, construindo infraestruturas automatizadas, resilientes e bem documentadas.

Ver perfil e posts