<?xml version='1.0' encoding='utf-8'?>
<rfc xmlns:xi="http://www.w3.org/2001/XInclude" version="3" ipr="trust200902" docName="draft-ietf-dnsop-dns-catalog-zones-09" number="9432" submissionType="IETF" category="std" consensus="true" xml:lang="en" tocInclude="true" sortRefs="true" symRefs="true" updates="" obsoletes="" prepTime="2023-07-06T16:21:34" indexInclude="true" scripts="Common,Latin" tocDepth="3">
  <link href="https://datatracker.ietf.org/doc/draft-ietf-dnsop-dns-catalog-zones-09" rel="prev"/>
  <link href="https://dx.doi.org/10.17487/rfc9432" rel="alternate"/>
  <link href="urn:issn:2070-1721" rel="alternate"/>
  <front>
    <title abbrev="DNS Catalog Zones">DNS Catalog Zones</title>
    <seriesInfo name="RFC" value="9432" stream="IETF"/>
    <author initials="P." surname="van Dijk" fullname="Peter van Dijk">
      <organization showOnFrontPage="true">PowerDNS</organization>
      <address>
        <postal>
          <city>Den Haag</city>
          <country>Netherlands</country>
        </postal>
        <email>peter.van.dijk@powerdns.com</email>
      </address>
    </author>
    <author initials="L." surname="Peltan" fullname="Libor Peltan">
      <organization showOnFrontPage="true">CZ.NIC</organization>
      <address>
        <postal>
          <country>Czech Republic</country>
        </postal>
        <email>libor.peltan@nic.cz</email>
      </address>
    </author>
    <author initials="O." surname="Sury" fullname="Ondrej Sury">
      <organization showOnFrontPage="true">Internet Systems Consortium</organization>
      <address>
        <postal>
          <country>Czech Republic</country>
        </postal>
        <email>ondrej@isc.org</email>
      </address>
    </author>
    <author initials="W." surname="Toorop" fullname="Willem Toorop">
      <organization showOnFrontPage="true">NLnet Labs</organization>
      <address>
        <postal>
          <street>Science Park 400</street>
          <city>Amsterdam</city>
          <code>1098 XH</code>
          <country>Netherlands</country>
        </postal>
        <email>willem@nlnetlabs.nl</email>
      </address>
    </author>
    <author initials="C.R." surname="Monshouwer" fullname="Kees Monshouwer">
      <organization showOnFrontPage="true"/>
      <address>
        <postal>
          <country>Netherlands</country>
        </postal>
        <email>mind@monshouwer.eu</email>
      </address>
    </author>
    <author initials="P." surname="Thomassen" fullname="Peter Thomassen">
      <organization showOnFrontPage="true">deSEC, SSE - Secure Systems Engineering</organization>
      <address>
        <postal>
          <street/>
          <city>Berlin</city>
          <country>Germany</country>
        </postal>
        <email>peter@desec.io</email>
      </address>
    </author>
    <author initials="A." surname="Sargsyan" fullname="Aram Sargsyan">
      <organization showOnFrontPage="true">Internet Systems Consortium</organization>
      <address>
        <postal>
          <street/>
        </postal>
        <email>aram@isc.org</email>
      </address>
    </author>
    <date month="07" year="2023"/>
    <area>ops</area>
    <workgroup>dnsop</workgroup>
    <abstract pn="section-abstract">
      <t indent="0" pn="section-abstract-1">This document describes a method for automatic DNS zone provisioning among DNS
