WebFinger

<h2 id="example">Example</h2>
<h3>Basic example with profile page and business card</h3>

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

<p>Server response:
</p>
{
	"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"
		}
	]
}

<h3>Usage on Mastodon</h3>
<p>On Mastodon, any federated servers can look up users by sending a request to the WebFinger endpoint on other servers.<a class="footnote-ref" id="fnref:8" href="#fn:8"><sup>8</sup></a> Here is an example for the user@Mastodon@mastodon.social:
</p><p>
Client request:</p>GET /.well-known/webfinger?resource=acct%3AMastodon%40mastodon.social HTTP/1.1
Host: mastodon.social
<p>Server response:</p>{
    "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}"
        }
    ]
}

<h2 id="see-also">See also</h2>
<ul><li><a href="/facts/Authorization/FYFAkCH2">Authorization</a></li>
<li><a href="/facts/IndieAuth/E9FoR74g">IndieAuth</a></li>
<li><a href="/facts/OpenID/Vpx5mbcV">OpenID</a></li>
<li><a href="/facts/OpenID_Connect/Vpx5mbcV">OpenID Connect</a></li>
<li><a href="/facts/WebID/bBX6QrEe">WebID</a></li></ul>

<h2 id="external-links">External links</h2>
<ul><li><a href="https://webfinger.net/">webfinger.net community site</a></li>
<li><a href="http://www.packetizer.com/webfinger/">WebFinger information and open source software</a></li>
<li><a href="https://github.com/sabre-io/webfinger">sabre/webfinger server implementation</a> by <a href="https://sabre.io/">sabre.io</a></li>
<li><a href="https://github.com/cloudsecurityalliance/webfinger-cloudflare-worker">webfinger Cloudflare worker</a> by <a href="https://seifried.org/">Kurt Seifried</a></li></ul>

<h2 id="references">References</h2>

<ol>
<li id="fn:1"><p>Jones, Paul E.; Salgueiro, Gonzalo; Jones, Michael B.; Smarr, Joseph (September 2013). "RFC 7033: WebFinger". <a href="http://tools.ietf.org/html/rfc7033" target="_blank">http://tools.ietf.org/html/rfc7033</a> <a href="#fnref:1" class="footnote-back-ref">↩</a></p></li>
<li id="fn:2"><p>"Final: OpenID Connect Discovery 1.0 incorporating errata set 1". openid.net. Retrieved 2022-12-19. <a href="https://openid.net/specs/openid-connect-discovery-1_0.html" target="_blank">https://openid.net/specs/openid-connect-discovery-1_0.html</a> <a href="#fnref:2" class="footnote-back-ref">↩</a></p></li>
<li id="fn:3"><p>"OpenID Connect | OpenID". 2011-08-01. Retrieved 2022-12-19. <a href="https://openid.net/connect/" target="_blank">https://openid.net/connect/</a> <a href="#fnref:3" class="footnote-back-ref">↩</a></p></li>
<li id="fn:4"><p>Clemens (2011-09-17). "How Diaspora Connects Users". Sarah Mei. Retrieved 2022-12-19. <a href="http://www.sarahmei.com/blog/2011/09/17/how-diaspora-connects-users/" target="_blank">http://www.sarahmei.com/blog/2011/09/17/how-diaspora-connects-users/</a> <a href="#fnref:4" class="footnote-back-ref">↩</a></p></li>
<li id="fn:5"><p>"WebFinger - Mastodon documentation". docs.joinmastodon.org. Retrieved 2022-12-19. <a href="https://docs.joinmastodon.org/spec/webfinger/" target="_blank">https://docs.joinmastodon.org/spec/webfinger/</a> <a href="#fnref:5" class="footnote-back-ref">↩</a></p></li>
<li id="fn:6"><p>remoteStorage protocol draft at the IETF website. <a href="https://datatracker.ietf.org/doc/draft-dejong-remotestorage/" target="_blank">https://datatracker.ietf.org/doc/draft-dejong-remotestorage/</a> <a href="#fnref:6" class="footnote-back-ref">↩</a></p></li>
<li id="fn:7"><p>Introducing WebFinger <a href="http://hueniverse.com/2009/08/20/introducing-webfinger/" target="_blank">http://hueniverse.com/2009/08/20/introducing-webfinger/</a> <a href="#fnref:7" class="footnote-back-ref">↩</a></p></li>
<li id="fn:8"><p>"WebFinger - Mastodon documentation". docs.joinmastodon.org. Retrieved 2022-12-19. <a href="https://docs.joinmastodon.org/spec/webfinger/" target="_blank">https://docs.joinmastodon.org/spec/webfinger/</a> <a href="#fnref:8" class="footnote-back-ref">↩</a></p></li>
</ol>

WebFinger open-in-new

WebFinger