World Library  
Flag as Inappropriate
Email this Article


Article Id: WHEBN0003035490
Reproduction Date:

Title: Yadis  
Author: World Heritage Encyclopedia
Language: English
Subject: OpenID, OpenMicroBlogging, MicroID, I-number, Identity 2.0
Collection: Federated Identity
Publisher: World Heritage Encyclopedia


Yadis logo

Yadis is a communications protocol for discovery of services such as OpenID, OAuth, and XDI connected to a Yadis ID. While intended to discover digital identity services, Yadis is not restricted to those. Other services can easily be included.

A Yadis ID can either be a traditional URL or a newer XRI i-name, where the i-name must resolve to a URL. The so-called Yadis URL either equals the Yadis ID (if this is a URL) or the resolved URL of the XRI i-name.

Furthermore, Yadis specifies how to use the Yadis URL to retrieve a service descriptor called Yadis Resource Descriptor. This descriptor follows the XRDS format and connects several services, like authentication or authorization to the Yadis URL. Each service description can have further parameters.


  • Modular architecture 1
  • Discovery of the Yadis Resource Descriptor 2
  • XRDS documents 3
  • LID, OpenID and the developer community 4
  • See also 5
  • External links 6

Modular architecture

Yadis follows the REST-ful, "small pieces loosely joined" paradigm that has proven to be successful in the development of the web.

The basic assumption is that identities can be addressed with URLs or with other identifiers (such as XRI i-names) that can be resolved to URLs. Yadis then associates an XRDS document (an XML-based capability file) with each URL that expresses the associated capabilities or services.

The owner of a Yadis identifier can choose which services he wishes to use in his XRDS document. After retrieving this document, a relying party such as a website accepting Yadis identifiers can select an appropriate services of the XRDS document, e.g. a protocol to use for authentication. This can allow existing web sites, like blogs, to easily implement basic Yadis functionality (for instance, redirecting users who arrive at a blog to relevant information about the person the blog belongs to) while also making it possible to build more advanced applications (for example, allowing complex queries of a site-owner's information to be submitted directly to the Yadis site).

Discovery of the Yadis Resource Descriptor

The capability document associated with an identity URL is found either:

  1. By following a custom HTTP response header called X-XRDS-Location,
  2. By an equivalent entry in the HTML HEAD section, called
    , or
  3. By requesting a special mime type called application/xrds+xml when performing an HTTP GET on the identity URL.

Developers can choose which of the alternatives to implement, based on factors such as whether they can run software at the identity URL or not.

XRDS documents

Here is an example XRDS capability document:


If this XRDS document was returned, using one of the listed mechanisms, for a URL, it would express the following information:

  • The URL is a Yadis identity URL.
  • This URL supports the OpenID protocol, through two servers and two delegates.
  • This URL supports version 1.0 and version 2.0 of the LID protocol, with a delegate.
  • The owner of this identity URL prefers to sign-on using their LiveJournal account and the OpenID protocol (priority 10). If that is not possible (e.g. because a relying party does not support OpenID, or because the LiveJournal server is unavailable), the owner would like to use the LID URL (priority 20), followed by the MyOpenID service (priority 50).

LID, OpenID and the developer community

Yadis was initiated by developers of the OASIS XRI Technical Committee, particularly those working on i-names.

However, Yadis is an open initiative, so other developers will start using XRDS lightweight capabilities description, making possible a "mix and match" approach to building Yadis-enabled applications, enabling application developers to choose their own balance between ease of implementation on one hand, and range of features on the other.

See also

External links

  • Yadis Documentation
This article was sourced from Creative Commons Attribution-ShareAlike License; additional terms may apply. World Heritage Encyclopedia content is assembled from numerous content providers, Open Access Publishing, and in compliance with The Fair Access to Science and Technology Research Act (FASTR), Wikimedia Foundation, Inc., Public Library of Science, The Encyclopedia of Life, Open Book Publishers (OBP), PubMed, U.S. National Library of Medicine, National Center for Biotechnology Information, U.S. National Library of Medicine, National Institutes of Health (NIH), U.S. Department of Health & Human Services, and, which sources content from all federal, state, local, tribal, and territorial government publication portals (.gov, .mil, .edu). Funding for and content contributors is made possible from the U.S. Congress, E-Government Act of 2002.
Crowd sourced content that is contributed to World Heritage Encyclopedia is peer reviewed and edited by our editorial staff to ensure quality scholarly research articles.
By using this site, you agree to the Terms of Use and Privacy Policy. World Heritage Encyclopedia™ is a registered trademark of the World Public Library Association, a non-profit organization.

Copyright © World Library Foundation. All rights reserved. eBooks from Project Gutenberg are sponsored by the World Library Foundation,
a 501c(4) Member's Support Non-Profit Organization, and is NOT affiliated with any governmental agency or department.