TOC |
|
By submitting this Internet-Draft, each author represents that any applicable patent or other IPR claims of which he or she is aware have been or will be disclosed, and any of which he or she becomes aware will be disclosed, in accordance with Section 6 of BCP 79.
Internet-Drafts are working documents of the Internet Engineering Task Force (IETF), its areas, and its working groups. Note that other groups may also distribute working documents as Internet-Drafts.
Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as “work in progress.”
The list of current Internet-Drafts can be accessed at http://www.ietf.org/ietf/1id-abstracts.txt.
The list of Internet-Draft Shadow Directories can be accessed at http://www.ietf.org/shadow.html.
This Internet-Draft will expire on June 13, 2008.
Copyright © The IETF Trust (2007).
This specification defines MicroID, a lightweight identity technology that enables the creation of a portable identity token based on any two Uniform Resource Identifiers.
1. Introduction
1.1. Overview
1.2. Terminology
1.3. Discussion Venue
1.4. Acknowledgements
2. Format
3. Generation
4. Processing
5. Meaning
5.1. Overview
5.2. Generating Applications
5.3. Using Technologies
6. Internationalization Considerations
7. Security Considerations
8. References
8.1. Normative References
8.2. Informative References
Appendix A. Legacy Support
Appendix B. Copying Conditions
§ Authors' Addresses
§ Intellectual Property and Copyright Statements
TOC |
TOC |
MicroID is a lightweight identity technology that enables the creation of a portable identity token from any two Uniform Resource Identifiers [URI] (Berners-Lee, T., Fielding, R., and L. Masinter, “Uniform Resource Identifier (URI): Generic Syntax,” January 2005.).
Such identity tokens are desirable because they:
TOC |
The following keywords as used in this document are to be interpreted as described in [TERMS] (Bradner, S., “Key words for use in RFCs to Indicate Requirement Levels,” March 1997.): "MUST", "SHALL", "REQUIRED"; "MUST NOT", "SHALL NOT"; "SHOULD", "RECOMMENDED"; "SHOULD NOT", "NOT RECOMMENDED"; "MAY", "OPTIONAL".
TOC |
The preferred discussion forum for this specification is the MicroID mailing list; subscription information is located at <http://lists.ibiblio.org/mailman/listinfo/microid> and the mailing list archives are located at <http://lists.ibiblio.org/pipermail/microid/>.
TOC |
Thanks to James Cridland, Yaniv Golan, David Koblas, Paco Nathan, Will Norris, Evan Prodromou, Chris Roos, Terrell Russell, Eran Sandler, and Brian Suda for their feedback.
TOC |
The syntax for a MicroID is defined as follows, using the Augmented Backus-Naur Form specified in [ABNF] (Crocker, D. and P. Overell, “Augmented BNF for Syntax Specifications: ABNF,” October 2005.).
microid = inputs ":" algo ":" hash inputs = scheme "+" scheme scheme = ALPHA *( ALPHA / DIGIT / "+" / "-" / "." ) ; a URI scheme name (e.g., mailto) algo = ALPHA *( ALPHA / DIGIT ) ; the short name of a hashing ; algorithm (e.g., sha256), hash = *( ALPHA / DIGIT ) ; a hash of the URIs for both entities
Note: If the URI scheme name includes the "+" character (which is allowed by [URI] (Berners-Lee, T., Fielding, R., and L. Masinter, “Uniform Resource Identifier (URI): Generic Syntax,” January 2005.) but not in common use), that character MUST be escaped to %2B.
Note: The algorithm names should be as registered with the IANA in the Hash Function Textual Names registry located at <http://www.iana.org/assignments/hash-function-text-names>, but may exclude the "-" character (e.g., "sha1" rather than "sha-1").
Note: See the Legacy Support (Legacy Support) section of this document for information regarding the original MicroID format.
TOC |
The method for generating the hash is:
hash = algo( algo(EntityURI) + algo(EntityURI) )
The "algo" MAY be any recognized hashing algorithm, such as those defined in [SHA] (National Institute of Standards and Technology, “Secure Hash Standard,” August 2002.). Support for the sha1 and sha256 algorithms is REQUIRED for interoperability. The output MUST be in hexadecimal (not base64) format. The same algorithm MUST be used for all hashing functions when generating a given MicroID.
The "EntityURI" MAY conform to any URI scheme, such as [HTTP] (Fielding, R., Gettys, J., Mogul, J., Frystyk, H., Masinter, L., Leach, P., and T. Berners-Lee, “Hypertext Transfer Protocol -- HTTP/1.1,” June 1999.), , [SIP] (Rosenberg, J., Schulzrinne, H., Camarillo, G., Johnston, A., Peterson, J., Sparks, R., Handley, M., and E. Schooler, “SIP: Session Initiation Protocol,” June 2002.), or [XMPP] (Saint-Andre, P., “Internationalized Resource Identifiers (IRIs) and Uniform Resource Identifiers (URIs) for the Extensible Messaging and Presence Protocol (XMPP),” August 2006.).
As an example, consider the following inputs, from which a MicroID is generated using the sha1 algorithm:
The hash is generated as follows (note: the line break in the third example is included only for the sake of readability):
sha1( sha1(xmpp:) + sha1(https://www.xmpp.net/) ) sha1( afa6353518f818af2f036da336c3097dedc00dee + 3115de01ebfa34a34314060b5f30038b0fa359f8 ) sha1( afa6353518f818af2f036da336c3097dedc00dee 3115de01ebfa34a34314060b5f30038b0fa359f8 ) 6196ea6709be2a4cbdf2bc0cfaeac491f2fb8921
Thus in accordance with the format previously described the issued MicroID is:
xmpp+https:sha1:6196ea6709be2a4cbdf2bc0cfaeac491f2fb8921
TOC |
A processing application MAY use only the hash portion of the MicroID for comparison purposes. An implementation SHOULD be liberal in accepting MicroIDs that conform to the legacy format; for details, see the Legacy Support (Legacy Support) section of this document.
TOC |
TOC |
By itself, a MicroID has no inherent meaning, since it is simply a string created from two URIs. Any entity can generate a MicroID even if it has not verified the identity of the resources associated with one or both URIs. Furthermore, a MicroID is easily copied by an entity that did not generate it. Finally, a MicroID is not digitally signed by the entity that generated it and therefore cannot be cryptographically associated with the generating entity.
Therefore it may be wondered: what is the meaning of a MicroID? The answer is: any meaning imputed to a MicroID results from the context in which it is used. That context includes the nature of the generating application and the nature of the using technology.
Some possible generating applications and using technologies are described in the following sections. We use the following terms to describe the parties involved in the generation and processing of a MicroID:
A MicroID should be generated by an issuer, not by an individual. The issuer may be the service provider that hosts the information about, content created by, or reputation earned by an individual, or it may be a third party trusted by both the individual and the service provider.
An issuer should not generate a MicroID until it has verified that the individual or service provider has control over a given entity URI. Methods for such verification are out of scope for this specification and may vary according to local service policies and the URI scheme in question.
The first entity URI should be that of the individual and the second EntityURI should be that of the service provider. Any given entity URI may have meaning above and beyond that encapsulated in the relevant URI scheme; for example, the HTTP URI for an individual could be hosted by an OpenID service (see <http://openid.net/>). However, MicroID places no restrictions on the semantics of a given entity URI.
TOC |
TOC |
It is envisioned that one common deployment scenario will be that of a service provider "stamping" information or reputation that is hosted by the service provider on behalf of individuals. In this architecture, the service provider is both the issuer and one of the entities, where the other entity is an individual.
+--------+ | Entity | +--------+ | | registration | +-------------------+ | Service Provider | | (Entity + Issuer) | +-------------------+ | | issuance | MicroID
Whether a given consumer imputes meaning to the MicroID in this scenario depends on the consumer's relationship to the service provider, whether the consumer has some trust in the information presented by the service provider, etc.
TOC |
Another scenario is that in which the MicroID is issued by a trusted third party (e.g., a part with which both a service provider and individual have registered). In this architecture, the service provider is merely one of the entities.
+--------+ +------------------+ | Entity | | Service Provider | +--------+ +------------------+ | | | | +-----------------+ | | registration | +--------+ | Issuer | +--------+ | | issuance | MicroID
Whether a given consumer imputes meaning to the MicroID in this scenario depends on the consumer's relationship to the third part, whether the consumer has some trust in the information presented by the third party, whether the consumer is one of the entities, etc.
TOC |
This specification does not limit the technologies that might make use of MicroIDs, and future versions of this specification might describe a wide range of such uses. Here we describe two such uses.
Note: The scope of information (e.g., markup) covered by a MicroID depends on the nature of the using technology and must be defined separately by each using technology.
TOC |
One possible use is to include a MicroID in the HyperText Markup Language [HTML] (Jacobs, I., Raggett, D., and A. Hors, “HTML 4.01 Specification,” December 1999.) class attribute. The recommended format is to prepend the MicroID itself with the string "microid-", as shown in the following example:
<p class='microid-xmpp+https:sha1: 6196ea6709be2a4cbdf2bc0cfaeac491f2fb8921'> mycontent</p>
In this usage, the scope of the MicroID is all information contained within the element that possesses the class attribute, whether that information is represented as attributes, character data, or child elements. However, any given child element may itself possess a class attribute specifying a MicroID that overrides the content claim asserted by the parent element. In all cases, the relevant claim is always that of the nearest containing element in the hierarchy.
A MicroID can be used on its own to mark content as created by a certain individual (e.g., a comment made on a web forum):
<div class=' microid-xmpp+https:sha1:6196ea6709be2a4cbdf2bc0cfaeac491f2fb8921'> <p>This is a great idea!</p> </div>
A MicroID can be also used in concert with other lightweight identity technologies such as the rel='me' value defined by XHTML Friends Network (XFN) as specified at <http://gmpg.org/xfn/11>:
<div class=' microid-xmpp+https:sha1:6196ea6709be2a4cbdf2bc0cfaeac491f2fb8921'> <p>This is a great idea!</p> <p>--<a rel='me' href='http://2idi.com/contact/=stpeter'> stpeter</a></p> </div>
TOC |
Another possible use is in meta data about an [HTML] (Jacobs, I., Raggett, D., and A. Hors, “HTML 4.01 Specification,” December 1999.) file (e.g., to signify that a given web page is created by, owned by, or about a given Individual). This is done by including a <meta/> tag whose 'name' attribute is "microid" and whose 'content' attribute specifies the MicroID, as shown in the following example:
<meta name='microid' content='xmpp+https:sha1:6196ea6709be2a4cbdf2bc0cfaeac491f2fb8921'/>
In this usage, the scope of the MicroID is the page itself. However, the whole-page claim represented in the META tag can be overridden by claims represented in class attributes possessed by elements within the HTML body.
A file MAY contain multiple META tags with a name of "microid" (e.g., to claim ownership by multiple authors or to represent multiple identities associated with the same individual).
TOC |
A MicroID SHOULD be constructed using two Uniform Resource Identifiers [URI] (Berners-Lee, T., Fielding, R., and L. Masinter, “Uniform Resource Identifier (URI): Generic Syntax,” January 2005.) but one or both inputs MAY instead be an Internationalized Resource Identifier [IRI] (Duerst, M. and M. Suignard, “Internationalized Resource Identifiers (IRIs),” January 2005.).
TOC |
MicroID is a technology for identifying the ownership or authorship of information on the Internet. It is not a mechanism for authentication, authorization, security, or encryption. Use of MicroID technology results only in weak verification of identities (if any). MicroID may be susceptible to [DNS] (Mockapetris, P., “Domain names - implementation and specification,” November 1987.) poisoning attacks unless [DNSSEC] (Arends, R., Austein, R., Larson, M., Massey, D., and S. Rose, “DNS Security Introduction and Requirements,” March 2005.) is used, since most URIs depend on DNS.
TOC |
TOC |
[ABNF] | and , “Augmented BNF for Syntax Specifications: ABNF,” RFC 4234, October 2005 (TXT). |
[SHA] | National Institute of Standards and Technology, “Secure Hash Standard,” FIPS PUB 180-2, August 2002. |
[TERMS] | , “Key words for use in RFCs to Indicate Requirement Levels,” BCP 14, RFC 2119, March 1997 (TXT, HTML, XML). |
[URI] | , , and , “Uniform Resource Identifier (URI): Generic Syntax,” STD 66, RFC 3986, January 2005 (TXT, HTML, XML). |
TOC |
[DNS] | Mockapetris, P., “Domain names - implementation and specification,” STD 13, RFC 1035, November 1987 (TXT). |
[DNSSEC] | Arends, R., Austein, R., Larson, M., Massey, D., and S. Rose, “DNS Security Introduction and Requirements,” RFC 4033, March 2005 (TXT). |
[HTML] | Jacobs, I., Raggett, D., and A. Hors, “HTML 4.01 Specification,” World Wide Web Consortium Recommendation REC-html401-19991224, December 1999 (HTML). |
[HTTP] | , , , , , , and , “Hypertext Transfer Protocol -- HTTP/1.1,” RFC 2616, June 1999 (TXT, PS, PDF, HTML, XML). |
[IRI] | Duerst, M. and M. Suignard, “Internationalized Resource Identifiers (IRIs),” RFC 3987, January 2005 (TXT). |
, , and , “The mailto URL scheme,” RFC 2368, July 1998 (TXT, HTML, XML). | |
[SIP] | Rosenberg, J., Schulzrinne, H., Camarillo, G., Johnston, A., Peterson, J., Sparks, R., Handley, M., and E. Schooler, “SIP: Session Initiation Protocol,” RFC 3261, June 2002 (TXT). |
[XMPP] | Saint-Andre, P., “Internationalized Resource Identifiers (IRIs) and Uniform Resource Identifiers (URIs) for the Extensible Messaging and Presence Protocol (XMPP),” RFC 4622, August 2006 (TXT). |
TOC |
MicroID originally assumed the use of sha1 as the hashing algorithm and did not specify the schemes of the EntityURI inputs, resulting in the following format:
microid = hash hash = *( ALPHA / DIGIT ) ; a hash of the URIs for both entities
For example, using the same inputs as shown in the body of this specification, the MicroID in legacy format would be:
6196ea6709be2a4cbdf2bc0cfaeac491f2fb8921
An implementation MUST generate MicroIDs in the format specified in the Format (Format) section of this document, but SHOULD process MicroIDs generated using the legacy format for the sake of backward compatibility.
TOC |
The Contributors grant third parties the irrevocable right to copy, use and distribute the Contribution, with or without modification, in any medium, without royalty, provided that, unless separate permission is granted, redistributed modified works:
The IETF suggests that any citation or excerpt of unmodified text reference the RFC or other document from which the text is derived.
TOC |
Jeremie Miller | |
Email: | |
Peter Saint-Andre | |
Email: | |
URI: | https://stpeter.im/ |
Fred Stutzman | |
ClaimID | |
Email: |
TOC |
Copyright © The IETF Trust (2007).
This document is subject to the rights, licenses and restrictions contained in BCP 78, and except as set forth therein, the authors retain all their rights.
This document and the information contained herein are provided on an “AS IS” basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY, THE IETF TRUST AND THE INTERNET ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
The IETF takes no position regarding the validity or scope of any Intellectual Property Rights or other rights that might be claimed to pertain to the implementation or use of the technology described in this document or the extent to which any license under such rights might or might not be available; nor does it represent that it has made any independent effort to identify any such rights. Information on the procedures with respect to rights in RFC documents can be found in BCP 78 and BCP 79.
Copies of IPR disclosures made to the IETF Secretariat and any assurances of licenses to be made available, or the result of an attempt made to obtain a general license or permission for the use of such proprietary rights by implementers or users of this specification can be obtained from the IETF on-line IPR repository at http://www.ietf.org/ipr.
The IETF invites any interested party to bring to its attention any copyrights, patents or patent applications, or other proprietary rights that may cover technology that may be required to implement this standard. Please address the information to the IETF at .
Funding for the RFC Editor function is provided by the IETF Administrative Support Activity (IASA).