Comece aqui: seu app feito com IA · Aula 1 de 3 · grátis
A chave de API que foi parar no GitHub
Por que a IA às vezes escreve a chave direto no código, como separar segredos com .env e o que fazer, na ordem certa, se a chave vazou.
Como a chave vai parar lá
Você pede: “integra o app com a API de pagamento”. A IA entrega um código que funciona de primeira, com a chave escrita no meio dele:
const cliente = new Pagamentos("sk-EXEMPLO-NAO-USE");
Para a IA, esse é o caminho mais curto até o código rodar. Às vezes a chave nem foi inventada: você mesmo colou a chave no pedido, e ela foi reaproveitada. Depois vem o commit, o push, e a chave está no GitHub.
Repositório público é lido por qualquer pessoa, inclusive por robôs que procuram chaves. Por isso o próprio GitHub mantém a varredura de segredos (secret scanning) e o bloqueio de push com segredo (push protection). Repositório privado também não é cofre: ex-colaboradores, ferramentas conectadas e um “tornar público” por engano expõem tudo.
O jeito certo: a chave fica fora do código
A chave vai para um arquivo .env, que fica só na sua máquina:
# .env (nunca vai para o Git)
PAGAMENTOS_API_KEY=sk-EXEMPLO-NAO-USE
O .gitignore avisa o Git para ignorar esse arquivo:
.env
.env.*
!.env.example
O código lê a chave do ambiente:
const cliente = new Pagamentos(process.env.PAGAMENTOS_API_KEY);
Crie também um .env.example só com os nomes, sem os valores, para lembrar quais variáveis o app precisa.
Dois cuidados:
- O
.gitignorenão tira o que já foi commitado. Se o.envjá entrou no Git, rodegit rm --cached .enve faça um novo commit (e trate a chave como vazada, veja abaixo). - Diga isso à IA no começo do trabalho: “Nunca escreva chaves no código. Leia sempre de variáveis de ambiente e
atualize o
.env.examplesó com o nome da variável.”
Em produção: variáveis de ambiente da hospedagem
Vercel, Render, Netlify e outras hospedagens têm uma tela de variáveis de ambiente (environment variables). A chave de produção mora lá, não no repositório.
- Use chaves diferentes para teste e para produção.
- Cuidado com o front-end. Tudo o que vai para o navegador é público. Em frameworks como Next.js e Vite, variáveis
com prefixo
NEXT_PUBLIC_ouVITE_entram no código que o navegador baixa, conforme a documentação de cada um. Chave secreta nunca usa esses prefixos; ela fica no servidor.
A chave vazou: a ordem certa
A reação natural é apagar a chave do código. Esse é o terceiro passo, não o primeiro.
- Revogue a chave no painel do serviço e gere outra. Faça isso antes de tudo.
- Coloque a chave nova na variável de ambiente da hospedagem e no seu
.env. - Tire a chave do código e faça o commit.
- Confira o uso no painel do serviço: chamadas estranhas, cobranças, dados acessados no período.
Por que nessa ordem? O histórico do Git guarda tudo. Apagar a linha cria um commit novo, mas os commits antigos continuam mostrando a chave. Clones e forks feitos antes também têm uma cópia. A documentação do GitHub sobre remover dados sensíveis de um repositório diz o mesmo: considere comprometida qualquer chave que foi enviada, e revogue. Reescrever o histórico é opcional e não substitui revogar.
Chave que foi para o GitHub é chave vazada. Revogar resolve; apagar só esconde.
Dá para descobrir chaves esquecidas no repositório de forma automática; veja abaixo como.
Para levar
- Peça à IA, no começo, para nunca escrever chaves no código e ler tudo de variáveis de ambiente.
.envfora do Git com o.gitignore; em produção, a chave mora nas variáveis da hospedagem.- Chave secreta nunca vai para o front-end com prefixo público.
- Vazou? Revogue e gere outra antes de mexer no código: o histórico do Git guarda a chave antiga.
Teste rápido · 3 perguntas
Crie sua conta grátis para salvar o progresso e seguir para a próxima aula.
Criar conta grátisVer respostas
- B) Revogar a chave no serviço e gerar outra. Revogar primeiro: o histórico do Git guarda a chave antiga; apagar só esconde.
- B) Nas variáveis de ambiente da hospedagem. Na hospedagem. O .env fica só na sua máquina e fora do Git.
- B) Não: ela vai para o navegador, que é público. Tudo o que vai para o navegador é público. Chave secreta fica no servidor.