This FEP specifies a method by which website authors can attach their fediverse profile to link previews generated by fediverse software for that website, through the combination of a new OpenGraph-style meta property and an ActivityPub-side security mechanism to prevent spoofing.
Websites use OpenGraph meta properties in their HTML markup to control (or at least influence) how link previews generated in various applications, such as instant messengers and social media platforms, will render. Information such as title, website name, thumbnail picture, and author name are typically provided. This is especially common for websites that host individual articles, such as news sites, magazines, blogs, and other social media platforms.
Often, the author of a website is present on the social media platform where the links to the website are being shared. However, usually there is no quick way to navigate to the author’s social media profile from the link preview. Some social media platforms, like Twitter and Facebook, have added OpenGraph-style meta properties for linking a website with a Twitter (twitter:site) or Facebook (fb:app_id) profile. However, at the time of writing, even those properties don’t result in a user-accessible way to navigate to the respective profile.
In Twitter documentation, references to a property called twitter:creator can be found, with similar argumentation as this FEP; however, it does not seem to be in use or have ever been widely used.
Being able to navigate to the social media profile of a website’s author from that website’s link preview is a win-win situation for the author and for the platform:
This FEP defines a new meta property fediverse:creator:
<meta name="fediverse:creator" content="@alice@example.com" />
Which can appear in the <head> section of any website.
The content attribute is to contain the WebFinger handle of the author’s fediverse profile, i.e. username and domain separated by an @-symbol. A leading @ can be included and ignored when processing. This format was chosen for its user-friendliness, as this style of handle is what users would be used to seeing and typing when using most fediverse software.
The property can appear on the same page more than once to reference multiple authors. However, the display of more than one author and enforcement of a maximum number is left to the interpretation of individual platform implementers.
It’s trivial to imagine a scenario where a malicious website could be deliberately created to damage the reputation of unaffiliated social media users. By displaying a social media profile next to the link preview and facilitating quick navigation (and interactivity) to the “author”, dogpiling, harassment and abuse can be directed from unsuspecting social media users (who see a malicious, e.g. bigoted, villanious, illegal website) towards other unsuspecting social media users who have nothing to do with it.
To prevent this, a two-way verification must be established between the website that advertises a fediverse:creator tag, and the fediverse profile within.
For this purpose, a new property for the JSON-LD Actor entity is defined: attributionDomains. This property is defined as a JSON-LD @set, an unordered array of string values, each being a hostname (domain) which is allowed to reference the Actor using fediverse:creator.
Example:
{
"@context": [
"https://www.w3.org/ns/activitystreams",
{
"attributionDomains": {
"@id": "https://joinmastodon.org/ns#attributionDomains",
"@container": "@set"
}
}
],
"attributionDomains": [
"techcrunch.com",
"theverge.com"
]
}
A fediverse:creator tag should only be processed if the website its on has its hostname listed in the attributionDomains property. attributionDomains only needs to list the top-level domain name to permit references from subdomains, e.g. example.com should allow references from pages on foo.example.com or foo.bar.example.com.
In line with the above, the procedure for processing a fediverse:creator tag on a link preview is as follows:
<meta> tag with the name or property attribute equal to fediverse:creator.content attribute of the tag and resolve it to an ActivityPub actor using WebFinger or local cache as seen fit.attributionDomains property of the actor.
fediverse:creator tag. Alternatively, you may notify the actor if they are on your platform and ask them if they want to add this hostname to their attributionDomains.A fediverse:creator tag must not be processed if the hostname of the website it’s on is not referenced from the target profile’s attributionDomains property.
List of fediverse software that can interpret and render fediverse:creator information.
List of notable websites that are publishing fediverse:creator information.
CC0 1.0 Universal (CC0 1.0) Public Domain Dedication
To the extent possible under law, the authors of this Fediverse Enhancement Proposal have waived all copyright and related or neighboring rights to this work.