Token de Migração do Bluesky Inválido: Causas e Correção
🔍 WiseChecker

Token de Migração do Bluesky Inválido: Causas e Correção

Ao tentar migrar sua conta do Bluesky para um novo host ou domínio, você pode ver o erro “Migration token invalid”. Esse erro interrompe a transferência da conta e deixa você preso ao provedor atual. A causa raiz é quase sempre uma incompatibilidade na geração ou aplicação do token no sistema de autenticação do Bluesky. Este artigo explica por que o token se torna inválido e fornece correções passo a passo para resolver o problema.

Principais Conclusões: Corrigindo o Erro de Token de Migração Inválido do Bluesky

  • Configurações > Conta > Migração > Gerar Token de Migração: Gera um token único e com tempo limitado para transferência de conta
  • Janela de expiração do token: O token é válido apenas por 15 minutos após a geração, exigindo um token novo se o processo parar
  • Verificação manual do registro DNS TXT: Confirma a propriedade do domínio antes que o Bluesky aceite o token de migração

Por que o Token de Migração se Torna Inválido no Bluesky

O token de migração do Bluesky é uma string criptográfica que prova que você é o dono da conta do Bluesky e deseja movê-la para um novo domínio ou provedor de hospedagem. O Bluesky gera esse token dentro das configurações da sua conta. O token inclui um timestamp e uma assinatura vinculada às suas credenciais atuais da conta.

O token se torna inválido por três razões principais:

  • Expiração do token: O token expira 15 minutos após a geração. Se você gerá-lo e esperar muito para usá-lo, o Bluesky o rejeita como inválido.
  • Incompatibilidade no registro DNS: O registro TXT que você adiciona às configurações de DNS do seu novo domínio deve corresponder exatamente ao que o Bluesky espera. Um erro de digitação no nome ou valor do registro torna o token inválido.
  • Alteração nas credenciais da conta: Se você alterar sua senha ou handle após gerar o token, a assinatura do token não corresponderá mais à sua conta. O Bluesky invalida o token antigo imediatamente.

Passos para Gerar e Aplicar um Token de Migração Válido

  1. Verifique seu handle e domínio atuais
    Abra o Bluesky em um navegador. Vá em Configurações > Conta. Confirme que seu handle atual é o que você deseja migrar de. Se você alterou sua senha recentemente, aguarde 10 minutos antes de gerar um token para evitar incompatibilidades de assinatura.
  2. Gere o token de migração
    Em Configurações > Conta, role até a seção Migração. Clique em “Gerar Token de Migração”. Uma caixa de diálogo mostra a string do token. Copie-a imediatamente para a área de transferência. Não feche a caixa de diálogo nem navegue para outra página.
  3. Adicione o registro TXT ao seu novo domínio
    Faça login no seu registrador de domínio ou provedor de hospedagem DNS. Crie um novo registro TXT com os seguintes valores:
    Nome: _atproto.seunovodominio.com
    Valor: did=plc:seudid (substitua seudid pelo seu DID do Bluesky, encontrado em Configurações > Conta)
    TTL: 300 segundos (5 minutos) ou o menor valor permitido.
  4. Aguarde a propagação do DNS
    As alterações de DNS podem levar até 15 minutos para se propagar mundialmente. Use uma ferramenta como whatsmydns.net para verificar se o registro TXT está visível globalmente. Não prossiga até que o registro apareça como publicado.
  5. Insira o token no novo host
    Se você estiver migrando para um PDS auto-hospedado, abra a interface de administração do PDS e cole o token no formulário de migração. Se estiver migrando para outro host compatível com Bluesky, siga as instruções de migração desse host. O token deve ser inserido dentro de 15 minutos após a geração. Se o token tiver expirado, volte ao passo 2 e gere um novo token.
  6. Confirme a migração
    Após inserir o token, o Bluesky verifica o registro DNS TXT. Se o registro corresponder, o handle da sua conta será alterado para o novo domínio. Você verá uma mensagem de confirmação em Configurações > Conta. Seu handle antigo ficará disponível para liberação.

Se o Bluesky Ainda Mostrar Token Inválido Após a Correção Principal

Token expirou durante a propagação do DNS

A propagação do DNS pode levar mais tempo do que a janela de validade de 15 minutos do token. Se você gerou o token antes do registro DNS estar visível globalmente, o token expira antes que você possa usá-lo. Gere um novo token após confirmar que o registro TXT está ativo. Em seguida, aplique o novo token imediatamente.

Registro DNS com erro de digitação ou valor incorreto

Verifique novamente o nome e o valor do registro TXT. O nome deve ser exatamente _atproto.seunovodominio.com. O valor deve começar com did=plc: seguido pelo seu DID exato. Um underscore faltando ou um DID errado torna o token inválido. Exclua o registro incorreto e adicione um corrigido. Aguarde a propagação e gere um novo token.

Handle da conta já reivindicado por outro usuário

Se o handle do novo domínio já estiver em uso por outra conta do Bluesky, a migração falha com um erro de token inválido. O Bluesky não permite que duas contas usem o mesmo handle. Verifique se o handle está disponível pesquisando por ele no aplicativo Bluesky. Se estiver ocupado, escolha um handle diferente ou entre em contato com o proprietário atual para liberá-lo.

Token de Migração do Bluesky: Geração do Token vs Verificação DNS

Item Geração do Token Verificação DNS
Propósito Prova que você controla a conta do Bluesky Prova que você controla o novo domínio
Método Bluesky gera uma string criptográfica assinada Você adiciona um registro TXT às configurações de DNS do seu domínio
Expiração 15 minutos após a geração Sem expiração, mas deve estar presente no momento da migração
Falha comum Token usado após expiração ou após alteração de senha Registro TXT ausente, com nome incorreto ou valor DID errado

Agora você pode resolver o erro “Migration token invalid” gerando um novo token após a propagação do DNS e verificando se o registro TXT está correto. Para migrações futuras, sempre confirme que o DNS está totalmente propagado antes de gerar o token. Se planeja migrar várias contas, gere e aplique os tokens uma de cada vez para evitar confusão com diferentes valores de DID.