Aula 5 · 14 min
Uma chave colada num documento, num print ou num pedido vira acesso para quem ler, e continua valendo depois que a conversa acaba. Separar o segredo do resto, antes da primeira versão salva, deixa você compartilhar a pasta sem medo.
Começar a aula
Objetivo: criar .env, .env.example e .gitignore antes do primeiro commit e saber o que fazer se uma chave vazar.
A lista de salas pode ficar à vista; a chave, não.
Role a página: cada etapa abaixo acende a sua parte do diagrama.
Guarda variáveis: um nome, um sinal de igual e um valor. Não é cofre: não é criptografado, quem abre o arquivo lê. Por isso fica só na sua máquina e nunca vai para o Git.
Os mesmos nomes, com valores de mentira. Quem recebe o projeto vê o que precisa preencher, mas não ganha acesso a nada. Lembre: o que termina em example é o exemplo.
Cada linha é um padrão. .env pega o arquivo; .env.* pega variantes como .env.local; a linha com ! abre uma exceção e devolve o .env.example à lista do que é guardado.
O .gitignore só vale para o que o Git ainda não guardou. Se o .env já entrou num commit, a linha escrita depois não o tira do histórico. Por isso a lista vem antes da primeira versão.
O .env com o valor real fica em casa, o .env.example circula, e o .gitignore decide isso antes de o Git guardar qualquer versão. Depois que o malote partiu, riscar o papel da lista não o traz de volta.
Na regra do AGENTS.md: "Nunca escreva chaves ou senhas em arquivo de texto; elas ficam no .env."
Clique em cada uma.
Senha, chave de API e token de bot deixam quem os tem agir em nome da sua conta, e quem paga é você.
Antes de mandar um print, olhe os cantos da tela: uma senha visível passa a ser de todo mundo que recebeu.
A mesma tela, com a senha coberta antes de enviar.
Para ajudar, a IA quase sempre só precisa saber que a variável existe, como TELEGRAM_BOT_TOKEN.
Valor real não vai em pedido, exemplo de curso nem arquivo enviado à IA sem necessidade.
O token do bot está na variável TELEGRAM_BOT_TOKEN do .env.
Crie o .gitignore antes do primeiro git commit. Ele não tira do histórico o que já entrou.
Na próxima aula, git status é a prova: o .env não pode aparecer.
git status não mostra o .env.
Se uma chave foi publicada ou colada por engano, a primeira correção é revogar a chave no site que a criou e gerar outra. Apagar a mensagem ou a linha não invalida a cópia que alguém já viu.
Só depois cuide do arquivo e do histórico.
1. Revogar e trocar. 2. Limpar o arquivo.
Na pasta meu-primeiro-agente. A chave é falsa, de treino.
cd %USERPROFILE%\projetos\meu-primeiro-agente echo MINHA_CHAVE=teste123> .env echo MINHA_CHAVE=preencha_localmente> .env.example echo .env> .gitignore echo .env.*>> .gitignore echo !.env.example>> .gitignore type .gitignore
.env .env.* !.env.example
- Nunca escreva chaves ou senhas em arquivo de texto; elas ficam no .env. - Se precisar de uma chave, cite o nome da variável, nunca o valor.
C:\Users\ana\projetos\meu-primeiro-agente> type .gitignore .env .env.* !.env.example
Um > cria o arquivo (ou substitui o conteúdo); dois >> acrescentam uma linha no fim.
echo .env > .gitignore grava ".env " com espaço no fim. Escreva colado: echo .env> .gitignore.Crie os arquivos e confira a lista.
Missões
MINHA_CHAVE=teste123..env (sem espaço antes do >)..env.*.!.env.example.Simulação: no seu cmd os comandos são os mesmos.
Antes de qualquer git commit.
Crie o .env com a chave falsa, o .env.example com o valor de mentira e o .gitignore com as três linhas. Acrescente a regra ao AGENTS.md.
Pronto quando: type .gitignore mostra .env, .env.* e !.env.example, e nenhum arquivo além do .env tem o valor teste123.
Escreva na ficha do projeto, para cada credencial que você usa (assinatura, token, chave), o site onde ela se troca.
Pronto quando: para cada credencial você sabe em que página revogar e gerar outra, sem procurar na hora do susto.
A explicação aparece depois da sua resposta.
Pergunta 1 de 3
Onde fica a chave de uma API no projeto?competência
Pergunta 2 de 3
Um colega pôs o .env no .gitignore uma semana depois da primeira versão. O .env saiu do histórico?
Pergunta 3 de 3
Você colou uma chave real num grupo por engano. Qual o primeiro passo?
Escolha uma alternativa. A explicação aparece depois da sua tentativa.