Adding upstream version 5.3.1.upstream/5.3.1upstream

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 54 insertions, 0 deletions

diff --git a/doc/config-policy.rst b/doc/config-policy.rst
new file mode 100644
index 0000000..d1d44ce
--- /dev/null
+++ b/doc/config-policy.rst
@@ -0,0 +1,54 @@
+.. SPDX-License-Identifier: GPL-3.0-or-later
+
+.. _policies:
+
+*****************************************
+Policy, access control, data manipulation
+*****************************************
+
+.. note::
+
+   Knot Resolver developers need your feedback to make the software even better!
+
+   We believe features described in this section are harder to use than
+   necessary. To fix this, we plan to rework these features, possibly even in
+   an incompatible way if we determine it is needed.
+
+   Please `participate in survey <https://www.knot-resolver.cz/survey/>`_
+   to provide developers with necessary information. Your answers will help us
+   tailor Knot Resolver to your needs. Thank you!
+
+
+Features in this section allow to configure what clients can get access to what
+DNS data, i.e. DNS data filtering and manipulation.
+
+:ref:`mod-policy` specify global policies applicable to all requests,
+e.g. for blocking access to particular domain. :ref:`mod-view` allow
+to specify per-client policies, e.g. block or unblock access
+to a domain only for subset of clients.
+
+It is also possible to modify data returned to clients, either by providing
+:ref:`mod-hints` (answers with statically configured IP addresses),
+:ref:`mod-dns64` translation, or :ref:`mod-renumber`.
+
+Additional modules offer protection against various DNS-based attacks,
+see :ref:`mod-rebinding` and :ref:`mod-refuse_nord`.
+
+At the very end, module :ref:`mod-daf` provides HTTP API for run-time policy
+modification, and generally just offers different interface for previously
+mentioned features.
+
+
+.. toctree::
+   :maxdepth: 1
+
+   modules-policy
+   modules-view
+   modules-hints
+   modules-dns64
+   modules-renumber
+   config-answer-reordering
+   modules-rebinding
+   modules-refuse_nord
+   modules-daf
+