Como Federar o Mastodon com Kbin e Mbin: Notas sobre o Protocolo

Mastodon e as plataformas agregadoras de links Kbin e Mbin usam o protocolo ActivityPub para se comunicar. No entanto, seus propósitos base diferentes fazem com que a federação nem sempre seja perfeita. Um usuário do Mastodon pode descobrir que respostas a um tópico do Kbin não aparecem, ou que seguir uma revista do Kbin a partir do Mastodon produz um comportamento inesperado. Este artigo explica as diferenças subjacentes do protocolo, fornece instruções passo a passo para configurar a federação entre essas plataformas e lista os erros comuns que você deve evitar.

Entendendo as Diferenças no Modelo ActivityPub

Mastodon é uma plataforma de microblogging onde cada usuário tem uma caixa de entrada e uma caixa de saída pessoais. Kbin e Mbin são plataformas agregadoras de links que operam em um modelo de revista ou comunidade. Cada revista atua como um ator de grupo com sua própria caixa de entrada ActivityPub. Quando um usuário do Mastodon responde a um tópico de uma revista do Kbin, a resposta é enviada para a caixa de entrada da revista. A revista então redistribui a resposta para todos os assinantes. Isso é diferente do modelo de mensagens diretas do Mastodon, onde uma resposta vai apenas para o autor original e os seguidores do usuário.

A principal diferença técnica é o mecanismo de shared inbox. Kbin e Mbin usam uma shared inbox para coletar respostas de todas as revistas na instância. O Mastodon não oferece suporte nativo a shared inbox para atores de grupo, então as respostas podem ser atrasadas ou perdidas se a instância do Kbin não as encaminhar corretamente. Além disso, Kbin e Mbin permitem postagens anônimas em revistas, o que o Mastodon não suporta. Isso significa que um usuário do Mastodon não pode postar diretamente em uma revista do Kbin sem primeiro ser seguido pela conta bot da revista ou usar a interface web do Kbin.

Ator de Grupo vs Ator Pessoa

No ActivityPub, um ator pode ser Person, Group, Service ou Organization. O Mastodon trata todos os atores como Person por padrão. As revistas do Kbin e Mbin são atores Group. Quando o Mastodon recebe uma atividade de um ator Group, pode não exibir o conteúdo corretamente porque o Mastodon não possui uma interface de usuário nativa para atores Group. Por exemplo, uma postagem fixada de uma revista pode não aparecer como fixada no Mastodon, e a descrição da revista pode não ficar visível no cartão de perfil do Mastodon.

Federação de Tópicos e Respostas

Quando um usuário do Mastodon segue uma revista do Kbin, as postagens da revista aparecem na linha do tempo inicial do Mastodon. No entanto, as respostas a essas postagens de usuários do Kbin podem não federar para o Mastodon se a instância do Kbin não configurou corretamente sua entrega de saída. A instância do Kbin deve ter sua fila de entrega ActivityPub ativada e não deve ser limitada pela instância do Mastodon. Da mesma forma, as respostas do Mastodon a um tópico do Kbin são enviadas para a caixa de entrada da revista, mas a revista pode não exibi-las se a resposta não for endereçada diretamente ao ator da revista. Para garantir que as respostas federem, o usuário do Mastodon deve mencionar o identificador da revista na resposta, por exemplo @revista@kbin.example.

Passos para Estabelecer a Federação entre Mastodon e Kbin ou Mbin

Antes de começar, verifique se ambas as instâncias estão executando uma versão recente de seus softwares. Versões antigas do Kbin (anteriores à 1.0) tinham suporte ActivityPub incompleto. Mbin é um fork do Kbin e geralmente tem o mesmo comportamento de federação. Você precisa saber o identificador ActivityPub completo da revista que deseja seguir, que está no formato @nome-da-revista@dominio-da-instancia.

1. Encontre o identificador ActivityPub da revista
   Na instância do Kbin ou Mbin, navegue até a página da revista. A URL será algo como https://kbin.example/m/nome-da-revista. O identificador ActivityPub é @nome-da-revista@kbin.example. Você também pode encontrar esse identificador na barra lateral da revista, em “Federação”.
2. Pesquise a revista no Mastodon
   Abra a barra de pesquisa do Mastodon. Digite o identificador ActivityPub completo, incluindo os símbolos @, por exemplo @nome-da-revista@kbin.example. Pressione Enter. O Mastodon buscará o perfil do ator da revista.
