Bluesky: nome de utilizador inválido e soluções

Um nome inválido costuma indicar que não é possível confirmar o nome e a conta nos dois sentidos. Identifique a verificação que falha antes de alterar o DNS ou criar outra conta.

Por A equipa do Bluesky.bot

Publicado:
Atualizado:
Revisto:

A resposta curta

O Bluesky precisa de duas provas coincidentes: o nome aponta para o DID da conta e o documento desse DID reclama o mesmo nome. handle.invalid é o valor da API quando esta relação não pode ser confirmada; não é um domínio para registar. Uma aplicação também pode mostrar uma resposta antiga em cache. A especificação Handle define os dois sentidos.

Verifique o seu nome agora

Este formulário GET abre o verificador existente. Acrescente aí o DID da conta esperada se o domínio apontar para outra conta. Não precisa de iniciar sessão.

⚠️Nome de utilizador inválido

Mensagens exatas da aplicação Bluesky

  • Falha ao tentar alterar nome de utilizador. Tente novamente.
  • Falha ao tentar alterar o nome de utilizador. Por favor, tente novamente.
  • Nome de utilizador inválido. Por favor, tente um diferente.
  • Não foi possível resolver o nome de utilizador

Traduções da aplicação verificadas em 16 de novembro de 2026; versões posteriores podem alterar o texto. Fonte

Os textos citados vêm de uma versão específica das traduções do Bluesky, verificada em 16 de novembro de 2026. Um erro ao guardar ou verificar é um sintoma, não prova de que um registo DNS específico está errado.

Como funciona a verificação bidirecional

Confirmação do nome nos dois sentidos
  1. 1. Nome → prova DNS TXT ou HTTPS
  2. 2. Prova → DID da conta
  3. 3. Documento DID → alsoKnownAs: at://nome

Basta um método direto: um TXT em _atproto.<nome> cujo valor começa por did=, ou o ficheiro HTTPS apenas com o DID. O documento DID tem depois de reclamar at://<nome>. Leia nomes e DIDs e a especificação DID para perceber a identidade.

Qual dos sentidos falha?

  1. Nem DNS nem HTTPS devolvem um DID: veja o nome e valor TXT, ou o estado e corpo do ficheiro. Um erro de rede significa «não foi possível verificar», não «nome abandonado».
  2. Devolvem outro DID: compare-o com a conta pretendida. Não copie o DID de um exemplo nem altere um domínio de outra conta.
  3. DID correto, outro nome no sentido inverso: volte a selecionar o nome nessa conta. Alterar DNS não atualiza o documento DID.
  4. Ambos os sentidos funcionam, mas uma aplicação mostra o nome antigo: compare a AppView, aguarde a atualização das caches e repita a verificação nas definições.
  5. A conta foi eliminada, desativada ou suspensa: mudar DNS não a restaura. Resolva primeiro o estado com o fornecedor de alojamento.

Falta o TXT ou está no nome errado

O que vê: dns: missing, ou dns: wrong_host com o nome onde o registo foi encontrado. Na zona example.com, voce.example.com precisa do nome relativo _atproto.voce. Alguns painéis acrescentam a zona e podem criar _atproto.voce.example.com.example.com ao receber o nome completo.

Correção: confirme o nome completo resultante, não apenas o texto introduzido. Coloque uma única prova DID em _atproto.voce.example.com. Não precisa de TXT se já funcionar uma prova HTTPS válida. O guia do Bluesky também apresenta subdomínios.

As saídas datadas usam o motor real do verificador com respostas de teste injetadas, DIDs fictícios e nomes reservados de example.com. São exemplos controlados, não consultas DNS em direto, casos de utilizadores ou um teste do domínio real do projeto. Cada captura declara a sua proveniência. Nenhum DNS nem conta foi alterado: segue-se a opção inicial prevista sem domínios de teste ativos.

Exemplo capturado: sem TXT nem prova HTTPS
Capturado em

Entrada

Controlled fixture: checkHandleSetup({"domain":"missing-txt.example.com","expected":"did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"})

Saída capturada

