Comment lire un historique de l’annuaire PLC
Ce qu’est l’annuaire PLC, les champs d’une opération did:plc (clés de rotation, méthodes de vérification, alias, services, prev, sig), l’annulation et les tombstones.
Ce qu’est l’annuaire PLC
did:plc est la méthode DID qu’utilisent presque tous les comptes Bluesky. Son registre, l’annuaire PLC (plc.directory), est un service public qui garde, pour chaque identité, la liste signée de toutes les modifications qui lui ont été apportées. Tout le monde peut la lire : le document actuel à GET /{did}, le journal complet à GET /{did}/log/audit.
curl https://plc.directory/did:plc:z72i7hdynmk6r22z27h6tvur/log/auditLa réponse est une liste d’entrées, de la plus ancienne à la plus récente. Chaque entrée contient une opération signée et ce que l’annuaire y ajoute : cid (l’empreinte du contenu de l’opération), nullified et createdAt (quand l’annuaire l’a reçue).
Les champs d’une opération
Une plc_operation contient tout l’état de l’identité, pas seulement ce qui a changé : pour trouver le changement, il faut la comparer à l’opération précédente, comme le fait l’outil.
| Champ | Ce qu’il contient |
|---|---|
rotationKeys | Les clés autorisées à signer l’opération suivante, la première ayant la plus haute priorité. En général la clé de votre serveur, parfois votre propre clé de récupération. |
verificationMethods | Les clés du compte lui-même ; atproto est la clé de signature qui signe vos posts et vos enregistrements. |
alsoKnownAs | Les alias : la première entrée at:// est le handle. |
services | Où vit le compte : atproto_pds est son serveur (PDS) ; un labeler ajoute atproto_labeler. |
prev | Le CID de l’opération que celle-ci remplace, null pour la première. |
sig | La signature de l’opération par l’une des rotationKeys précédentes. |
{
"type": "plc_operation",
"rotationKeys": ["did:key:zQ3sh…"],
"verificationMethods": { "atproto": "did:key:zQ3sh…" },
"alsoKnownAs": ["at://alice.example.com"],
"services": {
"atproto_pds": {
"type": "AtprotoPersonalDataServer",
"endpoint": "https://pds.example.com"
}
},
"prev": "bafyrei…",
"sig": "…"
}Les plus anciennes identités ont commencé par une opération create de 2022, à l’ancien format, avec les champs signingKey, recoveryKey, handle et service. L’outil la lit comme le fait l’implémentation de référence : la clé de signature devient la méthode atproto, [recoveryKey, signingKey] les clés de rotation, le handle un alias at:// et le service le atproto_pds.
Annulation et récupération
Les clés de rotation sont classées par priorité. Pendant les 72 heures qui suivent une opération, une clé plus prioritaire que celle qui l’a signée peut signer une autre opération avec le même prev : l’annuaire marque alors la première nullified: true et l’identité suit la nouvelle. C’est ainsi qu’une clé de récupération reprend une identité après une modification non voulue.
Une opération annulée reste dans le journal : l’outil la garde donc dans la chronologie avec un badge « Annulée », et compare les opérations suivantes à la dernière opération valide.
Les tombstones
Une plc_tombstone désactive l’identité dans le registre : elle n’a pas d’état, seulement prev et sig. Comme toute opération, elle peut être annulée dans les 72 heures par une clé de rotation plus prioritaire que celle qui l’a signée, ce qui rétablit l’identité. Une fois ce délai passé, le DID ne mène plus à aucun document et aucune opération ne peut suivre. L’outil affiche l’identité comme « Désactivée », et une tombstone annulée avec son badge « Annulée ».
Comment lire un déménagement
Quand un compte déménage vers un autre serveur, son nouveau serveur prend la main sur l’identité en une seule opération, signée par la clé de rotation de l’ancien serveur :
services.atproto_pds.endpointpasse au nouveau serveur ;verificationMethods.atprotopasse à la clé de signature du nouveau serveur ;rotationKeyschange, la clé de l’ancien serveur remplacée par celle du nouveau.
Un déménagement de serveur avec de nouvelles clés de rotation en moins d’une journée, c’est donc à quoi ressemble une migration, mais aussi un piratage de compte : l’outil ajoute une note quand il en voit un. Si vous n’avez pas déménagé votre compte, contactez l’hébergeur de votre serveur. Pour donner à un bot un handle reconnaissable sans le déménager, voir Obtenir votre handle.