primary and secondary name servers by storing and transferring the catalog of
zones to be provisioned as one or more regular DNS zones.</t>
    </abstract>
    <boilerplate>
      <section anchor="status-of-memo" numbered="false" removeInRFC="false" toc="exclude" pn="section-boilerplate.1">
        <name slugifiedName="name-status-of-this-memo">Status of This Memo</name>
        <t indent="0" pn="section-boilerplate.1-1">
            This is an Internet Standards Track document.
        </t>
        <t indent="0" pn="section-boilerplate.1-2">
            This document is a product of the Internet Engineering Task Force
            (IETF).  It represents the consensus of the IETF community.  It has
            received public review and has been approved for publication by
            the Internet Engineering Steering Group (IESG).  Further
            information on Internet Standards is available in Section 2 of 
            RFC 7841.
        </t>
        <t indent="0" pn="section-boilerplate.1-3">
            Information about the current status of this document, any
            errata, and how to provide feedback on it may be obtained at
            <eref target="https://www.rfc-editor.org/info/rfc9432" brackets="none"/>.
        </t>
      </section>
      <section anchor="copyright" numbered="false" removeInRFC="false" toc="exclude" pn="section-boilerplate.2">
        <name slugifiedName="name-copyright-notice">Copyright Notice</name>
        <t indent="0" pn="section-boilerplate.2-1">
            Copyright (c) 2023 IETF Trust and the persons identified as the
            document authors. All rights reserved.
        </t>
        <t indent="0" pn="section-boilerplate.2-2">
            This document is subject to BCP 78 and the IETF Trust's Legal
            Provisions Relating to IETF Documents
            (<eref target="https://trustee.ietf.org/license-info" brackets="none"/>) 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.
        </t>
      </section>
    </boilerplate>
    <toc>
      <section anchor="toc" numbered="false" removeInRFC="false" toc="exclude" pn="section-toc.1">
        <name slugifiedName="name-table-of-contents">Table of Contents</name>
        <ul bare="true" empty="true" indent="2" spacing="compact" pn="section-toc.1-1">
          <li pn="section-toc.1-1.1">
            <t indent="0" keepWithNext="true" pn="section-toc.1-1.1.1"><xref derivedContent="1" format="counter" sectionFormat="of" target="section-1"/>.  <xref derivedContent="" format="title" sectionFormat="of" target="name-introduction">Introduction</xref></t>
          </li>
          <li pn="section-toc.1-1.2">
            <t indent="0" keepWithNext="true" pn="section-toc.1-1.2.1"><xref derivedContent="2" format="counter" sectionFormat="of" target="section-2"/>.  <xref derivedContent="" format="title" sectionFormat="of" target="name-terminology">Terminology</xref></t>
          </li>
          <li pn="section-toc.1-1.3">
            <t indent="0" keepWithNext="true" pn="section-toc.1-1.3.1"><xref derivedContent="3" format="counter" sectionFormat="of" target="section-3"/>.  <xref derivedContent="" format="title" sectionFormat="of" target="name-description">Description</xref></t>
          </li>
          <li pn="section-toc.1-1.4">
            <t indent="0" pn="section-toc.1-1.4.1"><xref derivedContent="4" format="counter" sectionFormat="of" target="section-4"/>.  <xref derivedContent="" format="title" sectionFormat="of" target="name-catalog-zone-structure">Catalog Zone Structure</xref></t>
            <ul bare="true" empty="true" indent="2" spacing="compact" pn="section-toc.1-1.4.2">
              <li pn="section-toc.1-1.4.2.1">
                <t indent="0" pn="section-toc.1-1.4.2.1.1"><xref derivedContent="4.1" format="counter" sectionFormat="of" target="section-4.1"/>.  <xref derivedContent="" format="title" sectionFormat="of" target="name-member-zones">Member Zones</xref></t>
              </li>
              <li pn="section-toc.1-1.4.2.2">
                <t indent="0" pn="section-toc.1-1.4.2.2.1"><xref derivedContent="4.2" format="counter" sectionFormat="of" target="section-4.2"/>.  <xref derivedContent="" format="title" sectionFormat="of" target="name-properties">Properties</xref></t>
                <ul bare="true" empty="true" indent="2" spacing="compact" pn="section-toc.1-1.4.2.2.2">
                  <li pn="section-toc.1-1.4.2.2.2.1">
                    <t indent="0" pn="section-toc.1-1.4.2.2.2.1.1"><xref derivedContent="4.2.1" format="counter" sectionFormat="of" target="section-4.2.1"/>.  <xref derivedContent="" format="title" sectionFormat="of" target="name-schema-version-version-prop">Schema Version (<tt>version</tt> property)</xref></t>
                  </li>
                </ul>
              </li>
              <li pn="section-toc.1-1.4.2.3">
                <t indent="0" pn="section-toc.1-1.4.2.3.1"><xref derivedContent="4.3" format="counter" sectionFormat="of" target="section-4.3"/>.  <xref derivedContent="" format="title" sectionFormat="of" target="name-member-zone-properties">Member Zone Properties</xref></t>
                <ul bare="true" empty="true" indent="2" spacing="compact" pn="section-toc.1-1.4.2.3.2">
                  <li pn="section-toc.1-1.4.2.3.2.1">
                    <t indent="0" pn="section-toc.1-1.4.2.3.2.1.1"><xref derivedContent="4.3.1" format="counter" sectionFormat="of" target="section-4.3.1"/>.  <xref derivedContent="" format="title" sectionFormat="of" target="name-change-of-ownership-coo-pro">Change of Ownership (<tt>coo</tt> property)</xref></t>
                  </li>
                  <li pn="section-toc.1-1.4.2.3.2.2">
                    <t indent="0" pn="section-toc.1-1.4.2.3.2.2.1"><xref derivedContent="4.3.2" format="counter" sectionFormat="of" target="section-4.3.2"/>.  <xref derivedContent="" format="title" sectionFormat="of" target="name-groups-group-property">Groups (<tt>group</tt> property)</xref></t>
                  </li>
                </ul>
              </li>
              <li pn="section-toc.1-1.4.2.4">
                <t indent="0" pn="section-toc.1-1.4.2.4.1"><xref derivedContent="4.4" format="counter" sectionFormat="of" target="section-4.4"/>.  <xref derivedContent="" format="title" sectionFormat="of" target="name-custom-properties-ext-prope">Custom Properties (<tt>*.ext</tt> properties)</xref></t>
              </li>
            </ul>
          </li>
          <li pn="section-toc.1-1.5">
            <t indent="0" pn="section-toc.1-1.5.1"><xref derivedContent="5" format="counter" sectionFormat="of" target="section-5"/>.  <xref derivedContent="" format="title" sectionFormat="of" target="name-name-server-behavior">Name Server Behavior</xref></t>
            <ul bare="true" empty="true" indent="2" spacing="compact" pn="section-toc.1-1.5.2">
              <li pn="section-toc.1-1.5.2.1">
                <t indent="0" pn="section-toc.1-1.5.2.1.1"><xref derivedContent="5.1" format="counter" sectionFormat="of" target="section-5.1"/>.  <xref derivedContent="" format="title" sectionFormat="of" target="name-general-requirements">General Requirements</xref></t>
              </li>
              <li pn="section-toc.1-1.5.2.2">
                <t indent="0" pn="section-toc.1-1.5.2.2.1"><xref derivedContent="5.2" format="counter" sectionFormat="of" target="section-5.2"/>.  <xref derivedContent="" format="title" sectionFormat="of" target="name-member-zone-name-clash">Member Zone Name Clash</xref></t>
              </li>
              <li pn="section-toc.1-1.5.2.3">
                <t indent="0" pn="section-toc.1-1.5.2.3.1"><xref derivedContent="5.3" format="counter" sectionFormat="of" target="section-5.3"/>.  <xref derivedContent="" format="title" sectionFormat="of" target="name-member-zone-removal">Member Zone Removal</xref></t>
              </li>
              <li pn="section-toc.1-1.5.2.4">
                <t indent="0" pn="section-toc.1-1.5.2.4.1"><xref derivedContent="5.4" format="counter" sectionFormat="of" target="section-5.4"/>.  <xref derivedContent="" format="title" sectionFormat="of" target="name-member-node-name-change">Member Node Name
     Change</xref></t>
              </li>
              <li pn="section-toc.1-1.5.2.5">
                <t indent="0" pn="section-toc.1-1.5.2.5.1"><xref derivedContent="5.5" format="counter" sectionFormat="of" target="section-5.5"/>.  <xref derivedContent="" format="title" sectionFormat="of" target="name-migrating-member-zones-betw">Migrating Member Zones between Catalogs</xref></t>
              </li>
              <li pn="section-toc.1-1.5.2.6">
                <t indent="0" pn="section-toc.1-1.5.2.6.1"><xref derivedContent="5.6" format="counter" sectionFormat="of" target="section-5.6"/>.  <xref derivedContent="" format="title" sectionFormat="of" target="name-zone-associated-state-reset">Zone-Associated State Reset</xref></t>
              </li>
            </ul>
          </li>
          <li pn="section-toc.1-1.6">
            <t indent="0" pn="section-toc.1-1.6.1"><xref derivedContent="6" format="counter" sectionFormat="of" target="section-6"/>.  <xref derivedContent="" format="title" sectionFormat="of" target="name-implementation-and-operatio">Implementation and Operational Notes</xref></t>
          </li>
          <li pn="section-toc.1-1.7">
            <t indent="0" pn="section-toc.1-1.7.1"><xref derivedContent="7" format="counter" sectionFormat="of" target="section-7"/>.  <xref derivedContent="" format="title" sectionFormat="of" target="name-security-considerations">Security Considerations</xref></t>
          </li>
          <li pn="section-toc.1-1.8">
            <t indent="0" pn="section-toc.1-1.8.1"><xref derivedContent="8" format="counter" sectionFormat="of" target="section-8"/>.  <xref derivedContent="" format="title" sectionFormat="of" target="name-iana-considerations">IANA Considerations</xref></t>
          </li>
          <li pn="section-toc.1-1.9">
            <t indent="0" pn="section-toc.1-1.9.1"><xref derivedContent="9" format="counter" sectionFormat="of" target="section-9"/>.  <xref derivedContent="" format="title" sectionFormat="of" target="name-references">References</xref></t>
            <ul bare="true" empty="true" indent="2" spacing="compact" pn="section-toc.1-1.9.2">
              <li pn="section-toc.1-1.9.2.1">
                <t indent="0" pn="section-toc.1-1.9.2.1.1"><xref derivedContent="9.1" format="counter" sectionFormat="of" target="section-9.1"/>.  <xref derivedContent="" format="title" sectionFormat="of" target="name-normative-references">Normative References</xref></t>
              </li>
              <li pn="section-toc.1-1.9.2.2">
                <t indent="0" pn="section-toc.1-1.9.2.2.1"><xref derivedContent="9.2" format="counter" sectionFormat="of" target="section-9.2"/>.  <xref derivedContent="" format="title" sectionFormat="of" target="name-informative-references">Informative References</xref></t>
              </li>
            </ul>
          </li>
          <li pn="section-toc.1-1.10">
            <t indent="0" pn="section-toc.1-1.10.1"><xref derivedContent="Appendix A" format="default" sectionFormat="of" target="section-appendix.a"/>.  <xref derivedContent="" format="title" sectionFormat="of" target="name-catalog-zone-example">Catalog Zone Example</xref></t>
          </li>
          <li pn="section-toc.1-1.11">
            <t indent="0" pn="section-toc.1-1.11.1"><xref derivedContent="" format="none" sectionFormat="of" target="section-appendix.b"/><xref derivedContent="" format="title" sectionFormat="of" target="name-acknowledgements">Acknowledgements</xref></t>
          </li>
          <li pn="section-toc.1-1.12">
            <t indent="0" pn="section-toc.1-1.12.1"><xref derivedContent="" format="none" sectionFormat="of" target="section-appendix.c"/><xref derivedContent="" format="title" sectionFormat="of" target="name-authors-addresses">Authors' Addresses</xref></t>
          </li>
        </ul>
      </section>
    </toc>
  </front>
  <middle>
    <section anchor="introduction" numbered="true" removeInRFC="false" toc="include" pn="section-1">
      <name slugifiedName="name-introduction">Introduction</name>
      <t indent="0" pn="section-1-1">The content of a DNS zone is synchronized among its primary and secondary
name servers using Authoritative Transfer (AXFR) and Incremental Zone Transfer (IXFR).  
However, the list of zones served by the
primary (called a "catalog" in <xref target="RFC1035" format="default" sectionFormat="of" derivedContent="RFC1035"/>) is not automatically synchronized
with the secondaries.  To add or remove a zone, the administrator of a DNS
name server farm has to not only add or remove the zone from the primary but must also 
add or remove configuration for the zone from all secondaries.  This
can be both inconvenient and error-prone. In addition, the steps required are
dependent on the name server implementation.</t>
      <t indent="0" pn="section-1-2">This document describes a method in which the list of zones is represented as a
regular DNS zone (called a "catalog zone" here) and transferred using DNS zone
transfers.  When entries are added to or removed from the catalog zone, it is
distributed to the secondary name servers just like any other zone.  Secondary
name servers can then add, remove, or modify the zones they serve in accordance with the
changes to the catalog zone. Other use cases of name server remote configuration
by catalog zones are possible where the catalog consumer might not be a
secondary.</t>
    </section>
    <section anchor="terminology" numbered="true" removeInRFC="false" toc="include" pn="section-2">
      <name slugifiedName="name-terminology">Terminology</name>
      <t indent="0" pn="section-2-1">
    The key words "<bcp14>MUST</bcp14>", "<bcp14>MUST NOT</bcp14>", "<bcp14>REQUIRED</bcp14>", "<bcp14>SHALL</bcp14>", "<bcp14>SHALL NOT</bcp14>", "<bcp14>SHOULD</bcp14>", "<bcp14>SHOULD NOT</bcp14>", "<bcp14>RECOMMENDED</bcp14>", "<bcp14>NOT RECOMMENDED</bcp14>",
    "<bcp14>MAY</bcp14>", and "<bcp14>OPTIONAL</bcp14>" in this document are to be interpreted as
    described in BCP 14 <xref target="RFC2119" format="default" sectionFormat="of" derivedContent="RFC2119"/> <xref target="RFC8174" format="default" sectionFormat="of" derivedContent="RFC8174"/> 
    when, and only when, they appear in all capitals, as shown here.
      </t>
      <dl indent="3" newline="false" spacing="normal" pn="section-2-2">
        <dt pn="section-2-2.1">Catalog zone:</dt>
        <dd pn="section-2-2.2">A DNS zone containing a DNS catalog, which is a list of DNS zones and associated properties.</dd>
        <dt pn="section-2-2.3">Member zone:</dt>
        <dd pn="section-2-2.4">A DNS zone whose configuration is published inside a catalog zone.</dd>
        <dt pn="section-2-2.5">Member node:</dt>
        <dd pn="section-2-2.6">A DNS name in the catalog zone representing a member zone.</dd>
        <dt pn="section-2-2.7"><tt>$CATZ</tt>:</dt>
        <dd pn="section-2-2.8">Used in examples as a placeholder to represent the domain name of the
