AWS HubAWS HubSão Paulo operando · 2 eventos no mundo

Agentes de códigoAWS para Vibe Coders

Nível de dificuldade: Avançado (4 de 5)

Como blindar seu banco de produção na AWS contra a shadow-database-url do Prisma

Por AWS Hub7 min de leitura

Um desenvolvedor pediu para o Claude Code, rodando Claude Opus 5 em modo Ultracode (o modo multiagente da ferramenta), reconstruir as páginas de comparação de um projeto pessoal. Para checar se o schema do banco estava sincronizado, o agente rodou prisma migrate diff e, no parâmetro --shadow-database-url, colou a connection string real e não-pooled do banco de produção. O caso foi relatado pelo próprio desenvolvedor e publicado na DEV Community, com apuração adicional do IT-Connect.

Segundo o relato do incidente, publicado pela DEV Community com apuração do IT-Connect, não havia nada quebrado no Prisma: --shadow-database-url existiria para apontar para um banco descartável, que a ferramenta resetaria antes de reaplicar as migrations nele. Essa descrição do comportamento do Prisma não está confirmada por documentação oficial entre as fontes consultadas aqui, mas é consistente com o nome do parâmetro e com o que a fonte relata ter ocorrido.

O problema, segundo o relato, é que nada na construção do comando do agente distinguiu "um banco que posso jogar fora" de "o único banco que este projeto tem". O resultado: as 22 tabelas do banco de produção no Supabase foram derrubadas, e o schema foi reconstruído a partir de um diretório prisma/migrations desatualizado.

O caso envolve Supabase, mas o mecanismo é o mesmo para qualquer Postgres gerenciado, incluindo Amazon RDS e Aurora. Se você deixa um agente com uma DATABASE_URL de produção no ambiente e uma tarefa que mexe em schema, o risco existe independente de quem hospeda o banco. Este texto monta o isolamento que teria impedido o desastre, usando Secrets Manager e IAM no lugar de confiar que o agente vai acertar a string.

Em números

  • 22 tabelas derrubadas no banco de produção pelo reset do shadow database
  • 2 tabelas (BlogPost e ApiKey) nunca foram recriadas, porque já tinham saído do histórico de migrations antes do incidente
  • 130 registros de ferramentas (tool records) perdidos
  • 21 comparações perdidas, sem confirmação de recuperação via backup

O que você vai construir

Uma configuração em que o agente de código fisicamente não consegue obter a connection string de produção para usar como shadow database. O setup final tem:

  • Um banco Amazon RDS for PostgreSQL de produção, isolado em secret próprio
  • Um banco (ou instância) separado, explicitamente marcado como descartável, para servir de shadow database
  • Um papel IAM com acesso só ao secret do ambiente de desenvolvimento, sem leitura do secret de produção
  • Um script de guarda que recusa rodar prisma migrate diff se as duas URLs apontarem para o mesmo host

O objetivo não é confiar que o agente vai ler a documentação do Prisma antes de montar o comando. É fazer a credencial errada simplesmente não existir no ambiente dele.

Pré-requisitos

  • Conta AWS com permissão para criar instâncias RDS, segredos no Secrets Manager e políticas IAM
  • AWS CLI configurado, versão 2.x, ou acesso ao console em São Paulo (sa-east-1)
  • Projeto com Prisma já configurado (prisma, @prisma/client instalados) e um schema.prisma existente
  • Permissões IAM mínimas para o usuário ou role que vai executar os passos: rds:CreateDBInstance, rds:DescribeDBInstances, secretsmanager:CreateSecret, secretsmanager:PutSecretValue, iam:CreatePolicy, iam:CreateRole, iam:AttachRolePolicy
  • Node.js 18+ e psql ou outro client Postgres para os testes

Passo a passo

1. Crie dois bancos, não um com dois schemas. Produção e shadow não podem compartilhar instância. Na sa-east-1:

bash
aws rds create-db-instance \
  --db-instance-identifier app-prod-db \
  --db-instance-class db.t4g.micro \
  --engine postgres \
  --master-username appadmin \
  --master-user-password '<senha-forte>' \
  --allocated-storage 20 \
  --region sa-east-1 \
  --deletion-protection

aws rds create-db-instance \
  --db-instance-identifier app-shadow-db \
  --db-instance-class db.t4g.micro \
  --engine postgres \
  --master-username appadmin \
  --master-user-password '<outra-senha>' \
  --allocated-storage 20 \
  --region sa-east-1

Repare na diferença: só app-prod-db leva --deletion-protection. O app-shadow-db é o banco que QUALQUER comando com --shadow-database-url pode resetar sem dó, porque ele não guarda nada que importe.

2. Guarde as duas connection strings em segredos separados, com nomes que não deixam dúvida.

bash
aws secretsmanager create-secret \
  --name prod/database-url \
  --secret-string '{"url":"postgresql://appadmin:...@app-prod-db.xxxx.sa-east-1.rds.amazonaws.com:5432/app"}' \
  --region sa-east-1

aws secretsmanager create-secret \
  --name dev/shadow-database-url \
  --secret-string '{"url":"postgresql://appadmin:...@app-shadow-db.xxxx.sa-east-1.rds.amazonaws.com:5432/app"}' \
  --region sa-east-1

3. Crie uma policy IAM que dá ao agente acesso só ao secret de desenvolvimento.

