Como ler um histórico do diretório PLC
O que é o diretório PLC, os campos de uma operação did:plc (chaves de rotação, métodos de verificação, alias, serviços, prev, sig), a anulação e os tombstones.
O que é o diretório PLC
did:plc é o método DID que quase todas as contas Bluesky usam. O seu registo, o diretório PLC (plc.directory), é um serviço público que guarda, para cada identidade, a lista assinada de todas as alterações que lhe foram feitas. Qualquer pessoa a pode ler: o documento atual em GET /{did}, o registo completo em GET /{did}/log/audit.
curl https://plc.directory/did:plc:z72i7hdynmk6r22z27h6tvur/log/auditA resposta é uma lista de entradas, da mais antiga para a mais recente. Cada entrada contém uma operação assinada e o que o diretório lhe acrescenta: cid (o hash do conteúdo da operação), nullified e createdAt (quando o diretório a recebeu).
Os campos de uma operação
Uma plc_operation contém todo o estado da identidade, não só o que mudou: para encontrar a alteração, é preciso compará-la com a operação anterior, como faz a ferramenta.
| Campo | O que contém |
|---|---|
rotationKeys | As chaves autorizadas a assinar a operação seguinte; a primeira tem a prioridade mais alta. Normalmente a chave do seu servidor, por vezes a sua própria chave de recuperação. |
verificationMethods | As chaves da própria conta; atproto é a chave de assinatura que assina as suas publicações e registos. |
alsoKnownAs | Os alias: a primeira entrada at:// é o handle. |
services | Onde vive a conta: atproto_pds é o seu servidor (PDS); um labeler acrescenta atproto_labeler. |
prev | O CID da operação que esta substitui, null para a primeira. |
sig | A assinatura da operação por uma das rotationKeys anteriores. |
{
"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": "…"
}As identidades mais antigas começaram com uma operação create de 2022, no formato antigo, com os campos signingKey, recoveryKey, handle e service. A ferramenta lê-a como a implementação de referência: a chave de assinatura passa a ser o método atproto, [recoveryKey, signingKey] as chaves de rotação, o handle um alias at:// e o serviço o atproto_pds.
Anulação e recuperação
As chaves de rotação estão ordenadas por prioridade. Durante as 72 horas seguintes a uma operação, uma chave com mais prioridade do que a que a assinou pode assinar outra operação com o mesmo prev: o diretório marca então a primeira como nullified: true e a identidade segue a nova. É assim que uma chave de recuperação recupera uma identidade depois de uma alteração indesejada.
Uma operação anulada fica no registo, por isso a ferramenta mantém-na na cronologia com uma etiqueta «Anulada» e compara as operações seguintes com a última válida.
Os tombstones
Uma plc_tombstone desativa a identidade no registo: não tem estado, só prev e sig. Como qualquer operação, pode ser anulada em menos de 72 horas por uma chave de rotação com mais prioridade do que a que a assinou, o que restabelece a identidade. Passado esse prazo, o DID já não leva a nenhum documento e nenhuma operação a pode seguir. A ferramenta mostra a identidade como «Desativada», e uma tombstone anulada com a sua etiqueta «Anulada».
Como ler uma mudança de servidor
Quando uma conta muda para outro servidor, o novo servidor assume a identidade numa única operação, assinada pela chave de rotação do servidor antigo:
services.atproto_pds.endpointpassa para o novo servidor;verificationMethods.atprotopassa para a chave de assinatura do novo servidor;rotationKeysmuda: a chave do servidor antigo é substituída pela do novo.
Por isso, uma mudança de servidor com chaves de rotação novas em menos de um dia é o aspeto de uma migração, e também o de uma conta roubada: a ferramenta acrescenta uma nota quando a vê. Se não mudou a sua conta de servidor, contacte quem aloja o seu servidor. Para dar a um bot um handle reconhecível sem o mudar de servidor, consulte Obter o seu handle.