Clase 5 · 14 min
Una clave pegada en un documento, una captura de pantalla o un pedido da acceso a quien la lea, y sigue siendo válida después de que termina la conversación. Separar el secreto del resto, antes de guardar la primera versión, te permite compartir la carpeta sin miedo.
Empezar la lección
Objetivo: crear .env, .env.example y .gitignore antes del primer commit y saber qué hacer si se filtra una clave.
La lista de salas puede quedar a la vista; la clave, no.
Desplázate por la página: cada etapa ilumina su parte del diagrama.
Guarda variables: un nombre, un signo igual y un valor. No es una caja fuerte: no está cifrado; quien abre el archivo puede leerlo. Por eso se queda solo en tu máquina y nunca va a Git.
Los mismos nombres, con valores ficticios. Quien recibe el proyecto ve qué necesita completar, pero no obtiene acceso a nada. Recuerda: lo que termina en example es el ejemplo.
Cada línea es un patrón. .env incluye el archivo; .env.* incluye variantes como .env.local; la línea con ! abre una excepción y devuelve .env.example a la lista de lo que se guarda.
.gitignore solo se aplica a lo que Git aún no ha guardado. Si .env ya entró en un commit, escribir la línea después no lo quita del historial. Por eso la lista va antes de la primera versión.
El .env con el valor real se queda en casa, .env.example circula y .gitignore lo decide antes de que Git guarde cualquier versión. Una vez que el sobre salió, tachar el papel de la lista no lo trae de vuelta.
En la regla de AGENTS.md: "Nunca escribas claves ni contraseñas en un archivo de texto; se quedan en .env."
Haz clic en cada una.
Una contraseña, una clave de API y un token de bot permiten que quien los tenga actúe en nombre de tu cuenta, y tú pagas las consecuencias.
Antes de enviar una captura, mira las esquinas de la pantalla: una contraseña visible queda a la vista de todas las personas que la recibieron.
La misma pantalla, con la contraseña cubierta antes de enviarla.
Para ayudarte, la IA casi siempre solo necesita saber que la variable existe, como TELEGRAM_BOT_TOKEN.
No incluyas el valor real en una solicitud, un ejemplo del curso ni un archivo enviado a la IA si no es necesario.
El token del bot está en la variable TELEGRAM_BOT_TOKEN de .env.
Crea .gitignore antes del primer git commit. No quita del historial lo que ya entró.
En la próxima clase, git status es la prueba: .env no puede aparecer.
git status no muestra .env.
Si publicaste una clave o la pegaste por error, la primera corrección es revocarla en el sitio donde se creó y generar otra. Borrar el mensaje o la línea no invalida la copia que alguien ya vio.
Después, ocúpate del archivo y del historial.
1. Revoca y cambia. 2. Limpia el archivo.
En la carpeta meu-primeiro-agente. La clave es falsa, para practicar.
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 escribas claves ni contraseñas en un archivo de texto; van en .env. - Si necesitas una clave, menciona el nombre de la variable, nunca el valor.
C:\Users\ana\projetos\meu-primeiro-agente> type .gitignore .env .env.* !.env.example
Un > crea el archivo (o reemplaza el contenido); dos >> agregan una línea al final.
echo .env > .gitignore guarda ".env " con un espacio al final. Escríbelo pegado: echo .env> .gitignore.Crea los archivos y revisa la lista.
Misiones
MINHA_CHAVE=teste123..env (sin espacio antes de >)..env.*.!.env.example.Simulación: en tu cmd los comandos son los mismos.
Antes de cualquier git commit.
Crea el .env con la clave falsa, el .env.example con el valor ficticio y el .gitignore con las tres líneas. Agrega la regla a AGENTS.md.
Listo cuando: type .gitignore muestra .env, .env.* y !.env.example, y ningún archivo aparte de .env tiene el valor teste123.
Escribe en la ficha del proyecto, para cada credencial que usas (suscripción, token, clave), el sitio donde puedes cambiarla.
Listo cuando: para cada credencial sabes en qué página revocarla y generar otra, sin tener que buscar en un momento de apuro.
La explicación aparece después de tu respuesta.
Pregunta 1 de 3
¿Dónde va la clave de una API en el proyecto?competencia
Pregunta 2 de 3
Un compañero agregó .env a .gitignore una semana después de la primera versión. ¿Se eliminó .env del historial?
Pregunta 3 de 3
Pegaste una clave real en un grupo por error. ¿Cuál es el primer paso?
Elige una alternativa. La explicación aparece después de tu intento.