A global distributed Social Web requires that each person be able to control their identity, that this identity be linkable across sites - placing each person in a Web of relationships - and that it be possible to authenticate globally with such identities.
This specification outlines a simple universal identification mechanism that is distributed, openly extensible, improves privacy, security and control over how each person can identify themselves in order to allow fine grained access control to their information on the Web. It does this by applying the best practices of Web Architecture whilst building on well established widely deployed protocols and standards including HTML, URIs, HTTP, and RDF Semantics.
There are a number of concepts that are covered in this document that the reader may want to be aware of before continuing. General knowledge of RDF [[!RDF-PRIMER]] is necessary to understand how to implement this specification. WebID uses a number of specific technologies like Turtle [[!TURTLE-TR]] and RDFa [[!RDFA-CORE]].
A general Introduction is provided for all that would like to understand why this specification is necessary to simplify usage of the Web.
The terms used throughout this specification are listed in the section titled Terminology.
A WebID is an HTTP URI which refers to an Agent (Person, Organization, Group, Device, etc.). A description of the WebID can be found in the
A WebID
WebIDs can be used to build a Web of trust using vocabularies such as FOAF [[!FOAF]] by allowing people to link together their profiles in a public or protected manner.
Such a web of trust can then be used by a
This specification is divided in the following sections.
This section gives a high level overview of WebID, and presents the organization of the specification and the conventions used throughout the document.
Section 2 provides a short description for the most commonly used terms in this document.
Section 3 describes what a WebID URI is.
Section 4 presents an overview of WebID.
Section 5 deals with the publishing of a
Section 6 describes how a request for a
This section provides definitions for several important terms used in this document.
Examples assume the following namespace prefix bindings unless otherwise stated:
Prefix | IRI |
---|---|
foaf |
http://xmlns.com/foaf/0.1/ |
The WebID HTTP URI must be one that dereferences to a document the user controls.
For example, if a user Bob controls https://bob.example/profile
,
then his WebID can be https://bob.example/profile#me
.
Hash URIs are encouraged when choosing a WebID since 303 redirects require an extra HTTP request for an Agent to get from the
The relation between the
The WebID URI - "http://www.w3.org/People/Berners-Lee/card#i" - is an Identifier that denotes (refers to) a person or more generally an agent: in the illustration the referent is Tim Bernsers Lee, the real physical person who has a history, who invented the World Wide Web, who acts in the world, ...
The WebID Profile URI - "http://www.w3.org/People/Berners-Lee/card" - denotes the document describing the person (or more generally any agent) who is the referent of the WebID URI.
The WebID Profile gives the sense of the WebID: its RDF Graph contains a Concise Bounded Description of the WebID such that this subgraph forms a definite description of the referent of the WebID, that is, a description that distinguishes the referent of that WebID from all other things in the world.
The document can for example contain relations to another document depicting the WebID referent.
Or it can related the WebID to Principals used by different authentication protocols.
( More information on WebID and other authentication protocols can be found on the WebID Identity Interoperability page ).
WebID requires that servers MUST at least be able to provide Turtle representation of profile documents, but other serialization formats of the graph are allowed, provided that agents are able to parse that serialization and obtain the graph automatically. Technologies such as GRDDL [[!GRDDL-PRIMER]] for example permit any XML format to be transformed automatically to a graph of relations. HTTP Content Negotiation can be employed to aid in publication and discovery of multiple distinct serializations of the same graph at the same URL, as explained by the working group note Best Practice Recipes for Publishing RDF Vocabularies [[!SWBP-VOCAB-PUB]]
It is particularly useful to have one of the representations be in HTML even if it is not marked up in RDFa as this allows people using a web browser to understand what the information at that URI represents.
WebID RDF graphs are built using vocabularies identified by URIs, that can be placed in subject, predicate or object position of the relations constituting the graph. The definition of each URI should be found at the namespace of the URI, by dereferencing it.
Personal details are the most common requirement when registering an
account with a website. Some of these pieces of information include an e-mail
address, a name and perhaps an avatar image. This section includes
properties that SHOULD be used when conveying key pieces of personal information
but are NOT REQUIRED to be present in a
A widely used format for writing RDF graphs by hand is the Turtle [[!TURTLE-TR]] notation.
It is easy to learn, and very handy for communicating over e-mail and on mailing lists.
The syntax is very similar to the SPARQL query language.
Turtle profile documents should be served with the text/turtle
content type.
Take for example the WebID https://bob.example/profile#me, for which the WebID Profile document contains the following Turtle representation:
@prefix foaf: <http://xmlns.com/foaf/0.1/> . <#me> a foaf:Person; foaf:name "Bob"; foaf:knows <https://example.edu/p/Alice#MSc>; foaf:img <http://bob.example/picture.jpg>.
RDFa in HTML [[!RDFA-CORE]] is a way to markup HTML with relations that have a well defined semantics and mapping to an RDF graph. There are many ways of writing out the above graph using RDFa in HTML. Here is just one example of what a WebID profile could look like.
<div vocab="http://xmlns.com/foaf/0.1/" about="#me" typeof="foaf:Person"> <p>My name is <span property="name">Bob</span> and this is how I look like: <img property="img" src="http://bob.example/picture.jpg" title="Bob" alt="Bob" /></p> <h2>My Good Friends</h2> <ul> <li property="knows" href="https://example.edu/p/Alice#MSc">Alice</li> </ul> </div>
If a WebID provider would rather prefer not to mark up his data in RDFa, but just provide a human readable format for users and have the RDF graph appear in a machine readable format such as RDF/XML then a link from the HTML to a machine readable format MAY be published as follows:
<html> <head> <link rel="alternate" type="application/rdf+xml" href="profile.rdf"/> </head> <body> ... </body> </html>
A WebID Profile document does not need to contain only public resources. A possible way of protecting its contents can be achieved by separating parts of the profile information into separate documents, each protected by access control policies. In the following example, Bob is limiting access to his list of friends, by placing all foaf:knows relations into a separate document.
@prefix foaf: <http://xmlns.com/foaf/0.1/> . @prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> . <#me> a foaf:Person; foaf:name "Bob"; rdfs:seeAlso <https://bob.example/friends>; foaf:img <http://bob.example/picture.jpg>.
Where https://bob.example/friends is a reference to an ACL protected document containing:
@prefix foaf: <http://xmlns.com/foaf/0.1/> . <https://bob.example/profile#me> a foaf:Person; foaf:knows <https://example.edu/p/Alice#MSc>; foaf:knows <https://example.com/people/Mary/card#me>.
Having the following corresponding ACL rule, expressed using the WebAccessControl ontology:
@prefix acl: <http://www.w3.org/ns/auth/acl#> . <#FriendsOnly> <acl:accessTo> <https://bob.example/friends>; <acl:agent> <http://example.edu/p/Alice#Msc>, <http://example.com/people/Mary/card#me>; <acl:mode> <acl:Read>.
The
It is important that the text/turtle
with a higher priority than application/xhtml+xml
(RDFa) and application/rdf+xml
(RDF/XML). The reason is that it is quite likely that many sites will produce non marked up HTML and leave the graph in pure RDF formats.
If the
The following people have been instrumental in providing thoughts, feedback, reviews, criticism and input in the creation of this specification:
Stéphane Corlosquet, Kingsley Idehen, Ted Thibodeau, Alexandre Bertails, Thomas Bergwinkl.