Documentation de l’outil

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.

sh
curl https://plc.directory/did:plc:z72i7hdynmk6r22z27h6tvur/log/audit

La 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.

ChampCe qu’il contient
rotationKeysLes 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.
verificationMethodsLes clés du compte lui-même ; atproto est la clé de signature qui signe vos posts et vos enregistrements.
alsoKnownAsLes alias : la première entrée at:// est le handle.
servicesOù vit le compte : atproto_pds est son serveur (PDS) ; un labeler ajoute atproto_labeler.
prevLe CID de l’opération que celle-ci remplace, null pour la première.
sigLa signature de l’opération par l’une des rotationKeys précédentes.
json
{
  "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.endpoint passe au nouveau serveur ;
  • verificationMethods.atproto passe à la clé de signature du nouveau serveur ;
  • rotationKeys change, 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.

Historique PLC

Chaque changement de handle, de serveur et de clé d’un compte.