El enlace lo lleva todo
Una invitación a un espacio de trabajo de Buzz parece un enlace de invitación cualquiera, pero el relay que hay detrás no guarda ninguna tabla de invitaciones. El código del enlace es un HMAC: una firma generada con una clave derivada de la propia identidad del relay. Cuando alguien llama a la puerta con el código, el relay recalcula la firma y compara. Si coincide, adelante. Si no coincide, no es un código que haya emitido él.
No guardar nada por invitación es la parte elegante. No hay nada que filtrar, nada que limpiar y nada que se desincronice, porque la validez de una invitación es una propiedad de las matemáticas, no de un registro guardado.
Todo lo que lleva incluye un reloj
El código firmado incorpora una caducidad, y las nuestras llegan como máximo a 30 días. Hasta ese momento, cualquiera que tenga el enlace puede unirse. No es un defecto que haya que eliminar a base de ingeniería; es lo que es un enlace de invitación. Un enlace que se puede reenviar es una puerta que no ves, así que la única forma segura es una vida corta y una rotación fácil.
Trata una invitación como una acreditación de visitante, no como una tarjeta de acceso: con fecha, entregada sin problema en el mostrador y sin ningún valor el mes siguiente.
La rotación es un interruptor de emergencia que ya tienes
Como cada invitación se firma con una clave derivada de la identidad del relay, rotar esa identidad invalida de una vez todas las invitaciones pendientes. No hay lista que purgar ni tabla de revocaciones: las firmas viejas simplemente dejan de verificarse. Si un enlace se escapa a algún sitio del que te arrepientes, una rotación cierra todas las puertas abiertas, al instante, gratis.
Publica un puntero, no la llave
La consecuencia práctica: nunca pongas la invitación en sí en ningún sitio duradero. Una página de inicio, un README, una bio, una diapositiva impresa: todos sobreviven a cualquier código de 30 días. Publica una URL estable que controles y haz que redirija a la invitación vigente. La nuestra es hachiflow.com/hive: la dirección de nuestra página de inicio nunca cambia, y aquello a lo que apunta rota por detrás.
Es la misma disciplina que no escribir nunca una credencial a fuego en el código: la superficie duradera lleva un nombre, y el nombre se resuelve en lo que sea válido en ese momento.
Lo aprendimos en nuestra propia página de inicio
El día que pusimos nuestra propia invitación en nuestra página de inicio, la invitación detrás del enlace ya estaba muerta. La identidad de firma del espacio de trabajo había rotado unos días antes, después de que se generara esa invitación, y todo parecía estar bien hasta que alguien pulsó el botón. Como la página de inicio publicaba la URL estable y no la invitación en sí, el arreglo fue actualizar un puntero a una invitación recién generada: ni un cambio de texto ni un despliegue de la web, una línea. Esa tarde es todo el argumento a favor de este patrón, hecho por nosotros, a nuestra costa.