Handles e DID: como funciona a identidade no Bluesky
Cada conta do Bluesky tem dois nomes. O seu handle, como alice.bsky.social, é um nome de domínio que as pessoas leem, e pode mudar. O seu DID, como did:plc:…, é um identificador permanente pensado para o software. Cada um aponta para o outro, e as apps verificam os dois sentidos antes de mostrarem um handle.
Revisto pela última vez a 14 de novembro de 2026
Na maioria das redes sociais, o seu nome de utilizador é uma linha na base de dados de uma única empresa. No Bluesky, a identidade de uma conta não pertence a nenhum servidor em particular: assenta em dois nomes públicos, que qualquer app pode verificar por si própria.
Dois nomes para uma só conta
- O handle é o nome que as pessoas leem, como
alice.bsky.social. É um nome de domínio e pode mudar. As apps mostram-no muitas vezes com um @ à frente, mas o @ não faz parte do handle. - O DID (identificador descentralizado) é o identificador permanente da conta, como
did:plc:ewvi7nxzyoun6zhxrhs64oiz. É uma norma do W3C, feita para o software mais do que para as pessoas, e nunca muda.
O DID é a verdadeira identidade da conta. As apps resolvem um handle no seu DID e depois usam o DID em todo o lado. Assim, quando muda de handle, as suas publicações e os seus seguidores ficam consigo; quando passa para outro PDS, o seu DID também fica. Os dados da rede são endereçados por AT URI, como at://did:plc:…/app.bsky.feed.post/…: os que são escritos com o DID continuam a funcionar depois de uma mudança de handle.
did:plc e did:web
A norma DID prevê muitos métodos para criar e resolver identificadores. O AT Protocol aceita dois.
- did:plc é o método criado para o AT Protocol, desenvolvido pela Bluesky Social PBC em 2022. O próprio DID é o hash da primeira operação assinada da identidade. O controlo da identidade cabe a algumas chaves de rotação: assinam cada atualização, como um novo endereço de PDS ou uma nova chave de assinatura. O PLC directory recolhe estas atualizações, serve o estado atual de cada DID e mantém um registo público do seu histórico. Se uma atualização estava errada ou era maliciosa, uma chave de rotação com mais prioridade pode anulá-la durante uma janela de recuperação, hoje de 72 horas. Não usa nenhuma blockchain.
- did:web está ligado a um nome de domínio:
did:web:example.comé publicado por HTTPS peloexample.com. É simples, mas não permite passar para outro domínio nem recuperar a identidade se perder o controlo do domínio. O AT Protocol só o aceita para um nome de anfitrião completo, não para um caminho. Serve a quem tem a certeza de que vai manter o seu domínio.
O did:plc é o mais usado dos dois, e o que resiste à perda de um servidor ou de um domínio, graças às suas chaves de rotação e à sua janela de recuperação.
Para ir mais longe. Qualquer pessoa pode ler um
did:plcno diretório:https://plc.directory/<did>devolve o seu documento DID atual, ehttps://plc.directory/<did>/log/audito seu histórico.
O documento DID
Resolver um DID dá um pequeno documento JSON, o documento DID. Para o AT Protocol, contam três coisas nele:
- o handle que a conta reivindica, em
alsoKnownAs, escrito comoat://seguido do handle; - a chave de assinatura pública da conta, que verifica as assinaturas do seu repositório, na entrada
#atproto; - o endereço do seu PDS, no serviço
#atproto_pds.
Um exemplo abreviado:
{
"id": "did:plc:ewvi7nxzyoun6zhxrhs64oiz",
"alsoKnownAs": ["at://alice.example.com"],
"verificationMethod": [{ "id": "did:plc:ewvi7nxzyoun6zhxrhs64oiz#atproto", "type": "Multikey" }],
"service": [{ "id": "#atproto_pds", "type": "AtprotoPersonalDataServer", "serviceEndpoint": "https://pds.example.com" }]
}A chave de assinatura só assina os dados da conta. Com did:plc, não tem qualquer controlo sobre a identidade, a não ser que seja também uma das chaves de rotação, e a prática recomendada é manter as duas separadas.
Como é verificado um handle
Um handle só é de confiança quando a ligação funciona nos dois sentidos: o handle aponta para o DID, e o documento DID nomeia o handle de volta. Caso contrário, qualquer pessoa poderia fazer-se passar pela conta de outra.
- Handlealice.example.comUm registo DNS ou um ficheiro web no domínio dá o DID.
- DIDdid:plc:ewvi7nxz…O identificador permanente. Ao resolvê-lo, obtém-se o documento DID.
- Documento DIDat://alice.example.comNomeia o handle de volta, com o PDS e a chave de assinatura.
- Os dois sentidos coincidemAs apps mostram o handle. Caso contrário, mostram handle.invalid.
O handle aponta para o seu DID de uma de duas formas:
- Um registo DNS. Um registo TXT em
_atproto.seguido do handle, com o valordid=seguido do DID. É a forma recomendada para um handle isolado. - Um ficheiro web. Um pedido HTTPS a
/.well-known/atproto-didno domínio do handle devolve o DID, em texto simples e nada mais. Esta forma destina-se a serviços que alojam muitos handles e não conseguem adicionar um registo DNS para cada um.
_atproto.alice.example.com TXT "did=did:plc:ewvi7nxzyoun6zhxrhs64oiz"GET https://alice.example.com/.well-known/atproto-did
did:plc:ewvi7nxzyoun6zhxrhs64oizQuando os dois sentidos deixam de coincidir, por exemplo porque o registo ou o ficheiro desapareceu, as apps mostram handle.invalid em vez do handle. A conta mantém o seu DID, as suas publicações e os seus seguidores; precisa de um handle que volte a ser verificado.
Use o seu próprio domínio
Qualquer domínio ou subdomínio que controle pode ser o seu handle: na app Bluesky, escolha usar o seu próprio domínio, adicione o registo DNS indicado com o seu DID e confirme. O guia de handles de domínio do Bluesky descreve os passos, e as opções para um handle personalizado são comparadas nos nossos guias. O seu último handle .bsky.social fica reservado para si.
Um handle de domínio liga a sua conta ao seu site, e é por isso que o Bluesky o apresenta como uma forma de verificação. Não é o selo azul de verificação, um sistema à parte que o Bluesky introduziu em abril de 2025.
As regras de um handle
- Apenas letras ASCII, algarismos e hífenes, em partes separadas por pontos, com pelo menos duas partes.
- Cada parte tem de 1 a 63 caracteres e não pode começar nem acabar com um hífen; a última parte, o domínio de topo, não pode começar por um algarismo.
- O handle completo tem no máximo 253 caracteres, e na prática 244, para que o nome do seu registo DNS
_atproto.continue a caber. - Os handles não distinguem maiúsculas de minúsculas: as apps guardam-nos e mostram-nos em minúsculas.
- Alguns domínios de topo são recusados, como
.local,.onion,.internal,.localhost,.arpa,.example,.invalide.alt.
Um serviço que atribui handles sob o seu próprio domínio pode acrescentar as suas próprias regras, como um comprimento mínimo ou palavras reservadas.
Como o Bluesky.bot usa isto
O Bluesky.bot usa o método do ficheiro web. Cada handle name.bluesky.bot responde a /.well-known/atproto-did com o DID do seu bot e, assim que o bot o adota, o documento DID do bot nomeia name.bluesky.bot de volta. Antes de um bot mostrar Ao vivo no Bluesky, o Bluesky.bot pergunta à API pública do Bluesky se os dois sentidos coincidem. Como é verificado um bot.
Perguntas frequentes
- Como encontro o meu DID?
- O seu DID é público. Na app Bluesky, o ecrã para usar o seu próprio domínio como handle mostra-o, no registo DNS que lhe pede para adicionar (did=did:plc:…). Os programadores podem resolver qualquer handle no seu DID com com.atproto.identity.resolveHandle e consultar um did:plc no PLC directory.
- O que acontece ao meu DID se mudar de handle?
- Nada: o seu DID continua o mesmo, tal como as suas publicações e os seus seguidores. As menções ao seu antigo handle continuam a levar à sua conta. Só muda o nome legível, e o novo handle tem de ser verificado nos dois sentidos.
- O que significa handle.invalid?
- As apps mostram handle.invalid quando o handle de uma conta e o seu DID deixam de se confirmar um ao outro, por exemplo quando o registo DNS ou o ficheiro web que provava o handle desapareceu. A conta mantém o seu DID, as suas publicações e os seus seguidores; precisa de um handle que volte a ser verificado.