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.keyExchangedo CloudTrail:X25519MLKEM768indica 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.
| Cliente | Versão mínima | Observação |
|---|---|---|
| Workload Credentials Provider | 2.0.0 | O anúncio de abril o chama de Secrets Manager Agent |
| Extensão Lambda | 19 | Habilitado automaticamente |
| ASCP (Secrets and Configuration Provider) | 2.0.0 | Citado no anúncio |
| Secrets Manager CSI Driver | 2.0.0 | Citado no post de segurança |
| SDK Go | Go 1.24 | |
| SDK Node.js | 22.20 ou 24.9.0 | |
| SDK Rust | Releases após 29/08/2025 | |
| SDK Kotlin | 1.5.78 | Somente Linux |
| SDK Python (boto3) | OpenSSL 3.5 no host | Depende do sistema, não só da biblioteca |
| SDK Java v2 | 2.35.11 | Exige 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:
- AWS Secrets Manager now supports hybrid post-quantum TLS (What’s New, abril/2026)
- Protecting your secrets from tomorrow’s quantum risks (AWS Security Blog)
- ML-KEM post-quantum TLS now supported in AWS KMS, ACM, and Secrets Manager (AWS Security Blog)
- Lambda rotation functions (documentação de rotação)
- CloudTrail record contents: tlsDetails (documentação do CloudTrail)



