Internet-Draft | dnssec-bootstrapping | May 2024 |
Thomassen & Wisiol | Expires 29 November 2024 | [Page] |
This document introduces an in-band method for DNS operators to publish arbitrary information about the zones they are authoritative for, in an authenticated fashion and on a per-zone basis. The mechanism allows managed DNS operators to securely announce DNSSEC key parameters for zones under their management, including for zones that are not currently securely delegated.¶
Whenever DS records are absent for a zone's delegation, this signal enables the parent's registry or registrar to cryptographically validate the CDS/CDNSKEY records found at the child's apex. The parent can then provision DS records for the delegation without resorting to out-of-band validation or weaker types of cross-checks such as "Accept after Delay".¶
This document establishes the DS enrollment method described in Section 4 of this document as the preferred method over those from Section 3 of RFC 8078. It also updates RFC 7344.¶
[ Ed note: This document is being collaborated on at https://github.com/desec-io/draft-ietf-dnsop-dnssec-bootstrapping/. The authors gratefully accept pull requests. ]¶
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 29 November 2024.¶
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.¶
Securing a DNS delegation for the first time requires that the child's DNSSEC parameters be conveyed to the parent through some trusted channel. While the communication conceptually has to occur between the parent registry and the DNSSEC key holder, what exactly that means and how the communication is coordinated traditionally depends on the relationship the child has with the parent.¶
A typical situation is that the key is held by the child DNS operator; the communication thus often involves this entity. In addition, depending on the circumstances, it may also involve the registrar, possibly via the registrant (for details, see [RFC7344], Appendix A).¶
As observed in [RFC7344], these dependencies often result in a manual process that is susceptible to mistakes and/or errors. In addition, due to the annoyance factor of the process, involved parties may avoid the process of getting a DS record set (RRset) published in the first place.¶
To alleviate these problems, automated provisioning of DS records has been specified in ([RFC8078]). It is based on the parental agent (registry or registrar) fetching DNSSEC key parameters from the CDS and CDNSKEY records ([RFC7344]) located at the child zone's apex, and validating them somehow. This validation can be done using the child's existing DNSSEC chain of trust if the objective is to update an existing DS RRset (such as during key rollover). However, when bootstrapping a DNSSEC delegation, the child zone has no existing DNSSEC validation path, and other means to ensure the CDS/CDNSKEY records' legitimacy must be found.¶
Due to the lack of a comprehensive DNS-innate solution, either out-of-band methods have been used so far to complete the chain of trust, or cryptographic validation has been entirely dispensed with, in exchange for weaker types of cross-checks such as "Accept after Delay" ([RFC8078] Section 3.3). [RFC8078] does not define an in-band validation method for enabling DNSSEC.¶
This document aims to close this gap by introducing an in-band method for DNS operators to publish arbitrary information about the zones they are authoritative for, in an authenticated manner and on a per-zone basis. The mechanism allows managed DNS operators to securely announce DNSSEC key parameters for zones under their management. The parent can then use this signal to cryptographically validate the CDS/CDNSKEY RRsets found at an insecure child zone's apex and, upon success, secure the delegation.¶
While applicable to the vast majority of domains, the protocol does not support certain edge cases, such as excessively long child zone names, or DNSSEC bootstrapping for domains with in-domain nameservers only (see Section 4.4).¶
DNSSEC bootstrapping is just one application of the generic signaling mechanism specified in this document. Other applications might arise in the future, such as publishing operational metadata or auxiliary information which the DNS operator likes to make known (e.g., API endpoints for third-party interaction).¶
Readers are expected to be familiar with DNSSEC [BCP237].¶
This section defines the terminology used in this document.¶
_signal
to a
hostname taken from the child's NS RRSet.
There are as many signaling domains as there are distinct NS
targets.¶
_dsboot
for DNSSEC bootstrapping.¶
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 [RFC2119] [RFC8174] when, and only when, they appear in all capitals, as shown here.¶
The DS enrollment methods described in Section 3 of [RFC8078] are less secure than the method described in Section 4 of this document. Child DNS operators and parental agents wishing to use CDS/CDNSKEY records for initial DS enrollment SHOULD therefore support the authentication protocol described here.¶
In order to facilitate publication of signaling records for the purpose of DNSSEC bootstrapping (see Section 4.1), the first bullet ("Location") of [RFC7344] Section 4.1 is removed.¶
This section describes the general mechanism by which a child DNS operator can publish an authenticated signal about a child zone. Parental agents (or any other party) can then discover and process the signal. Authenticity is ensured through standard DNSSEC validation.¶
If a child DNS operator implements this specification, each signaling zone MUST be signed and be validatable by the parental agent (i.e., have a valid publicly resolvable DNSSEC chain of trust). This is typically achieved by securely delegating each signaling zone.¶
For example, when publishing a signal that relates to a child zone
with NS records ns1.example.net
and ns2.example.org
, the child
DNS operator needs to ensure that the parental agent has a valid DNSSEC
chain of trust for the zone(s) that are authoritative for the signaling
domains _signal.ns1.example.net
and _signal.ns2.example.org
.¶
To publish information about the child zone in an authenticated fashion, the child DNS operator MUST publish one or more signaling records at a signaling name under each signaling domain.¶
Signaling records MUST be accompanied by RRSIG records created with the corresponding signaling zone's key(s). The type and contents of these signaling records depend on the type of signal.¶
The signaling name identifies the child and the signaling type. It is identical to the child name (with the final root label removed), prefixed with a label containing the signaling type.¶
When the child zone's CDS/CDNSKEY RRsets are used for setting up initial trust, they need to be authenticated. This is achieved by co-publishing the child's CDS/CDNSKEY RRsets as an authenticated signal as described in Section 3. The parent can discover and validate it, thus transferring trust from the child DNS operator nameservers' chain of trust to the child zone.¶
This protocol is not intended for updating an existing DS RRset. For this purpose, the parental agent can validate the child's CDS/CDNSKEY RRsets directly, using the chain of trust established by the existing DS RRset ([RFC7344] Section 4).¶
To confirm its willingness to act as the child's delegated signer and authenticate the child's CDS/CDNSKEY RRsets, the child DNS operator MUST co-publish them at the corresponding signaling name under each signaling domain, excluding those that would fall within the child domain (Section 3.2). For simplicity, the child DNS operator MAY also co-publish the child's CDS/CDNSKEY RRsets under signaling domains within the child domain, although those signaling domains are not used for validation (Section 4.2).¶
Unlike the CDS/CDNSKEY RRsets at the child's apex, a signaling record set MUST be signed with the corresponding signaling zone's key(s). Its contents MUST be identical to the corresponding RRset published at the child's apex.¶
Existing use of CDS/CDNSKEY records was specified at the child apex only ([RFC7344], Section 4.1). This protocol extends the use of these record types to non-apex owner names for the purpose of DNSSEC bootstrapping. To exclude the possibility of semantic collision, there MUST NOT be a zone cut at a signaling name.¶
For the purposes of bootstrapping the child zone example.co.uk
with NS
records ns1.example.net
, ns2.example.org
, and ns3.example.co.uk
,
the required signaling domains are _signal.ns1.example.net
and
_signal.ns2.example.org
.¶
In the zones containing these domains, the child DNS operator authenticates the CDS/CDNSKEY RRsets found at the child's apex by co-publishing them as CDS/CDNSKEY RRsets at the names:¶
_dsboot.example.co.uk._signal.ns1.example.net _dsboot.example.co.uk._signal.ns2.example.org¶
These RRsets are signed with DNSSEC just like any other zone data.¶
Publication of signaling records under the in-domain name
_signal.ns3.example.co.uk
is not required.¶
To validate a child's CDS/CDNSKEY RRset for DNSSEC bootstrapping, the parental agent, knowing both the child zone name and its NS hostnames, MUST execute the following steps:¶
verify that the child has no DS records published at the parent and that at least one of its nameservers is outside the child domain;¶
query the CDS/CDNSKEY RRset at the child zone apex directly from each of the authoritative servers as determined by the delegation's (parent-side) NS RRset, without caching;¶
query the CDS/CDNSKEY RRset located at the signaling name under each signaling domain (except those falling within the child domain) using a trusted DNS resolver and enforce DNSSEC validation;¶
check (separately by record type) that all RRsets retrieved in Steps 2 and 3 have equal contents;¶
If the above steps succeed without error, the CDS/CDNSKEY RRsets are successfully verified, and the parental agent can proceed with the publication of the DS RRset under the precautions described in [RFC8078], Section 5.¶
The parental agent MUST abort the procedure if an error condition occurs, in particular:¶
in Step 1: the child is already securely delegated or has in-domain nameservers only;¶
in Step 2: any failure during the retrieval of the CDS/CDNSKEY RRset located at the child apex from any of the authoritative nameservers;¶
in Step 3: any failure to retrieve the CDS/CDNSKEY RRsets located at the signaling name under any signaling domain, including failure of DNSSEC validation, or unauthenticated data (AD bit not set);¶
in Step 4: inconsistent responses (for at least one of the types), including an RRset that is empty in one of Steps 2 or 3, but non-empty in the other.¶
To verify the CDS/CDNSKEY RRsets for the child example.co.uk
, the
parental agent (assuming that the child delegation's NS records are
ns1.example.net
, ns2.example.org
, and ns3.example.co.uk
)¶
checks that the child domain is not yet securely delegated;¶
queries the CDS/CDNSKEY RRsets for example.co.uk
directly from
ns1.example.net
, ns2.example.org
, and ns3.example.co.uk
(without caching);¶
queries and validates the CDS/CDNSKEY RRsets located at (see
Section 3.2; ns3.example.co.uk
is ignored because it is
in-domain)¶
_dsboot.example.co.uk._signal.ns1.example.net _dsboot.example.co.uk._signal.ns2.example.org¶
If all these steps succeed, the parental agent can proceed to publish a DS RRset as indicated by the validated CDS/CDNSKEY RRset.¶
As in-domain signaling names do not have a chain of trust at bootstrapping time, the parental agent does not consider them during validation. Consequently, if all NS hostnames are in-domain, validation cannot be completed, and DS records are not published.¶
Parental agents SHOULD trigger the procedure described in Section 4.2 once one of the following conditions is fulfilled:¶
The parental agent receives a new or updated NS RRset for a child;¶
The parental agent receives a notification indicating that the child wishes to have its CDS/CDNSKEY RRset processed;¶
The parental agent encounters a signaling record during a proactive, opportunistic scan (e.g., daily queries of signaling records for some or all of its delegations);¶
The parental agent encounters a signaling record during an NSEC walk or when parsing a signaling zone (e.g., when made available via AXFR by the child DNS operator);¶
Any other condition as deemed appropriate by local policy.¶
Timer-based trigger mechanisms (such as scans) exhibit undesirable properties with respect to processing delay and scaling; on-demand triggers (like notifications) are preferable. Whenever possible, child DNS operators and parental agents are thus encouraged to use them, reducing both delays and the amount of scanning traffic.¶
Most types of discovery (such as daily scans of delegations) are based directly on the delegation's NS RRset. In this case, these NS names can be used as is by the bootstrapping algorithm (Section 4.2) for querying signaling records.¶
Some discovery methods, however, do not imply reliable knowledge of the delegation's NS RRset. For example, when discovering signaling names by performing an NSEC walk or zone transfer of a signaling zone, the parental agent MUST NOT assume that a nameserver under whose signaling domain a signaling record appears is actually authoritative for the corresponding child.¶
Instead, whenever a list of "bootstrappable domains" is obtained other than directly from the parent, the parental agent MUST ascertain that the delegation actually contains the nameserver hostname seen during discovery, and ensure that signaling record queries are only made against the proper set of nameservers as listed in the child's delegation from the parent.¶
As a consequence of Step 3 in Section 4.2, DS bootstrapping does not work for fully in-domain delegations, as no pre-existing chain of trust to the child domain is available during bootstrapping. (As a workaround, one can add an out-of-domain nameserver to the initial NS RRset and remove it once bootstrapping is completed. Automation for this is available via CSYNC records, see [RFC7477].)¶
Fully qualified signaling names must by valid DNS names. Label count and length requirements for DNS names ([RFC1035] Section 3.1) imply that the protocol does not work for unusually long child domain names or NS hostnames.¶
It is possible to add CDS/CDNSKEY records and corresponding signaling records to a zone without the domain owner's explicit knowledge. To spare domain owners from being caught off guard by the ensuing DS changes, child DNS operators following this practice are advised to make that transparent, such as by informing the domain owner during zone creation (e.g., in a GUI), or by notifying them via email.¶
When transferring a zone to another DNS operator, the old and new child DNS operators need to cooperate to achieve a smooth transition, e.g., by using the multi-signer protocols described in [RFC8901]. If all else fails, the domain owner might have to request the removal of all DS records and have the transfer performed insecurely (see [I-D.hardaker-dnsop-intentionally-temporary-insec]).¶
Signaling domains SHOULD be delegated as standalone zones, so
that the signaling zone's apex coincides with the signaling domain (such
as _signal.ns1.example.net
).
While it is permissible for the signaling domain to be contained
in a signaling zone of fewer labels (such as example.net
), a
zone cut ensures that bootstrapping activities do not require
modifications of the zone containing the nameserver hostname.¶
Once a Child DNS Operator determines that specific signaling record sets have been processed (e.g., by seeing the result in the parent zone), they are advised to remove them. This will reduce the size of the signaling zone, and facilitate more efficient bulk processing (such as via zone transfers).¶
In order to ensure timely DNSSEC bootstrapping of insecure domains, stalemate situations due to mismatch of stale cached records (Step 4 of Section 4.2) need to be avoided. It is thus RECOMMENDED to perform queries into signaling domains with an (initially) empty resolver cache, or using some other method for retrieving fresh data from authoritative servers.¶
It is also RECOMMENDED to use QNAME minimization [RFC9156] when resolving queries for signaling records, to guard against certain attacks (see Section 6).¶
The DNSSEC bootstrapping method introduced in this document is based on the approaches described in [RFC8078] Section 3, but adds authentication to the CDS/CDNSKEY concept. Its security level is therefore strictly higher than that of existing approaches described in that document (e.g., "Accept after Delay"). Apart from this general improvement, the same Security Considerations apply as in [RFC8078].¶
The level of rigor in Section 4.2 is needed to prevent publication of a ill-conceived DS RRset (authorized only under a subset of NS hostnames). This ensures, for example, that an operator in a multi-homed setup cannot enable DNSSEC unless all other operators agree.¶
In any case, as the child DNS operator has authoritative knowledge of the child's CDS/CDNSKEY records, it can readily detect fraudulent provisioning of DS records.¶
In order to prevent the parents of nameserver hostnames from becoming a single point of failure for a delegation (both in terms of resolution availability and for the trust model of this protocol), it is advisable to diversify the path from the root to the child's nameserver hostnames, such as by using different and independently operated TLDs for each one.¶
If QNAME minimization [RFC9156] is not used when querying for signaling records, an upstream parent of a signaling domain will see those CDS/CDNSKEY queries and could respond with an authoritative answer signed with its own key, instead of sending the referral. Enabling QNAME minimization reduces the attack surface for such forgery.¶
Per [RFC8552], IANA is requested to add the following entries to the "Underscored and Globally Scoped DNS Node Names" registry:¶
+---------+------------+------------+ | RR Type | _NODE NAME | Reference | +---------+------------+------------+ | CDS | _signal | [This RFC] | | CDNSKEY | _signal | [This RFC] | +---------+------------+------------+¶
Note to the RFC Editor: please replace "This RFC" in the above table with a proper reference.¶
Note to the RFC Editor: please remove this entire section before publication.¶
In addition to the information in this section, deployment is tracked by the community at https://github.com/oskar456/cds-updates.¶
Operator support:¶
Authoritative nameserver support:¶
ccTLD:¶
gTLD:¶
Registrars:¶
A tool to retrieve and process signaling records for bootstrapping purposes, either directly or via zone walking, is available at https://github.com/desec-io/dsbootstrap. The tool outputs the validated DS records which then can be added to the parent zone.¶
Thanks to Brian Dickson, Ondřej Caletka, John R. Levine, Christian Elmerot, Oli Schacher, Donald Eastlake, Libor Peltan, Warren Kumari, Scott Rose, Linda Dunbar, Tim Wicinski, Paul Wouters, Paul Hoffman, Peter Yee, Benson Muite, Roman Danyliw, Éric Vyncke, and Joe Abley for reviewing draft proposals and offering comments and suggestions.¶
Thanks also to Steve Crocker, Hugo Salgado, and Ulrich Wisser for early-stage brainstorming.¶
Addressed comment by Paul Wouters¶
Editorial nit¶
Addressed comments by Paul Wouters¶
Make capitalization of registrar/registrant consistent¶
Editorial nit by Joe Abley¶
Addressed comments by Éric Vyncke¶
Addressed comments by Paul Wouters¶
Editorial nits by Roman Danyliw¶
Editorial nits by Benson Muite¶
Editorial nits by Peter Yee¶
Editorial nit by Scott Rose¶
Editorial suggestion from John Levine¶
Editorial changes from AD Review¶
Updated implementation section¶
Change capitalization of terms from terminology section¶
Add Glauca registrar implementation¶
Editorial changes to Security Considerations¶
Add/discuss on-demand triggers (notifications)¶
Add section "Updates to RFCs"¶
Editorial nits¶
Editorial changes from Secdir early review¶
Editorial changes¶
Added consent considerations.¶
Editorial changes.¶
Updated Implementation section.¶
Typo fix.¶
Clarified that RFC 8078 Section 3 is not replaced, but its methods are deprecated.¶
Added new deployments to Implementation section.¶
Included NSEC walk / AXFR as possible triggers for DS bootstrapping.¶
Editorial changes.¶
Allow bootstrapping when some (not all) NS hostnames are in bailiwick.¶
Clarified Operational Recommendations according to operator feedback.¶
Turn loose Security Considerations points into coherent text.¶
Do no longer suggest NSEC-walking Signaling Domains. (It does not work well due to the Signaling Type prefix. What's more, it's unclear who would do this: Parents know there delegations and can do a targeted scan; others are not interested.)¶
Editorial changes.¶
Added IANA request.¶
Introduced Signaling Type prefix (
_dsboot
), renamed Signaling Name infix from_dsauth
to_signal
.¶
Editorial changes.¶
Clarified importance of record cleanup by moving paragraph up.¶
Pointed out limitations.¶
Replace [RFC8078] Section 3 with our Section 4.2.¶
Changed
_boot
label to_dsauth
.¶Removed hashing of Child name components in Signaling Names.¶
Editorial changes.¶
Reframed as an authentication mechanism for RFC 8078.¶
Removed multi-signer use case (focus on RFC 8078 authentication).¶
Triggers need to fetch NS records (if not implicit from context).¶
Improved title.¶
Recognized that hash collisions are dealt with by Child apex check.¶
Add section on Triggers.¶
Clarified title.¶
Improved abstract.¶
Require CDS/CDNSKEY records at the Child.¶
Reworked Signaling Name scheme.¶
Recommend using cold cache for consumption.¶
Updated terminology (replace "Bootstrapping" by "Signaling").¶
Added NSEC recommendation for Bootstrapping Zones.¶
Added multi-signer use case.¶
Editorial changes.¶
Initial public draft.¶