Sync usage with man page.
[netbsd-mini2440.git] / external / bsd / bind / dist / doc / draft / draft-ietf-dnsext-rfc2672bis-dname-18.txt
blob3b9a35aeaf7f160963652077ecbe17878cac8cf5
4 DNS Extensions Working Group                                     S. Rose
5 Internet-Draft                                                      NIST
6 Obsoletes: 2672 (if approved)                              W. Wijngaards
7 Updates: 3363,4294                                            NLnet Labs
8 (if approved)                                          November 12, 2009
9 Intended status: Standards Track
10 Expires: May 16, 2010
13                  Update to DNAME Redirection in the DNS
14                  draft-ietf-dnsext-rfc2672bis-dname-18
16 Abstract
18    The DNAME record provides redirection for a sub-tree of the domain
19    name tree in the DNS system.  That is, all names that end with a
20    particular suffix are redirected to another part of the DNS.  This is
21    a revision of the original specification in RFC 2672, also aligning
22    RFC 3363 and RFC 4294 with this revision.
24 Requirements Language
26    The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
27    "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
28    document are to be interpreted as described in RFC 2119 [RFC2119].
30 Status of This Memo
32    This Internet-Draft is submitted to IETF in full conformance with the
33    provisions of BCP 78 and BCP 79.
35    Internet-Drafts are working documents of the Internet Engineering
36    Task Force (IETF), its areas, and its working groups.  Note that
37    other groups may also distribute working documents as Internet-
38    Drafts.
40    Internet-Drafts are draft documents valid for a maximum of six months
41    and may be updated, replaced, or obsoleted by other documents at any
42    time.  It is inappropriate to use Internet-Drafts as reference
43    material or to cite them other than as "work in progress."
45    The list of current Internet-Drafts can be accessed at
46    http://www.ietf.org/ietf/1id-abstracts.txt.
48    The list of Internet-Draft Shadow Directories can be accessed at
49    http://www.ietf.org/shadow.html.
51    This Internet-Draft will expire on May 16, 2010.
55 Rose & Wijngaards         Expires May 16, 2010                  [Page 1]
57 Internet-Draft              DNAME Redirection              November 2009
60 Copyright Notice
62    Copyright (c) 2009 IETF Trust and the persons identified as the
63    document authors.  All rights reserved.
65    This document is subject to BCP 78 and the IETF Trust's Legal
66    Provisions Relating to IETF Documents
67    (http://trustee.ietf.org/license-info) in effect on the date of
68    publication of this document.  Please review these documents
69    carefully, as they describe your rights and restrictions with respect
70    to this document.  Code Components extracted from this document must
71    include Simplified BSD License text as described in Section 4.e of
72    the Trust Legal Provisions and are provided without warranty as
73    described in the BSD License.
75    This document may contain material from IETF Documents or IETF
76    Contributions published or made publicly available before November
77    10, 2008.  The person(s) controlling the copyright in some of this
78    material may not have granted the IETF Trust the right to allow
79    modifications of such material outside the IETF Standards Process.
80    Without obtaining an adequate license from the person(s) controlling
81    the copyright in such materials, this document may not be modified
82    outside the IETF Standards Process, and derivative works of it may
83    not be created outside the IETF Standards Process, except to format
84    it for publication as an RFC or to translate it into languages other
85    than English.
111 Rose & Wijngaards         Expires May 16, 2010                  [Page 2]
113 Internet-Draft              DNAME Redirection              November 2009
116 Table of Contents
118    1.  Introduction . . . . . . . . . . . . . . . . . . . . . . . . .  4
120    2.  The DNAME Resource Record  . . . . . . . . . . . . . . . . . .  4
121      2.1.  Format . . . . . . . . . . . . . . . . . . . . . . . . . .  4
122      2.2.  The DNAME Substitution . . . . . . . . . . . . . . . . . .  5
123      2.3.  DNAME Owner Name not Redirected Itself . . . . . . . . . .  6
124      2.4.  Names Next to and Below a DNAME Record . . . . . . . . . .  7
125      2.5.  Compression of the DNAME record. . . . . . . . . . . . . .  7
127    3.  Processing . . . . . . . . . . . . . . . . . . . . . . . . . .  8
128      3.1.  CNAME synthesis  . . . . . . . . . . . . . . . . . . . . .  8
129      3.2.  Server algorithm . . . . . . . . . . . . . . . . . . . . .  8
130      3.3.  Wildcards  . . . . . . . . . . . . . . . . . . . . . . . . 10
131      3.4.  Acceptance and Intermediate Storage  . . . . . . . . . . . 10
133    4.  DNAME Discussions in Other Documents . . . . . . . . . . . . . 11
135    5.  Other Issues with DNAME  . . . . . . . . . . . . . . . . . . . 12
136      5.1.  Canonical hostnames cannot be below DNAME owners . . . . . 12
137      5.2.  Dynamic Update and DNAME . . . . . . . . . . . . . . . . . 12
138      5.3.  DNSSEC and DNAME . . . . . . . . . . . . . . . . . . . . . 13
139        5.3.1.  Signed DNAME, Unsigned Synthesized CNAME . . . . . . . 13
140        5.3.2.  DNAME Bit in NSEC Type Map . . . . . . . . . . . . . . 13
141        5.3.3.  DNAME Chains as Strong as the Weakest Link . . . . . . 13
142        5.3.4.  Validators Must Understand DNAME . . . . . . . . . . . 13
143          5.3.4.1.  DNAME in Bitmap Causes Invalid Name Error  . . . . 13
144          5.3.4.2.  Valid Name Error Response Involving DNAME in
145                    Bitmap . . . . . . . . . . . . . . . . . . . . . . 14
146          5.3.4.3.  Response With Synthesized CNAME  . . . . . . . . . 14
148    6.  IANA Considerations  . . . . . . . . . . . . . . . . . . . . . 15
150    7.  Security Considerations  . . . . . . . . . . . . . . . . . . . 15
152    8.  Acknowledgments  . . . . . . . . . . . . . . . . . . . . . . . 15
154    9.  References . . . . . . . . . . . . . . . . . . . . . . . . . . 15
155      9.1.  Normative References . . . . . . . . . . . . . . . . . . . 15
156      9.2.  Informative References . . . . . . . . . . . . . . . . . . 16
167 Rose & Wijngaards         Expires May 16, 2010                  [Page 3]
169 Internet-Draft              DNAME Redirection              November 2009
172 1.  Introduction
174    DNAME is a DNS Resource Record type originally defined in RFC 2672
175    [RFC2672].  DNAME provides redirection from a part of the DNS name
176    tree to another part of the DNS name tree.
178    The DNAME RR and the CNAME RR [RFC1034] cause a lookup to
179    (potentially) return data corresponding to a domain name different
180    from the queried domain name.  The difference between the two
181    resource records is that the CNAME RR directs the lookup of data at
182    its owner to another single name, a DNAME RR directs lookups for data
183    at descendents of its owner's name to corresponding names under a
184    different (single) node of the tree.
186    Take for example, looking through a zone (see RFC 1034 [RFC1034],
187    section 4.3.2, step 3) for the domain name "foo.example.com" and a
188    DNAME resource record is found at "example.com" indicating that all
189    queries under "example.com" be directed to "example.net".  The lookup
190    process will return to step 1 with the new query name of
191    "foo.example.net".  Had the query name been "www.foo.example.com" the
192    new query name would be "www.foo.example.net".
194    This document is a revision of the original specification of DNAME in
195    RFC 2672 [RFC2672].  DNAME was conceived to help with the problem of
196    maintaining address-to-name mappings in a context of network
197    renumbering.  With a careful set-up, a renumbering event in the
198    network causes no change to the authoritative server that has the
199    address-to-name mappings.  Examples in practice are classless reverse
200    address space delegations.
202    Another usage of DNAME lies in aliasing of name spaces.  For example,
203    a zone administrator may want sub-trees of the DNS to contain the
204    same information.  Examples include punycode alternates for domain
205    spaces.
207    This revision to DNAME does not change the wire format or the
208    handling of DNAME Resource Records.  Discussion is added on problems
209    that may be encountered when using DNAME.
211 2.  The DNAME Resource Record
213 2.1.  Format
215    The DNAME RR has mnemonic DNAME and type code 39 (decimal).  It is
216    not class-sensitive.
223 Rose & Wijngaards         Expires May 16, 2010                  [Page 4]
225 Internet-Draft              DNAME Redirection              November 2009
228    Its RDATA is comprised of a single field, <target>, which contains a
229    fully qualified domain name that must be sent in uncompressed form
230    [RFC1035], [RFC3597].  The <target> field MUST be present.  The
231    presentation format of <target> is that of a domain name [RFC1035].
233            <owner> <ttl> <class> DNAME <target>
235    The effect of the DNAME RR is the substitution of the record's
236    <target> for its owner name, as a suffix of a domain name.  This
237    substitution has to be applied for every DNAME RR found in the
238    resolution process, which allows fairly lengthy valid chains of DNAME
239    RRs.
241    Details of the substitution process, methods to avoid conflicting
242    resource records, and rules for specific corner cases are given in
243    the following subsections.
245 2.2.  The DNAME Substitution
247    When following RFC 1034 [RFC1034], section 4.3.2's algorithm's third
248    step, "start matching down, label by label, in the zone" and a node
249    is found to own a DNAME resource record a DNAME substitution occurs.
250    The name being sought may be the original query name or a name that
251    is the result of a CNAME resource record being followed or a
252    previously encountered DNAME.  As in the case when finding a CNAME
253    resource record or NS resource record set, the processing of a DNAME
254    will happen prior to finding the desired domain name.
256    A DNAME substitution is performed by replacing the suffix labels of
257    the name being sought matching the owner name of the DNAME resource
258    record with the string of labels in the RDATA field.  The matching
259    labels end with the root label in all cases.  Only whole labels are
260    replaced.  See the table of examples for common cases and corner
261    cases.
279 Rose & Wijngaards         Expires May 16, 2010                  [Page 5]
281 Internet-Draft              DNAME Redirection              November 2009
284    In the table below, the QNAME refers to the query name.  The owner is
285    the DNAME owner domain name, and the target refers to the target of
286    the DNAME record.  The result is the resulting name after performing
287    the DNAME substitution on the query name. "no match" means that the
288    query did not match the DNAME and thus no substitution is performed
289    and a possible error message is returned (if no other result is
290    possible).  Thus every line contains one example substitution.  In
291    the examples below, 'cyc' and 'shortloop' contain loops.
293     QNAME            owner  DNAME   target         result
294     ---------------- -------------- -------------- -----------------
295     com.             example.com.   example.net.   <no match>
296     example.com.     example.com.   example.net.   <no match>
297     a.example.com.   example.com.   example.net.   a.example.net.
298     a.b.example.com. example.com.   example.net.   a.b.example.net.
299     ab.example.com.  b.example.com. example.net.   <no match>
300     foo.example.com. example.com.   example.net.   foo.example.net.
301     a.x.example.com. x.example.com. example.net.   a.example.net.
302     a.example.com.   example.com.   y.example.net. a.y.example.net.
303     cyc.example.com. example.com.   example.com.   cyc.example.com.
304     cyc.example.com. example.com.   c.example.com. cyc.c.example.com.
305     shortloop.x.x.   x.             .              shortloop.x.
306     shortloop.x.     x.             .              shortloop.
308                    Table 1. DNAME Substitution Examples.
310    It is possible for DNAMEs to form loops, just as CNAMEs can form
311    loops.  DNAMEs and CNAMEs can chain together to form loops.  A single
312    corner case DNAME can form a loop.  Resolvers and servers should be
313    cautious in devoting resources to a query, but be aware that fairly
314    long chains of DNAMEs may be valid.  Zone content administrators
315    should take care to insure that there are no loops that could occur
316    when using DNAME or DNAME/CNAME redirection.
318    The domain name can get too long during substitution.  For example,
319    suppose the target name of the DNAME RR is 250 octets in length
320    (multiple labels), if an incoming QNAME that has a first label over 5
321    octets in length, the result would be a name over 255 octets.  If
322    this occurs the server returns an RCODE of YXDOMAIN [RFC2136].  The
323    DNAME record and its signature (if the zone is signed) are included
324    in the answer as proof for the YXDOMAIN (value 6) RCODE.
326 2.3.  DNAME Owner Name not Redirected Itself
328    Unlike a CNAME RR, a DNAME RR redirects DNS names subordinate to its
329    owner name; the owner name of a DNAME is not redirected itself.  The
330    domain name that owns a DNAME record is allowed to have other
331    resource record types at that domain name, except DNAMEs, CNAMEs or
335 Rose & Wijngaards         Expires May 16, 2010                  [Page 6]
337 Internet-Draft              DNAME Redirection              November 2009
340    other types that have restrictions on what they can co-exist with.
341    DNAME RRs MUST NOT appear at the same owner name as an NS RR unless
342    the owner name is the zone apex.
344    If a DNAME record is present at the zone apex, there is still a need
345    to have the customary SOA and NS resource records there as well.
346    Such a DNAME cannot be used to mirror a zone completely, as it does
347    not mirror the zone apex.
349    These rules also allow DNAME records to be queried through RFC 1034
350    [RFC1034] compliant, DNAME-unaware caches.
352 2.4.  Names Next to and Below a DNAME Record
354    Resource records MUST NOT exist at any sub-domain of the owner of a
355    DNAME RR.  To get the contents for names subordinate to that owner
356    name, the DNAME redirection must be invoked and the resulting target
357    queried.  A server MAY refuse to load a zone that has data at a sub-
358    domain of a domain name owning a DNAME RR.  If the server does load
359    the zone, those names below the DNAME RR will be occluded as
360    described in RFC 2136 [RFC2136], section 7.18.  Also a server SHOULD
361    refuse to load a zone subordinate to the owner of a DNAME record in
362    the ancestor zone.  See Section 5.2 for further discussion related to
363    dynamic update.
365    DNAME is a singleton type, meaning only one DNAME is allowed per
366    name.  The owner name of a DNAME can only have one DNAME RR, and no
367    CNAME RRs can exist at that name.  These rules make sure that for a
368    single domain name only one redirection exists, and thus no confusion
369    which one to follow.  A server SHOULD refuse to load a zone that
370    violates these rules.
372 2.5.  Compression of the DNAME record.
374    The DNAME owner name can be compressed like any other owner name.
375    The DNAME RDATA target name MUST NOT be sent out in compressed form,
376    so that a DNAME RR can be treated as an unknown type [RFC3597].
378    Although the previous DNAME specification [RFC2672] (that is
379    obsoleted by this specification) talked about signaling to allow
380    compression of the target name, such signaling has never been
381    specified and this document also does not specify this signaling
382    behavior.
384    RFC 2672 (obsoleted by this document) stated that the EDNS version
385    had a meaning for understanding of DNAME and DNAME target name
386    compression.  This document revises RFC 2672, in that there is no
387    EDNS version signaling for DNAME.
391 Rose & Wijngaards         Expires May 16, 2010                  [Page 7]
393 Internet-Draft              DNAME Redirection              November 2009
396 3.  Processing
398    The DNAME RR causes type NS additional section processing.  This
399    refers to action at step 6 of the server algorithm outlined in
400    section 3.2.
402 3.1.  CNAME synthesis
404    When preparing a response, a server performing a DNAME substitution
405    will in all cases include the relevant DNAME RR in the answer
406    section.  A CNAME RR with TTL equal to the corresponding DNAME RR is
407    synthesized and included in the answer section.  The owner name of
408    the CNAME is the QNAME of the query.  The DNSSEC specification
409    [RFC4033], [RFC4034], [RFC4035] says that the synthesized CNAME does
410    not have to be signed.  The DNAME has an RRSIG and a validating
411    resolver can check the CNAME against the DNAME record and validate
412    the signature over the DNAME RR.
414    Resolvers MUST be able to handle a synthesized CNAME TTL of zero or
415    equal to the TTL of the corresponding DNAME record.  A TTL of zero
416    means that the CNAME can be discarded immediately after processing
417    the answer.
419    Servers MUST be able to answer a query for a synthesized CNAME.  Like
420    other query types this invokes the DNAME, and synthesizes the CNAME
421    into the answer.
423 3.2.  Server algorithm
425    Below is the server algorithm, which appeared in RFC 2672 Section
426    4.1.
428    1.  Set or clear the value of recursion available in the response
429        depending on whether the name server is willing to provide
430        recursive service.  If recursive service is available and
431        requested via the RD bit in the query, go to step 5, otherwise
432        step 2.
435    2.  Search the available zones for the zone which is the nearest
436        ancestor to QNAME.  If such a zone is found, go to step 3,
437        otherwise step 4.
440    3.  Start matching down, label by label, in the zone.  The matching
441        process can terminate several ways:
447 Rose & Wijngaards         Expires May 16, 2010                  [Page 8]
449 Internet-Draft              DNAME Redirection              November 2009
452        A.  If the whole of QNAME is matched, we have found the node.
454            If the data at the node is a CNAME, and QTYPE does not match
455            CNAME, copy the CNAME RR into the answer section of the
456            response, change QNAME to the canonical name in the CNAME RR,
457            and go back to step 1.
459            Otherwise, copy all RRs which match QTYPE into the answer
460            section and go to step 6.
463        B.  If a match would take us out of the authoritative data, we
464            have a referral.  This happens when we encounter a node with
465            NS RRs marking cuts along the bottom of a zone.
467            Copy the NS RRs for the sub-zone into the authority section
468            of the reply.  Put whatever addresses are available into the
469            additional section, using glue RRs if the addresses are not
470            available from authoritative data or the cache.  Go to step
471            4.
474        C.  If at some label, a match is impossible (i.e., the
475            corresponding label does not exist), look to see whether the
476            last label matched has a DNAME record.
478            If a DNAME record exists at that point, copy that record into
479            the answer section.  If substitution of its <target> for its
480            <owner> in QNAME would overflow the legal size for a <domain-
481            name>, set RCODE to YXDOMAIN [RFC2136] and exit; otherwise
482            perform the substitution and continue.  The server MUST
483            synthesize a CNAME record as described above and include it
484            in the answer section.  Go back to step 1.
486            If there was no DNAME record, look to see if the "*" label
487            exists.
489            If the "*" label does not exist, check whether the name we
490            are looking for is the original QNAME in the query or a name
491            we have followed due to a CNAME or DNAME.  If the name is
492            original, set an authoritative name error in the response and
493            exit.  Otherwise just exit.
495            If the "*" label does exist, match RRs at that node against
496            QTYPE.  If any match, copy them into the answer section, but
497            set the owner of the RR to be QNAME, and not the node with
498            the "*" label.  If the data at the node with the "*" label is
499            a CNAME, and QTYPE doesn't match CNAME, copy the CNAME RR
503 Rose & Wijngaards         Expires May 16, 2010                  [Page 9]
505 Internet-Draft              DNAME Redirection              November 2009
508            into the answer section of the response changing the owner
509            name to the QNAME, change QNAME to the canonical name in the
510            CNAME RR, and go back to step 1.  Otherwise, Go to step 6.
513    4.  Start matching down in the cache.  If QNAME is found in the
514        cache, copy all RRs attached to it that match QTYPE into the
515        answer section.  If QNAME is not found in the cache but a DNAME
516        record is present at an ancestor of QNAME, copy that DNAME record
517        into the answer section.  If there was no delegation from
518        authoritative data, look for the best one from the cache, and put
519        it in the authority section.  Go to step 6.
522    5.  Use the local resolver or a copy of its algorithm to answer the
523        query.  Store the results, including any intermediate CNAMEs and
524        DNAMEs, in the answer section of the response.
527    6.  Using local data only, attempt to add other RRs which may be
528        useful to the additional section of the query.  Exit.
530    Note that there will be at most one ancestor with a DNAME as
531    described in step 4 unless some zone's data is in violation of the
532    no-descendants limitation in section 3.  An implementation might take
533    advantage of this limitation by stopping the search of step 3c or
534    step 4 when a DNAME record is encountered.
536 3.3.  Wildcards
538    The use of DNAME in conjunction with wildcards is discouraged
539    [RFC4592].  Thus records of the form "*.example.com DNAME
540    example.net" SHOULD NOT be used.
542    The interaction between the expansion of the wildcard and the
543    redirection of the DNAME is non-deterministic.  Because the
544    processing is non-deterministic, DNSSEC validating resolvers may not
545    be able to validate a wildcarded DNAME.
547    A server MAY give a warning that the behavior is unspecified if such
548    a wildcarded DNAME is loaded.  The server MAY refuse it, refuse to
549    load the zone or refuse dynamic updates.
551 3.4.  Acceptance and Intermediate Storage
553    Recursive caching name servers can encounter data at names below the
554    owner name of a DNAME RR, due to a change at the authoritative server
555    where data from before and after the change resides in the cache.
559 Rose & Wijngaards         Expires May 16, 2010                 [Page 10]
561 Internet-Draft              DNAME Redirection              November 2009
564    This conflict situation is a transitional phase that ends when the
565    old data times out.  The caching name server can opt to store both
566    old and new data and treat each as if the other did not exist, or
567    drop the old data, or drop the longer domain name.  In any approach,
568    consistency returns after the older data TTL times out.
570    Recursive caching name servers MUST perform CNAME synthesis on behalf
571    of clients.
573    If a recursive caching name server encounters a DNAME RR which
574    contradicts information already in the cache (excluding CNAME
575    records), it SHOULD NOT cache the DNAME RR, but it MAY cache the
576    CNAME record received along with it, subject to the rules for CNAME.
578 4.  DNAME Discussions in Other Documents
580    In [RFC2181], in Section 10.3., the discussion on MX and NS records
581    touches on redirection by CNAMEs, but this also holds for DNAMEs.
583    Excerpt from 10.3.  MX and NS records (in RFC 2181).
585            The domain name used as the value of a NS resource record,
586            or part of the value of a MX resource record must not be
587            an alias.  Not only is the specification clear on this
588            point, but using an alias in either of these positions
589            neither works as well as might be hoped, nor well fulfills
590            the ambition that may have led to this approach.  This
591            domain name must have as its value one or more address
592            records.  Currently those will be A records, however in
593            the future other record types giving addressing
594            information may be acceptable.  It can also have other
595            RRs, but never a CNAME RR.
597    The DNAME RR is discussed in RFC 3363, section 4, on A6 and DNAME.
598    The opening premise of this section is demonstrably wrong, and so the
599    conclusion based on that premise is wrong.  In particular, [RFC3363]
600    deprecates the use of DNAME in the IPv6 reverse tree, which is then
601    carried forward as a recommendation in [RFC4294].  Based on the
602    experience gained in the meantime, [RFC3363] should be revised,
603    dropping all constraints on having DNAME RRs in these zones.  This
604    would greatly improve the manageability of the IPv6 reverse tree.
605    These changes are made explicit below.
615 Rose & Wijngaards         Expires May 16, 2010                 [Page 11]
617 Internet-Draft              DNAME Redirection              November 2009
620    In [RFC3363], the paragraph
622      "The issues for DNAME in the reverse mapping tree appears to be
623      closely tied to the need to use fragmented A6 in the main tree: if
624      one is necessary, so is the other, and if one isn't necessary, the
625      other isn't either.  Therefore, in moving RFC 2874 to experimental,
626      the intent of this document is that use of DNAME RRs in the reverse
627      tree be deprecated."
629    is to be replaced with the word "DELETED".
631    In [RFC4294], the reference to DNAME was left in as an editorial
632    oversight.  The paragraph
634      "Those nodes are NOT RECOMMENDED to support the experimental A6 and
635      DNAME Resource Records [RFC3363]."
637    is to be replaced by
639      "Those nodes are NOT RECOMMENDED to support the experimental
640      A6 Resource Record [RFC3363]."
642 5.  Other Issues with DNAME
644    There are several issues to be aware of about the use of DNAME.
646 5.1.  Canonical hostnames cannot be below DNAME owners
648    The names listed as target names of MX, NS, PTR and SRV [RFC2782]
649    records must be canonical hostnames.  This means no CNAME or DNAME
650    redirection may be present during DNS lookup of the address records
651    for the host.  This is discussed in RFC 2181 [RFC2181], section 10.3,
652    and RFC 1912 [RFC1912], section 2.4.  For SRV see RFC 2782 [RFC2782]
653    page 4.
655    The upshot of this is that although the lookup of a PTR record can
656    involve DNAMEs, the name listed in the PTR record can not fall under
657    a DNAME.  The same holds for NS, SRV and MX records.  For example,
658    when punycode alternates for a zone use DNAME then the NS, MX, SRV
659    and PTR records that point to that zone must use names without
660    punycode in their RDATA.  What must be done then is to have the
661    domain names with DNAME substitution already applied to it as the MX,
662    NS, PTR, SRV data.  These are valid canonical hostnames.
664 5.2.  Dynamic Update and DNAME
666    DNAME records can be added, changed and removed in a zone using
667    dynamic update transactions.  Adding a DNAME RR to a zone occludes
671 Rose & Wijngaards         Expires May 16, 2010                 [Page 12]
673 Internet-Draft              DNAME Redirection              November 2009
676    any domain names that may exist under the added DNAME.
678    A server MUST reject a dynamic update message that attempts to add a
679    DNAME RR at a name that already has a CNAME RR or another DNAME RR
680    associated with that name.
682 5.3.  DNSSEC and DNAME
684    The following subsections specify the behavior of implementations
685    that understand both DNSSEC and DNAME (synthesis).
687 5.3.1.  Signed DNAME, Unsigned Synthesized CNAME
689    In any response, a signed DNAME RR indicates a non-terminal
690    redirection of the query.  There might or might not be a server
691    synthesized CNAME in the answer section; if there is, the CNAME will
692    never be signed.  For a DNSSEC validator, verification of the DNAME
693    RR and then checking that the CNAME was properly synthesized is
694    sufficient proof.
696 5.3.2.  DNAME Bit in NSEC Type Map
698    In any negative response, the NSEC or NSEC3 [RFC5155] record type bit
699    map SHOULD be checked to see that there was no DNAME that could have
700    been applied.  If the DNAME bit in the type bit map is set and the
701    query name is a subdomain of the closest encloser that is asserted,
702    then DNAME substitution should have been done, but the substitution
703    has not been done as specified.
705 5.3.3.  DNAME Chains as Strong as the Weakest Link
707    A response can contain a chain of DNAME and CNAME redirections.  That
708    chain can end in a positive answer or a negative (no name error or no
709    data error) reply.  Each step in that chain results in resource
710    records added to the answer or authority section of the response.
711    Only if all steps are secure can the AD bit be set for the response.
712    If one of the steps is bogus, the result is bogus.
714 5.3.4.  Validators Must Understand DNAME
716    Below are examples of why DNSSEC validators MUST understand DNAME.
717    In the examples below, SOA records, wildcard denial NSECs and other
718    material not under discussion has been omitted.
720 5.3.4.1.  DNAME in Bitmap Causes Invalid Name Error
727 Rose & Wijngaards         Expires May 16, 2010                 [Page 13]
729 Internet-Draft              DNAME Redirection              November 2009
732    ;; Header: QR AA DO RCODE=3(NXDOMAIN)
733    ;; Question
734    foo.bar.example.com. IN A
735    ;; Authority
736    bar.example.com. NSEC dub.example.com. A DNAME
737    bar.example.com. RRSIG NSEC [valid signature]
739    If this is the received response, then only by understanding that the
740    DNAME bit in the NSEC bitmap means that foo.bar.example.com needed to
741    have been redirected by the DNAME, the validator can see that it is a
742    BOGUS reply from an attacker that collated existing records from the
743    DNS to create a confusing reply.
745    If the DNAME bit had not been set in the NSEC record above then the
746    answer would have validated as a correct name error response.
748 5.3.4.2.  Valid Name Error Response Involving DNAME in Bitmap
750    ;; Header: QR AA DO RCODE=3(NXDOMAIN)
751    ;; Question
752    cee.example.com. IN A
753    ;; Authority
754    bar.example.com. NSEC dub.example.com. A DNAME
755    bar.example.com. RRSIG NSEC [valid signature]
757    This response has the same NSEC records as the example above, but
758    with this query name (cee.example.com), the answer is validated,
759    because 'cee' does not get redirected by the DNAME at 'bar'.
761 5.3.4.3.  Response With Synthesized CNAME
763    ;; Header: QR AA DO RCODE=0(NOERROR)
764    ;; Question
765    foo.bar.example.com. IN A
766    ;; Answer
767    bar.example.com. DNAME bar.example.net.
768    bar.example.com. RRSIG DNAME [valid signature]
769    foo.bar.example.com. CNAME foo.bar.example.net.
771    The response shown above has the synthesized CNAME included.
772    However, the CNAME has no signature, since the server does not sign
773    online.  So this response cannot be trusted.  It could be altered by
774    an attacker to be foo.bar.example.com CNAME bla.bla.example.  The
775    DNAME record does have its signature included, since it does not
776    change.  The validator must verify the DNAME signature and then
777    recursively resolve further to query for the foo.bar.example.net A
778    record.
783 Rose & Wijngaards         Expires May 16, 2010                 [Page 14]
785 Internet-Draft              DNAME Redirection              November 2009
788 6.  IANA Considerations
790    The DNAME Resource Record type code 39 (decimal) originally has been
791    registered by [RFC2672].  IANA should update the DNS resource record
792    registry to point to this document for RR type 39.
794 7.  Security Considerations
796    DNAME redirects queries elsewhere, which may impact security based on
797    policy and the security status of the zone with the DNAME and the
798    redirection zone's security status.  For validating resolvers, the
799    lowest security status of the links in the chain of CNAME and DNAME
800    redirections is applied to the result.
802    If a validating resolver accepts wildcarded DNAMEs, this creates
803    security issues.  Since the processing of a wildcarded DNAME is non-
804    deterministic and the CNAME that was substituted by the server has no
805    signature, the resolver may choose a different result than what the
806    server meant, and consequently end up at the wrong destination.  Use
807    of wildcarded DNAMEs is discouraged in any case [RFC4592].
809    A validating resolver MUST understand DNAME, according to [RFC4034].
810    The examples in Section 5.3.4 illustrate this need.
812 8.  Acknowledgments
814    The authors of this draft would like to acknowledge Matt Larson for
815    beginning this effort to address the issues related to the DNAME RR
816    type.  The authors would also like to acknowledge Paul Vixie, Ed
817    Lewis, Mark Andrews, Mike StJohns, Niall O'Reilly, Sam Weiler, Alfred
818    Hoenes and Kevin Darcy for their review and comments on this
819    document.
821 9.  References
823 9.1.  Normative References
825    [RFC1034]  Mockapetris, P., "Domain names - concepts and facilities",
826               STD 13, RFC 1034, November 1987.
828    [RFC1035]  Mockapetris, P., "Domain names - implementation and
829               specification", STD 13, RFC 1035, November 1987.
831    [RFC2119]  Bradner, S., "Key words for use in RFCs to Indicate
832               Requirement Levels", BCP 14, RFC 2119, March 1997.
834    [RFC2136]  Vixie, P., Thomson, S., Rekhter, Y., and J. Bound,
835               "Dynamic Updates in the Domain Name System (DNS UPDATE)",
839 Rose & Wijngaards         Expires May 16, 2010                 [Page 15]
841 Internet-Draft              DNAME Redirection              November 2009
844               RFC 2136, April 1997.
846    [RFC2181]  Elz, R. and R. Bush, "Clarifications to the DNS
847               Specification", RFC 2181, July 1997.
849    [RFC2782]  Gulbrandsen, A., Vixie, P., and L. Esibov, "A DNS RR for
850               specifying the location of services (DNS SRV)", RFC 2782,
851               February 2000.
853    [RFC3597]  Gustafsson, A., "Handling of Unknown DNS Resource Record
854               (RR) Types", RFC 3597, September 2003.
856    [RFC4033]  Arends, R., Austein, R., Larson, M., Massey, D., and S.
857               Rose, "DNS Security Introduction and Requirements",
858               RFC 4033, March 2005.
860    [RFC4034]  Arends, R., Austein, R., Larson, M., Massey, D., and S.
861               Rose, "Resource Records for the DNS Security Extensions",
862               RFC 4034, March 2005.
864    [RFC4035]  Arends, R., Austein, R., Larson, M., Massey, D., and S.
865               Rose, "Protocol Modifications for the DNS Security
866               Extensions", RFC 4035, March 2005.
868    [RFC4592]  Lewis, E., "The Role of Wildcards in the Domain Name
869               System", RFC 4592, July 2006.
871    [RFC5155]  Laurie, B., Sisson, G., Arends, R., and D. Blacka, "DNS
872               Security (DNSSEC) Hashed Authenticated Denial of
873               Existence", RFC 5155, March 2008.
875 9.2.  Informative References
877    [RFC1912]  Barr, D., "Common DNS Operational and Configuration
878               Errors", RFC 1912, February 1996.
880    [RFC2672]  Crawford, M., "Non-Terminal DNS Name Redirection",
881               RFC 2672, August 1999.
883    [RFC3363]  Bush, R., Durand, A., Fink, B., Gudmundsson, O., and T.
884               Hain, "Representing Internet Protocol version 6 (IPv6)
885               Addresses in the Domain Name System (DNS)", RFC 3363,
886               August 2002.
888    [RFC4294]  Loughney, J., "IPv6 Node Requirements", RFC 4294,
889               April 2006.
895 Rose & Wijngaards         Expires May 16, 2010                 [Page 16]
897 Internet-Draft              DNAME Redirection              November 2009
900 Authors' Addresses
902    Scott Rose
903    NIST
904    100 Bureau Dr.
905    Gaithersburg, MD  20899
906    USA
908    Phone: +1-301-975-8439
909    Fax:   +1-301-975-6238
910    EMail: scottr@nist.gov
913    Wouter Wijngaards
914    NLnet Labs
915    Science Park 140
916    Amsterdam  1098 XG
917    The Netherlands
919    Phone: +31-20-888-4551
920    EMail: wouter@nlnetlabs.nl
951 Rose & Wijngaards         Expires May 16, 2010                 [Page 17]