draft-ietf-weirds-rdap-query-12.txt   draft-ietf-weirds-rdap-query-13.txt 
Network Working Group A. Newton Network Working Group A. Newton
Internet-Draft ARIN Internet-Draft ARIN
Intended status: Standards Track S. Hollenbeck Intended status: Standards Track S. Hollenbeck
Expires: February 19, 2015 Verisign Labs Expires: February 26, 2015 Verisign Labs
August 18, 2014 August 25, 2014
Registration Data Access Protocol Query Format Registration Data Access Protocol Query Format
draft-ietf-weirds-rdap-query-12 draft-ietf-weirds-rdap-query-13
Abstract Abstract
This document describes uniform patterns to construct HTTP URLs that This document describes uniform patterns to construct HTTP URLs that
may be used to retrieve registration information from registries may be used to retrieve registration information from registries
(including both Regional Internet Registries (RIRs) and Domain Name (including both Regional Internet Registries (RIRs) and Domain Name
Registries (DNRs)) using "RESTful" web access patterns. Registries (DNRs)) using "RESTful" web access patterns.
Status of This Memo Status of This Memo
skipping to change at page 1, line 34 skipping to change at page 1, line 34
Internet-Drafts are working documents of the Internet Engineering Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF). Note that other groups may also distribute Task Force (IETF). Note that other groups may also distribute
working documents as Internet-Drafts. The list of current Internet- working documents as Internet-Drafts. The list of current Internet-
Drafts is at http://datatracker.ietf.org/drafts/current/. Drafts is at http://datatracker.ietf.org/drafts/current/.
Internet-Drafts are draft documents valid for a maximum of six months Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress." material or to cite them other than as "work in progress."
This Internet-Draft will expire on February 19, 2015. This Internet-Draft will expire on February 26, 2015.
Copyright Notice Copyright Notice
Copyright (c) 2014 IETF Trust and the persons identified as the Copyright (c) 2014 IETF Trust and the persons identified as the
document authors. All rights reserved. document authors. All rights reserved.
This document is subject to BCP 78 and the IETF Trust's Legal This document is subject to BCP 78 and the IETF Trust's Legal
Provisions Relating to IETF Documents Provisions Relating to IETF Documents
(http://trustee.ietf.org/license-info) in effect on the date of (http://trustee.ietf.org/license-info) in effect on the date of
publication of this document. Please review these documents publication of this document. Please review these documents
skipping to change at page 2, line 19 skipping to change at page 2, line 19
2. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 3 2. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 3
3. Path Segment Specification . . . . . . . . . . . . . . . . . 4 3. Path Segment Specification . . . . . . . . . . . . . . . . . 4
3.1. Lookup Path Segment Specification . . . . . . . . . . . . 4 3.1. Lookup Path Segment Specification . . . . . . . . . . . . 4
3.1.1. IP Network Path Segment Specification . . . . . . . . 5 3.1.1. IP Network Path Segment Specification . . . . . . . . 5
3.1.2. Autonomous System Path Segment Specification . . . . 6 3.1.2. Autonomous System Path Segment Specification . . . . 6
3.1.3. Domain Path Segment Specification . . . . . . . . . . 6 3.1.3. Domain Path Segment Specification . . . . . . . . . . 6
3.1.4. Name Server Path Segment Specification . . . . . . . 7 3.1.4. Name Server Path Segment Specification . . . . . . . 7
3.1.5. Entity Path Segment Specification . . . . . . . . . . 7 3.1.5. Entity Path Segment Specification . . . . . . . . . . 7
3.1.6. Help Path Segment Specification . . . . . . . . . . . 8 3.1.6. Help Path Segment Specification . . . . . . . . . . . 8
3.2. Search Path Segment Specification . . . . . . . . . . . . 8 3.2. Search Path Segment Specification . . . . . . . . . . . . 8
3.2.1. Domain Search . . . . . . . . . . . . . . . . . . . . 8 3.2.1. Domain Search . . . . . . . . . . . . . . . . . . . . 9
3.2.2. Name Server Search . . . . . . . . . . . . . . . . . 10 3.2.2. Name Server Search . . . . . . . . . . . . . . . . . 10
3.2.3. Entity Search . . . . . . . . . . . . . . . . . . . . 10 3.2.3. Entity Search . . . . . . . . . . . . . . . . . . . . 10
4. Query Processing . . . . . . . . . . . . . . . . . . . . . . 11 4. Query Processing . . . . . . . . . . . . . . . . . . . . . . 11
5. Extensibility . . . . . . . . . . . . . . . . . . . . . . . . 13 5. Extensibility . . . . . . . . . . . . . . . . . . . . . . . . 13
6. Internationalization Considerations . . . . . . . . . . . . . 13 6. Internationalization Considerations . . . . . . . . . . . . . 13
7. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 14 7. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 14
8. Security Considerations . . . . . . . . . . . . . . . . . . . 14 8. Security Considerations . . . . . . . . . . . . . . . . . . . 14
9. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 14 9. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . 14
10. References . . . . . . . . . . . . . . . . . . . . . . . . . 15 10. References . . . . . . . . . . . . . . . . . . . . . . . . . 15
10.1. Normative References . . . . . . . . . . . . . . . . . . 15 10.1. Normative References . . . . . . . . . . . . . . . . . . 15
skipping to change at page 8, line 28 skipping to change at page 8, line 28
policy, supported authentication methods, supported extensions, policy, supported authentication methods, supported extensions,
technical support contact, etc.) from an RDAP server. The response technical support contact, etc.) from an RDAP server. The response
to "help" should provide basic information that a client needs to to "help" should provide basic information that a client needs to
successfully use the service. The following URL would be used to successfully use the service. The following URL would be used to
return "help" information: return "help" information:
http://example.com/rdap/help http://example.com/rdap/help
3.2. Search Path Segment Specification 3.2. Search Path Segment Specification
A simple search to determine if an object exists (or not) without
returning RDAP-encoded results can be performed using the HTTP HEAD
method as described in Section 4.1 of [I-D.ietf-weirds-using-http].
Detailed results can be retrieved using the path segments specified
here.
The resource type path segments for search are: The resource type path segments for search are:
o 'domains': Used to identify a domain name information search using o 'domains': Used to identify a domain name information search using
a pattern to match a fully-qualified domain name. a pattern to match a fully-qualified domain name.
o 'nameservers': Used to identify a name server information search o 'nameservers': Used to identify a name server information search
using a pattern to match a host name. using a pattern to match a host name.
o 'entities': Used to identify an entity information search using a o 'entities': Used to identify an entity information search using a
pattern to match a string identifier. pattern to match a string identifier.
RDAP search path segments are formed using a concatenation of the RDAP search path segments are formed using a concatenation of the
skipping to change at page 15, line 31 skipping to change at page 15, line 31
bootstrap-04 (work in progress), July 2014. bootstrap-04 (work in progress), July 2014.
[I-D.ietf-weirds-json-response] [I-D.ietf-weirds-json-response]
Newton, A. and S. Hollenbeck, "JSON Responses for the Newton, A. and S. Hollenbeck, "JSON Responses for the
Registration Data Access Protocol (RDAP)", draft-ietf- Registration Data Access Protocol (RDAP)", draft-ietf-
weirds-json-response-08 (work in progress), August 2014. weirds-json-response-08 (work in progress), August 2014.
[I-D.ietf-weirds-rdap-sec] [I-D.ietf-weirds-rdap-sec]
Hollenbeck, S. and N. Kong, "Security Services for the Hollenbeck, S. and N. Kong, "Security Services for the
Registration Data Access Protocol", draft-ietf-weirds- Registration Data Access Protocol", draft-ietf-weirds-
rdap-sec-07 (work in progress), August 2014. rdap-sec-08 (work in progress), August 2014.
[I-D.ietf-weirds-using-http] [I-D.ietf-weirds-using-http]
Newton, A., Ellacott, B., and N. Kong, "HTTP usage in the Newton, A., Ellacott, B., and N. Kong, "HTTP usage in the
Registration Data Access Protocol (RDAP)", draft-ietf- Registration Data Access Protocol (RDAP)", draft-ietf-
weirds-using-http-09 (work in progress), August 2014. weirds-using-http-10 (work in progress), August 2014.
[RFC0952] Harrenstien, K., Stahl, M., and E. Feinler, "DoD Internet [RFC0952] Harrenstien, K., Stahl, M., and E. Feinler, "DoD Internet
host table specification", RFC 952, October 1985. host table specification", RFC 952, October 1985.
[RFC1035] Mockapetris, P., "Domain names - implementation and [RFC1035] Mockapetris, P., "Domain names - implementation and
specification", STD 13, RFC 1035, November 1987. specification", STD 13, RFC 1035, November 1987.
[RFC1123] Braden, R., "Requirements for Internet Hosts - Application [RFC1123] Braden, R., "Requirements for Internet Hosts - Application
and Support", STD 3, RFC 1123, October 1989. and Support", STD 3, RFC 1123, October 1989.
skipping to change at page 18, line 30 skipping to change at page 18, line 30
-11: Replaced reference to RFC 4627 with reference to RFC 7159. -11: Replaced reference to RFC 4627 with reference to RFC 7159.
Replaced .well-known with bootstrap-defined prefix. Replaced Replaced .well-known with bootstrap-defined prefix. Replaced
references to RFC 2616 with references to RFC 7231 and draft-ietf- references to RFC 2616 with references to RFC 7231 and draft-ietf-
httpbis-http2, adding a note to make it clear that 2616 is an httpbis-http2, adding a note to make it clear that 2616 is an
acceptable reference if http2 isn't ready when needed. acceptable reference if http2 isn't ready when needed.
-12: IDN label processing clarification. Added domain search by -12: IDN label processing clarification. Added domain search by
name server name and name server IP address. Minor text editing name server name and name server IP address. Minor text editing
for consistency in the search sections. Replaced reference to for consistency in the search sections. Replaced reference to
draft-ietf-httpbis-http2 with a reference to RFC 7230 and removed draft-ietf-httpbis-http2 with a reference to RFC 7230 and removed
reference note. reference note.
-13: Added HTTP HEAD reference in Section 3.2.
Authors' Addresses Authors' Addresses
Andrew Lee Newton Andrew Lee Newton
American Registry for Internet Numbers American Registry for Internet Numbers
3635 Concorde Parkway 3635 Concorde Parkway
Chantilly, VA 20151 Chantilly, VA 20151
US US
Email: andy@arin.net Email: andy@arin.net
 End of changes. 8 change blocks. 
7 lines changed or deleted 14 lines changed or added

This html diff was produced by rfcdiff 1.41. The latest version is available from http://tools.ietf.org/tools/rfcdiff/