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
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 (
BlogPosteApiKey) 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 diffse 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/clientinstalados) e umschema.prismaexistente - 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
psqlou 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:
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-1Repare 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.
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-13. Crie uma policy IAM que dá ao agente acesso só ao secret de desenvolvimento.
{
"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.
#!/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_URLigual aDATABASE_URLde 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-urlusando as credenciais do agente e confirme que a chamada retornaAccessDeniedException - Rode o fluxo normal, com
SHADOW_DATABASE_URLapontando paraapp-shadow-db, e confirme queprisma migrate diffcompleta e reseta só o banco shadow (psqlnele depois: as tabelas devem refletir só o schema doprisma/migrations, nada de dados de produção) - Verifique no console do RDS que
app-prod-dbsegue comDeletion 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-instanceemapp-prod-dbsem antes desativar--deletion-protectionde 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 7ou 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
GetSecretValuefor 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 diffsozinho, ele precisa ser instruído a nunca usar a mesma variável de ambiente paraDATABASE_URLe--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ã?