Efficient RDAP Referrals

Status of This Memo

This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79.¶

Internet-Drafts are working documents of the Internet Engineering Task Force (IETF). Note that other groups may also distribute working documents as Internet-Drafts. The list of current Internet-Drafts is at https://datatracker.ietf.org/drafts/current/.¶

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."¶

This Internet-Draft will expire on 24 May 2025.¶

Copyright Notice

Copyright (c) 2024 IETF Trust and the persons identified as the document authors. All rights reserved.¶

This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Revised BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Revised BSD License.¶

Table of Contents

1. Introduction

Many Registration Data Access Protocol (RDAP, described in [RFC7480], [RFC7481], [RFC9082], [RFC9083] and others) resources contain referrals to related RDAP resources.¶

For example, in the domain space, an RDAP record for a domain name received from the registry operator may include a referral to the RDAP record for the same object provided by the sponsoring registrar, while in the IP address space, an RDAP record for an address allocation may include referrals to enclosing or sibling prefixes.¶

In both cases, RDAP service users are often equally if not more interested in these related RDAP resources than the resource provided by the TLD registry or RIR.¶

While RDAP supports redirection of RDAP requests using HTTP redirections (which use a 3xx HTTP status and the "Location" header field, see Section 15.4 of [RFC9110]), it is not possible for RDAP servers to know a priori whether a client requesting an RDAP record is doing so because it wants to retrieve a related RDAP record, or its own, so it can only respond by providing the full RDAP response. The client must then parse that response in order to extract the relevant URL from the "links" property of the object.¶

This results in the wasteful expenditure of time, compute resources and bandwidth on the part of both the client and server.¶

This document describes how an RDAP server can use "Link" HTTP header fields in responses to HEAD and GET requests to provide RDAP clients with the URL of related RDAP records, without the need for a signalling mechanism for the client to tell the server that it is only interested in retrieving those URLs.¶

2. RDAP Link Objects

RDAP link objects, described in Section 4.2 of [RFC9083], establish unidirectional relationships between an RDAP resource and other web resources, which may also be RDAP resources. The "rel" property indicates the nature of the relationship, and its possible values are described in [RFC8288].¶

If a link object has a "type" property which contains the value "application/rdap+json", then clients can assume that the linked resource is also an RDAP resource.¶

In the domain name space, this allows clients to discover the URL of the sponsoring registrar's RDAP record for a given domain name, if the "rel" property has the value "related", while in the IP address space, the "up" and "down" values allow RDAP clients to navigate the hierarchy of address space allocations.¶

3. HTTP "Link" Header Field

"Link" header fields, described in Section 3 of [RFC8288], provide a means for describing a relationship between two resources, generally between the requested resource and some other resource. The "Link" header field is semantically equivalent to the <link> element in HTML, and multiple "Link" headers may be present in the header of an HTTP response.¶

"Link" header fields may contain most of the parameters that are also present in Link objects in RDAP responses (See Section 4.2 of [RFC9083]). So for example, an RDAP link object which has the following JSON representation:¶

{
  "value" : "https://example.com/context_uri",
  "rel" : "self",
  "href" : "https://example.com/target_uri",
  "hreflang" : [ "en", "ch" ],
  "title" : "title",
  "media" : "screen",
  "type" : "application/json"
}

may be represented in an HTTP response header as follows:¶

Link: <https://example.com/target_uri>;
  rel="self";
  hreflang="en,ch";
  title="title";
  media="screen";
  type="application/json"

In this example, the context URI is the URI that was requested by the user agent.¶

{
  "value": "https://rdap.example.com/domain/example.com",
  "title": "URL of Sponsoring Registrar's RDAP Record",
  "rel": "related",
  "href": "https://rdap.example.com/domain/example.com",
  "type": "application/rdap+json"
}

Link: <https://rdap.example.com/domain/example.com>;
  title="URL of Sponsoring Registrar's RDAP Record";
  rel="related";
  type="application/rdap+json"

4. RDAP Responses

In response to GET and HEAD RDAP requests, RDAP servers which implement this specification MUST include a "Link" header field for each link object which refers to an RDAP resource that is present in the "links" array of the object in question. The server MAY also include "Link" headers for link objects which refer to other types of resource. In all cases, the link attributes MUST be the same in both places.¶

5. RDAP Conformance

Servers which implement this specification MUST include the string "link_headers" in the "rdapConformance" array in all RDAP responses.¶

6. IANA Considerations

IANA is requested to register the following value in the RDAP Extensions Registry:¶

Extension identifier:

link_headers¶

Registry operator:

any.¶

Published specification:

this document.¶

Contact:

the authors of this document.¶

Intended usage:

this extension indicates that the server will provide links to related resources using "Link" headers in responses to RDAP queries.¶

Authors' Addresses