RDS e AuroraComunidade
Nível de dificuldade: Avançado (4 de 5)
RDS criptografado recusando conexão? O problema está na chave KMS, não na rede
RDS criptografado recusando conexão? O problema está na chave KMS, não na rede
Um guia publicado na DEV Community mapeia os quatro pontos onde a permissão entre KMS e IAM quebra silenciosamente num RDS ou Aurora com encryption at rest, derrubando o banco sem tocar em nenhuma Security Group.
Nota da redação: este artigo é baseado inteiramente no guia de um único autor externo (aniketsoni, DEV Community). Os comandos AWS, o trecho de política JSON e a numeração das quatro causas refletem o que está descrito na fonte; a redação não executou esses comandos em ambiente próprio para confirmar o comportamento. A pergunta atribuída a 'um comentário no próprio artigo original' também não pôde ser verificada de forma independente quanto à autoria ou ao contexto completo da discussão. Leve isso em conta ao aplicar as recomendações em produção.
O sintoma que manda você pro lugar errado
Um guia de troubleshooting publicado por aniketsoni na DEV Community (link na fonte desta matéria) descreve um cenário comum demais em quem roda Aurora PostgreSQL com Customer Managed Key (CMK): a aplicação recebe connection timed out ou authentication failed com credenciais corretas, o console mostra o banco como Available, mas um snapshot manual falha com AccessDeniedException.
O reflexo natural é abrir Security Groups e NACLs. É o caminho errado. Quando o RDS está com encryption at rest via AWS KMS, toda operação de I/O do storage depende de kms:Decrypt e kms:GenerateDataKey acontecendo nos bastidores, continuamente. Se essa permissão falha, o sintoma imita um problema de rede, mas a causa está inteiramente fora da VPC.
Por que isso é pior que um erro de rede comum
Falha de Security Group costuma ser determinística: ou a porta está aberta ou não está, e um telnet resolve a dúvida em segundos. Falha de KMS é intermitente e cumulativa: o banco pode seguir servindo conexões já estabelecidas enquanto novas operações (snapshot automatizado, replicação cross-region, failover de Multi-AZ) começam a falhar silenciosamente.
Em resumo: o CloudWatch acusa picos de KMSKeyError, mas o painel do RDS não muda de status, porque o serviço gerenciado não necessariamente marca a instância como indisponível só porque uma operação de criptografia específica foi negada.
Os quatro pontos onde a permissão quebra
O guia numera as quatro causas na ordem em que aparecem no material original:
- Key Policy restritiva demais: a política da chave KMS não concede ao principal
rds.amazonaws.comas açõeskms:Encrypt,kms:Decrypt,kms:ReEncrypt*,kms:GenerateDataKey*ekms:DescribeKey. - IAM role sem permissão: mesmo com a Key Policy aberta, o role que a aplicação assume (ou o usuário que conecta) não tem uma IAM policy liberando
kms:Decryptpara o ARN daquela chave específica. - Chave agendada para deleção: um cleanup de "chaves não usadas" colocou o
KeyStateemPendingDeletion, e o banco perde acesso ao material criptográfico sem aviso imediato. - Falha de acesso cross-account: a instância RDS está numa conta e a CMK está centralizada numa conta de segurança, exigindo confiança nos dois sentidos.
O quarto ponto é o que mais pega arquiteturas com AWS Organizations e conta de segurança dedicada: a Key Policy precisa confiar na conta remota, e o role da conta remota precisa ter a policy de uso da chave. Falta qualquer um dos dois lados, e o erro aparece só do lado do RDS, escondendo a causa real.
Como confirmar cada hipótese sem adivinhar
O guia traz comandos específicos para isolar cada causa. Para a Key Policy:
aws kms get-key-policy --key-id <seu-kms-key-id> --policy-name defaultPara simular se o IAM role tem a permissão necessária antes mesmo de tentar a conexão real:
aws iam simulate-principal-policy \
--policy-source-arn <arn-do-seu-iam-role> \
--action-names kms:Decrypt kms:GenerateDataKey \
--resource-arns <arn-da-sua-kms-key>Para descartar a hipótese de deleção agendada, o campo que importa é KeyState:
aws kms describe-key --key-id <seu-kms-key-id>Se vier PendingDeletion e o período de espera ainda não tiver expirado, aws kms cancel-key-deletion --key-id <seu-kms-key-id> reverte a situação. Depois desse ponto, não tem volta.
O bloco de política que resolve o caso mais comum
A correção para o cenário 1 (Key Policy restritiva) é dar ao serviço rds.amazonaws.com as ações criptográficas que ele precisa para operar o storage:
{
"Sid": "AllowRDSUse",
"Effect": "Allow",
"Principal": { "Service": "rds.amazonaws.com" },
"Action": [
"kms:Encrypt",
"kms:Decrypt",
"kms:ReEncrypt*",
"kms:GenerateDataKey*",
"kms:DescribeKey"
],
"Resource": "*"
}Para o lado do IAM role que a aplicação assume, a fonte recomenda escopar a permissão ao ARN exato da chave, evitando Resource: "*".
Prevenir é tratar KMS como parte do IaC, não como afterthought
O ponto mais útil para quem opera ambiente de produção não é o diagnóstico, é a prevenção. O guia sugere quatro práticas:
- Linting de Terraform: rodar
tflintoucheckovno pipeline para pegar Key Policy permissiva ou ausente antes doterraform apply, não depois do incidente. - Nunca tocar no service-linked role: o
AWSServiceRoleForRDSé gerenciado pela AWS; editá-lo ou deletá-lo manualmente é a forma mais rápida de quebrar a relação entre RDS e KMS. - Alerta em CloudTrail via EventBridge: disparar notificação sempre que
kms:DisableKeyoukms:ScheduleKeyDeletionaparecer nos logs, antes que o período de espera da chave expire. - IAM Access Analyzer ligado para achar Key Policy que concede acesso de fora da conta, pegando erro de configuração multi-conta antes que vire incidente.
Um comentário no próprio artigo original levanta uma pergunta que vale a reflexão em qualquer revisão de arquitetura: o alerta de ScheduleKeyDeletion via EventBridge deve ser tratado como a rede de segurança principal, ou faz mais sentido bloquear essa ação diretamente na Key Policy, via uma condição que nega kms:ScheduleKeyDeletion para quem não é administrador explícito da chave? Alertar depois do fato ainda deixa uma janela de sete dias de corrida contra o relógio; impedir a ação na origem elimina a corrida, ao custo de mais fricção operacional para times que legitimamente precisam rotacionar chaves.
O que o guia não cobre
O material foca em CMK gerenciada manualmente, com Terraform e IAM role escopado por serviço, o cenário descrito no guia original. Ele não entra no caso de AWS Managed Key (a chave default do RDS, sem CMK), que tem dinâmica de permissão diferente e fica fora do escopo deste guia. Para quem ainda não decidiu entre CMK e chave gerenciada pela AWS no RDS, vale pesquisar esse trade-off antes de decidir, independente de compliance.
Fonte 1: DEV Community — #aws (https://dev.to/aniketsoni/why-is-your-encrypted-rds-instance-refusing-connection-requests-g1d)
Why Is Your Encrypted RDS Instance Refusing Connection Requests? - DEV Community.
Fonte: DEV Community — #aws
Serviços neste textoRDS e Aurora
Leve para a sua IA
Decida com o seu assistente, com o contexto deste texto já montado.
1. O que você quer saber
Ver o prompt
Li no AWS Hub: "RDS criptografado recusando conexão? O problema está na chave KMS, não na rede" (https://awshub.com.br/comunidade/rds-criptografado-recusando-conexao-o-problema-esta-na-chave-kms-nao-na-rede). Resumo: Um guia publicado na DEV Community mapeia os quatro pontos onde a permissão entre KMS e IAM quebra silenciosamente num RDS ou Aurora com encryption at rest, derrubando o banco sem tocar em nenhuma Security Group. Serviços: RDS e Aurora Minha stack: [descreva em uma linha: serviços, linguagem, volume, região] Isso muda alguma coisa na minha arquitetura? O que eu faria diferente a partir de amanhã?