3. Siga a revista
   Quando o perfil da revista aparecer nos resultados da pesquisa, clique no botão Seguir. O Mastodon envia uma atividade Follow para a caixa de entrada da revista. A revista aceitará o follow automaticamente se for pública. Você verá então as postagens da revista em sua linha do tempo inicial.
4. Responda a uma postagem da revista corretamente
   Ao responder a uma postagem da revista, certifique-se de que a resposta seja endereçada ao identificador da revista. O Mastodon inclui automaticamente o autor original na resposta. Se o autor original for um usuário do Kbin, a resposta irá para esse usuário. Para também enviar a resposta para a revista, adicione @nome-da-revista@kbin.example no texto da resposta. Isso garante que a resposta feder para a caixa de entrada da revista e apareça no tópico da revista.
5. Verifique a federação do Mastodon para o Kbin
   Após responder, verifique o tópico da revista na instância do Kbin. Procure sua resposta na seção de comentários. Se ela não aparecer, a instância do Kbin pode estar com um atraso de federação. Aguarde até 15 minutos para a atividade ser processada. Se ainda assim não aparecer, verifique os logs do servidor Mastodon em busca de erros 4xx ou 5xx ao entregar para a instância do Kbin.

Problemas Comuns ao Federar Mastodon com Kbin e Mbin

Postagens da Revista Não Aparecem na Linha do Tempo do Mastodon

Se você seguir uma revista mas não vir postagens, a instância do Kbin pode ter bloqueado sua instância do Mastodon, ou sua instância do Mastodon pode ter um bloqueio de domínio na instância do Kbin. Verifique os bloqueios de domínio do Mastodon em Preferências > Moderação > Bloqueios de Domínio. Se a instância do Kbin estiver bloqueada, remova o bloqueio ou defina como “silenciar” em vez de “suspender”. No lado do Kbin, peça ao administrador para verificar as configurações de federação da instância e garantir que sua instância do Mastodon não esteja bloqueada.

Respostas de Usuários do Kbin Não Federam para o Mastodon

Quando um usuário do Kbin responde a um tópico de revista que se originou no Mastodon, a resposta pode não federar para o usuário do Mastodon. Isso acontece se a instância do Kbin não entregar a resposta na caixa de entrada do usuário do Mastodon. A instância do Kbin deve ter a entrega ActivityPub de saída ativada e deve ter a URL correta da caixa de entrada para o usuário do Mastodon. Certifique-se de que o administrador da instância do Kbin ativou a “Entrega ActivityPub” nas configurações da instância. Se o problema persistir, peça ao administrador para verificar os logs da instância em busca de erros de entrega.

Seguir um Usuário do Kbin ou Mbin para o Mastodon

Seguir um usuário do Mastodon a partir do Kbin funciona de forma semelhante. No Kbin, pesquise o identificador do usuário do Mastodon, por exemplo @usuario@mastodon.example. O Kbin enviará uma atividade Follow para o usuário do Mastodon. O usuário do Mastodon receberá uma solicitação de seguimento, que deve aprovar se sua conta for bloqueada. Uma vez aprovada, as postagens do usuário do Mastodon aparecerão no feed da revista do Kbin se a revista tiver sido configurada para incluir postagens remotas. Por padrão, as revistas mostram apenas postagens locais. O usuário do Kbin também deve se inscrever na revista para ver as postagens do usuário do Mastodon em seu feed pessoal.

Item	Mastodon	Kbin / Mbin
Tipo de ator principal	Person	Group para revistas, Person para usuários
Destino da entrega de respostas	Caixa de entrada do autor original	Caixa de entrada do grupo da revista
Suporte a shared inbox	Parcial (não para atores de grupo)	Completo
Postagem anônima	Não suportado	Suportado para revistas
Atraso de federação	Geralmente instantâneo	Até 15 minutos para atividades de grupo

Federar o Mastodon com Kbin ou Mbin é possível, mas requer compreensão do modelo de ator de grupo. Sempre use o identificador ActivityPub completo ao pesquisar revistas. Verifique a federação conferindo ambas as plataformas após enviar uma resposta. Se encontrar problemas, comece verificando os bloqueios de domínio em ambos os lados. Para solução de problemas avançada, examine os logs de entrega ActivityPub em sua instância do Mastodon em Preferências > Administração > Sidekiq > Retries para entregas com falha.