Problemas de Verificação Webfinger na Migração do Mastodon: Corrigir

Quando você migra sua conta do Mastodon de uma instância para outra, a nova instância precisa verificar sua conta antiga através do Webfinger. Esta etapa de verificação confirma que você controla a conta antiga antes que os seguidores sejam transferidos. Sem uma verificação bem-sucedida, o processo de migração falha, deixando seus seguidores presos na instância antiga. Este artigo explica por que a verificação Webfinger falha e fornece correções passo a passo para resolver o problema.

Por que a Verificação Webfinger Falha Durante a Migração do Mastodon

Webfinger é um protocolo que permite que instâncias do Mastodon consultem informações sobre um usuário pelo endereço no formato de e-mail (usuário@instancia.com). Durante a migração de conta, a nova instância envia uma solicitação Webfinger para a instância antiga para confirmar que a conta antiga existe e pertence à pessoa que está iniciando a migração. Se a instância antiga estiver inacessível, retornar um erro ou não reconhecer o alias, a verificação falha.

As causas raiz geralmente se enquadram em três categorias:

Instância Inacessível ou Falha na Resolução de DNS

Se a instância antiga foi desligada, está atrás de um firewall ou seu nome de domínio não resolve mais para o endereço IP correto, a nova instância não pode enviar a solicitação Webfinger. Isso é comum ao migrar de uma instância pequena ou mal mantida que ficou offline.

Configuração de Alias Ausente ou Incorreta na Instância Antiga

O processo de migração exige que você defina um alias de conta na instância antiga. Esse alias informa à instância antiga que sua conta foi movida para o novo endereço. Sem esse alias, a resposta Webfinger da instância antiga não incluirá as informações de redirecionamento, fazendo com que a verificação falhe.

Endpoint Webfinger Não Respondendo Corretamente

Algumas instâncias do Mastodon têm configurações personalizadas ou proxies reversos de terceiros que bloqueiam ou modificam as solicitações Webfinger. Se o endpoint /.well-known/webfinger não estiver acessível, retornar um 404 ou servir um JSON incorreto, a nova instância não pode concluir a verificação.

Passos para Corrigir a Verificação Webfinger Durante a Migração de Conta

Siga estes passos em ordem. Não pule nenhum passo, pois cada um se baseia no anterior.

1. Verifique se a instância antiga ainda está online
   Abra um navegador e acesse a página inicial da instância antiga. Se a página carregar, a instância está acessível. Se retornar um erro 502 ou 503, a instância pode estar temporariamente fora do ar. Aguarde 24 horas e tente novamente. Se o domínio mostrar um erro de DNS ou a página estiver em branco, a instância provavelmente está permanentemente offline. Nesse caso, você não pode realizar uma migração padrão e deve entrar em contato com o administrador da instância antiga ou usar métodos alternativos para notificar seus seguidores manualmente.
2. Defina o alias de conta na instância antiga
   Faça login na sua conta antiga do Mastodon. Vá para Preferências > Conta > Mover de uma conta diferente. Na verdade, a configuração de alias está em Preferências > Conta > Configurações da conta > Mover para uma conta diferente. Insira o endereço completo da sua nova conta (usuario@novainstancia.com). Salve as alterações. Isso cria um alias compatível com Webfinger que aponta para sua nova conta.
3. Inicie a migração na nova instância
   Faça login na sua nova conta do Mastodon. Vá para Preferências > Conta > Mover de uma conta diferente. Insira o endereço completo da sua conta antiga (usuario@instanciaantiga.com). A nova instância enviará uma solicitação Webfinger para a instância antiga. Se o alias estiver configurado corretamente e a instância antiga estiver acessível, você verá uma mensagem de confirmação. Clique no botão de confirmação para prosseguir.
