Proyectos y desarrollo
Secretos del equipo de desarrollo: claves API fuera del código y revocación si se filtran
Intermedio | 4 páginas de pizarra · Tablero de tareas: 5 columnas (4 tareas principales y 12 subtareas)
Intermedio: Aparecen los nombres de los métodos, pero la pizarra explica lo esencial. Guíate por los ejemplos y complétala reflexionando según tu propia situación.
Decide con tu equipo cómo mantener las claves API, las contraseñas de bases de datos y las claves privadas fuera del código, el chat y los tickets, y cómo revocarlas si se filtran. Una tabla recoge dónde se usa cada secreto, dónde está y quién lo gestiona, con un solo sitio por entorno. La hoja 2 revisa tres trampas (commits antiguos que conservan el valor borrado, pantallas y logs que lo muestran y portátiles con valores de producción). Un valor subido por error cuenta como filtrado y se revoca en el proveedor antes de reescribir el historial. Los 5 porqués y una matriz de impacto llevan a una regla de no escribirlos, un sistema de gestión y una revisión previa al commit. Un calendario de cambios con la forma de comprobar qué se detiene evita dejar claves viejas por miedo. Las contraseñas personales se cambian si se filtran o si se sospecha, no por calendario. La pizarra tiene 4 hojas y el tablero de tareas, 5 columnas, 4 tareas principales y 12 subtareas.
Con una cuenta gratuita, puedes copiar esta plantilla desde el mercado
Vista previa de la pizarra
Leer el contenido de la pizarra en formato texto
Gestión de secretos del equipo de desarrollo
Cómo usarla (4 hojas): ① Haz el inventario de secretos y anota dónde se dispersan → ② Decide dónde vive cada uno por entorno y revisa las trampas → ③ Busca por qué acaban en el código y elige las protecciones → ④ Crea el procedimiento ante fugas y el calendario de cambios
1/4 Inventariar los secretos
① Meta y alcance (empieza aquí)
- Meta ej. Sacar las claves API y las contraseñas del código y del chat, y poder frenar cualquiera que se filtre en 30 minutos
- Alcance ej. Pagos, envío de correo y base de datos, en 2 repositorios
- Plazo y quién coordina ej. 2 semanas. Coordina el líder de desarrollo y las revisiones se reparten entre todos
② Lista de secretos (uno por fila, sin escribir nunca el valor)
| Dónde se usa | Dónde está hoy | Responsable | Último cambio | |
|---|---|---|---|---|
| Clave API de pagos | ej. Procesar pedidos en producción | ej. Variable de entorno del servidor | ej. Líder de desarrollo | ej. Se desconoce (sin registro) |
| Contraseña de la BD | ej. Apps de producción y de pruebas | ej. Escrita directamente en un archivo de configuración | ej. Responsable de infraestructura | ej. Hace más de un año |
| Clave privada del certificado | ej. Servidor web de producción | ej. Archivo dentro del servidor | ej. Responsable de infraestructura | ej. Renovado antes del último vencimiento |
| Clave de envío de correo | ej. Envío de correos de aviso | ej. Sigue pegada en el chat | ej. Sin decidir | ej. Sin cambiar desde que se creó |
③ Dispersión: código y configuración
- ej. Una clave API escrita directamente en el código de pruebas
- ej. El archivo de configuración de ejemplo lleva un valor real
- Para cada caso, anota el nombre del archivo y qué valor es
④ Dispersión: chat y tickets
- ej. Un ticket de instrucciones lleva una contraseña escrita
- ej. Alguien pegó un valor en el chat con un mensaje para usar esa clave
- Para cada caso, anota dónde está y más o menos cuándo
⑤ Dispersión: dispositivos personales
- ej. Un archivo de clave de certificado descargado sigue en el escritorio
- ej. La contraseña de un certificado está en una app de notas
- Para cada caso, anota de quién es el dispositivo y qué valor es
2/4 Decidir dónde viven
⑥ Reglas de guardado por entorno (adónde mover los secretos de ②)
| Desarrollo | Pruebas | Producción | |
|---|---|---|---|
| Dónde se guarda | ej. Archivo de configuración de cada dispositivo (solo valores de desarrollo) | ej. Servicio de gestión de secretos | ej. Servicio de gestión de secretos |
| Quién puede leerlo | ej. Todo el equipo de desarrollo | ej. Desarrollo y pruebas | ej. Dos personas de operaciones y la propia app |
| Cómo se entrega | ej. Cada uno lo recoge del servicio de gestión | ej. Se carga solo al desplegar | ej. Se carga al ejecutar y nunca se muestra a nadie |
| Dónde no escribirlo | ej. Código, chat y tickets | ej. Código, chat y tickets | ej. Código, chat, tickets y dispositivos personales |
⑦ Trampa: un valor subido queda en el historial
- Qué ocurre: ej. Borrarlo del archivo lo deja en los commits pasados, y cualquiera que vea el repositorio puede leerlo
- Cómo comprobarlo: ej. Mira si algún secreto de ② se subió alguna vez, con la búsqueda del repositorio o los resultados de una herramienta de detección de secretos
- Cómo evitarlo: ej. Da por filtrado el valor subido y revócalo y cámbialo en el proveedor antes de reescribir el historial
- Resultado de la revisión: ej. Revisados 2 repositorios. Hay 1 caso → cambiado con los pasos de ⑮
⑧ Trampa: los valores salen en pantallas y logs
- Qué ocurre: ej. Pantallas compartidas, capturas, logs de errores y salidas de depuración muestran el valor tal cual
- Cómo comprobarlo: ej. Mira en la configuración y en la salida de los logs si los campos secretos salen enmascarados
- Cómo evitarlo: ej. Enmascara los valores antes de que lleguen a los logs y cierra los archivos de configuración antes de compartir pantalla
- Resultado de la revisión: ej. El log de errores mostraba la contraseña de la BD junto al destino de conexión → añadido el enmascaramiento
⑨ Trampa: configuración en dispositivos personales
- Qué ocurre: ej. Un valor de producción queda en el archivo de un portátil personal y sigue sirviendo aunque se pierda el dispositivo o la persona cambie de puesto
- Cómo comprobarlo: ej. Pregunta a los dueños de los dispositivos de ⑤ y a los responsables de ② si algún archivo de desarrollo lleva un valor de producción, y mira en la consola del proveedor el nombre de la clave, la nota y el registro de uso (lo que se ve cambia según el servicio, así que consulta su guía)
- Cómo evitarlo: ej. Deja solo valores de desarrollo en los dispositivos personales y haz que los de producción se lean del servicio de gestión al ejecutar
- Resultado de la revisión: ej. Claves de producción en 2 dispositivos → borradas y cambiadas
3/4 Buscar por qué se cuelan
⑩ Los 5 porqués (elige un caso de ③–⑤ y ⑦–⑨ y pregunta 5 veces por qué entró)
- Por qué 1 ej. ¿Por qué estaba la contraseña de la BD de producción escrita en un archivo de configuración? → Quería que funcionara enseguida en mi ordenador
- Por qué 2 ej. ¿Por qué escribirla directamente en el archivo para que funcionara enseguida? → Nadie había decidido de dónde leer el valor
- Por qué 3 ej. ¿Por qué no se había decidido? → No se separaba el guardado por entorno
- Por qué 4 ej. ¿Por qué no se separaba? → Al principio se desarrollaba en solitario y no daba problemas
- Por qué 5 ej. ¿Por qué no se revisó al crecer el equipo? → Nadie era responsable de los secretos
- Causa raíz ej. No hay reglas de guardado y entrega, y nadie es responsable
⑪ Ordena los secretos de ② por impacto si se filtran y facilidad de cambio
Eje vertical: Impacto si se filtra (arriba = mayor) / Eje horizontal: Facilidad de cambio (izquierda = más difícil, derecha = más fácil)
- Impacto alto, difícil de cambiar Primero crea una forma de cambiarlo sin parar nada ej. Contraseña de la BD (la usan muchas apps)
- Impacto alto, fácil de cambiar Pásalo ya al servicio de gestión y cámbialo ej. Clave API de pagos (se emite una nueva en la consola)
- Impacto bajo, difícil de cambiar Haz un calendario y pásalos por turnos ej. Contraseña de conexión de una herramienta interna antigua
- Impacto bajo, fácil de cambiar Pásalos juntos en el próximo cambio ej. Clave de envío de correo de desarrollo
⑫ Regla de no escribirlos
- ej. No escribir valores en código, chat ni tickets. Se escribe solo dónde están
- ej. Poner valores ficticios en el archivo de configuración de ejemplo
- Anota quién se encarga de la regla y cuándo empieza
⑬ Sistema de gestión
- ej. Elegir un servicio de gestión de secretos y reunir allí todos los sitios de guardado
- ej. Repartir quién puede leer por roles y limitar producción a 2 personas
- Anota quién se encarga del sistema y cuándo empieza
⑭ Revisión previa al commit
- ej. Ejecutar en todos los dispositivos una herramienta que detecte secretos antes de cada commit
- ej. Añadir a la lista de la revisión de código un punto sobre valores escritos directamente en el código
- Anota quién se encarga de la revisión y cuándo empieza
4/4 Montar pasos y calendario
⑮ Los 5 pasos si se filtra (aplícalos al secreto de impacto alto de ⑪)
- Avisar Quien lo note avisa enseguida ej. Escribe al contacto que fijó el equipo qué ha salido y dónde. Sin culpar a nadie
- Revocar Detén el valor antiguo en el proveedor ej. Desactiva la clave filtrada en la consola del servicio de pagos
- Cambiar Emite un valor nuevo y sustitúyelo en el sitio de guardado ej. Mete la clave nueva en el servicio de gestión y recarga producción
- Buscar rastros Mira si hay señales de uso ej. Revisa el historial de uso y la facturación del proveedor por si hay usos que no reconoces
- Anotar la causa Anota por qué salió y úsalo para mejorar el sistema ej. Analízalo con ⑩ y añade reglas a ⑫–⑭
⑯ Calendario de cambios (empieza por arriba a la derecha y arriba a la izquierda de ⑪)
| Próximo cambio | Cómo comprobar qué se detiene | Responsable | |
|---|---|---|---|
| Clave API de pagos | ej. Segunda semana de este mes | ej. Usar la clave nueva y la vieja a la vez, ver que pasan los pedidos y parar la vieja | ej. Líder de desarrollo |
| Contraseña de la BD | ej. Primera semana del mes que viene | ej. Contar en ② las apps que la usan, cambiar primero en pruebas y luego en producción | ej. Responsable de infraestructura |
| Clave privada del certificado | ej. Un mes antes del vencimiento | ej. Contar en ② los servidores con el certificado, cambiarlo en pruebas y ver que conectan, y luego en producción | ej. Responsable de infraestructura |
| Clave de envío de correo | ej. Este mes (antes por haber estado pegada en el chat) | ej. Ver en pruebas que llegan los correos de aviso | ej. Una persona del equipo de desarrollo |
⑰ Explicación para los nuevos (se entrega el primer día)
- Dónde no escribirlos y dónde guardarlos ej. No escribir valores en código, chat ni tickets. Se leen del sitio de ⑥
- Trampa: dejar una clave por miedo a que el cambio pare algo Qué ocurre ej. Una clave vieja se usa durante años y una fuga pasa sin notarse Cómo comprobarlo ej. Ver que ⑯ tiene responsable y fecha en todas las filas Cómo evitarlo ej. Usar la nueva y la vieja a la vez y luego parar la vieja
- Si crees que se filtró ej. No se culpa a nadie, así que avisa enseguida al contacto del paso 1 de ⑮
Contenido del tablero de tareas
Sin empezar 16 elementos
Hacer el inventario
En la hoja 1, escribe la meta y el alcance y lista los secretos y dónde están dispersos. Con la lista hecha, las hojas siguientes deciden dónde guardarlos y por qué acaban dispersos. Pulsa Ctrl+F (⌘F en Mac) y escribe 3/4 para ir a la hoja 3.
Listar las claves
Abre la lista de claves API en la consola de cada servicio externo que uses, como pagos, correo o nube, y copia el nombre y el uso de cada clave en las filas del tablero ②. Lleva unos 15 minutos y termina cuando haya 3 nombres o más. Nunca escribas el valor.
Meta y alcance
En el tablero ①, escribe la meta, los servicios y repositorios incluidos, el plazo y quién coordina. Terminado cuando las 3 notas estén rellenas.
Mapear dispersión
En los tableros ③–⑤, escribe dónde hay secretos en código y archivos de configuración, en chat y tickets y en dispositivos personales. Terminado cuando cada recuadro tenga al menos 1 caso real.
Decidir ubicaciones
En la hoja 2, decide dónde vive cada secreto de ② en cada entorno y revisa 3 trampas. Con un solo sitio para cada uno, en la hoja 3 será más fácil elegir las protecciones.
Reglas por entorno
En la tabla del tablero ⑥, escribe dónde se guarda, quién puede leerlo, cómo se entrega y dónde no escribirlo en desarrollo, pruebas y producción. Terminado cuando las 12 casillas estén rellenas.
Historial y logs
En los tableros ⑦ y ⑧, comprueba si quedan valores en commits pasados o si se ven en pantallas y logs, y anota el resultado en la nota de revisión.
Revisar dispositivos
En el tablero ⑨, toma los dispositivos anotados en ⑤ como pista y pregunta a sus dueños si hay valores de producción en archivos de configuración de desarrollo; anota el resultado. Si aparece uno, cambia esa clave con los pasos de ⑮.
Buscar las causas
En la hoja 3, busca por qué los secretos acaban en el código y el chat, y elige los secretos que van primero y las protecciones. Lo que decidas aquí es la base de los pasos y el calendario de la hoja 4.
Cinco porqués
En el tablero ⑩, elige un caso de ③–⑤ y ⑦–⑨, pregunta cinco veces por qué entró y escribe la causa raíz en el último paso.
Ordenar por impacto
En el tablero ⑪, reparte los secretos de ② en 4 grupos según el impacto si se filtran y lo fácil que es cambiarlos. Los de arriba a la derecha y arriba a la izquierda van primero.
Elegir protecciones
En los tableros ⑫–⑭, decide una regla de no escribirlos, un sistema de gestión y una revisión previa al commit. Terminado cuando tengan responsable y fecha de inicio.
Crear procedimiento
En la hoja 4, crea los pasos para revocar y cambiar un secreto filtrado, el calendario de cambios y la explicación para los nuevos. Copia los pasos terminados al documento del equipo y déjalos en la columna Pendiente de revisión hasta leerlos juntos.
Definir los 5 pasos
En los 5 pasos de ⑮, escribe a quién se avisa, dónde se revoca y qué se comprueba. Pruébalos con un secreto de impacto alto en ⑪ y termina cuando no quede ninguna duda.
Planificar cambios
En la tabla de ⑯, escribe para cada secreto cuándo se cambia, cómo comprobar qué se detiene y quién se encarga. Terminado cuando todas las filas tengan fecha.
Guía para novatos
En ⑰, escribe dónde no escribirlos y dónde guardarlos, por qué no dejar los cambios pendientes y a quién avisar si crees que se filtró. Terminado cuando una persona nueva pueda leerlo el primer día.