diff --git a/doc/arm/dnssec.xml b/doc/arm/dnssec.xml
index 6210a12a7f..be702849c3 100644
--- a/doc/arm/dnssec.xml
+++ b/doc/arm/dnssec.xml
@@ -16,9 +16,10 @@
- Changing a zone from insecure to secure can be done in two
- ways: using a dynamic DNS update, or the
- auto-dnssec zone option.
+ Changing a zone from insecure to secure can be done in three
+ ways: using a dynamic DNS update, use the
+ auto-dnssec zone option, or set a DNSSEC
+ policy for the zone with dnssec-policy.
For either method, you need to configure
@@ -26,8 +27,9 @@
K* files which contain the public and private
parts of the keys that will be used to sign the zone. These files
will have been generated by
- dnssec-keygen. You can do this by placing them
- in the key-directory, as specified in
+ dnssec-keygen (or created when needed by
+ named if dnssec-policy is
+ used). Keys should be placed in the key-directory, as specified in
named.conf:
zone example.net {
@@ -44,6 +46,18 @@
well. An NSEC chain will be generated as part of the initial
signing process.
+
+ With dnssec-policy you specify what keys should
+ be KSK and/or ZSK. If you want a key to sign all records with a key
+ you will need to specify a CSK:
+
+
+ dnssec-policy csk {
+ keys {
+ csk key-directory P5Y 13;
+ };
+ };
+
Dynamic DNS update method
@@ -95,7 +109,8 @@
- To enable automatic signing, add the
+ To enable automatic signing, you can set a
+ dnssec-policy, or add the
auto-dnssec option to the zone statement in
named.conf.
auto-dnssec has two possible arguments:
@@ -117,6 +132,13 @@
(See and
for more information.)
+
+ dnssec-policy is like
+ auto-dnssec maintain, but will also automatically
+ create new keys when necessary. Also any configuration related
+ to DNSSEC signing is retrieved from the policy (ignoring existing
+ DNSSEC named.conf options).
+
named will periodically search the key directory
for keys matching the zone, and if the keys' metadata indicates
@@ -288,6 +310,9 @@
chain will be generated before the NSEC chain is
destroyed.
+
+ NSEC3 is not supported yet with dnssec-policy.
+
Converting from NSEC3 to NSEC