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
Engenheiro de Software Full-Stack
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
.envno.gitignorenão basta. Ele precisa estar fora do repositório desde o início, e o.env.exampledeve 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.
Falar comigo