catalog zone itself.
<tt>$OLDCATZ</tt> and <tt>$NEWCATZ</tt> are used to discuss migration of a member zone from one catalog zone (<tt>$OLDCATZ</tt>) to another catalog zone (<tt>$NEWCATZ</tt>).</dd>
        <dt pn="section-2-2.9">Catalog producer:</dt>
        <dd pn="section-2-2.10">An entity that generates and is responsible for the contents of the catalog zone.</dd>
        <dt pn="section-2-2.11">Catalog consumer:</dt>
        <dd pn="section-2-2.12">An entity that extracts information from the catalog zone (such as a DNS
server that configures itself according to the catalog zone's contents).</dd>
      </dl>
      <t indent="0" pn="section-2-3">
This document makes use of terminology for transfer mechanisms (AXFR and IXFR), record types (SOA, NS, and PTR), and other technical terms (such as RDATA) that are specific to the DNS.
Since these terms have specific meanings in the DNS, they are not expanded upon first use in this document.
For definitions of these and other terms, see <xref target="RFC8499" format="default" sectionFormat="of" derivedContent="RFC8499"/>.</t>
    </section>
    <section anchor="description" numbered="true" removeInRFC="false" toc="include" pn="section-3">
      <name slugifiedName="name-description">Description</name>
      <t indent="0" pn="section-3-1">A catalog zone is a DNS zone whose contents are specially crafted. Its resource records (RRs) primarily constitute a list of PTR records referencing other DNS zones (so-called "member zones"). The catalog zone may contain other records indicating additional metadata (so-called "properties") associated with these member zones.</t>
      <t indent="0" pn="section-3-2">Catalog consumers <bcp14>MUST</bcp14> ignore any RRs in the catalog zone for which no processing is specified or which are otherwise not supported by the implementation.</t>
      <t indent="0" pn="section-3-3">Authoritative servers may be pre-configured with multiple catalog zones, each associated with a different set of configurations.</t>
      <t indent="0" pn="section-3-4">Although the contents of a catalog zone are interpreted and acted upon by
name servers, a catalog zone is a regular DNS zone and must adhere to the
standards for DNS zones.</t>
      <t indent="0" pn="section-3-5">A catalog zone is primarily intended for the management of a farm of authoritative name servers and should not be expected to be accessible from any recursive name server.</t>
    </section>
    <section anchor="catalog-zone-structure" numbered="true" removeInRFC="false" toc="include" pn="section-4">
      <name slugifiedName="name-catalog-zone-structure">Catalog Zone Structure</name>
      <t indent="0" pn="section-4-1">A catalog zone <bcp14>MUST</bcp14> follow the usual rules for DNS zones.
In particular, SOA and NS record sets <bcp14>MUST</bcp14> be present and adhere to standard requirements (such as <xref target="RFC1982" format="default" sectionFormat="of" derivedContent="RFC1982"/>).</t>
      <t indent="0" pn="section-4-2">Although catalog zones are not intended to be queried via recursive resolution (see <xref target="security" format="default" sectionFormat="of" derivedContent="Section 7"/>), at least one NS RR is still required so that a catalog zone is a syntactically correct DNS zone.
A single NS RR with a NSDNAME field containing the absolute name "invalid." is <bcp14>RECOMMENDED</bcp14> <xref target="RFC2606" format="default" sectionFormat="of" derivedContent="RFC2606"/> <xref target="RFC6761" format="default" sectionFormat="of" derivedContent="RFC6761"/>.</t>
      <section anchor="listofmemberzones" numbered="true" removeInRFC="false" toc="include" pn="section-4.1">
        <name slugifiedName="name-member-zones">Member Zones</name>
        <t indent="0" pn="section-4.1-1">The list of member zones is specified as a collection of member nodes represented by domain names under the owner name "zones" where "zones" is a direct child domain of the catalog zone.</t>
        <t indent="0" pn="section-4.1-2">The names of member zones are represented on the RDATA side of a PTR record (instead of being represented as a part of owner names) so that all valid domain names may be represented regardless of their length <xref target="RFC1035" format="default" sectionFormat="of" derivedContent="RFC1035"/>.
This PTR record <bcp14>MUST</bcp14> be the only record in the PTR RRset with the same name.
The presence of more than one record in the RRset indicates a broken catalog zone that <bcp14>MUST NOT</bcp14> be processed (see <xref target="generalrequirements" format="default" sectionFormat="of" derivedContent="Section 5.1"/>).</t>
        <t indent="0" pn="section-4.1-3">For example, if a catalog zone lists three zones ("example.com.",
"example.net.", and "example.org."), the member node RRs would appear as follows:</t>
        <sourcecode type="dns-rr" markers="false" pn="section-4.1-4">
&lt;unique-1&gt;.zones.$CATZ 0 IN PTR example.com.
&lt;unique-2&gt;.zones.$CATZ 0 IN PTR example.net.
&lt;unique-3&gt;.zones.$CATZ 0 IN PTR example.org.
</sourcecode>
        <t indent="0" pn="section-4.1-5">where <tt>&lt;unique-N&gt;</tt> is a label that tags each record in the collection and has a unique value.
When different <tt>&lt;unique-N&gt;</tt> labels hold the same PTR value (i.e., point to the same member zone), the catalog zone is broken and <bcp14>MUST NOT</bcp14> be processed (see <xref target="generalrequirements" format="default" sectionFormat="of" derivedContent="Section 5.1"/>).</t>
        <t indent="0" pn="section-4.1-6">Member node labels carry no informational meaning beyond labeling member zones.
A changed label may indicate that the state for a zone needs to be reset (see <xref target="zonereset" format="default" sectionFormat="of" derivedContent="Section 5.6"/>).</t>
        <t indent="0" pn="section-4.1-7">Having the zones uniquely tagged with the <tt>&lt;unique-N&gt;</tt> label ensures that additional RRs can be added below the member node (see <xref target="properties" format="default" sectionFormat="of" derivedContent="Section 4.2"/>).</t>
        <t indent="0" pn="section-4.1-8">The CLASS field of every RR in a catalog zone <bcp14>MUST</bcp14> be IN (1).
The TTL field's value has no meaning in this context and <bcp14>SHOULD</bcp14> be ignored.</t>
      </section>
      <section anchor="properties" numbered="true" removeInRFC="false" toc="include" pn="section-4.2">
        <name slugifiedName="name-properties">Properties</name>
        <t indent="0" pn="section-4.2-1">Catalog zone information is stored in the form of "properties".</t>
        <t indent="0" pn="section-4.2-2">Properties are identified by their name, which is used as an owner name prefix for one or more record sets underneath a member node (or underneath the catalog zone apex), with RR type(s) as appropriate for the respective property.</t>
        <t indent="0" pn="section-4.2-3">Known properties that have the correct RR type but are for some reason
invalid (for example, because of an impossible value or because of an illegal
number of RRs in the RRset) denote a broken catalog zone, which <bcp14>MUST NOT</bcp14> be
processed (see <xref target="generalrequirements" format="default" sectionFormat="of" derivedContent="Section 5.1"/>).</t>
        <t indent="0" pn="section-4.2-4">This document includes a set of initial properties that can be extended via the IANA registry defined and created in <xref target="iana" format="default" sectionFormat="of" derivedContent="Section 8"/>.
Some properties are defined at the global level; others are scoped to apply only to a specific member zone.
This document defines a mandatory global property in <xref target="version" format="default" sectionFormat="of" derivedContent="Section 4.2.1"/>.
The "zones" label from <xref target="listofmemberzones" format="default" sectionFormat="of" derivedContent="Section 4.1"/> can also be seen as a global property and is listed as such in the IANA registry in <xref target="iana" format="default" sectionFormat="of" derivedContent="Section 8"/>.
Member-specific properties are described in <xref target="memberproperties" format="default" sectionFormat="of" derivedContent="Section 4.3"/>.</t>
        <t indent="0" pn="section-4.2-5">Implementers may store additional information in the catalog zone with custom properties; see <xref target="customproperties" format="default" sectionFormat="of" derivedContent="Section 4.4"/>.
The meaning of such custom properties is determined by the implementation in question.</t>
        <section anchor="version" numbered="true" removeInRFC="false" toc="include" pn="section-4.2.1">
          <name slugifiedName="name-schema-version-version-prop">Schema Version (<tt>version</tt> property)</name>
          <t indent="0" pn="section-4.2.1-1">The catalog zone schema version is specified by an integer value embedded in a TXT RR named <tt>version.$CATZ</tt>.
All catalog zones <bcp14>MUST</bcp14> have a TXT RRset named <tt>version.$CATZ</tt> with exactly one RR.</t>
          <t indent="0" pn="section-4.2.1-2">Catalog consumers <bcp14>MUST NOT</bcp14> apply catalog zone processing to:</t>
          <ul bare="false" empty="false" indent="3" spacing="normal" pn="section-4.2.1-3">
            <li pn="section-4.2.1-3.1">zones without the <tt>version</tt> property</li>
            <li pn="section-4.2.1-3.2">zones with a <tt>version</tt> property with more than one RR in the RRset</li>
            <li pn="section-4.2.1-3.3">zones with a <tt>version</tt> property without an expected value in the
<tt>version.$CATZ</tt> TXT RR</li>
            <li pn="section-4.2.1-3.4">zones with a <tt>version</tt> property with a schema version value that is not implemented by the consumer (e.g., version "1")</li>
          </ul>
          <t indent="0" pn="section-4.2.1-4">These conditions signify a broken catalog zone, which <bcp14>MUST NOT</bcp14> be processed (see
<xref target="generalrequirements" format="default" sectionFormat="of" derivedContent="Section 5.1"/>).</t>
          <t indent="0" pn="section-4.2.1-5">For this memo, the value of the <tt>version.$CATZ</tt> TXT RR <bcp14>MUST</bcp14> be set to "2"; that is:</t>
          <sourcecode type="dns-rr" markers="false" pn="section-4.2.1-6">version.$CATZ 0 IN TXT "2"
</sourcecode>
          <t indent="0" pn="section-4.2.1-7">Note that Version 1 was used in an earlier draft version of this memo and reflected
the implementation first found in BIND 9.11.</t>
        </section>
      </section>
      <section anchor="memberproperties" numbered="true" removeInRFC="false" toc="include" pn="section-4.3">
        <name slugifiedName="name-member-zone-properties">Member Zone Properties</name>
        <t indent="0" pn="section-4.3-1">Each member zone <bcp14>MAY</bcp14> have one or more additional properties that are  described in this section.
The member properties described in this document are all optional, and implementations <bcp14>MAY</bcp14> choose to implement all, some, or none of them.
Member zone properties are represented by RRsets below the corresponding member node.</t>
        <section anchor="cooproperty" numbered="true" removeInRFC="false" toc="include" pn="section-4.3.1">
          <name slugifiedName="name-change-of-ownership-coo-pro">Change of Ownership (<tt>coo</tt> property)</name>
          <t indent="0" pn="section-4.3.1-1">The <tt>coo</tt> property facilitates controlled migration of a member zone from one catalog to another.</t>
          <t indent="0" pn="section-4.3.1-2">A Change Of Ownership is signaled by the <tt>coo</tt> property in the catalog zone currently "owning" the zone.
The name of the new catalog is the value of a PTR record in the relevant <tt>coo</tt> property in the old catalog.
For example, if member "example.com." migrates from catalog zone <tt>$OLDCATZ</tt> to catalog zone <tt>$NEWCATZ</tt>, this will appear in the <tt>$OLDCATZ</tt> catalog zone as follows:</t>
          <sourcecode type="dns-rr" markers="false" pn="section-4.3.1-3">
&lt;unique-N&gt;.zones.$OLDCATZ 0 IN PTR example.com.
coo.&lt;unique-N&gt;.zones.$OLDCATZ 0 IN PTR $NEWCATZ
</sourcecode>
          <t indent="0" pn="section-4.3.1-4">The PTR RRset <bcp14>MUST</bcp14> consist of a single PTR record.
The presence of more than one record in the RRset indicates a broken catalog zone, which <bcp14>MUST NOT</bcp14> be processed (see <xref target="generalrequirements" format="default" sectionFormat="of" derivedContent="Section 5.1"/>).</t>
          <t indent="0" pn="section-4.3.1-5">When a consumer of a catalog zone <tt>$OLDCATZ</tt> receives an update that adds or changes a <tt>coo</tt> property for a member zone in <tt>$OLDCATZ</tt>, it does <em>not</em> migrate the member zone immediately.

The migration has to wait for an update of <tt>$NEWCATZ</tt> in which the member zone is present. 
Before the actual migration, the consumer <bcp14>MUST</bcp14> verify that the <tt>coo</tt> property pointing to <tt>$NEWCATZ</tt> is still present in <tt>$OLDCATZ</tt>.</t>
          <t indent="0" pn="section-4.3.1-6">Unless the member node label (i.e., <tt>&lt;unique-N&gt;</tt>) for the member is the same in <tt>$NEWCATZ</tt>, all its associated state for a just migrated zone <bcp14>MUST</bcp14> be reset (see <xref target="zonereset" format="default" sectionFormat="of" derivedContent="Section 5.6"/>).
Note that the owner of <tt>$OLDCATZ</tt> allows for the zone-associated state to be taken over by the owner of <tt>$NEWCATZ</tt> by default.
To prevent the takeover of the zone-associated state, the owner of <tt>$OLDCATZ</tt> must remove this state by updating the associated properties or by performing a zone state reset (see <xref target="zonereset" format="default" sectionFormat="of" derivedContent="Section 5.6"/>) before or simultaneous with adding the <tt>coo</tt> property (see <xref target="security" format="default" sectionFormat="of" derivedContent="Section 7"/>).</t>
          <t indent="0" pn="section-4.3.1-7">The old owner may remove the member zone containing the <tt>coo</tt> property from <tt>$OLDCATZ</tt> once it has been established that all its consumers have processed the Change of Ownership.</t>
        </section>
        <section anchor="groups-group-property" numbered="true" removeInRFC="false" toc="include" pn="section-4.3.2">
          <name slugifiedName="name-groups-group-property">Groups (<tt>group</tt> property)</name>
          <t indent="0" pn="section-4.3.2-1">With a <tt>group</tt> property, a consumer(s) can be signaled to treat some member zones within the catalog zone differently.</t>
          <t indent="0" pn="section-4.3.2-2">The consumer <bcp14>MAY</bcp14> apply different configuration options when processing member zones, based on the value of the <tt>group</tt> property.
A <tt>group</tt> property value is stored as the entire RDATA of a TXT record directly below the member node.
The exact handling of the <tt>group</tt> property value is left to the consumer's implementation and configuration.</t>
          <t indent="0" pn="section-4.3.2-3">The producer <bcp14>MAY</bcp14> assign a <tt>group</tt> property to all, some, or none of the member zones within a catalog zone.
The producer <bcp14>MAY</bcp14> assign more than one <tt>group</tt> property to one member zone. This will make it possible to transfer group information for different consumer operators in a single catalog zone.
Implementations <bcp14>MAY</bcp14> facilitate mapping of a specific <tt>group</tt> value to a specific configuration configurable <em>on a per catalog zone basis</em> to allow for producers that publish their catalog zone at multiple consumer operators.
Consumer operators <bcp14>SHOULD</bcp14> namespace their <tt>group</tt> values to reduce the risk of having to resolve clashes.</t>
          <t indent="0" pn="section-4.3.2-4">The consumer <bcp14>MUST</bcp14> ignore <tt>group</tt> values it does not understand.
When a consumer encounters multiple <tt>group</tt> values for a single member zone, it <bcp14>MAY</bcp14> choose to process all, some, or none of them. This is left to the implementation.</t>
          <section anchor="example" numbered="true" removeInRFC="false" toc="exclude" pn="section-4.3.2.1">
            <name slugifiedName="name-example">Example</name>
            <t indent="0" pn="section-4.3.2.1-1"><tt>group</tt> properties are represented by TXT RRs. The record content
has no pre-defined meaning. Their interpretation is purely a matter
of agreement between the producer and the consumer(s) of the catalog.</t>
            <t indent="0" pn="section-4.3.2.1-2">For example, the "foo" group could be agreed to indicate that a zone not
be signed with DNSSEC. Conversely, an agreement could define that group names
starting with "operator-" indicate in which way a given DNS operator should set
up certain aspects of the member zone's DNSSEC configuration.</t>
            <t indent="0" pn="section-4.3.2.1-3">Assuming that the catalog producer and consumer(s) have established such
agreements, consider the following catalog zone (snippet) that signals to a
consumer(s) how to treat DNSSEC for the zones "example.net." and "example.com.":</t>
            <sourcecode type="dns-rr" markers="false" pn="section-4.3.2.1-4">
&lt;unique-1&gt;.zones.$CATZ        0 IN PTR    example.com.
group.&lt;unique-1&gt;.zones.$CATZ  0 IN TXT    "foo"
&lt;unique-2&gt;.zones.$CATZ        0 IN PTR    example.net.
group.&lt;unique-2&gt;.zones.$CATZ  0 IN TXT    "operator-x-foo"
group.&lt;unique-2&gt;.zones.$CATZ  0 IN TXT    "operator-y" "bar"
</sourcecode>
            <t indent="0" pn="section-4.3.2.1-5">In this scenario, a consumer(s) shall, by agreement, not sign the member zone "example.com." with DNSSEC.
For "example.net.", the consumers, at two different operators, will configure
the member zone to be signed with a specific combination of settings. 
The <tt>group</tt> value designated to indicate this combination of settings is prearranged with each operator ("operator-x-foo" vs. "operator-y" "bar").</t>
          </section>
        </section>
      </section>
      <section anchor="customproperties" numbered="true" removeInRFC="false" toc="include" pn="section-4.4">
        <name slugifiedName="name-custom-properties-ext-prope">Custom Properties (<tt>*.ext</tt> properties)</name>
        <t indent="0" pn="section-4.4-1">Implementations and operators of catalog zones may choose to provide their own properties.
Custom properties can occur globally or for a specific member zone.
To prevent a name clash with future properties, such properties <bcp14>MUST</bcp14> be represented below the label "ext".</t>
        <t indent="0" pn="section-4.4-2">"ext" is not a placeholder. A custom property is named as follows:</t>
        <sourcecode type="dns-rr" markers="false" pn="section-4.4-3">
; a global custom property:
&lt;property-prefix&gt;.ext.$CATZ

; a member zone custom property:
&lt;property-prefix&gt;.ext.&lt;unique-N&gt;.zones.$CATZ
</sourcecode>
        <t indent="0" pn="section-4.4-4"><tt>&lt;property-prefix&gt;</tt> may consist of one or more labels.</t>
        <t indent="0" pn="section-4.4-5">Implementations <bcp14>SHOULD</bcp14> namespace their custom properties to limit risk of clashes with other implementations of catalog zones.
This can be achieved by using two labels as the <tt>&lt;property-prefix&gt;</tt> so that the
name of the implementation is included in the prefix: <tt>&lt;some-setting&gt;.&lt;implementation-name&gt;.ext.$CATZ</tt>.</t>
        <t indent="0" pn="section-4.4-6">Implementations <bcp14>MAY</bcp14> use such properties on the member zone level to store additional information about member zones
(e.g., to flag them for specific treatment).</t>
        <t indent="0" pn="section-4.4-7">Further, implementations <bcp14>MAY</bcp14> use custom properties on the global level to store additional information about the catalog zone itself.
While there may be many use cases for this, a plausible one is to store default values for custom properties on the global level,
then override them using a property of the same name on the member level (= under the <tt>ext</tt> label of the member node) if so desired.
A property agreement between producer and consumer should clearly define what semantics apply and whether a property is global, member, or both.</t>
        <t indent="0" pn="section-4.4-8">The meaning of the custom properties described in this section is determined by the implementation alone without expectation of interoperability.</t>
      </section>
    </section>
    <section anchor="behavior" numbered="true" removeInRFC="false" toc="include" pn="section-5">
      <name slugifiedName="name-name-server-behavior">Name Server Behavior</name>
      <section anchor="generalrequirements" numbered="true" removeInRFC="false" toc="include" pn="section-5.1">
        <name slugifiedName="name-general-requirements">General Requirements</name>
        <t indent="0" pn="section-5.1-1">As it is a regular DNS zone, a catalog zone can be transferred using DNS zone
transfers among name servers.</t>
        <t indent="0" pn="section-5.1-2">Catalog updates should be automatic; i.e., when a name server that supports
catalog zones completes a zone transfer for a catalog zone, it <bcp14>SHOULD</bcp14> apply
changes to the catalog within the running name server automatically without any
manual intervention.</t>
        <t indent="0" pn="section-5.1-3">Name servers <bcp14>MAY</bcp14> allow loading and transfer of broken zones with incorrect
catalog zone syntax (as they are treated as regular zones).
The reason a catalog zone is considered broken <bcp14>SHOULD</bcp14> be communicated clearly to the operator (e.g., through a log message).</t>
        <t indent="0" pn="section-5.1-4">When a previously correct catalog zone becomes a broken catalog zone, it loses its catalog
meaning because                 
of an update through an incremental transfer or otherwise.
No special processing occurs. Member zones previously configured by this catalog
<bcp14>MUST NOT</bcp14> be removed or reconfigured in any way.</t>
        <t indent="0" pn="section-5.1-5">If a name server restarts with a broken catalog zone, the broken catalog <bcp14>SHOULD NOT</bcp14> prevent the name server from starting up and serving the member zones in
the last valid version of the catalog zone.</t>
        <t indent="0" pn="section-5.1-6">Processing of a broken catalog <bcp14>SHALL</bcp14> start (or resume) when the catalog turns
into a correct catalog zone, e.g., by an additional update (through zone
transfer or updates) fixing the catalog zone.</t>
        <t indent="0" pn="section-5.1-7">Similarly, when a catalog zone expires, it loses its catalog meaning and
<bcp14>MUST</bcp14> no longer be processed as such.
No special processing occurs until the zone becomes fresh again.</t>
      </section>
      <section anchor="nameclash" numbered="true" removeInRFC="false" toc="include" pn="section-5.2">
        <name slugifiedName="name-member-zone-name-clash">Member Zone Name Clash</name>
        <t indent="0" pn="section-5.2-1">If there is a clash between an existing zone's name (from either an existing member zone or an otherwise configured zone) and an incoming
member zone's name (via transfer or update), the new instance of the zone <bcp14>MUST</bcp14>
be ignored and an error <bcp14>SHOULD</bcp14> be logged.</t>
        <t indent="0" pn="section-5.2-2">A clash between an existing member zone's name and an incoming member zone's name (via transfer or update) may be an attempt to migrate a zone to a different catalog, but it should not be treated as one except as described in <xref target="cooproperty" format="default" sectionFormat="of" derivedContent="Section 4.3.1"/>.</t>
      </section>
      <section anchor="zoneremoval" numbered="true" removeInRFC="false" toc="include" pn="section-5.3">
        <name slugifiedName="name-member-zone-removal">Member Zone Removal</name>
        <t indent="0" pn="section-5.3-1">When a member zone is removed from a specific catalog zone, a consumer <bcp14>MUST NOT</bcp14> remove the zone and associated state data if the zone was not configured from that specific catalog zone.
The zone and associated state (such as zone data and DNSSEC keys) <bcp14>MUST</bcp14> be removed from the consumer when and only when the zone was configured initially from the same catalog.
Consumer operators may consider temporarily archiving associated state to facilitate mistake recovery.</t>
      </section>
      <section anchor="namechange" numbered="true" removeInRFC="false" toc="include" pn="section-5.4">
        <name slugifiedName="name-member-node-name-change">Member Node Name
     Change</name>
        <t indent="0" pn="section-5.4-1">When the member node's label value (<tt>&lt;unique-N&gt;</tt>) changes via a single update or transfer, catalog consumers <bcp14>MUST</bcp14> process this as a member zone removal, including the removal of all the zone's associated state (as described in <xref target="zoneremoval" format="default" sectionFormat="of" derivedContent="Section 5.3"/>), and then immediately process the member as a newly added zone to be configured in the same catalog.
</t>
      </section>
      <section anchor="zonemigration" numbered="true" removeInRFC="false" toc="include" pn="section-5.5">
        <name slugifiedName="name-migrating-member-zones-betw">Migrating Member Zones between Catalogs</name>
        <t indent="0" pn="section-5.5-1">If all consumers of the catalog zones involved support the <tt>coo</tt> property, it is <bcp14>RECOMMENDED</bcp14> to perform migration of a member zone by following the procedure described in <xref target="cooproperty" format="default" sectionFormat="of" derivedContent="Section 4.3.1"/>. Otherwise, the migration of a member zone from a catalog zone <tt>$OLDCATZ</tt> to a catalog zone <tt>$NEWCATZ</tt> has to be done by first removing the member zone from <tt>$OLDCATZ</tt> and then adding the member zone to <tt>$NEWCATZ</tt>.</t>
        <t indent="0" pn="section-5.5-2">If in the process of a migration some consumers of the involved catalog zones did not catch the removal of the member zone from <tt>$OLDCATZ</tt> yet (because of a lost packet or downtime or otherwise) but already saw the update of <tt>$NEWCATZ</tt> containing the addition of that member zone, they may consider this update to be a name clash (see <xref target="nameclash" format="default" sectionFormat="of" derivedContent="Section 5.2"/>) and, as a consequence, the member is not migrated to <tt>$NEWCATZ</tt>.
This possibility needs to be anticipated with a member zone migration.
Recovery from such a situation is out of the scope of this document.
For example, it may entail a manually forced retransfer of <tt>$NEWCATZ</tt> to consumers after they have been detected to have received and processed the removal of the member zone from <tt>$OLDCATZ</tt>.</t>
      </section>
      <section anchor="zonereset" numbered="true" removeInRFC="false" toc="include" pn="section-5.6">
        <name slugifiedName="name-zone-associated-state-reset">Zone-Associated State Reset</name>
        <t indent="0" pn="section-5.6-1">It may be desirable to reset state (such as zone data and DNSSEC keys) associated with a member zone.</t>
        <t indent="0" pn="section-5.6-2">A zone state reset may be performed by a change of the member node's name (see <xref target="namechange" format="default" sectionFormat="of" derivedContent="Section 5.4"/>).</t>
      </section>
    </section>
    <section anchor="implementationnotes" numbered="true" removeInRFC="false" toc="include" pn="section-6">
      <name slugifiedName="name-implementation-and-operatio">Implementation and Operational Notes</name>
      <t indent="0" pn="section-6-1">Although any valid domain name can be used for the catalog name $CATZ, a catalog producer <bcp14>MUST NOT</bcp14> use names that are not under the control of the catalog producer (with the exception of reserved names). 
It is
<bcp14>RECOMMENDED</bcp14> to use either a domain name owned by the catalog producer or a domain name under a suitable name such as "invalid." <xref target="RFC6761" format="default" sectionFormat="of" derivedContent="RFC6761"/>.</t>
      <t indent="0" pn="section-6-2">Catalog zones on secondary name servers would have to be set up manually, perhaps
as static configuration, similar to how ordinary DNS zones are configured when catalog zones or another automatic configuration mechanism are not in place.
Additionally, the secondary needs to be configured as a catalog consumer for the catalog zone to enable processing of the member zones in the catalog, such as automatic synchronization of the member zones for secondary service.</t>
      <t indent="0" pn="section-6-3">Operators of catalog consumers should note that secondary name servers may
receive DNS NOTIFY messages <xref target="RFC1996" format="default" sectionFormat="of" derivedContent="RFC1996"/> for zones before they are seen as
newly added member zones to the catalog from which that secondary is
provisioned.</t>
      <t indent="0" pn="section-6-4">Although they are regular DNS zones, catalog zones only contain information for
the management of a set of authoritative name servers.  To prevent unintended
exposure to other parties, operators <bcp14>SHOULD</bcp14> limit the systems able to query these zones.</t>
      <t indent="0" pn="section-6-5">Querying/serving catalog zone contents may be inconvenient via DNS
due to the nature of their representation.
Therefore, an administrator may want to use a different method for
looking at data inside the catalog zone.  Typical
queries might include dumping the list of member zones, dumping a member zone's
effective configuration, querying a specific property value of a member zone,
etc.  Because of the structure of catalog zones, it may not be possible to
perform these queries intuitively, or in some cases at all, using DNS QUERY.
For example, it is not possible to enumerate the contents of a multivalued
property (such as the list of member zones) with a single QUERY.
Implementations are therefore advised to provide a tool that uses either the
output of AXFR or an out-of-band method to perform queries on catalog zones.</t>
      <t indent="0" pn="section-6-6">Great power comes with great responsibility. Catalog zones simplify zone
provisioning by orchestrating zones on secondary name servers from a single
data source: the catalog.  Hence, the catalog producer has great power and
changes must be treated carefully. For example, if the catalog is generated by
some script and this script generates an empty catalog,
millions of member zones may get deleted from their secondaries within seconds,
and all the affected domains may be offline in a blink of an eye.</t>
    </section>
    <section anchor="security" numbered="true" removeInRFC="false" toc="include" pn="section-7">
      <name slugifiedName="name-security-considerations">Security Considerations</name>
      <t indent="0" pn="section-7-1">As catalog zones are transmitted using DNS zone transfers,
it is <bcp14>RECOMMENDED</bcp14> that catalog zone transfers be protected from unexpected modifications by way of authentication, e.g., by using a Transaction Signature (TSIG) <xref target="RFC8945" format="default" sectionFormat="of" derivedContent="RFC8945"/> or Strict or Mutual TLS authentication with DNS zone transfer over TLS or QUIC <xref target="RFC9103" format="default" sectionFormat="of" derivedContent="RFC9103"/>.</t>
      <t indent="0" pn="section-7-2">Use of DNS UPDATE <xref target="RFC2136" format="default" sectionFormat="of" derivedContent="RFC2136"/> to modify the content of catalog zones <bcp14>SHOULD</bcp14> similarly be authenticated.</t>
      <t indent="0" pn="section-7-3">Zone transfers of member zones <bcp14>SHOULD</bcp14> similarly be authenticated.
TSIG shared secrets used for member zones <bcp14>SHOULD NOT</bcp14> be mentioned in the catalog zone data.
However, key identifiers may be shared within catalog zones.</t>
      <t indent="0" pn="section-7-4">Catalog zones reveal the zones served by their consumers, including their properties.
To prevent unintentional exposure of catalog zone contents, it is <bcp14>RECOMMENDED</bcp14> to limit the systems able to query them and to conduct catalog zone transfers confidentially <xref target="RFC9103" format="default" sectionFormat="of" derivedContent="RFC9103"/>.</t>
      <t indent="0" pn="section-7-5">As with regular zones, primary and secondary name servers for a catalog zone may
be operated by different administrators.  The secondary name servers may be
configured as a catalog consumer to synchronize catalog zones from the primary, but the primary's
administrators may not have any administrative access to the secondaries.</t>
      <t indent="0" pn="section-7-6">Administrative control over what zones are served from the configured name servers shifts completely from the server operator (consumer) to the "owner" (producer) of the catalog zone content.
To prevent unintended provisioning of zones, a consumer(s) <bcp14>SHOULD</bcp14> scope the set of
admissible member zones by any means deemed suitable (such as statically via
regular expressions, or dynamically by verifying against another database
before accepting a member zone).</t>
      <t indent="0" pn="section-7-7">With migration of member zones between catalogs using the <tt>coo</tt> property, it is possible for the owner of the target catalog (i.e., <tt>$NEWCATZ</tt>) to take over all its associated state with the zone from the original owner (i.e., <tt>$OLDCATZ</tt>) by maintaining the same member node label (i.e., <tt>&lt;unique-N&gt;</tt>).
To prevent the takeover of the zone-associated state, the original owner has to enforce a zone state reset by changing the member node label (see <xref target="zonereset" format="default" sectionFormat="of" derivedContent="Section 5.6"/>) before or simultaneously with adding the <tt>coo</tt> property.</t>
    </section>
    <section anchor="iana" numbered="true" removeInRFC="false" toc="include" pn="section-8">
      <name slugifiedName="name-iana-considerations">IANA Considerations</name>
      <t indent="0" pn="section-8-1">IANA has created the "DNS Catalog Zones Properties" registry under the "Domain Name System (DNS) Parameters" registry as follows:</t>
      <dl indent="3" newline="false" spacing="normal" pn="section-8-2">
        <dt pn="section-8-2.1">Registry Name:</dt>
        <dd pn="section-8-2.2">DNS Catalog Zones Properties</dd>
        <dt pn="section-8-2.3">Assignment Policy:</dt>
        <dd pn="section-8-2.4">Expert Review, except for property prefixes ending in the label "ext", which are for Private Use <xref target="RFC8126" format="default" sectionFormat="of" derivedContent="RFC8126"/>.</dd>
        <dt pn="section-8-2.5">Reference:</dt>
        <dd pn="section-8-2.6">RFC 9432</dd>
        <dt pn="section-8-2.7">Note:</dt>
        <dd pn="section-8-2.8">This registry applies to Catalog Zones schema version "2" as specified in RFC 9432.</dd>
      </dl>
      <table align="center" pn="table-1">
        <name slugifiedName="name-dns-catalog-zones-propertie">DNS Catalog Zones Properties Registry</name>
        <thead>
          <tr>
            <th align="left" colspan="1" rowspan="1">Property Prefix</th>
            <th align="left" colspan="1" rowspan="1">Description</th>
            <th align="left" colspan="1" rowspan="1">Status</th>
            <th align="left" colspan="1" rowspan="1">Reference</th>
          </tr>
        </thead>
        <tbody>
          <tr>
            <td align="left" colspan="1" rowspan="1">zones</td>
            <td align="left" colspan="1" rowspan="1">List of member zones</td>
            <td align="left" colspan="1" rowspan="1">Standards Track</td>
            <td align="left" colspan="1" rowspan="1">RFC 9432</td>
          </tr>
          <tr>
            <td align="left" colspan="1" rowspan="1">version</td>
            <td align="left" colspan="1" rowspan="1">Schema version</td>
            <td align="left" colspan="1" rowspan="1">Standards Track</td>
            <td align="left" colspan="1" rowspan="1">RFC 9432</td>
          </tr>
          <tr>
            <td align="left" colspan="1" rowspan="1">coo</td>
            <td align="left" colspan="1" rowspan="1">Change of Ownership</td>
            <td align="left" colspan="1" rowspan="1">Standards Track</td>
            <td align="left" colspan="1" rowspan="1">RFC 9432</td>
          </tr>
          <tr>
            <td align="left" colspan="1" rowspan="1">group</td>
            <td align="left" colspan="1" rowspan="1">Group</td>
            <td align="left" colspan="1" rowspan="1">Standards Track</td>
            <td align="left" colspan="1" rowspan="1">RFC 9432</td>
          </tr>
          <tr>
            <td align="left" colspan="1" rowspan="1">*.ext</td>
            <td align="left" colspan="1" rowspan="1">Custom properties</td>
            <td align="left" colspan="1" rowspan="1">Private Use</td>
            <td align="left" colspan="1" rowspan="1">RFC 9432</td>
          </tr>
        </tbody>
      </table>
      <t indent="0" pn="section-8-4">The meanings of the fields are as follows:</t>
      <dl indent="3" newline="false" spacing="normal" pn="section-8-5">
        <dt pn="section-8-5.1">Property prefix:</dt>
        <dd pn="section-8-5.2">One or more domain name labels.</dd>
        <dt pn="section-8-5.3">Description:</dt>
        <dd pn="section-8-5.4">A human-readable short description or name for the property.</dd>
        <dt pn="section-8-5.5">Status:</dt>
        <dd pn="section-8-5.6">IETF Stream RFC status or "External" if not documented in an IETF Stream RFC.</dd>
        <dt pn="section-8-5.7">Reference:</dt>
        <dd pn="section-8-5.8">A stable reference to the document in which this property is defined.</dd>
      </dl>
    </section>
  </middle>
  <back>
    <references pn="section-9">
      <name slugifiedName="name-references">References</name>
      <references pn="section-9.1">
        <name slugifiedName="name-normative-references">Normative References</name>
        <reference anchor="RFC1035" target="https://www.rfc-editor.org/info/rfc1035" quoteTitle="true" derivedAnchor="RFC1035">
          <front>
            <title>Domain names - implementation and specification</title>
            <author fullname="P. Mockapetris" initials="P." surname="Mockapetris"/>
            <date month="November" year="1987"/>
            <abstract>
              <t indent="0">This RFC is the revised specification of the protocol and format used in the implementation of the Domain Name System. It obsoletes RFC-883. This memo documents the details of the domain name client - server communication.</t>
            </abstract>
          </front>
          <seriesInfo name="STD" value="13"/>
          <seriesInfo name="RFC" value="1035"/>
          <seriesInfo name="DOI" value="10.17487/RFC1035"/>
        </reference>
        <reference anchor="RFC1982" target="https://www.rfc-editor.org/info/rfc1982" quoteTitle="true" derivedAnchor="RFC1982">
          <front>
            <title>Serial Number Arithmetic</title>
            <author fullname="R. Elz" initials="R." surname="Elz"/>
            <author fullname="R. Bush" initials="R." surname="Bush"/>
            <date month="August" year="1996"/>
            <abstract>
              <t indent="0">The DNS has long relied upon serial number arithmetic, a concept which has never really been defined, certainly not in an IETF document, though which has been widely understood. This memo supplies the missing definition. It is intended to update RFC1034 and RFC1035. [STANDARDS-TRACK]</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="1982"/>
          <seriesInfo name="DOI" value="10.17487/RFC1982"/>
        </reference>
        <reference anchor="RFC1996" target="https://www.rfc-editor.org/info/rfc1996" quoteTitle="true" derivedAnchor="RFC1996">
          <front>
            <title>A Mechanism for Prompt Notification of Zone Changes (DNS NOTIFY)</title>
            <author fullname="P. Vixie" initials="P." surname="Vixie"/>
            <date month="August" year="1996"/>
            <abstract>
              <t indent="0">This memo describes the NOTIFY opcode for DNS, by which a master server advises a set of slave servers that the master's data has been changed and that a query should be initiated to discover the new data. [STANDARDS-TRACK]</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="1996"/>
          <seriesInfo name="DOI" value="10.17487/RFC1996"/>
        </reference>
        <reference anchor="RFC2119" target="https://www.rfc-editor.org/info/rfc2119" quoteTitle="true" derivedAnchor="RFC2119">
          <front>
            <title>Key words for use in RFCs to Indicate Requirement Levels</title>
            <author fullname="S. Bradner" initials="S." surname="Bradner"/>
            <date month="March" year="1997"/>
            <abstract>
              <t indent="0">In many standards track documents several words are used to signify the requirements in the specification. These words are often capitalized. This document defines these words as they should be interpreted in IETF documents. This document specifies an Internet Best Current Practices for the Internet Community, and requests discussion and suggestions for improvements.</t>
            </abstract>
          </front>
          <seriesInfo name="BCP" value="14"/>
          <seriesInfo name="RFC" value="2119"/>
          <seriesInfo name="DOI" value="10.17487/RFC2119"/>
        </reference>
        <reference anchor="RFC2136" target="https://www.rfc-editor.org/info/rfc2136" quoteTitle="true" derivedAnchor="RFC2136">
          <front>
            <title>Dynamic Updates in the Domain Name System (DNS UPDATE)</title>
            <author fullname="P. Vixie" initials="P." role="editor" surname="Vixie"/>
            <author fullname="S. Thomson" initials="S." surname="Thomson"/>
            <author fullname="Y. Rekhter" initials="Y." surname="Rekhter"/>
            <author fullname="J. Bound" initials="J." surname="Bound"/>
            <date month="April" year="1997"/>
            <abstract>
              <t indent="0">Using this specification of the UPDATE opcode, it is possible to add or delete RRs or RRsets from a specified zone. Prerequisites are specified separately from update operations, and can specify a dependency upon either the previous existence or nonexistence of an RRset, or the existence of a single RR. [STANDARDS-TRACK]</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="2136"/>
          <seriesInfo name="DOI" value="10.17487/RFC2136"/>
        </reference>
        <reference anchor="RFC2606" target="https://www.rfc-editor.org/info/rfc2606" quoteTitle="true" derivedAnchor="RFC2606">
          <front>
            <title>Reserved Top Level DNS Names</title>
            <author fullname="D. Eastlake 3rd" initials="D." surname="Eastlake 3rd"/>
            <author fullname="A. Panitz" initials="A." surname="Panitz"/>
            <date month="June" year="1999"/>
            <abstract>
              <t indent="0">To reduce the likelihood of conflict and confusion, a few top level domain names are reserved for use in private testing, as examples in documentation, and the like. In addition, a few second level domain names reserved for use as examples are documented. This document specifies an Internet Best Current Practices for the Internet Community, and requests discussion and suggestions for improvements.</t>
            </abstract>
          </front>
          <seriesInfo name="BCP" value="32"/>
          <seriesInfo name="RFC" value="2606"/>
          <seriesInfo name="DOI" value="10.17487/RFC2606"/>
        </reference>
        <reference anchor="RFC6761" target="https://www.rfc-editor.org/info/rfc6761" quoteTitle="true" derivedAnchor="RFC6761">
          <front>
            <title>Special-Use Domain Names</title>
            <author fullname="S. Cheshire" initials="S." surname="Cheshire"/>
            <author fullname="M. Krochmal" initials="M." surname="Krochmal"/>
            <date month="February" year="2013"/>
            <abstract>
              <t indent="0">This document describes what it means to say that a Domain Name (DNS name) is reserved for special use, when reserving such a name is appropriate, and the procedure for doing so. It establishes an IANA registry for such domain names, and seeds it with entries for some of the already established special domain names.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="6761"/>
          <seriesInfo name="DOI" value="10.17487/RFC6761"/>
        </reference>
        <reference anchor="RFC8174" target="https://www.rfc-editor.org/info/rfc8174" quoteTitle="true" derivedAnchor="RFC8174">
          <front>
            <title>Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words</title>
            <author fullname="B. Leiba" initials="B." surname="Leiba"/>
            <date month="May" year="2017"/>
            <abstract>
              <t indent="0">RFC 2119 specifies common key words that may be used in protocol specifications. This document aims to reduce the ambiguity by clarifying that only UPPERCASE usage of the key words have the defined special meanings.</t>
            </abstract>
          </front>
          <seriesInfo name="BCP" value="14"/>
          <seriesInfo name="RFC" value="8174"/>
          <seriesInfo name="DOI" value="10.17487/RFC8174"/>
        </reference>
        <reference anchor="RFC8499" target="https://www.rfc-editor.org/info/rfc8499" quoteTitle="true" derivedAnchor="RFC8499">
          <front>
            <title>DNS Terminology</title>
            <author fullname="P. Hoffman" initials="P." surname="Hoffman"/>
            <author fullname="A. Sullivan" initials="A." surname="Sullivan"/>
            <author fullname="K. Fujiwara" initials="K." surname="Fujiwara"/>
            <date month="January" year="2019"/>
            <abstract>
              <t indent="0">The Domain Name System (DNS) is defined in literally dozens of different RFCs. The terminology used by implementers and developers of DNS protocols, and by operators of DNS systems, has sometimes changed in the decades since the DNS was first defined. This document gives current definitions for many of the terms used in the DNS in a single document.</t>
              <t indent="0">This document obsoletes RFC 7719 and updates RFC 2308.</t>
            </abstract>
          </front>
          <seriesInfo name="BCP" value="219"/>
          <seriesInfo name="RFC" value="8499"/>
          <seriesInfo name="DOI" value="10.17487/RFC8499"/>
        </reference>
        <reference anchor="RFC8945" target="https://www.rfc-editor.org/info/rfc8945" quoteTitle="true" derivedAnchor="RFC8945">
          <front>
            <title>Secret Key Transaction Authentication for DNS (TSIG)</title>
            <author fullname="F. Dupont" initials="F." surname="Dupont"/>
            <author fullname="S. Morris" initials="S." surname="Morris"/>
            <author fullname="P. Vixie" initials="P." surname="Vixie"/>
            <author fullname="D. Eastlake 3rd" initials="D." surname="Eastlake 3rd"/>
            <author fullname="O. Gudmundsson" initials="O." surname="Gudmundsson"/>
            <author fullname="B. Wellington" initials="B." surname="Wellington"/>
            <date month="November" year="2020"/>
            <abstract>
              <t indent="0">This document describes a protocol for transaction-level authentication using shared secrets and one-way hashing. It can be used to authenticate dynamic updates to a DNS zone as coming from an approved client or to authenticate responses as coming from an approved name server.</t>
              <t indent="0">No recommendation is made here for distributing the shared secrets; it is expected that a network administrator will statically configure name servers and clients using some out-of-band mechanism.</t>
              <t indent="0">This document obsoletes RFCs 2845 and 4635.</t>
            </abstract>
          </front>
          <seriesInfo name="STD" value="93"/>
          <seriesInfo name="RFC" value="8945"/>
          <seriesInfo name="DOI" value="10.17487/RFC8945"/>
        </reference>
        <reference anchor="RFC9103" target="https://www.rfc-editor.org/info/rfc9103" quoteTitle="true" derivedAnchor="RFC9103">
          <front>
            <title>DNS Zone Transfer over TLS</title>
            <author fullname="W. Toorop" initials="W." surname="Toorop"/>
            <author fullname="S. Dickinson" initials="S." surname="Dickinson"/>
            <author fullname="S. Sahib" initials="S." surname="Sahib"/>
            <author fullname="P. Aras" initials="P." surname="Aras"/>
            <author fullname="A. Mankin" initials="A." surname="Mankin"/>
            <date month="August" year="2021"/>
            <abstract>
              <t indent="0">DNS zone transfers are transmitted in cleartext, which gives attackers the opportunity to collect the content of a zone by eavesdropping on network connections. The DNS Transaction Signature (TSIG) mechanism is specified to restrict direct zone transfer to authorized clients only, but it does not add confidentiality. This document specifies the use of TLS, rather than cleartext, to prevent zone content collection via passive monitoring of zone transfers: XFR over TLS (XoT). Additionally, this specification updates RFC 1995 and RFC 5936 with respect to efficient use of TCP connections and RFC 7766 with respect to the recommended number of connections between a client and server for each transport.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="9103"/>
          <seriesInfo name="DOI" value="10.17487/RFC9103"/>
        </reference>
      </references>
      <references pn="section-9.2">
        <name slugifiedName="name-informative-references">Informative References</name>
        <reference anchor="FOSDEM20" target="https://archive.fosdem.org/2020/schedule/event/dns_catz/" quoteTitle="true" derivedAnchor="FOSDEM20">
          <front>
            <title>Extending Catalog zones - another approach in automating maintenance</title>
            <author fullname="Leo Vandewoestijne" initials="L." surname="Vandewoestijne"/>
            <date month="February" year="2020"/>
          </front>
        </reference>
        <reference anchor="Metazones" target="https://www.semanticscholar.org/paper/Federated-Domain-Name-Service-Using-DNS-Metazones-Vixie/dc12b0116332f5c236b05c71bbe20499f3c6c4b6" quoteTitle="true" derivedAnchor="Metazones">
          <front>
            <title>Federated Domain Name Service Using DNS Metazones</title>
            <author fullname="Paul Vixie" initials="P." surname="Vixie"/>
            <date month="April" year="2006"/>
          </front>
          <seriesInfo name="DOI" value="10.1093/ietcom/e89-b.4.1144"/>
        </reference>
        <reference anchor="RFC8126" target="https://www.rfc-editor.org/info/rfc8126" quoteTitle="true" derivedAnchor="RFC8126">
          <front>
            <title>Guidelines for Writing an IANA Considerations Section in RFCs</title>
            <author fullname="M. Cotton" initials="M." surname="Cotton"/>
            <author fullname="B. Leiba" initials="B." surname="Leiba"/>
            <author fullname="T. Narten" initials="T." surname="Narten"/>
            <date month="June" year="2017"/>
            <abstract>
              <t indent="0">Many protocols make use of points of extensibility that use constants to identify various protocol parameters. To ensure that the values in these fields do not have conflicting uses and to promote interoperability, their allocations are often coordinated by a central record keeper. For IETF protocols, that role is filled by the Internet Assigned Numbers Authority (IANA).</t>
              <t indent="0">To make assignments in a given registry prudently, guidance describing the conditions under which new values should be assigned, as well as when and how modifications to existing values can be made, is needed. This document defines a framework for the documentation of these guidelines by specification authors, in order to assure that the provided guidance for the IANA Considerations is clear and addresses the various issues that are likely in the operation of a registry.</t>
              <t indent="0">This is the third edition of this document; it obsoletes RFC 5226.</t>
            </abstract>
          </front>
          <seriesInfo name="BCP" value="26"/>
          <seriesInfo name="RFC" value="8126"/>
          <seriesInfo name="DOI" value="10.17487/RFC8126"/>
        </reference>
      </references>
    </references>
    <section anchor="catalog-zone-example" numbered="true" removeInRFC="false" toc="include" pn="section-appendix.a">
      <name slugifiedName="name-catalog-zone-example">Catalog Zone Example</name>
      <t indent="0" pn="section-appendix.a-1">The following is a full example of a catalog zone containing three member zones with various properties:</t>
      <sourcecode type="dns-rr" markers="false" pn="section-appendix.a-2">
catalog.invalid.                                0  SOA   invalid. (
                        invalid. 1625079950 3600 600 2147483646 0 )
catalog.invalid.                                0  NS    invalid.
example.vendor.ext.catalog.invalid.             0  CNAME example.net.
version.catalog.invalid.                        0  TXT   "2"
nj2xg5b.zones.catalog.invalid.                  0  PTR   example.com.
nvxxezj.zones.catalog.invalid.                  0  PTR   example.net.
group.nvxxezj.zones.catalog.invalid.            0  TXT   (
                        "operator-x-foo" )
nfwxa33.zones.catalog.invalid.                  0  PTR   example.org.
coo.nfwxa33.zones.catalog.invalid.              0  PTR   (
                        newcatz.invalid. )
group.nfwxa33.zones.catalog.invalid.            0  TXT   (
                        "operator-y-bar" )
metrics.vendor.ext.nfwxa33.zones.catalog.invalid. 0  CNAME (
                        collector.example.net. )
</sourcecode>
    </section>
    <section anchor="acknowledgements" numbered="false" removeInRFC="false" toc="include" pn="section-appendix.b">
      <name slugifiedName="name-acknowledgements">Acknowledgements</name>
      <t indent="0" pn="section-appendix.b-1">Our deepest thanks and appreciation go to <contact fullname="Stephen Morris"/>,                     
<contact fullname="Ray Bellis"/>, and <contact fullname="Witold Krecicki"/> who initiated this document  
and did the bulk of                                                                                    
the work.</t>
      <t indent="0" pn="section-appendix.b-2">Catalog zones originated as the chosen method among various proposals that were                     
evaluated at Internet Systems Consortium (ISC) for easy zone management.  The chosen method of storing the                           
catalog as a regular DNS zone was proposed by <contact fullname="Stephen Morris"/>.</t>
      <t indent="0" pn="section-appendix.b-3">The initial authors discovered that <contact fullname="Paul Vixie"/>'s earlier <xref target="Metazones" format="default" sectionFormat="of" derivedContent="Metazones"/> proposal                                                                    
implemented a similar approach, and they reviewed it.  Catalog zones borrow some                             
syntax ideas from <xref target="Metazones" format="default" sectionFormat="of" derivedContent="Metazones"/>, as both share this scheme of representing the                             
catalog as a regular DNS zone.</t>
      <t indent="0" pn="section-appendix.b-4">Thanks to <contact fullname="Leo Vandewoestijne"/>. Leo's presentation in the DNS devroom at    
FOSDEM'20 <xref target="FOSDEM20" format="default" sectionFormat="of" derivedContent="FOSDEM20"/> was one of the motivations to take up and continue the       
effort of standardizing catalog zones.</t>
      <t indent="0" pn="section-appendix.b-5">Thanks to <contact fullname="Joe Abley"/>, <contact fullname="David Blacka"/>, <contact fullname="Brian Conry"/>, <contact fullname="Klaus Darilion"/>, <contact fullname="Brian Dickson"/>,   
<contact fullname="Tony Finch"/>, <contact fullname="Evan Hunt"/>, <contact fullname="Shane Kerr"/>,   
<contact fullname="Warren Kumari"/>, <contact fullname="Patrik Lundin"/>, <contact fullname="Matthijs  Mekking"/>, <contact fullname="Victoria Risk"/>, <contact fullname="Josh Soref"/>, <contact fullname="Petr Spacek"/>, <contact fullname="Michael StJohns"/>, <contact fullname="Carsten             Strotmann"/>, and <contact fullname="Tim Wicinski"/> for reviewing earlier draft versions and offering         
comments and suggestions.</t>
    </section>
    <section anchor="authors-addresses" numbered="false" removeInRFC="false" toc="include" pn="section-appendix.c">
      <name slugifiedName="name-authors-addresses">Authors' Addresses</name>
      <author initials="P." surname="van Dijk" fullname="Peter van Dijk">
        <organization showOnFrontPage="true">PowerDNS</organization>
        <address>
          <postal>
            <city>Den Haag</city>
            <country>Netherlands</country>
          </postal>
          <email>peter.van.dijk@powerdns.com</email>
        </address>
      </author>
      <author initials="L." surname="Peltan" fullname="Libor Peltan">
        <organization showOnFrontPage="true">CZ.NIC</organization>
        <address>
          <postal>
            <country>Czech Republic</country>
          </postal>
          <email>libor.peltan@nic.cz</email>
        </address>
      </author>
      <author initials="O." surname="Sury" fullname="Ondrej Sury">
        <organization showOnFrontPage="true">Internet Systems Consortium</organization>
        <address>
          <postal>
            <country>Czech Republic</country>
          </postal>
          <email>ondrej@isc.org</email>
        </address>
      </author>
      <author initials="W." surname="Toorop" fullname="Willem Toorop">
        <organization showOnFrontPage="true">NLnet Labs</organization>
        <address>
          <postal>
            <street>Science Park 400</street>
            <city>Amsterdam</city>
            <code>1098 XH</code>
            <country>Netherlands</country>
          </postal>
          <email>willem@nlnetlabs.nl</email>
        </address>
      </author>
      <author initials="C.R." surname="Monshouwer" fullname="Kees Monshouwer">
        <organization showOnFrontPage="true"/>
        <address>
          <postal>
            <country>Netherlands</country>
          </postal>
          <email>mind@monshouwer.eu</email>
        </address>
      </author>
      <author initials="P." surname="Thomassen" fullname="Peter Thomassen">
        <organization showOnFrontPage="true">deSEC, SSE - Secure Systems Engineering</organization>
        <address>
          <postal>
            <street/>
            <city>Berlin</city>
            <country>Germany</country>
          </postal>
          <email>peter@desec.io</email>
        </address>
      </author>
      <author initials="A." surname="Sargsyan" fullname="Aram Sargsyan">
        <organization showOnFrontPage="true">Internet Systems Consortium</organization>
        <address>
          <postal>
            <street/>
          </postal>
          <email>aram@isc.org</email>
        </address>
      </author>
    </section>
  </back>
</rfc>
