Mastodon é um serviço de rede social gratuito e de código aberto, descentralizado e distribuído. Foi criado em 2016 como uma alternativa às plataformas centralizadas de mídia social, como Twitter e Facebook.
Uma das principais características do Mastodon é o uso do protocolo WebFinger, que permite aos usuários descobrir e acessar informações sobre outros usuários na rede Mastodon. WebFinger é um protocolo simples baseado em HTTP que permite ao usuário descobrir informações sobre outros usuários ou recursos na Internet usando seu endereço de e-mail ou outras informações de identificação. O protocolo WebFinger é importante para o Mastodon porque permite que os usuários se encontrem e sigam uns aos outros na rede, independentemente de onde estejam hospedados.
O WebFinger usa uma estrutura de caminho “bem conhecida” ao chamar um domínio. Você deve estar familiarizado com a convenção robots.txt. Todos concordamos que o robots.txt ficará no caminho superior do domínio de todos.
O protocolo WebFinger é um protocolo simples baseado em HTTP que permite que um usuário ou pesquisa descubra informações sobre outros usuários ou recursos na Internet usando seu endereço de e-mail ou outras informações de identificação. Meu nome é o sobrenome .com, então… meu endpoint pessoal da API WebFinger está aqui https://www.hanselman.com/.well-known/webfinger
A ideia é que…
-
Um usuário envia uma solicitação WebFinger a um servidor, usando o endereço de e-mail ou outras informações de identificação do usuário ou recurso que está tentando descobrir.
-
O servidor consulta as informações solicitadas em seu banco de dados e retorna um objeto JSON contendo as informações sobre o usuário ou recurso. Este objeto JSON é chamado de “descritor de recursos”.
-
O cliente do usuário recebe o descritor de recurso e exibe as informações ao usuário.
O descritor de recurso contém vários tipos de informações sobre o usuário ou recurso, como nome, foto do perfil e links para contas de mídia social ou outros recursos online. Também pode incluir outros tipos de informações, como a chave pública do usuário, que pode ser usada para estabelecer uma conexão segura com o usuário.
Há um ótimo explicador aqui também. Dessa página:
Quando alguém procura por você no Mastodon, seu servidor será consultado em busca de contas usando um endpoint semelhante a este:
PEGAR https://${MASTODON_DOMAIN}/.well-known/webfinger?resource=acct:${MASTODON_USER}@${MASTODON_DOMAIN}
Observe que os nomes de usuário do Mastodon começam com @, portanto são @username@someserver.com. Assim como o twiter seria @shanselman@twitter.com, agora posso ser @shanselman@hanselman.com!
Então talvez https://www.hanselman.com/.well-known/webfinger?resource=acct:FRED@HANSELMAN.COM
O meu retorna
{
"subject":"acct:shanselman@hachyderm.io",
"aliases":
(
"https://hachyderm.io/@shanselman",
"https://hachyderm.io/users/shanselman"
),
"links":
(
{
"rel":"http://webfinger.net/rel/profile-page",
"type":"text/html",
"href":"https://hachyderm.io/@shanselman"
},
{
"rel":"self",
"type":"application/activity+json",
"href":"https://hachyderm.io/users/shanselman"
},
{
"rel":"http://ostatus.org/schema/1.0/subscribe",
"template":"https://hachyderm.io/authorize_interaction?uri={uri}"
}
)
}
Este arquivo deve ser retornado como um tipo mime de aplicação/jrd+json
Meu site é um site ASP.NET Razor Pages, então fiz isso em Startup.cs para mapear aquele URL conhecido para uma página/rota que retorna o JSON necessário.
services.AddRazorPages().AddRazorPagesOptions(options =>
{
options.Conventions.AddPageRoute("/robotstxt", "/Robots.Txt"); //i did this before, not needed
options.Conventions.AddPageRoute("/webfinger", "/.well-known/webfinger");
options.Conventions.AddPageRoute("/webfinger", "/.well-known/webfinger/{val?}");
});
então fiz um webfinger.cshtml assim. Observe que tenho que escapar duas vezes dos sites @@ porque é o Razor.
@page
@{
Layout = null;
this.Response.ContentType = "application/jrd+json";
}
{
"subject":"acct:shanselman@hachyderm.io",
"aliases":
(
"https://hachyderm.io/@@shanselman",
"https://hachyderm.io/users/shanselman"
),
"links":
(
{
"rel":"http://webfinger.net/rel/profile-page",
"type":"text/html",
"href":"https://hachyderm.io/@@shanselman"
},
{
"rel":"self",
"type":"application/activity+json",
"href":"https://hachyderm.io/users/shanselman"
},
{
"rel":"http://ostatus.org/schema/1.0/subscribe",
"template":"https://hachyderm.io/authorize_interaction?uri={uri}"
}
)
}
Esta é uma resposta estática, mas se eu estivesse hospedando páginas para mais de uma pessoa, gostaria de inserir o URL com o nome do usuário e, em seguida, mapeá-lo para seus aliases e retorná-los corretamente.
Ainda mais fácil, você pode simplesmente usar o arquivo JSON da resposta webfinger do seu próprio servidor Mastodon e SALVÁ-LO como um arquivo JSON estático e copiá-lo para o seu próprio servidor!
Contanto que seu servidor retorne o JSON correto daquele URL conhecido, ele funcionará.
Então isso é meu modelo https://hachyderm.io/.well-known/webfinger?resource=acct:shanselman@hachyderm.io de onde estou hospedado agora.
Se você quiser começar com o Mastodon, comece aqui. https://github.com/joyeusenoelle/GuideToMastodon/ parece o Twitter de 2007, exceto que não pertence a ninguém e é baseado em padrões da web como o ActivityPub.
Espero que isso ajude!
Sobre Scott
Scott Hanselman é ex-professor, ex-arquiteto-chefe em finanças, agora palestrante, consultor, pai, diabético e funcionário da Microsoft. Ele é um comediante stand-up fracassado, um cornrower e autor de livros.
Deseja saber mais sobre Programação e Desenvolvimento Clique Aqui!
Reflexões