summaryrefslogtreecommitdiffstats
path: root/doc/configuration.rst
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-13 08:02:46 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-13 08:02:46 +0000
commite4e8d437fe47a4d97ab469fc9116e50ab1601c54 (patch)
treed573aafc30201b68be84aba1a44a8f5f2fc30d4e /doc/configuration.rst
parentAdding debian version 3.3.4-1.1. (diff)
downloadknot-e4e8d437fe47a4d97ab469fc9116e50ab1601c54.tar.xz
knot-e4e8d437fe47a4d97ab469fc9116e50ab1601c54.zip
Merging upstream version 3.3.5.
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'doc/configuration.rst')
-rw-r--r--doc/configuration.rst22
1 files changed, 6 insertions, 16 deletions
diff --git a/doc/configuration.rst b/doc/configuration.rst
index 193bd78..55457eb 100644
--- a/doc/configuration.rst
+++ b/doc/configuration.rst
@@ -481,6 +481,11 @@ convenience delay the submission is started. The server publishes CDS and CDNSKE
and the user shall propagate them to the parent. The server periodically checks for
DS at the parent zone and when positive, finishes the rollover.
+.. NOTE::
+ As the key timestamp semantics differ between the automatic and manual key
+ management, all key timestamps set in the future, either manually or during
+ a key import, are ignorred (cleared).
+
.. _dnssec-manual-key-management:
Manual key management
@@ -528,22 +533,6 @@ parent zone to include a reference to the new key. This must happen within one
day (in this case) including a delay required to propagate the new DS to
caches.
-.. WARNING::
- If you ever decide to switch from manual key management to automatic key management,
- note that the automatic key management uses
- :ref:`policy_zsk-lifetime` and :ref:`policy_ksk-lifetime` policy configuration
- options to schedule key rollovers and it internally uses timestamps of keys differently
- than in the manual case. As a consequence it might break if the ``retire`` or ``remove`` timestamps
- are set for the manually generated keys currently in use. Make sure to set these timestamps
- to zero using :doc:`keymgr<man_keymgr>`:
-
- .. code-block:: console
-
- $ keymgr myzone.test. set <key_id> retire=0 remove=0
-
- and configure your policy suitably according to :ref:`dnssec-automatic-zsk-management`
- and :ref:`dnssec-automatic-ksk-management`.
-
.. _dnssec-signing:
Zone signing
@@ -570,6 +559,7 @@ The signing is initiated on the following occasions:
- Zone reload
- Reaching the signature refresh period
- Key set changed due to rollover event
+- NSEC3 salt is changed
- Received DDNS update
- Forced zone re-sign via server control interface