fbpx
Wikipedia

WebFinger

WebFinger is a protocol specified by the Internet Engineering Task Force IETF in RFC 7033 that allows for discovery of information about people and things identified by a URI.[1] Information about a person might be discovered via an acct: URI, for example, which is a URI that looks like an email address.

Logo of WebFinger

WebFinger is specified as the discovery protocol for OpenID Connect,[2] which is a protocol that allows one to more easily log in to various sites on the Internet.[3]

The WebFinger protocol is used by federated software, such as GNU social,[citation needed] Diaspora,[4] or Mastodon,[5] to discover users on federated nodes and pods, as well as the remoteStorage protocol.[6]

As a historical note, the name "WebFinger" is derived from the old ARPANET Finger protocol, but it is a very different protocol designed for HTTP.[7]

The protocol payload is represented in JSON format.

Example edit

Basic example with profile page and business card edit

 
Example format of a WebFinger JSON data model.

Client request:

GET /.well-known/webfinger?resource=acct%3Abob%40example.com HTTP/1.1 Host: example.com 

Server response:

{  "subject": "acct:bob@example.com",  "aliases": [  "https://www.example.com/~bob/"  ],  "properties": {  "http://example.com/ns/role": "employee"  },  "links": [{  "rel": "http://webfinger.example/rel/profile-page",  "href": "https://www.example.com/~bob/"  },  {  "rel": "http://webfinger.example/rel/businesscard",  "href": "https://www.example.com/~bob/bob.vcf"  }  ] } 

Usage on Mastodon edit

On Mastodon, any federated servers can look up users by sending a request to the WebFinger endpoint on other servers.[5] Here is an example for the user@Mastodon@mastodon.social:

Client request:

GET /.well-known/webfinger?resource=acct%3AMastodon%40mastodon.social HTTP/1.1 Host: mastodon.social 

Server response:

{  "subject": "acct:Mastodon@mastodon.social",  "aliases": [  "https://mastodon.social/@Mastodon",  "https://mastodon.social/users/Mastodon"  ],  "links": [  {  "rel": "http://webfinger.net/rel/profile-page",  "type": "text/html",  "href": "https://mastodon.social/@Mastodon"  },  {  "rel": "self",  "type": "application/activity+json",  "href": "https://mastodon.social/users/Mastodon"  },  {  "rel": "http://ostatus.org/schema/1.0/subscribe",  "template": "https://mastodon.social/authorize_interaction?uri={uri}"  }  ] } 

See also edit

References edit

  1. ^ Jones, Paul E.; Salgueiro, Gonzalo; Jones, Michael B.; Smarr, Joseph (September 2013). "RFC 7033: WebFinger".
  2. ^ "Final: OpenID Connect Discovery 1.0 incorporating errata set 1". openid.net. Retrieved 2022-12-19.
  3. ^ "OpenID Connect | OpenID". 2011-08-01. Retrieved 2022-12-19.
  4. ^ Clemens (2011-09-17). "How Diaspora Connects Users". Sarah Mei. Retrieved 2022-12-19.
  5. ^ a b "WebFinger - Mastodon documentation". docs.joinmastodon.org. Retrieved 2022-12-19.
  6. ^ remoteStorage protocol draft at the IETF website.
  7. ^ Introducing WebFinger

External links edit

  • webfinger.net community site
  • WebFinger information and open source software
  • sabre/webfinger server implementation by sabre.io
  • webfinger Cloudflare worker by Kurt Seifried

webfinger, protocol, specified, internet, engineering, task, force, ietf, 7033, that, allows, discovery, information, about, people, things, identified, information, about, person, might, discovered, acct, example, which, that, looks, like, email, address, log. WebFinger is a protocol specified by the Internet Engineering Task Force IETF in RFC 7033 that allows for discovery of information about people and things identified by a URI 1 Information about a person might be discovered via an acct URI for example which is a URI that looks like an email address Logo of WebFingerWebFinger is specified as the discovery protocol for OpenID Connect 2 which is a protocol that allows one to more easily log in to various sites on the Internet 3 The WebFinger protocol is used by federated software such as GNU social citation needed Diaspora 4 or Mastodon 5 to discover users on federated nodes and pods as well as the remoteStorage protocol 6 As a historical note the name WebFinger is derived from the old ARPANET Finger protocol but it is a very different protocol designed for HTTP 7 The protocol payload is represented in JSON format Contents 1 Example 1 1 Basic example with profile page and business card 1 2 Usage on Mastodon 2 See also 3 References 4 External linksExample editBasic example with profile page and business card edit nbsp Example format of a WebFinger JSON data model Client request GET well known webfinger resource acct 3Abob 40example com HTTP 1 1 Host example com Server response subject acct bob example com aliases https www example com bob properties http example com ns role employee links rel http webfinger example rel profile page href https www example com bob rel http webfinger example rel businesscard href https www example com bob bob vcf Usage on Mastodon edit On Mastodon any federated servers can look up users by sending a request to the WebFinger endpoint on other servers 5 Here is an example for the user Mastodon mastodon social Client request GET well known webfinger resource acct 3AMastodon 40mastodon social HTTP 1 1 Host mastodon socialServer response subject acct Mastodon mastodon social aliases https mastodon social Mastodon https mastodon social users Mastodon links rel http webfinger net rel profile page type text html href https mastodon social Mastodon rel self type application activity json href https mastodon social users Mastodon rel http ostatus org schema 1 0 subscribe template https mastodon social authorize interaction uri uri See also editAuthorization IndieAuth OpenID OpenID Connect WebIDReferences edit Jones Paul E Salgueiro Gonzalo Jones Michael B Smarr Joseph September 2013 RFC 7033 WebFinger Final OpenID Connect Discovery 1 0 incorporating errata set 1 openid net Retrieved 2022 12 19 OpenID Connect OpenID 2011 08 01 Retrieved 2022 12 19 Clemens 2011 09 17 How Diaspora Connects Users Sarah Mei Retrieved 2022 12 19 a b WebFinger Mastodon documentation docs joinmastodon org Retrieved 2022 12 19 remoteStorage protocol draft at the IETF website Introducing WebFingerExternal links editwebfinger net community site WebFinger information and open source software sabre webfinger server implementation by sabre io webfinger Cloudflare worker by Kurt Seifried Retrieved from https en wikipedia org w index php title WebFinger amp oldid 1175710788, wikipedia, wiki, book, books, library,

article

, read, download, free, free download, mp3, video, mp4, 3gp, jpg, jpeg, gif, png, picture, music, song, movie, book, game, games.