DNS Resolver Information

Historically, DNS stub resolvers communicated with recursive resolvers without needing to know anything about the features supported by these recursive resolvers. As more and more recursive resolvers expose different features that may impact the delivered DNS service, means to help stub resolvers to identify the capabilities of the resolver are valuable. Typically, stub resolvers can discover and authenticate encrypted DNS servers provided by a local network, for example, using the techniques specified in and . However, these stub resolvers need a means to retrieve information from the discovered recursive resolvers about their capabilities. This document fills that void by specifying a method for stub resolvers to retrieve such information. To that aim, a new RR type is defined for stub resolvers to query the recursive resolvers. The information that a resolver might want to give is defined in . Retrieved information can be used to feed the server selection procedure.

The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in BCP 14 when, and only when, they appear in all capitals, as shown here. This document makes use of the terms defined in . 'Encrypted DNS' refers to a DNS protocol that provides an encrypted channel between a DNS client and server (e.g., DoT, DoH, or DoQ).

A stub resolver that wants to retrieve the resolver information may use the RR type "RESINFO" defined in this document (see ). The content of the RDATA in a response to RR type query is defined in . If the resolver understands the RESINFO RR type, the RRSet in the Answer section MUST have exactly one record. A DNS client can retrieve the resolver information using the RESINFO RR type and QNAME of the domain name that is used to authenticate the DNS server (referred to as ADN in ). If the special use domain name "resolver.arpa" defined in is used to discover the Encrypted DNS server, the client can retrieve the resolver information using the RESINFO RR type and QNAME of the designated resolver.

The resolver information uses the same format as DNS TXT records. The intention of using the same format as TXT records is to convey a small amount of useful information about a DNS resolver. As a reminder, the format rules for TXT records are defined in Section 3.3.14 of the DNS specification and further elaborated in Section 6.1 of the DNS-based Service Discovery (DNS-SD) . The recommendations to limit the TXT record size are discussed in Section 6.2 of . Similar to DNS-SD, the RESINFO RR type uses "key/value" pairs to convey the resolver information. Each "key/value" pair is encoded using the format rules defined in Section 6.3 of . Using standardized "key/value" syntax within the RESINFO RR type makes it easier for future keys to be defined. If a DNS client sees unknown keys in a RESINFO RR type, it MUST silently ignore them. The same rules for the keys as those defined in Section 6.4 of MUST be followed for RESINFO. Keys MUST either be defined in the IANA registry or begin with the substring "temp-" for names defined for local use only.

The following resolver information keys are defined: If the DNS resolver supports QNAME minimisation to improve DNS privacy, the key is present. Note that, as per the rules for the keys defined in Section 6.4 of , if there is no '=' in a key, then it is a boolean attribute, simply identified as being present, with no value. This is a mandatory attribute. If the DNS resolver supports extended DNS errors (EDE) to return additional information about the cause of DNS errors, the value of this key lists the possible extended DNS error codes that can be returned by this DNS resolver. When multiple values are present, these values MUST be comma-separated. This is an optional attribute. An URL that points to the generic unstructured resolver information (e.g., DoH APIs supported, possible HTTP status codes returned by the DoH server, how to report a problem) for troubleshooting purpose. The server MUST support the content-type 'text/html'. The DNS client MUST reject the URL if the scheme is not "https". The client MUST validate that both the encrypted DNS server and the resolver information server are owned and managed by the same entity by establishing a TLS connection to the domain name in the URL and checking if the subjectAltName entry in the server certificate includes the name of the encrypted DNS server. If this match fails, the client MUST ignore the resolver information. The URL should be treated only as diagnostic information for IT staff. This is a mandatory attribute. New keys can be defined as per the procedure defined in . shows an example of published resolver information record:

Unless a DNS request to retrieve the resolver information is encrypted (e.g., sent over DNS-over-TLS (DoT) or DNS-over- HTTPS (DoH)) ), the response is susceptible to forgery. The DNS resolver information can be retrieved after the encrypted connection is established to the DNS server or retrieved before the encrypted connection is established to the DNS server by using local DNSSEC validation.

Note to the RFC Editor: Please update [RFCXXXX] with the RFC number to be assigned to this document.

This document requests IANA to register a new value from the "Resource Record (RR) TYPEs" subregistry of the "Domain Name System (DNS) Parameters" registry available at :

This document requests IANA to create a new registry entitled "DNS Resolver Information Keys". This registry contains definitions of the keys that can be used to provide the resolver information. The registration procedure is Specification Required (Section 4.6 of ). The structure of the registry is as follows: The key name. The name MUST conform to the definition in . The IANA registry MUST NOT register names that begin with "temp-", so these names can be used freely by any implementer. The type of the value to be used in the key. A description of the registered key. The reference specification for the registered element. The initial content of this registry is provided in . Name Value Type Specification Specification qnamemin boolean Indicates whether qnameminimization is enabled or not [RFCXXXX] exterr number Lists the set of extended DNS errors [RFCXXXX] infourl string Provides an unstructured resolver information that is used for troubleshooting [RFCXXXX]

This specification leverages the work that has been documented in . Thanks to Tommy Jensen, Vittorio Bertola, Vinny Parla, Chris Box, Ben Schwartz, Tony Finch, Daniel Kahn Gillmor, Eric Rescorla, and Shashank Jain for the discussion and comments. Thanks to Mark Andrews, Joe Abley, Paul Wouters, Tim Wicinski, and Steffen Nurpmeso for the discussion on the RR formatting rules.