{
  "provenance": "Controlled dependency fixture; no live DNS, HTTP, DID or AppView request. Fictional DIDs and reserved example.com names.",
  "observations": {
    "txt": {},
    "https": {
      "status": 404,
      "text": "Not found",
      "redirects": 0
    },
    "didDocument": null,
    "appviewHandle": "missing-txt.example.com"
  },
  "report": {
    "domain": "missing-txt.example.com",
    "did": null,
    "expected": {
      "input": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
      "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "method": "none",
    "verification": "not_verified",
    "ok": false,
    "problems": 2,
    "warnings": 0,
    "checks": [
      {
        "id": "syntax",
        "status": "pass",
        "reason": "valid",
        "details": {}
      },
      {
        "id": "dns",
        "status": "fail",
        "reason": "missing",
        "details": {}
      },
      {
        "id": "https",
        "status": "fail",
        "reason": "missing",
        "details": {}
      },
      {
        "id": "agreement",
        "status": "not_checked",
        "reason": "one_method",
        "details": {}
      },
      {
        "id": "document",
        "status": "not_checked",
        "reason": "no_did",
        "details": {}
      },
      {
        "id": "expected",
        "status": "not_checked",
        "reason": "no_did",
        "details": {
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
        }
      },
      {
        "id": "appview",
        "status": "not_checked",
        "reason": "no_did",
        "details": {}
      }
    ],
    "record": {
      "name": "_atproto.missing-txt",
      "fullName": "_atproto.missing-txt.example.com",
      "zone": "example.com",
      "zoneGuessed": false,
      "type": "TXT",
      "value": "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "file": {
      "url": "https://missing-txt.example.com/.well-known/atproto-did",
      "body": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "bot": false,
    "result": "dns_missing"
  }
}
Exemplo capturado: a zona foi acrescentada duas vezes
Capturado em

Entrada

Controlled fixture: checkHandleSetup({"domain":"wrong-host.example.com","expected":"did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"})

Saída capturada

{
  "provenance": "Controlled dependency fixture; no live DNS, HTTP, DID or AppView request. Fictional DIDs and reserved example.com names.",
  "observations": {
    "txt": {
      "_atproto.wrong-host.example.com.example.com": [
        [
          "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
        ]
      ]
    },
    "https": {
      "status": 404,
      "text": "Not found",
      "redirects": 0
    },
    "didDocument": null,
    "appviewHandle": "wrong-host.example.com"
  },
  "report": {
    "domain": "wrong-host.example.com",
    "did": null,
    "expected": {
      "input": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
      "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "method": "none",
    "verification": "not_verified",
    "ok": false,
    "problems": 2,
    "warnings": 0,
    "checks": [
      {
        "id": "syntax",
        "status": "pass",
        "reason": "valid",
        "details": {}
      },
      {
        "id": "dns",
        "status": "fail",
        "reason": "wrong_host",
        "details": {
          "where": "doubled",
          "name": "_atproto.wrong-host.example.com.example.com",
          "values": [
            "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
          ]
        }
      },
      {
        "id": "https",
        "status": "fail",
        "reason": "missing",
        "details": {}
      },
      {
        "id": "agreement",
        "status": "not_checked",
        "reason": "one_method",
        "details": {}
      },
      {
        "id": "document",
        "status": "not_checked",
        "reason": "no_did",
        "details": {}
      },
      {
        "id": "expected",
        "status": "not_checked",
        "reason": "no_did",
        "details": {
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
        }
      },
      {
        "id": "appview",
        "status": "not_checked",
        "reason": "no_did",
        "details": {}
      }
    ],
    "record": {
      "name": "_atproto.wrong-host",
      "fullName": "_atproto.wrong-host.example.com",
      "zone": "example.com",
      "zoneGuessed": false,
      "type": "TXT",
      "value": "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "file": {
      "url": "https://wrong-host.example.com/.well-known/atproto-did",
      "body": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "bot": false,
    "result": "dns_wrong_host"
  }
}

Valor mal formatado ou DID de outra conta

O que vê: dns: invalid_value, no_prefix ou leading_space. O valor TXT é did=did:plc:… com o seu DID completo, não o URL do perfil. Aspas ou espaços realmente guardados podem impedir o reconhecimento; as aspas de apresentação de uma ferramenta DNS são diferentes dos caracteres armazenados.

Correção: obtenha o DID nas definições da conta pretendida. Retire a formatação extra e os TXT antigos em conflito. Um DID com sintaxe válida pode ser a conta errada: preencha conta esperada antes de substituir alguma coisa. Na segunda captura, a prova do domínio é válida, mas falha a comparação com essa conta.

Exemplo capturado: o valor não é um DID
Capturado em

Entrada

Controlled fixture: checkHandleSetup({"domain":"malformed-txt.example.com","expected":"did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"})

Saída capturada

{
  "provenance": "Controlled dependency fixture; no live DNS, HTTP, DID or AppView request. Fictional DIDs and reserved example.com names.",
  "observations": {
    "txt": {
      "_atproto.malformed-txt.example.com": [
        [
          "did=not-a-did"
        ]
      ]
    },
    "https": {
      "status": 404,
      "text": "Not found",
      "redirects": 0
    },
    "didDocument": null,
    "appviewHandle": "malformed-txt.example.com"
  },
  "report": {
    "domain": "malformed-txt.example.com",
    "did": null,
    "expected": {
      "input": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
      "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "method": "none",
    "verification": "not_verified",
    "ok": false,
    "problems": 2,
    "warnings": 0,
    "checks": [
      {
        "id": "syntax",
        "status": "pass",
        "reason": "valid",
        "details": {}
      },
      {
        "id": "dns",
        "status": "fail",
        "reason": "invalid_value",
        "details": {
          "values": [
            "did=not-a-did"
          ]
        }
      },
      {
        "id": "https",
        "status": "fail",
        "reason": "missing",
        "details": {}
      },
      {
        "id": "agreement",
        "status": "not_checked",
        "reason": "one_method",
        "details": {}
      },
      {
        "id": "document",
        "status": "not_checked",
        "reason": "no_did",
        "details": {}
      },
      {
        "id": "expected",
        "status": "not_checked",
        "reason": "no_did",
        "details": {
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
        }
      },
      {
        "id": "appview",
        "status": "not_checked",
        "reason": "no_did",
        "details": {}
      }
    ],
    "record": {
      "name": "_atproto.malformed-txt",
      "fullName": "_atproto.malformed-txt.example.com",
      "zone": "example.com",
      "zoneGuessed": false,
      "type": "TXT",
      "value": "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "file": {
      "url": "https://malformed-txt.example.com/.well-known/atproto-did",
      "body": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "bot": false,
    "result": "dns_no_prefix"
  }
}
Exemplo capturado: o domínio aponta para outro DID
Capturado em

Entrada

Controlled fixture: checkHandleSetup({"domain":"wrong-account.example.com","expected":"did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"})

Saída capturada

{
  "provenance": "Controlled dependency fixture; no live DNS, HTTP, DID or AppView request. Fictional DIDs and reserved example.com names.",
  "observations": {
    "txt": {
      "_atproto.wrong-account.example.com": [
        [
          "did=did:plc:bbbbbbbbbbbbbbbbbbbbbbbb"
        ]
      ]
    },
    "https": {
      "status": 404,
      "text": "Not found",
      "redirects": 0
    },
    "didDocument": {
      "id": "did:plc:bbbbbbbbbbbbbbbbbbbbbbbb",
      "alsoKnownAs": [
        "at://wrong-account.example.com"
      ]
    },
    "appviewHandle": "wrong-account.example.com"
  },
  "report": {
    "domain": "wrong-account.example.com",
    "did": "did:plc:bbbbbbbbbbbbbbbbbbbbbbbb",
    "expected": {
      "input": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
      "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "method": "dns",
    "verification": "verified",
    "ok": false,
    "problems": 2,
    "warnings": 0,
    "checks": [
      {
        "id": "syntax",
        "status": "pass",
        "reason": "valid",
        "details": {}
      },
      {
        "id": "dns",
        "status": "pass",
        "reason": "found",
        "details": {
          "values": [
            "did=did:plc:bbbbbbbbbbbbbbbbbbbbbbbb"
          ],
          "did": "did:plc:bbbbbbbbbbbbbbbbbbbbbbbb"
        }
      },
      {
        "id": "https",
        "status": "pass",
        "reason": "not_needed",
        "details": {}
      },
      {
        "id": "agreement",
        "status": "not_checked",
        "reason": "one_method",
        "details": {}
      },
      {
        "id": "document",
        "status": "pass",
        "reason": "claims",
        "details": {
          "did": "did:plc:bbbbbbbbbbbbbbbbbbbbbbbb",
          "handle": "wrong-account.example.com"
        }
      },
      {
        "id": "expected",
        "status": "fail",
        "reason": "mismatch",
        "details": {
          "dids": [
            "did:plc:bbbbbbbbbbbbbbbbbbbbbbbb",
            "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
          ]
        }
      },
      {
        "id": "appview",
        "status": "fail",
        "reason": "unresolved",
        "details": {
          "handle": "wrong-account.example.com",
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
        }
      }
    ],
    "record": {
      "name": "_atproto.wrong-account",
      "fullName": "_atproto.wrong-account.example.com",
      "zone": "example.com",
      "zoneGuessed": false,
      "type": "TXT",
      "value": "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "file": {
      "url": "https://wrong-account.example.com/.well-known/atproto-did",
      "body": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "bot": false,
    "result": "did_mismatch"
  }
}

DNS e HTTPS devolvem DIDs diferentes

O que vê: agreement: disagree. Correção: alinhe os dois métodos com a conta pretendida ou remova o método antigo que não utiliza. A especificação dá preferência ao DNS; a divergência não invalida automaticamente uma cadeia DNS → DID → nome correta. O verificador separa o conflito do resultado verification.

Exemplo capturado: prevalece o DNS, mas o ficheiro está desatualizado
Capturado em

Entrada

Controlled fixture: checkHandleSetup({"domain":"disagree-methods.example.com","expected":"did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"})

Saída capturada

{
  "provenance": "Controlled dependency fixture; no live DNS, HTTP, DID or AppView request. Fictional DIDs and reserved example.com names.",
  "observations": {
    "txt": {
      "_atproto.disagree-methods.example.com": [
        [
          "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
        ]
      ]
    },
    "https": {
      "status": 200,
      "text": "did:plc:bbbbbbbbbbbbbbbbbbbbbbbb",
      "contentType": "text/plain",
      "redirects": 0
    },
    "didDocument": {
      "id": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
      "alsoKnownAs": [
        "at://disagree-methods.example.com"
      ]
    },
    "appviewHandle": "disagree-methods.example.com"
  },
  "report": {
    "domain": "disagree-methods.example.com",
    "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
    "expected": {
      "input": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
      "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "method": "both",
    "verification": "verified",
    "ok": false,
    "problems": 1,
    "warnings": 0,
    "checks": [
      {
        "id": "syntax",
        "status": "pass",
        "reason": "valid",
        "details": {}
      },
      {
        "id": "dns",
        "status": "pass",
        "reason": "found",
        "details": {
          "values": [
            "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
          ],
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
        }
      },
      {
        "id": "https",
        "status": "pass",
        "reason": "found",
        "details": {
          "did": "did:plc:bbbbbbbbbbbbbbbbbbbbbbbb",
          "redirects": 0
        }
      },
      {
        "id": "agreement",
        "status": "fail",
        "reason": "disagree",
        "details": {
          "dids": [
            "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
            "did:plc:bbbbbbbbbbbbbbbbbbbbbbbb"
          ]
        }
      },
      {
        "id": "document",
        "status": "pass",
        "reason": "claims",
        "details": {
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
          "handle": "disagree-methods.example.com"
        }
      },
      {
        "id": "expected",
        "status": "pass",
        "reason": "match",
        "details": {
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
        }
      },
      {
        "id": "appview",
        "status": "pass",
        "reason": "ok",
        "details": {
          "handle": "disagree-methods.example.com"
        }
      }
    ],
    "record": {
      "name": "_atproto.disagree-methods",
      "fullName": "_atproto.disagree-methods.example.com",
      "zone": "example.com",
      "zoneGuessed": false,
      "type": "TXT",
      "value": "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "file": {
      "url": "https://disagree-methods.example.com/.well-known/atproto-did",
      "body": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "bot": false,
    "result": "dns_https_conflict"
  }
}

HTTPS devolve uma página, autenticação ou desafio do proxy

O que vê: https: html, um estado 401/403 ou uma resposta inacessível. Ver a página inicial no navegador não é uma prova de identidade. Correção: sirva apenas o DID, em text/plain, em https://<nome>/.well-known/atproto-did, publicamente e por HTTPS. Confirme o estado e corpo finais após redirecionamentos. Limite a exceção à rota pública da prova; mantenha a proteção das restantes páginas.

A especificação permite redirecionamentos dentro de um limite razoável. Um redirecionamento que termina numa prova válida não é uma falha; uma página de autenticação, HTML ou um ciclo são situações diferentes. Um DNS válido pode ainda tornar o problema do método HTTPS não utilizado num aviso.

Exemplo capturado: HTML em vez de DID
Capturado em

Entrada

Controlled fixture: checkHandleSetup({"domain":"https-html.example.com","expected":"did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"})

Saída capturada

{
  "provenance": "Controlled dependency fixture; no live DNS, HTTP, DID or AppView request. Fictional DIDs and reserved example.com names.",
  "observations": {
    "txt": {},
    "https": {
      "status": 200,
      "text": "<html><body>Home page</body></html>",
      "contentType": "text/html",
      "redirects": 0
    },
    "didDocument": null,
    "appviewHandle": "https-html.example.com"
  },
  "report": {
    "domain": "https-html.example.com",
    "did": null,
    "expected": {
      "input": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
      "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "method": "none",
    "verification": "not_verified",
    "ok": false,
    "problems": 2,
    "warnings": 0,
    "checks": [
      {
        "id": "syntax",
        "status": "pass",
        "reason": "valid",
        "details": {}
      },
      {
        "id": "dns",
        "status": "fail",
        "reason": "missing",
        "details": {}
      },
      {
        "id": "https",
        "status": "fail",
        "reason": "html",
        "details": {
          "status": 200,
          "redirects": 0
        }
      },
      {
        "id": "agreement",
        "status": "not_checked",
        "reason": "one_method",
        "details": {}
      },
      {
        "id": "document",
        "status": "not_checked",
        "reason": "no_did",
        "details": {}
      },
      {
        "id": "expected",
        "status": "not_checked",
        "reason": "no_did",
        "details": {
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
        }
      },
      {
        "id": "appview",
        "status": "not_checked",
        "reason": "no_did",
        "details": {}
      }
    ],
    "record": {
      "name": "_atproto.https-html",
      "fullName": "_atproto.https-html.example.com",
      "zone": "example.com",
      "zoneGuessed": false,
      "type": "TXT",
      "value": "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "file": {
      "url": "https://https-html.example.com/.well-known/atproto-did",
      "body": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "bot": false,
    "result": "https_bad_body"
  }
}
Exemplo capturado: autenticação obrigatória
Capturado em

Entrada

Controlled fixture: checkHandleSetup({"domain":"https-login.example.com","expected":"did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"})

Saída capturada

{
  "provenance": "Controlled dependency fixture; no live DNS, HTTP, DID or AppView request. Fictional DIDs and reserved example.com names.",
  "observations": {
    "txt": {},
    "https": {
      "status": 401,
      "text": "Authentication required",
      "contentType": "text/plain",
      "redirects": 0
    },
    "didDocument": null,
    "appviewHandle": "https-login.example.com"
  },
  "report": {
    "domain": "https-login.example.com",
    "did": null,
    "expected": {
      "input": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
      "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "method": "none",
    "verification": "could_not_check",
    "ok": false,
    "problems": 2,
    "warnings": 0,
    "checks": [
      {
        "id": "syntax",
        "status": "pass",
        "reason": "valid",
        "details": {}
      },
      {
        "id": "dns",
        "status": "fail",
        "reason": "missing",
        "details": {}
      },
      {
        "id": "https",
        "status": "fail",
        "reason": "status",
        "details": {
          "status": 401
        }
      },
      {
        "id": "agreement",
        "status": "not_checked",
        "reason": "one_method",
        "details": {}
      },
      {
        "id": "document",
        "status": "not_checked",
        "reason": "no_did",
        "details": {}
      },
      {
        "id": "expected",
        "status": "not_checked",
        "reason": "no_did",
        "details": {
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
        }
      },
      {
        "id": "appview",
        "status": "not_checked",
        "reason": "no_did",
        "details": {}
      }
    ],
    "record": {
      "name": "_atproto.https-login",
      "fullName": "_atproto.https-login.example.com",
      "zone": "example.com",
      "zoneGuessed": false,
      "type": "TXT",
      "value": "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "file": {
      "url": "https://https-login.example.com/.well-known/atproto-did",
      "body": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "bot": false,
    "result": null
  }
}
Exemplo capturado: verificação do navegador
Capturado em

Entrada

Controlled fixture: checkHandleSetup({"domain":"https-challenge.example.com","expected":"did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"})

Saída capturada

{
  "provenance": "Controlled dependency fixture; no live DNS, HTTP, DID or AppView request. Fictional DIDs and reserved example.com names.",
  "observations": {
    "txt": {},
    "https": {
      "status": 403,
      "text": "<html><body>Browser verification required</body></html>",
      "contentType": "text/html",
      "redirects": 0
    },
    "didDocument": null,
    "appviewHandle": "https-challenge.example.com"
  },
  "report": {
    "domain": "https-challenge.example.com",
    "did": null,
    "expected": {
      "input": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
      "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "method": "none",
    "verification": "could_not_check",
    "ok": false,
    "problems": 2,
    "warnings": 0,
    "checks": [
      {
        "id": "syntax",
        "status": "pass",
        "reason": "valid",
        "details": {}
      },
      {
        "id": "dns",
        "status": "fail",
        "reason": "missing",
        "details": {}
      },
      {
        "id": "https",
        "status": "fail",
        "reason": "status",
        "details": {
          "status": 403
        }
      },
      {
        "id": "agreement",
        "status": "not_checked",
        "reason": "one_method",
        "details": {}
      },
      {
        "id": "document",
        "status": "not_checked",
        "reason": "no_did",
        "details": {}
      },
      {
        "id": "expected",
        "status": "not_checked",
        "reason": "no_did",
        "details": {
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
        }
      },
      {
        "id": "appview",
        "status": "not_checked",
        "reason": "no_did",
        "details": {}
      }
    ],
    "record": {
      "name": "_atproto.https-challenge",
      "fullName": "_atproto.https-challenge.example.com",
      "zone": "example.com",
      "zoneGuessed": false,
      "type": "TXT",
      "value": "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "file": {
      "url": "https://https-challenge.example.com/.well-known/atproto-did",
      "body": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "bot": false,
    "result": null
  }
}
Exemplo de controlo: um redirecionamento válido
Capturado em

Entrada

Controlled fixture: checkHandleSetup({"domain":"https-redirect.example.com","expected":"did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"})

Saída capturada

{
  "provenance": "Controlled dependency fixture; no live DNS, HTTP, DID or AppView request. Fictional DIDs and reserved example.com names.",
  "observations": {
    "txt": {},
    "https": {
      "status": 200,
      "text": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
      "contentType": "text/plain",
      "redirects": 1
    },
    "didDocument": {
      "id": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
      "alsoKnownAs": [
        "at://https-redirect.example.com"
      ]
    },
    "appviewHandle": "https-redirect.example.com"
  },
  "report": {
    "domain": "https-redirect.example.com",
    "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
    "expected": {
      "input": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
      "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "method": "https",
    "verification": "verified",
    "ok": true,
    "problems": 0,
    "warnings": 0,
    "checks": [
      {
        "id": "syntax",
        "status": "pass",
        "reason": "valid",
        "details": {}
      },
      {
        "id": "dns",
        "status": "pass",
        "reason": "not_needed",
        "details": {}
      },
      {
        "id": "https",
        "status": "pass",
        "reason": "found",
        "details": {
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
          "redirects": 1
        }
      },
      {
        "id": "agreement",
        "status": "not_checked",
        "reason": "one_method",
        "details": {}
      },
      {
        "id": "document",
        "status": "pass",
        "reason": "claims",
        "details": {
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
          "handle": "https-redirect.example.com"
        }
      },
      {
        "id": "expected",
        "status": "pass",
        "reason": "match",
        "details": {
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
        }
      },
      {
        "id": "appview",
        "status": "pass",
        "reason": "ok",
        "details": {
          "handle": "https-redirect.example.com"
        }
      }
    ],
    "record": {
      "name": "_atproto.https-redirect",
      "fullName": "_atproto.https-redirect.example.com",
      "zone": "example.com",
      "zoneGuessed": false,
      "type": "TXT",
      "value": "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "file": {
      "url": "https://https-redirect.example.com/.well-known/atproto-did",
      "body": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "bot": false,
    "result": "ok"
  }
}

O documento DID ainda reclama o nome antigo

O que vê: document: claims_other, embora o DNS encontre o DID esperado. Correção: entre na conta correta e volte a verificar/selecionar o domínio completo nas definições. Uma alteração noutra conta ou uma migração de alojamento incompleta pode deixar a declaração antiga. Confirme a conta antes de guardar; este guia não repara uma migração de PDS.

Exemplo capturado: o sentido inverso aponta para old.example.com
Capturado em

Entrada

Controlled fixture: checkHandleSetup({"domain":"reverse-claim.example.com","expected":"did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"})

Saída capturada

{
  "provenance": "Controlled dependency fixture; no live DNS, HTTP, DID or AppView request. Fictional DIDs and reserved example.com names.",
  "observations": {
    "txt": {
      "_atproto.reverse-claim.example.com": [
        [
          "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
        ]
      ]
    },
    "https": {
      "status": 404,
      "text": "Not found",
      "redirects": 0
    },
    "didDocument": {
      "id": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
      "alsoKnownAs": [
        "at://old.example.com"
      ]
    },
    "appviewHandle": "reverse-claim.example.com"
  },
  "report": {
    "domain": "reverse-claim.example.com",
    "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
    "expected": {
      "input": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
      "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "method": "dns",
    "verification": "not_verified",
    "ok": false,
    "problems": 1,
    "warnings": 0,
    "checks": [
      {
        "id": "syntax",
        "status": "pass",
        "reason": "valid",
        "details": {}
      },
      {
        "id": "dns",
        "status": "pass",
        "reason": "found",
        "details": {
          "values": [
            "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
          ],
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
        }
      },
      {
        "id": "https",
        "status": "pass",
        "reason": "not_needed",
        "details": {}
      },
      {
        "id": "agreement",
        "status": "not_checked",
        "reason": "one_method",
        "details": {}
      },
      {
        "id": "document",
        "status": "fail",
        "reason": "claims_other",
        "details": {
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
          "handle": "old.example.com"
        }
      },
      {
        "id": "expected",
        "status": "pass",
        "reason": "match",
        "details": {
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
        }
      },
      {
        "id": "appview",
        "status": "pass",
        "reason": "ok",
        "details": {
          "handle": "reverse-claim.example.com"
        }
      }
    ],
    "record": {
      "name": "_atproto.reverse-claim",
      "fullName": "_atproto.reverse-claim.example.com",
      "zone": "example.com",
      "zoneGuessed": false,
      "type": "TXT",
      "value": "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "file": {
      "url": "https://reverse-claim.example.com/.well-known/atproto-did",
      "body": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "bot": false,
    "result": "doc_not_claiming"
  }
}

As provas funcionam, mas a aplicação ainda não atualizou

O que vê: verification: verified com appview: old_handle, ou diferenças entre aplicações. Correção: confirme a prova e o documento DID atuais e repita Definições → Conta → Nome de utilizador, a opção de domínio próprio e a verificação. São os passos documentados pelo Bluesky, não uma operação garantida de limpeza de cache. O TTL DNS e as caches de identidade impedem prometer um prazo universal.

Exemplo capturado: cadeia válida e nome antigo na AppView
Capturado em

Entrada

Controlled fixture: checkHandleSetup({"domain":"stale-appview.example.com","expected":"did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"})

Saída capturada

{
  "provenance": "Controlled dependency fixture; no live DNS, HTTP, DID or AppView request. Fictional DIDs and reserved example.com names.",
  "observations": {
    "txt": {
      "_atproto.stale-appview.example.com": [
        [
          "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
        ]
      ]
    },
    "https": {
      "status": 404,
      "text": "Not found",
      "redirects": 0
    },
    "didDocument": {
      "id": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
      "alsoKnownAs": [
        "at://stale-appview.example.com"
      ]
    },
    "appviewHandle": "old.example.com"
  },
  "report": {
    "domain": "stale-appview.example.com",
    "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
    "expected": {
      "input": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
      "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "method": "dns",
    "verification": "verified",
    "ok": false,
    "problems": 1,
    "warnings": 0,
    "checks": [
      {
        "id": "syntax",
        "status": "pass",
        "reason": "valid",
        "details": {}
      },
      {
        "id": "dns",
        "status": "pass",
        "reason": "found",
        "details": {
          "values": [
            "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
          ],
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
        }
      },
      {
        "id": "https",
        "status": "pass",
        "reason": "not_needed",
        "details": {}
      },
      {
        "id": "agreement",
        "status": "not_checked",
        "reason": "one_method",
        "details": {}
      },
      {
        "id": "document",
        "status": "pass",
        "reason": "claims",
        "details": {
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
          "handle": "stale-appview.example.com"
        }
      },
      {
        "id": "expected",
        "status": "pass",
        "reason": "match",
        "details": {
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
        }
      },
      {
        "id": "appview",
        "status": "fail",
        "reason": "old_handle",
        "details": {
          "handle": "old.example.com"
        }
      }
    ],
    "record": {
      "name": "_atproto.stale-appview",
      "fullName": "_atproto.stale-appview.example.com",
      "zone": "example.com",
      "zoneGuessed": false,
      "type": "TXT",
      "value": "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "file": {
      "url": "https://stale-appview.example.com/.well-known/atproto-did",
      "body": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "bot": false,
    "result": "appview_stale"
  }
}

Um nome .bluesky.bot foi libertado ou substituído

A nossa prova usa HTTPS: não adiciona DNS para nome.bluesky.bot. Libertar o nome remove a sua reclamação. Se o bot apenas mudou de nome, a reserva pode manter-se enquanto a verificação periódica regista o incidente. Falhas confirmadas repetidas retiram o estado ativo; uma ficha pública pode manter-se durante 14 dias de tolerância. Um endereço de alertas confirmado e com consentimento pode receber um email por incidente. Verificar um bot explica estados e controlos.

Correção: no painel do bot, confirme que a conta está ativa e ainda possui o nome reclamado; use as ações de mudança/verificação. Depois de o libertar, escolha um nome disponível: o diagnóstico não restaura reservas. O exemplo simula a ausência de prova num domínio reservado, sem consultar um nome .bluesky.bot real.

Exemplo capturado: um nome libertado não tem prova direta
Capturado em

Entrada

Controlled fixture: checkHandleSetup({"domain":"released-handle.example.com","expected":"did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"})

Saída capturada

{
  "provenance": "Controlled dependency fixture; no live DNS, HTTP, DID or AppView request. Fictional DIDs and reserved example.com names.",
  "observations": {
    "txt": {},
    "https": {
      "status": 404,
      "text": "Not found",
      "redirects": 0
    },
    "didDocument": null,
    "appviewHandle": "released-handle.example.com"
  },
  "report": {
    "domain": "released-handle.example.com",
    "did": null,
    "expected": {
      "input": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa",
      "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "method": "none",
    "verification": "not_verified",
    "ok": false,
    "problems": 2,
    "warnings": 0,
    "checks": [
      {
        "id": "syntax",
        "status": "pass",
        "reason": "valid",
        "details": {}
      },
      {
        "id": "dns",
        "status": "fail",
        "reason": "missing",
        "details": {}
      },
      {
        "id": "https",
        "status": "fail",
        "reason": "missing",
        "details": {}
      },
      {
        "id": "agreement",
        "status": "not_checked",
        "reason": "one_method",
        "details": {}
      },
      {
        "id": "document",
        "status": "not_checked",
        "reason": "no_did",
        "details": {}
      },
      {
        "id": "expected",
        "status": "not_checked",
        "reason": "no_did",
        "details": {
          "did": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
        }
      },
      {
        "id": "appview",
        "status": "not_checked",
        "reason": "no_did",
        "details": {}
      }
    ],
    "record": {
      "name": "_atproto.released-handle",
      "fullName": "_atproto.released-handle.example.com",
      "zone": "example.com",
      "zoneGuessed": false,
      "type": "TXT",
      "value": "did=did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "file": {
      "url": "https://released-handle.example.com/.well-known/atproto-did",
      "body": "did:plc:aaaaaaaaaaaaaaaaaaaaaaaa"
    },
    "bot": false,
    "result": "dns_missing"
  }
}

O que observam as nossas verificações

Incidentes registados por causa

À data de

O que a verificação observouIncidentes registadosPercentagem dos incidentes registados (%)
O Bluesky mostra outro nome para a contaNão publicado: menos de cinco participantes ou sem histórico medido.Não publicado: menos de cinco participantes ou sem histórico medido.
O Bluesky devolve handle.invalidNão publicado: menos de cinco participantes ou sem histórico medido.Não publicado: menos de cinco participantes ou sem histórico medido.
O nome reclamado aponta para outro DIDNão publicado: menos de cinco participantes ou sem histórico medido.Não publicado: menos de cinco participantes ou sem histórico medido.
A conta deixou de ser servidaNão publicado: menos de cinco participantes ou sem histórico medido.Não publicado: menos de cinco participantes ou sem histórico medido.

Bots atualmente públicos no diretório; até aos últimos 90 dias UTC completos. São transições de incidentes, não todas as verificações diárias. Todo o detalhe fica oculto se uma causa não vazia tiver menos de cinco bots. Um valor ausente não é zero.

À data de

Identificadores públicos ativos
56
Disponibilidade observada do identificador (%)
100
Bots públicos que contribuem minutos medidos
56
Dias completos observados
2
Tempo mediano de recuperação (horas)
Não publicado: menos de cinco participantes ou sem histórico medido.
Incidentes recuperados
Não publicado: menos de cinco participantes ou sem histórico medido.
Reverificações diárias bem-sucedidas (%)
Não publicado: menos de cinco participantes ou sem histórico medido.
Dias de bot bem-sucedidos
Não publicado: menos de cinco participantes ou sem histórico medido.
Dias de bot observados
Não publicado: menos de cinco participantes ou sem histórico medido.
Bots públicos que contribuem com reverificações
Não publicado: menos de cinco participantes ou sem histórico medido.
Dias UTC completos com observações
Não publicado: menos de cinco participantes ou sem histórico medido.
Dias de calendário desde a primeira observação nesta janela
Não publicado: menos de cinco participantes ou sem histórico medido.

Os números referem-se a bots atualmente públicos do diretório. Disponibilidade é a proporção de minutos observados sem incidente registado, não de verificações bem-sucedidas. A recuperação usa encerramentos válidos dos últimos 90 dias UTC completos, sem incidentes abertos. O passado não é reconstituído.

A taxa divide os dias de bot bem-sucedidos pelos observados: conta apenas a última reverificação diária automática conclusiva de cada bot em cada dia UTC. Exclui verificações manuais, verificações iniciais ou pendentes, controlos de referência, incerteza da rede e falhas descartadas pela proteção contra indisponibilidade. Usamos no máximo 90 dias UTC completos até ontem; um dia sem observação não é um sucesso. O intervalo de calendário começa no primeiro dia registado nessa janela. Taxa e contagens são ocultadas juntas se não contribuírem cinco bots distintos ou se algum grupo de resultados não vazio tiver menos de cinco. A recolha começa na implementação, sem reconstruir o passado. A latência continua por medir.

Os números descrevem os bots atualmente públicos no diretório, incluindo fichas elegíveis em tolerância, durante até 90 dias UTC completos. Não representam todo o Bluesky nem todas as reservas. shows_other_handle, handle_invalid, resolves_elsewhere e account_gone são sintomas observados, não causas DNS demonstradas. Não deduzimos daí uma percentagem de erros de painel DNS. A mediana exclui incidentes ainda sem recuperação. O historial em falta não é reconstruído e os grupos pequenos ocultam todo o detalhe.

Continua com dificuldades?

Procure o suporte Bluesky para a conta ou aplicação e contacte-nos para uma reserva .bluesky.bot. Indique a verificação que falhou e a data, nunca palavras-passe ou tokens OAuth. Para bots sem gerir DNS, leia um nome para o bot e opções gratuitas. Uma conta pessoal não precisa de um nome de bot para reparar o domínio.

Verificar um identificador de bot

Perguntas frequentes

Um nome inválido faz perder seguidores?
A invalidação do nome, por si só, não apaga publicações nem seguidores. O DID identifica a conta; repare a prova ou escolha outro nome na mesma conta.
Quanto tempo demora o DNS?
Não existe um prazo fixo. As caches DNS e dos serviços de identidade podem guardar respostas antigas. Confirme o registo autoritativo, espere pelo TTL e verifique novamente; mudar constantemente o valor dificulta o diagnóstico.
Posso usar um subdomínio?
Sim. Para voce.example.com na zona example.com, o nome TXT é _atproto.voce e o nome completo _atproto.voce.example.com. A prova e o documento DID têm de reclamar o nome completo.
Porque é inválido apenas em algumas aplicações?
As aplicações e os serviços de identidade podem renovar as caches em alturas diferentes. Compare a prova DNS ou HTTPS atual, o documento DID e a resposta da AppView antes de concluir que o domínio continua incorreto.

Fontes