2
0
mirror of https://gitlab.isc.org/isc-projects/bind9 synced 2025-08-28 21:17:54 +00:00

23 Commits

Author SHA1 Message Date
Petr Špaček
146c125988 Mention zone storage in the DNSSEC chapter
Let's not duplicate texts, link to description elsewhere instead.
2022-06-22 13:37:18 +02:00
Suzanne Goldlust
6b1ad4dcfb Minor grammar improvements in the Signing chapter of the DNSSEC Guide 2022-06-22 13:37:18 +02:00
Matthijs Mekking
f721986589 Add a section about key rollover
Describe how to do key rollovers with dnssec-policy. Update the
revert to unsigned recipe in the DNSSEC guide.
2022-06-22 13:37:18 +02:00
Petr Špaček
7d25027898 Deduplicate Manual Signing between DNSSEC chapter and DNSSEC Guide
The two procedures were essentially the same, but each instance was
missing some details from the other. They are now combined into one text
in the DNSSEC Guide and linked from DNSSEC chapter.
2022-06-22 13:37:18 +02:00
Petr Špaček
7e96801841 Deduplicate key filename description in the DNSSEC Guide
Third time ...
2022-06-22 13:37:18 +02:00
Petr Špaček
915237a28f Use code-block directive for complete command lines
Minor rendering nit, not really important.
2022-06-22 13:37:18 +02:00
Petr Špaček
1dcc34f076 Deduplicate key filename description in the DNSSEC chapter 2022-06-22 13:37:18 +02:00
Petr Špaček
5ba618fd28 Move Private Type Records in DNSSEC chapter to higher level
Private Type Records are not specific to manually signing, so it is
better to move it to the end of the "Zone Signing" section shared by all
three methods.
2022-06-22 13:37:18 +02:00
Petr Špaček
bffa3063f0 Rewrite DNSSEC Validation subchapter in the ARM
Mostly deduplicating and linking information across the ARM.
Generally people should not touch it unless they what they are doing, so
let's try to discourage them a bit.
2022-06-22 13:37:18 +02:00
Petr Špaček
29030fa5d7 Add hints about secure delegation to DNSSEC chapter of the ARM
Let's not duplicate texts from elsewhere, just point to different parts
of documentation.
2022-06-22 13:37:18 +02:00
Petr Špaček
28a533322b Reorder chapters about Zone Signing in the DNSSEC chapter of ARM
Let's make more automated methods more prominent:
- KASP first
- dynamic updates second
- command-line tools only as last resort
2022-06-22 13:37:18 +02:00
Petr Špaček
744763f8f2 Rewrite KASP section of DNSSEC chapter in the ARM
The goal is simplicity. Copy&paste to do the right thing, or read
referenced material and make up your mind if you need specialities.

NSEC discussion is already present in the DNSSEC guide so I merged
KASP examples with example for NSEC3 and removed NSEC text from the
DNSSEC chapter.
2022-06-22 13:37:18 +02:00
Petr Špaček
0dc9c33149 Rewrite introduction for DNSSEC chapter of the ARM
I've attempted to drop most of DNSSEC-specific jargon from the intro
paragraph, and to convince readers to read on.
2022-06-22 13:37:18 +02:00
Matthijs Mekking
93601d8325 Use NSEC3 guidance values in nsec3 config examples
Use best practice values in examples that follow new guidance from
draft-ietf-dnsop-nsec3-guidance:

   ; SHA-1, no extra iterations, empty salt:
   ;
   bcp.example. IN NSEC3PARAM 1 0 0 -
2022-06-22 13:37:18 +02:00
Matthijs Mekking
7824c5c967 Move Dynamic Zones section up
Move this section up so that DNSSEC signing topics are grouped together
(and not split by the DNSSEC Validation chapter).
2022-06-22 13:37:18 +02:00
Matthijs Mekking
be54c08d2b Rewrite Dynamic Zones section
Restructure the section about dynamic zones and automatic signing:
- Focus on dynamic zones with 'auto-dnssec allow;'.
- Add a section about multi-signer models.
- Move NSEC3 related topics into one section.
- Remove any text that does not concern dynamic zones (mostly duplicate
  text anyway).
2022-06-22 13:37:18 +02:00
Matthijs Mekking
71490a5a2d Add a section about Denial of Existence
Move bits from the "DNSSEC, Dynamic Zones, and Automatic Signing"
about denial of existence to a separate section below the "Key and
Signing Policy" section.

Add a brief introduction about denial of existence to this section.
2022-06-22 13:37:18 +02:00
Matthijs Mekking
34dea43f9c Rewrap a paragraph in DNSSEC Validation section
No textual changes, just rewrapping to 80 characters.
2022-06-22 13:37:18 +02:00
Matthijs Mekking
a1c95e8e7c Rewrite DNSSEC chapter - signing
Restructure the first part of the DNSSEC chapter that deals with zone
signing. Put dnssec-policy first. Mention Key and Signing Policy.
Only then talk about the DNSSEC tools.
2022-06-22 13:37:18 +02:00
Matthijs Mekking
fb24454c58 Nit changes in introduction of DNSSEC chapter
DNSSEC-bis is an uncommon term. Other servers are typically resolvers
and they usually are configured with the root key.
2022-06-22 13:37:18 +02:00
Petr Špaček
2ee3f4e6c8
Update NSEC3 guidance to match draft-ietf-dnsop-nsec3-guidance-10
https://datatracker.ietf.org/doc/html/draft-ietf-dnsop-nsec3-guidance-10
is on it's way to become RFC, so let's update our recommendations in the
docs to be in line with it.
2022-06-15 17:53:33 +02:00
Ron Aitchison
25eb91d23c
Split chapter Advanced DNS Features in the ARM into chapters 5, 6, 7 2022-05-11 10:51:26 +02:00
Petr Špaček
1322372a0c
Restructure includes for ARM chapters 1 (Intro) and 2 (Requirements)
We have had perpetual problem with Sphinx implicitly double-including
files. To avoid that problem all files with name suffix .inc.rst are now
ignored by Sphinx, and writter can conveniently include them without
modifying conf.py for each and every file.
2022-05-11 10:51:21 +02:00