]> git.ipfire.org Git - thirdparty/knot-dns.git/commitdiff
mod-cookies: update doc (module can be used without config)
authorMark Karpilovskij <mark.karpilovskij@nic.cz>
Fri, 8 Feb 2019 16:19:07 +0000 (17:19 +0100)
committerDaniel Salzman <daniel.salzman@nic.cz>
Tue, 12 Feb 2019 08:57:18 +0000 (09:57 +0100)
src/knot/modules/cookies/cookies.rst

index 57d84d9db8ec9e0da3d56174aebce4ef685a2579..fbe737d81a94173c80c3b9eed254a791a9d6eb9f 100644 (file)
@@ -5,7 +5,7 @@
 
 DNS Cookies (:rfc:`7873`) is a lightweight security mechanism against
 denial-of-service and amplification attacks. The server keeps a secret value
-(the server secret), which is used to generate a cookie, which is sent to
+(the Server Secret), which is used to generate a cookie, which is sent to
 the client in the OPT RR. The server then verifies the authenticity of the client
 by the presence of a correct cookie. Both the server and the client have to
 support DNS Cookies, otherwise they are not used.
@@ -21,13 +21,21 @@ support DNS Cookies, otherwise they are not used.
 Example
 -------
 
-It is recommended to enable DNS Cookies globally, not per zone.
+It is recommended to enable DNS Cookies globally, not per zone. The module may be used without any further configuration.
+
+::
+
+    template:
+        - id: default
+          global-module: mod-cookies # Enable DNS Cookies globally
+
+Module configuration may be supplied if necessary.
 
 ::
 
     mod-cookies:
       - id: default
-        secret-lifetime: 30h # The server secret is regenerated every 30 hours
+        secret-lifetime: 30h # The Server Secret is regenerated every 30 hours
         badcookie-slip: 3    # The server replies only to every third query with a wrong cookie
 
     template: