Cómo compartir claves de API y secretos sin ponerlos en Slack
Alguien del equipo necesita la DATABASE_URL de staging. Son las 4 de la tarde de un viernes. Las opciones de siempre son: mandarla por mensaje directo en Slack, enviarla por correo o pegarla en una página de Notion. Cada una deja la credencial en un sistema con una retención prácticamente infinita y un conjunto poco claro de personas que podrán leerla el año que viene.
Una entrega mejor es un enlace que apunta a bytes cifrados, donde el servidor que los guarda no puede leer el texto plano y el archivo se elimina tras una descarga. El proceso es lo bastante corto como para caber en los mismos cinco minutos que habrías gastado en montar una caja fuerte compartida en un gestor de contraseñas.
Por qué Slack, el correo y Notion no sirven para secretos
Un secreto pegado en Slack:
- Se queda en los dos historiales de mensajes hasta que alguien lo borra.
- Cualquiera del canal puede encontrarlo con el buscador, incluidas las personas que se añadan después.
- Aparece en la exportación de datos del espacio de trabajo cuando alguien deja la empresa.
- Está a un clic en el canal equivocado de que lo vea toda la empresa.
El correo es peor. Una credencial enviada por SMTP se almacena en el servidor de envío, en la bandeja de entrada del destinatario, en la política de archivo que haya configurado el equipo de TI y en cualquier copia de seguridad posterior. Rotar la clave cada 90 días no lo arregla: significa que la ventana de exposición dura 90 días, no que desaparezca.
Notion, Linear y Google Docs están pensados para que las cosas persistan. Es justo la propiedad equivocada para un secreto.
Por qué un gestor de secretos no siempre es la herramienta adecuada
1Password, Doppler, Vault e Infisical resuelven bien el caso de «muchos secretos, muchos consumidores». Añaden una carga real en el caso de «una credencial, una vez». Montar una caja fuerte compartida para una entrega puntual rara vez compensa, y la mayoría de los equipos se lo salta y vuelve a Slack.
El reparto aproximado: si una credencial la van a leer varias personas muchas veces, ponla en un gestor. Si se leerá una vez y después se rotará, un enlace de un solo uso encaja mejor.
Qué significa realmente «una descarga confirmada»
La credencial se cifra en el navegador antes de salir del dispositivo del remitente. La clave de cifrado se deriva de una contraseña que el servidor nunca ve. El servidor almacena texto cifrado, el hash de un token de descarga, un registro de subida y nada que pueda convertirse en texto plano.
La copia del servidor se elimina tras una descarga autenticada. Cargar la página de entrada no cuenta, y tampoco una descarga que se interrumpe: se reanuda donde se quedó o vuelve a empezar en el mismo navegador. El archivo se consume cuando se ha descargado entero y guardado. Si nadie lo descarga nunca, un TTL corto elimina el archivo cuando se cumple el plazo.
El servidor sigue guardando un registro de auditoría (token de la URL, marcas de tiempo, direcciones IP con hash y cifradas junto con su ubicación y red aproximadas, user agent, tamaño en bytes). Es intencionado: se usa para investigar abusos. No permite al operador leer tu archivo.
El proceso en 30 segundos
- Abre ttl.space.
- Cambia a Nota y pega el secreto; las notas son de un solo uso por defecto. Si es un archivo
.env, suéltalo y activa Eliminar tras lectura. - Copia el enlace y la contraseña generada de la página de confirmación. Son dos valores distintos.
- Envía el enlace y la contraseña por dos canales distintos: el enlace por Slack y la contraseña por SMS o Signal (o al revés). Un solo canal comprometido no debería dar acceso a los dos.
- El destinatario abre el enlace, introduce la contraseña y obtiene el secreto. El servidor elimina su copia. El enlace empieza a devolver un 404.
- Ves cuándo ocurrió en la página de confirmación o en Mis subidas; con Avisarme, tu navegador te lo notifica incluso después de cerrar la pestaña.
Desde una terminal es una sola línea: ttl send -b .env sube el archivo como enlace de un solo uso e imprime el enlace y una contraseña generada. Consulta la guía de la CLI.
En ningún momento el secreto queda en un historial de mensajes, en un almacenamiento en la nube ni en un archivo de correo.
Por qué repartirlo en dos canales. El enlace por sí solo es texto cifrado más un token; sin la contraseña no se puede descifrar. Enviar las dos cosas en el mismo hilo de Slack le quita la mitad del sentido, porque quien comprometa ese hilo obtiene ambas. Repartirlas obliga a un atacante a comprometer dos sistemas dentro de la ventana de tiempo anterior a la descarga.
Eliminar tras lectura frente a TTL
Eliminar tras lectura encaja en una entrega que va a ocurrir en los próximos minutos. La primera descarga que obtiene el archivo entero y lo guarda lo consume, y cualquier petición posterior recibe un 404. Una descarga que se interrumpe a medias no lo consume: continúa o vuelve a empezar en el mismo navegador.
El TTL encaja cuando el destinatario abrirá el archivo en un momento posterior incierto (por ejemplo, un colaborador externo que leerá las credenciales el lunes). Un TTL de 24 horas le da un margen y acota la exposición.
Límites
Si la credencial ya se está filtrando (guardada en el historial del shell, en un registro de CI o en una captura de pantalla que se subió automáticamente a algún sitio), rótala primero. Un enlace de vida corta evita copias futuras, no las que ya existen.
Esto no sustituye a un gestor de secretos a cierta escala. Es la herramienta para «un secreto, una persona, ahora mismo». Para un equipo que comparte decenas de credenciales a la semana, usa un gestor para lo recurrente y enlaces de un solo uso para las entregas que no deben estar en uno.
Eliminar tras lectura también se puede burlar si el destinatario hace una captura del contenido descifrado o lo pega de todos modos en una herramienta persistente. Si la credencial es así de sensible, la respuesta real es un token OAuth de corta duración, una llave de seguridad física o asumir un rol temporal, no un enlace. Para todo lo demás (una contraseña de base de datos, una clave de staging, el secreto de un webhook puntual), un enlace de un solo uso es un buen punto de partida.