Le lien porte tout
Une invitation dans un espace de travail Buzz ressemble à n'importe quel lien d'invitation, mais le relais derrière ne tient aucune table d'invitations. Le code du lien est un HMAC : une signature générée avec une clé dérivée de l'identité propre du relais. Quand quelqu'un frappe à la porte avec le code, le relais recalcule la signature et compare. Elle correspond : entrez. Elle ne correspond pas : ce n'est pas un code qu'il a émis.
Ne rien stocker par invitation, c'est la partie élégante. Rien à fuiter, rien à nettoyer, rien qui puisse se désynchroniser, car la validité d'une invitation est une propriété des mathématiques, pas d'un enregistrement stocké.
Et tout ce qu'il porte comprend une horloge
Le code signé embarque une date d'expiration, et les nôtres plafonnent à 30 jours. Jusqu'à cet instant, quiconque détient le lien peut rejoindre l'espace. Ce n'est pas un défaut à faire disparaître à force d'ingénierie ; c'est la nature même d'un lien d'invitation. Un lien qu'on peut transférer est une porte que vous ne voyez pas, donc la seule forme sûre, c'est une vie courte et une rotation facile.
Traitez une invitation comme un badge visiteur, pas comme une carte d'accès : datée, remise sans formalité à l'accueil, et sans valeur le mois suivant.
La rotation est un interrupteur d'urgence que vous possédez déjà
Comme chaque invitation est signée avec une clé dérivée de l'identité du relais, faire tourner cette identité invalide d'un coup toutes les invitations en circulation. Aucune liste à purger, aucune table de révocation : les anciennes signatures ne passent simplement plus la vérification. Si un lien s'échappe là où vous le regrettez, une seule rotation ferme toutes les portes ouvertes, instantanément, gratuitement.
Publiez un pointeur, pas la clé
La conséquence pratique : ne mettez jamais l'invitation elle-même dans un endroit durable. Une page d'accueil, un README, une bio, une diapositive imprimée survivent tous à un code de 30 jours. Publiez une URL stable sous votre contrôle, et faites-la rediriger vers l'invitation en cours. La nôtre est hachiflow.com/hive : l'adresse sur notre page d'accueil ne change jamais, et ce vers quoi elle pointe tourne derrière elle.
C'est la même discipline que de ne jamais coder un secret en dur : la surface durable porte un nom, et ce nom se résout vers ce qui est valide à l'instant.
Nous l'avons appris sur notre propre page d'accueil
Le jour où nous avons mis notre propre invitation sur notre page d'accueil, l'invitation derrière le lien était déjà morte. L'identité de signature de l'espace avait tourné quelques jours plus tôt, après la création de cette invitation, et tout semblait en ordre jusqu'à ce que quelqu'un appuie sur le bouton. Comme la page d'accueil publiait l'URL stable et non l'invitation elle-même, le correctif a consisté à rediriger un seul pointeur vers une invitation toute neuve : pas de modification du texte, pas de déploiement du site, une ligne. Cet après-midi-là, c'est tout l'argument en faveur de ce schéma, démontré par nous, à nos propres dépens.