json
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "secretsmanager:GetSecretValue",
      "Resource": "arn:aws:secretsmanager:sa-east-1:*:secret:dev/shadow-database-url-*"
    },
    {
      "Effect": "Deny",
      "Action": "secretsmanager:GetSecretValue",
      "Resource": "arn:aws:secretsmanager:sa-east-1:*:secret:prod/database-url-*"
    }
  ]
}

O Deny explícito no secret de produção importa mais do que parece: se amanhã alguém anexar outra policy mais permissiva ao mesmo role por engano, o Deny continua vencendo. É a diferença entre "o agente não tem a chave da produção" e "o agente não deveria ter a chave da produção".

4. Anexe essa policy ao role ou ao usuário que o agente de código usa para rodar comandos localmente ou em CI. Nunca cole prod/database-url direto no .env de uma sessão onde um agente vai montar comandos de migration.

5. Adicione um script de guarda antes de qualquer migrate diff ou migrate dev. Isso é o que faltou no incidente: uma checagem que roda antes do Prisma, não depois.

bash
#!/usr/bin/env bash
set -euo pipefail

PROD_HOST=$(echo "$DATABASE_URL" | sed -E 's#.*@([^:/]+).*#\1#')
SHADOW_HOST=$(echo "$SHADOW_DATABASE_URL" | sed -E 's#.*@([^:/]+).*#\1#')

if [ "$PROD_HOST" = "$SHADOW_HOST" ]; then
  echo "ERRO: shadow database aponta para o mesmo host da produção ($PROD_HOST). Abortando."
  exit 1
fi

npx prisma migrate diff --shadow-database-url "$SHADOW_DATABASE_URL" "$@"

Esse script teria barrado exatamente o comando que derrubou o banco do desenvolvedor na DEV Community: ele compara os dois hosts antes de deixar o Prisma tocar em qualquer coisa.

Testando

  • Rode o script de guarda com SHADOW_DATABASE_URL igual a DATABASE_URL de propósito e confirme que ele aborta com o erro antes de chamar o Prisma
  • Rode aws secretsmanager get-secret-value --secret-id prod/database-url usando as credenciais do agente e confirme que a chamada retorna AccessDeniedException
  • Rode o fluxo normal, com SHADOW_DATABASE_URL apontando para app-shadow-db, e confirme que prisma migrate diff completa e reseta só o banco shadow (psql nele depois: as tabelas devem refletir só o schema do prisma/migrations, nada de dados de produção)
  • Verifique no console do RDS que app-prod-db segue com Deletion protection: Enabled

Limpando os recursos

  • Apague a instância de shadow depois do teste, já que ela não guarda nada que precise sobreviver: aws rds delete-db-instance --db-instance-identifier app-shadow-db --skip-final-snapshot --region sa-east-1
  • Remova os dois segredos de teste se foram criados só para este exercício: aws secretsmanager delete-secret --secret-id dev/shadow-database-url --force-delete-without-recovery --region sa-east-1
  • Desanexe e apague a policy IAM de teste se ela não vai para produção
  • Nunca rode delete-db-instance em app-prod-db sem antes desativar --deletion-protection de propósito, e só depois de confirmar snapshot válido

Consulte a página de preços da AWS para RDS e para Secrets Manager antes de deixar esses recursos rodando além do teste: os valores e eventuais camadas gratuitas variam por região e mudam com o tempo. De todo modo, manter duas instâncias pequenas e dois segredos por um teste curto tende a ser custo irrisório perto do risco que o isolamento elimina.

Próximos passos

  • Ative backups automáticos e point-in-time recovery no RDS de produção (--backup-retention-period 7 ou mais); o relato original na DEV Community não confirma se havia snapshot para recuperar os dados perdidos, e essa é a rede de segurança que você não quer descobrir que não tinha
  • Configure o CloudTrail para alertar quando GetSecretValue for chamado para o secret de produção fora de um pipeline conhecido
  • Considere branches de banco (o equivalente, no mundo RDS, ao que ferramentas como Neon oferecem nativamente) em vez de um shadow database fixo, se o fluxo de trabalho com agentes for intenso
  • Releia o prompt que você dá ao agente: se ele tem permissão para rodar prisma migrate diff sozinho, ele precisa ser instruído a nunca usar a mesma variável de ambiente para DATABASE_URL e --shadow-database-url, mas a instrução em prompt é reforço, não substituto do isolamento por IAM

O próprio log de execução do agente, segundo o relato reproduzido pela DEV Community, registrou o erro assim que ele aconteceu.

Isso é culpa minha e eu preciso te avisar imediatamente.

This is my fault and I need to tell you immediately.Claude Opus 5, agente em modo Ultracode, no Claude Code

A honestidade do log não desfaz o dano. O ponto do incidente, como a fonte argumenta, não é que o agente tenha escondido o erro: é que nada no ambiente dele impedia o comando de rodar antes de errar.

Fonte: DEV Community — #claudecode

Serviços neste textoAgentes de código

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: "Como blindar seu banco de produção na AWS contra a shadow-database-url do Prisma" (https://awshub.com.br/vibe-coding/como-blindar-seu-banco-de-producao-na-aws-contra-a-shadow-database-url-do-prisma).
Resumo: Um agente rodando Claude Opus 5 em modo Ultracode apagou 22 tabelas de um banco de produção ao confundir a flag --shadow-database-url do Prisma com uma string descartável. O isolamento de credenciais no RDS evita que isso se repita.
Serviços: Agentes de código

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ã?

Newsletter semanal

A semana da AWS, em português

Os lançamentos que importam, o que chegou à região São Paulo e o melhor tutorial da semana. Toda sexta, gratuita.