diff --git a/doc/arm/Bv9ARM-book.xml b/doc/arm/Bv9ARM-book.xml index c8eec62d4e..a0e195efd1 100644 --- a/doc/arm/Bv9ARM-book.xml +++ b/doc/arm/Bv9ARM-book.xml @@ -12459,19 +12459,41 @@ example.com. NS ns2.example.net. mirror - If set to yes, causes the + If set to yes, this causes the zone to become a mirror zone. A mirror zone is a - slave zone whose every - version is subject to DNSSEC validation before being - used. In order for zone validation to succeed, its - KSK must be configured as a trust anchor. Answers - coming from a mirror zone look almost exactly like - answers from a regular slave - zone, with the notable exception of the AA bit not - being set. The default is no. - This option is meant to be used for deploying an RFC - 7706-style local copy of the root zone, e.g. using a - configuration like this: + secondary zone whose data + is subject to DNSSEC validation before being + used in answers. The default is + no. + + + A mirror zone's contents are validated during the transfer + process, and again when the zone file is loaded from disk + when named is restarted. If validation + fails, a retransfer of the zone is scheduled; if the mirror + zone had not previously been loaded or if the previous + version has expired, traditional DNS recursion will be used + to look up the answers instead. + + + For validation to succeed, a key-signing key (KSK) for + the zone must be configured as a trust anchor in + named.conf: + that is, a key for the zone must either be specified in + managed-keys or + trusted-keys, or in the case of + the root zone, dnssec-validation + must be set to auto. + Answers coming from a mirror zone look almost exactly like + answers from a normal slave zone, with the notable + exceptions that the AA bit ("authoritative answer") is + not set, and the AD bit ("authenticated data") is. + + + Though this option can be used for other zones, it + is intended to be used to set up a fast local copy of + the root zone, as described in RFC 7706. + This can be done by using the following configuration: zone "." { type slave; diff --git a/doc/arm/notes.xml b/doc/arm/notes.xml index e69b0af0bd..b6c3fdbfc7 100644 --- a/doc/arm/notes.xml +++ b/doc/arm/notes.xml @@ -82,11 +82,12 @@ A new secondary zone option, mirror, enables named to serve a transferred copy of a zone's contents without acting as an authority for the - zone. DNS responses from mirror zones do not set the AA - ("authoritative answer") bit, and are subject to DNSSEC - validation. This is meant to facilitate deployment - of a local copy of the root zone as described in RFC 7706. - [GL #33] + zone. A zone must be fully validated against an active trust + anchor before it can be used as a mirror zone. DNS responses + from mirror zones do not set the AA bit ("authoritative answer"), + but do set the AD bit ("authenticated data"). This feature is + meant to facilitate deployment of a local copy of the root zone, + as described in RFC 7706. [GL #33]