
WebFinger es un protocolo especificado por el Grupo de Trabajo de Ingeniería de Internet (IETF) en el RFC 7033 que permite descubrir información sobre personas y cosas identificadas por una URI . [ 1 ] La información sobre una persona podría descubrirse a través de una acct:URI, por ejemplo, que es una URI que parece una dirección de correo electrónico .
WebFinger se especifica como el protocolo de descubrimiento para OpenID Connect , [ 2 ] que es un protocolo que permite iniciar sesión más fácilmente en varios sitios de Internet. [ 3 ]
El protocolo WebFinger es utilizado por software federado , como GNU social (a través de su uso en OStatus ), Diaspora [ 4 ] o Mastodon [ 5 ] , para descubrir usuarios en nodos y pods federados, así como por el protocolo remoteStorage [ 6 ] . El protocolo WebFinger no especifica el uso de "template" dentro de la sección "links". Esta es una extensión realizada por el antiguo protocolo oStatus del que Fediverso heredó. La razón para ampliar esto posteriormente se justificó por el deseo de usar una clave diferente para un valor que no es una URL, sino un patrón para crear una [ 7 ] .
Como nota histórica, el nombre "WebFinger" deriva del antiguo protocolo ARPANET Finger , pero es un protocolo muy diferente diseñado para HTTP . [ 8 ]
La carga útil del protocolo se representa en formato JSON con un tipo MIME de application/jrd+json. [ 9 ]
Descripción general técnica
La especificación WebFinger consiste en un formato URI específico y una ontología mínima que requiere que los recursos JSON servidos desde ese URI declaren sus propias ontologías adicionales.

Ejemplo de información de contacto
El siguiente ejemplo muestra una funcionalidad hipotética de un cliente de correo electrónico que recupera información de contacto de servidores compatibles con WebFinger:
- Alice abre la página "Agregar contacto" de su cliente de correo electrónico e ingresa la dirección de correo electrónico de Bob
bob@example.com. - La aplicación deriva entonces la URL de WebFinger:
https://example.com/.well-known/webfinger?resource=...- ...el tipo de esquema que busca la aplicación (en este caso queremos tener información de la cuenta):
acct... - ...seguido de un carácter codificado en URL
:, también conocido como%3A... - ...seguido del valor codificado en URL de interés:
bob%40example.com. - El resultado es la URL:
https://example.com/.well-known/webfinger?resource=acct%3Abob%40example.com.
- La aplicación realiza entonces una solicitud HTTP GET a esta URL y recibe del servidor un documento JSON que contiene la información solicitada:
{"Asunto" : "acct:bob@example.com" ,"alias" : ["https://www.example.com/~bob/"],"propiedades" : {"http://example.com/ns/role" : "empleado"},"enlaces" : [{"rel" : "http://webfinger.net/rel/profile-page" ,"href" : "https://www.example.com/~bob/"},{"rel" : "http://webfinger.net/rel/avatar" ,"tipo" : "imagen/png" ,"href" : "https://www.example.com/~bob/avatar.png"}]}
- La aplicación puede entonces analizar el JSON, utilizando las
"rel"propiedades para encontrar usos apropiados para cada URI. Por ejemplo, los enlaces con"rel"http://webfinger.net/rel/profile-pagese pueden usar para completar el campo de página de inicio del usuario, y aquellos con"rel"http://webfinger.net/rel/avatarpodrían usarse como foto de perfil.
Uso del Fediverso
El software de redes sociales basado en Fediverse , como Mastodon , [ 5 ] PeerTube y Misskey, puede buscar el nombre del servidor de un nombre de usuario específico enviando una solicitud al punto final WebFinger del dominio dentro de su nombre de usuario (la parte después del segundo @símbolo -). Esto permite que cualquier entidad con su propio nombre de dominio DNS tenga un conjunto consistente de nombres de usuario de Fediverse, sin tener que ejecutar el software en su propio dominio. Esto es especialmente útil para permitir nombres de usuario de Fediverse consistentes en diferentes softwares de Fediverse con características incongruentes sin tener que alojarlos todos; por ejemplo, una empresa podría tener cuentas en PeerTube y Mastodon con el mismo @bigcompany.tldsufijo sin tener que alojar ninguno de los softwares en su propio dominio. Para los individuos, esta función permite al usuario mantener un nombre de usuario consistente (y su capital social asociado ) incluso si cambia de instancia al servir un archivo JSON con la /.well-known/webfinger?resource=...ruta apropiada en su servidor web.
Ejemplo de nombre de usuario@Mastodon@mastodon.social
Las plataformas y clientes compatibles con WebFinger primero envían una solicitud HTTP GET a https://mastodon.social/.well-known/webfinger?resource=acct%3AMastodon%40mastodon.social. El servidor responde con un documento JSON:
{"Asunto" : "acct:Mastodon@mastodon.social" ,"alias" :["https://mastodon.social/@Mastodon" ,"https://mastodon.social/users/Mastodon"],"enlaces" :[{"rel" : "http://webfinger.net/rel/profile-page" ,"tipo" : "texto/html" ,"href" : "https://mastodon.social/@Mastodon"},{"rel" : "yo" ,"type" : "application/activity+json" ,"href" : "https://mastodon.social/users/Mastodon"},{"rel" : "http://osatatus.org/schema/1.0/subscribe" ,"template" : "https://mastodon.social/authorize_interaction?uri={uri}"},{"rel" : "http://webfinger.net/rel/avatar" ,"tipo" : "imagen/png" ,"href" : "https://files.mastodon.social/accounts/avatars/000/013/179/original/b4ceb19c9c54ec7e.png"}]}Véase también
Referencias
- ^ Jones, Paul E.; Salgueiro, Gonzalo; Jones, Michael B.; Smarr, Joseph (septiembre de 2013). "RFC 7033: WebFinger" .
- ↑ "Final: OpenID Connect Discovery 1.0 incorporando el conjunto de erratas 1" . openid.net . Consultado el 19 de diciembre de 2022 .
- ↑ "OpenID Connect | OpenID" . 1 de agosto de 2011. Consultado el 19 de diciembre de 2022 .
- ↑ Clemens (17 de septiembre de 2011). "Cómo la diáspora conecta a los usuarios" . Sarah Mei . Consultado el 19 de diciembre de 2022 .
- 1 2 "WebFinger - Documentación de Mastodon" . docs.joinmastodon.org . Consultado el 19 de diciembre de 2022 .
- ↑ Borrador del protocolo remoteStorage en el sitio web de la IETF.
- ↑ "FEP-3b86: Intenciones de actividad" . codeberg.org . Consultado el 12 de octubre de 2025 .
- ↑ Presentamos WebFinger
- ↑ Jones, Paul; Salgueiro, Gonzalo; Jones, Michael B.; Smarr, Joseph (septiembre de 2013). WebFinger (Informe). Grupo de Trabajo de Ingeniería de Internet.
Enlaces externos
- sitio web de la comunidad webfinger.net
- Información de WebFinger y software de código abierto
- Implementación del servidor sabre/webfinger por sabre.io
- Webfinger Cloudflare worker de Kurt Seifried
- Protocolos de Internet
- Presentaciones de 2013