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.

6 min de leitura

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 .gitignore não tira o que já foi commitado. Se o .env já entrou no Git, rode git rm --cached .env e 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.example só 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_ ou VITE_ 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.

  1. Revogue a chave no painel do serviço e gere outra. Faça isso antes de tudo.
  2. Coloque a chave nova na variável de ambiente da hospedagem e no seu .env.
  3. Tire a chave do código e faça o commit.
  4. 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.
  • .env fora 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

1. A chave vazou no GitHub. O que fazer primeiro?

2. Onde a chave de produção deve morar?

3. Uma variável com prefixo NEXT_PUBLIC_ ou VITE_ pode guardar chave secreta?

Ver respostas
  1. B) Revogar a chave no serviço e gerar outra. Revogar primeiro: o histórico do Git guarda a chave antiga; apagar só esconde.
  2. B) Nas variáveis de ambiente da hospedagem. Na hospedagem. O .env fica só na sua máquina e fora do Git.
  3. 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.