Extensible Resource Identifier (XRI) Resolution V2.0
Total Page:16
File Type:pdf, Size:1020Kb
1 2 Extensible Resource Identifier (XRI) 3 Resolution V2.0 4 Working Draft 10, 18 March 2006 5 Document identifier: 6 xri-resolution-V2.0-wd-10 7 Location: 8 http://docs.oasis-open.org/xri/xri/V2.0 9 Editors: 10 Gabe Wachob, Visa International <[email protected]> 11 Drummond Reed, Cordance <[email protected]> 12 Les Chasen, NeuStar <[email protected]> 13 William Tan, NeuStar <[email protected]> 14 Steve Churchill, XDI.ORG <[email protected]> 15 Contributors: 16 Dave McAlpin, Epok <[email protected]> 17 Chetan Sabnis, Epok <[email protected]> 18 Peter Davis, Neustar <[email protected]> 19 Victor Grey, PlaNetwork <[email protected]> 20 Mike Lindelsee, Visa International <[email protected]> 21 Abstract: 22 This document defines both generic and trusted HTTP(S)-based resolution protocols for 23 Extensible Resource Identifiers (XRIs) as defined by Extensible Resource Identifier (XRI) 24 Syntax V2.0 [XRISyntax] or higher. For the set of XRIs defined to provide identifier 25 metadata, see Extensible Resource Identifier (XRI) Metadata V2.0 [XRIMetadata]. For a 26 basic introduction to XRIs, see the XRI 2.0 FAQ [XRIFAQ]. 27 Status: 28 This document was last revised or approved by the XRI Technical Committee on the 29 above date. The level of approval is also listed above. Check the current location noted 30 above for possible later revisions of this document. This document is updated periodically 31 on no particular schedule. 32 Technical Committee members should send comments on this specification to the 33 Technical Committee's email list. Others should send comments to the Technical 34 Committee by using the "Send A Comment" button on the Technical Committee's web 35 page at http://www.oasis-open.org/committees/xri. 36 For information on whether any patents have been disclosed that may be essential to 37 implementing this specification, and any offers of patent licensing terms, please refer to 38 the Intellectual Property Rights section of the Technical Committee web page 39 (http://www.oasis-open.org/committees/xri/ipr.php. 40 The non-normative errata page for this specification is located at http://www.oasis- 41 open.org/committees/xri. xri-resolution-V2.0-wd-10 18 March 2006 Copyright © OASIS Open 2006. All Rights Reserved. Page 1 of 74 42 Table of Contents 43 1 Introduction ............................................................................................................................. 5 44 1.1 Overview of XRI Resolution Architecture.............................................................................. 5 45 1.2 Structure of this Specification................................................................................................ 7 46 1.3 Examples of XRI Resolution Requests and Responses....................................................... 8 47 1.4 Terminology and Notation ..................................................................................................... 8 48 2 Namespaces ........................................................................................................................... 9 49 2.1 XRI Namespaces for XRI Resolution.................................................................................... 9 50 2.1.1 XRIs Reserved for XRI Resolution ................................................................................ 9 51 2.1.2 XRIs Assigned to XRI Resolution Service Types .......................................................... 9 52 2.2 XML Namespaces for XRI Resolution................................................................................... 9 53 2.3 Media Types for XRI Resolution ......................................................................................... 10 54 3 XRDS Documents................................................................................................................. 11 55 3.1 XRDS and XRD Namespaces............................................................................................. 11 56 3.2 XRD Elements and Attributes ............................................................................................. 11 57 3.2.1 Management Elements................................................................................................ 13 58 3.2.2 Authority Trust Elements ............................................................................................. 13 59 3.2.3 Synonym Elements...................................................................................................... 14 60 3.2.4 Service Endpoint Elements.......................................................................................... 14 61 3.2.5 Service Endpoint Trust Elements ................................................................................ 15 62 3.2.6 Service Endpoint Selection Elements.......................................................................... 15 63 3.3 XRD Attribute Processing Rules ......................................................................................... 16 64 3.3.1 ID Attribute ................................................................................................................... 16 65 3.3.2 Version Attribute .......................................................................................................... 16 66 3.3.3 Priority Attribute ........................................................................................................... 16 67 3.4 XRI Encoding Requirements............................................................................................... 17 68 4 Inputs and Outputs................................................................................................................ 18 69 4.1 Inputs................................................................................................................................... 18 70 4.1.1 QXRI (Authority String, Path String, and Query String)............................................... 19 71 4.1.2 Resolution Media Type ................................................................................................ 19 72 4.1.3 Service Type ................................................................................................................ 20 73 4.1.4 Service Media Type ..................................................................................................... 20 74 4.2 Outputs................................................................................................................................21 75 4.2.1 XRDS Document.......................................................................................................... 21 76 4.2.2 XRD Document............................................................................................................ 21 77 4.2.3 URI List ........................................................................................................................ 22 78 4.2.4 HTTP(S) Redirect ........................................................................................................ 22 79 5 Generic Authority Resolution ................................................................................................ 23 80 5.1 XRI Authority Resolution ..................................................................................................... 23 81 5.1.1 Service Type and Service Media Type........................................................................ 23 82 5.1.2 Protocol........................................................................................................................ 24 83 5.1.3 Community Root Authorities ........................................................................................ 26 84 5.1.4 Qualified Subsegments................................................................................................ 26 xri-resolution-V2.0-wd-10 18 March 2006 Copyright © OASIS Open 2006. All Rights Reserved. Page 2 of 74 85 5.1.5 Cross-References........................................................................................................ 27 86 5.1.6 Recursing Authority Resolution ................................................................................... 27 87 5.1.7 Construction of the Next Authority URI........................................................................ 28 88 5.2 IRI Authority Resolution ...................................................................................................... 28 89 5.2.1 Service Type and Media Type ..................................................................................... 29 90 5.2.2 Protocol........................................................................................................................ 29 91 5.2.3 Optional Use of HTTPS ............................................................................................... 29 92 6 Trusted Authority Resolution................................................................................................. 30 93 6.1 HTTPS................................................................................................................................. 30 94 6.1.1 Service Type and Service Media Type........................................................................ 30 95 6.1.2 Protocol........................................................................................................................ 30 96 6.2 SAML................................................................................................................................... 30 97