4. Verifique a resolução Webfinger manualmente
   Se a migração falhar, teste o endpoint Webfinger manualmente. Abra um navegador e acesse https://instanciaantiga.com/.well-known/webfinger?resource=acct:usuario@instanciaantiga.com. Substitua instanciaantiga.com e usuario pelo domínio e nome de usuário reais. A resposta deve ser um objeto JSON contendo um campo subject e um array links com um alias apontando para sua nova conta. Se você vir um 404 ou um JSON vazio, o alias não está configurado corretamente. Volte ao passo 2 e verifique o alias.
5. Configure o DNS se estiver usando um domínio personalizado
   Se sua instância antiga usa um domínio personalizado (não o domínio padrão da instância), você deve adicionar um registro DNS TXT para verificar a propriedade do domínio. Faça login no painel de controle do seu registrador de domínios. Adicione um registro TXT para _mastodon com o valor instanciaantiga.com. Aguarde a propagação do DNS, que pode levar até 48 horas. Em seguida, tente novamente a migração a partir da nova instância.
6. Entre em contato com o administrador da instância antiga se os problemas persistirem
   Se o endpoint Webfinger retornar um erro ou a instância estiver inacessível, mas não permanentemente offline, entre em contato com o administrador da instância. Peça para verificarem os logs do servidor em busca de solicitações Webfinger e garantirem que o proxy reverso (se houver) não está bloqueando /.well-known/webfinger. O administrador também pode acionar manualmente uma atualização do cache Webfinger reiniciando o serviço web do Mastodon.

Se o Webfinger Ainda Falhar Após a Correção Principal

Solicitação Webfinger Excede o Tempo Limite

Um tempo limite indica que a instância antiga está acessível, mas não está respondendo rápido o suficiente. Isso geralmente acontece com instâncias sobrecarregadas. Aguarde 30 minutos e tente novamente. Se o tempo limite persistir, a instância pode estar limitando a taxa de solicitações Webfinger. Use o teste manual do Webfinger do passo 4 para confirmar que o endpoint está funcionando. Se o teste manual for bem-sucedido, mas a migração exceder o tempo limite, peça ao administrador da instância antiga para desabilitar temporariamente a limitação de taxa para sua conta.

Webfinger Retorna um Erro 404

Um erro 404 significa que o endpoint Webfinger não existe ou o recurso não foi encontrado. Verifique se a URL no passo 4 usa o formato correto. Se o endpoint retornar 404 para todas as contas, a instância pode ter desabilitado o Webfinger ou usar um caminho não padrão. Entre em contato com o administrador para ativar o endpoint Webfinger padrão em /.well-known/webfinger.

Migração é Bem-sucedida, Mas os Seguidores Não São Transferidos

Mesmo que a verificação Webfinger passe, a migração de seguidores pode não ser concluída imediatamente. O Mastodon enfileira as transferências de seguidores e as processa em lotes. Aguarde até 24 horas. Se nenhum seguidor aparecer, verifique a lista de seguidores da sua conta antiga. Se os seguidores ainda estiverem lá, a migração pode não ter sido totalmente processada. Tente novamente a migração a partir da nova instância. Se o problema continuar, a instância antiga pode ter um bug no manipulador de migração. Relate o problema ao administrador com a mensagem de erro exata dos logs do servidor.

Item	Verificação Webfinger Bem-sucedida	Falha na Verificação Webfinger
Status da instância antiga	Online e acessível	Offline, erro de DNS ou com limite de taxa
Configuração de alias	Configurado corretamente na instância antiga	Alias ausente ou incorreto
Endpoint Webfinger	Retorna JSON válido com alias	Retorna 404, tempo limite ou dados incorretos
Configuração de DNS para domínio personalizado	Registro TXT adicionado e propagado	Registro TXT ausente

Agora você pode diagnosticar e corrigir falhas na verificação Webfinger durante a migração de conta do Mastodon. Comece verificando se a instância antiga está online e se o alias está configurado. Se os testes manuais do Webfinger falharem, entre em contato com o administrador da instância. Para problemas persistentes, verifique os registros DNS para domínios personalizados. Essa abordagem resolve a grande maioria dos problemas de verificação de migração.