Renan Montanari Blog
Voltar ao blog
SegurançaDevOps

Credencial Não Some Sozinha: Quando o Ex-Desenvolvedor Ainda Tem as Chaves

O desenvolvedor saiu em bons termos, mas a senha do banco e a chave de pagamento continuam as mesmas. Como tirar segredos do código, dar acesso nominal e revogar tudo no dia do desligamento.

Renan Montanari

Renan Montanari

Engenheiro de Software Full-Stack

6 min de leitura

Introdução: Saiu em Bons Termos, Mas Ainda Tem Acesso

O desenvolvedor entregou o projeto e saiu em bons termos. Seis meses depois, ninguém trocou nada.

A senha do banco de dados é a mesma. A chave do meio de pagamento é a mesma. O acesso ao servidor é o mesmo.

E tudo isso continua no computador dele, no histórico do repositório e, provavelmente, num arquivo de configuração que já foi enviado por e-mail pelo menos uma vez.

O problema quase nunca é má-fé. É que credencial não some sozinha. Ela se copia.

Como Uma Credencial Se Multiplica

Cada cópia feita por conveniência vira mais um lugar onde a credencial existe:

  • Colada num arquivo de configuração para “testar rápido”.
  • Enviada por mensagem para alguém resolver um problema urgente.
  • Salva no histórico do repositório, mesmo depois de apagada no código atual.
  • Copiada para o computador de um colaborador que já saiu.
  • Usada no script de um estagiário que nunca foi revisado.

Ninguém mantém essa lista. E uma credencial que você não sabe onde está é uma credencial que você não consegue revogar.

Três Práticas Que Resolvem a Maior Parte

1. Credencial nunca dentro do código

Segredo vai para variável de ambiente ou para um cofre de segredos, nunca para o repositório.

// ❌ Nunca faça isso
const stripe = new Stripe('sk_live_xxxxxxxxxxxxxxxx');

// ✅ Lê do ambiente, com validação na inicialização
const stripeKey = process.env.STRIPE_SECRET_KEY;

if (!stripeKey) {
  throw new Error('STRIPE_SECRET_KEY não configurada');
}

const stripe = new Stripe(stripeKey);

Duas observações importantes:

  • Se um segredo já foi commitado, ele está comprometido. Remover o arquivo no commit seguinte não resolve. O histórico do Git guarda tudo. A resposta correta é trocar a credencial e só depois limpar o histórico, se for necessário.
  • Um .env no .gitignore não basta. Ele precisa estar fora do repositório desde o início, e o .env.example deve trazer apenas os nomes das variáveis, sem valores reais.

Ferramentas de varredura de segredos, como o gitleaks ou o trufflehog, podem rodar no pipeline e bloquear commits com chaves expostas. Vale ativar antes que o primeiro vazamento aconteça.

2. Acesso nominal, um por pessoa

Credencial compartilhada significa que ninguém sabe quem fez o quê. E revogar uma delas derruba todo mundo que a usava.

O caminho é cada pessoa ter o próprio acesso, com permissões mínimas para o papel dela. Ferramentas de cloud, bancos gerenciados e provedores de pagamento geralmente permitem criar usuários ou chaves separadas por função.

Isso conversa diretamente com o controle de acesso que já falamos em posts anteriores. A diferença é que aqui o foco é quem tem a chave, e não o que a aplicação permite.

3. Desligamento que revoga tudo no mesmo dia

Quando alguém sai, o procedimento precisa ser o mesmo de recolher um crachá: revogar o que a pessoa tinha, no dia, sem depender de lembrança.

Uma lista simples de revogação:

  • Acesso ao repositório e ao servidor de deploy.
  • Acesso ao painel do provedor de nuvem e ao banco.
  • Chaves de API que a pessoa criou ou conhecia.
  • Contas em ferramentas de terceiros, como pagamento, e-mail e mensagens.
  • Dispositivos e sessões ativas, quando for o caso.

E o detalhe que quase ninguém faz: trocar as credenciais compartilhadas que ela conhecia. Se a pessoa sabia a senha do banco, a senha do banco precisa ser trocada, mesmo que ela tenha saído em bons termos.

Trade-offs: Rotação Dá Trabalho, Mas Não Dá Para Evitar

Trocar credenciais tem custo. Alguma coisa pode parar se a atualização não for coordenada. Por isso, alguns cuidados:

  • Rotacione com um plano. Atualize as variáveis de ambiente, faça o deploy e só então revogue a antiga.
  • Automatize o que for possível. Gerenciadores de segredos podem rotacionar chaves sem intervenção manual.
  • Documente onde cada credencial é usada. Sem essa lista, a rotação vira caça ao tesouro.

O custo de trocar uma chave planejada é pequeno. O custo de descobrir um vazamento depois é muito maior.

Checklist: Você Sabe Onde Estão Suas Chaves?

  • Existe alguma credencial escrita diretamente no código ou no histórico do repositório?
  • Você sabe a lista de todas as credenciais do sistema e onde cada uma é usada?
  • Cada pessoa tem acesso próprio, ou algum acesso é compartilhado?
  • Existe um procedimento escrito de desligamento que revoga acessos no mesmo dia?
  • A última rotação de chaves críticas foi feita em quanto tempo?
  • Existe varredura de segredos no pipeline?

Conclusão: A Pergunta Simples

Quando foi a última vez que você trocou as chaves do seu sistema?

Se a resposta for “não lembro”, a lista de quem ainda tem acesso provavelmente é maior do que você imagina.

Uma tarde organizando credenciais, acessos e procedimento de desligamento economiza muito mais do que custa.

Gostou? Compartilhe