]> granicus.if.org Git - pdns/commitdiff
Remove a merged page
authorPieter Lexis <pieter@plexis.eu>
Wed, 10 Dec 2014 18:23:26 +0000 (19:23 +0100)
committerPieter Lexis <pieter@plexis.eu>
Wed, 24 Dec 2014 15:13:42 +0000 (16:13 +0100)
pdns/docs/security-poll.md [deleted file]

diff --git a/pdns/docs/security-poll.md b/pdns/docs/security-poll.md
deleted file mode 100644 (file)
index c5e63c2..0000000
+++ /dev/null
@@ -1,67 +0,0 @@
-# PowerDNS Security Polling
-PowerDNS software sadly sometimes has critical security bugs. Even though we
-send out notifications of these via all channels available, we find that not
-everybody actually find out about our security releases.
-
-To solve this, PowerDNS software will start polling for security
-notifications, and log these periodically. Secondly, the security status
-of the software will be reported using the built-in metrics. This allows
-operators to poll for the PowerDNS security status and alert on it.
-
-In the implementation of this idea, we have taken the unique role of
-operating system distributors into account. Specifically, we can deal with
-backported security fixes.
-
-Finally, this feature can be disabled, or operators can have the automated
-queries point at their own status service.
-
-## Implementation
-PowerDNS software periodically tries to resolve
-'auth-x.y.z.security-status.secpoll.powerdns.com|TXT' or
-'recursor-x.y.z.security-status.secpoll.powerdns.com'. 
-
-The data returned is in one of the following forms:
-
- * NXDOMAIN or resolution failure -> 0
- * "1 Ok" -> 1
- * "2 Upgrade recommended for security reasons, see http://powerdns.com/..." -> 2
- * "3 Upgrade mandatory for security reasons, see http://powerdns.com/..." -> 3
-
-In cases 2 or 3, periodic logging commences. The metric security-status is
-set to 2 or 3 respectively. If at a later date, resolution fails, the
-security-status is not reset to 1. It could be lowered however if we
-discover the security status is less urgent than we thought.
-
-If resolution fails, and the previous security-status was 1, the new
-security-status becomes 0 ('no data'). If the security-status was higher
-than 1, it will remain that way, and not get set to 0.
-
-In this way, security-status of 0 really means 'no data', and can not mask
-a known problem.
-
-## Distributions
-Distributions frequently backport security fixes to the PowerDNS versions
-they ship. This might lead to a version number that is known to us to be
-insecure to be secure in reality.
-
-To solve this issue, PowerDNS can be compiled with a distribution setting
-which will move the security polls from:
-'auth-x.y.z.security-status.secpoll.powerdns.com' to
-'auth-x.y.z-n.debian.security-status.secpoll.powerdns.com
-
-Note two things, one, there is a separate namespace for debian, and
-secondly, we use the package version of this release. This allows us to know
-that 3.6.0-1 (say) is insecure, but that 3.6.0-2 is not.
-
-## Details
-The configuration setting 'security-poll-suffix' is by default set to
-'secpoll.powerdns.com'. If empty, nothing is polled. This can be moved to
-'secpoll.yourorganization.com'.
-
-If compiled with PACKAGEVERSION=3.1.6-abcde.debian, queries will be sent to
-"auth-3.1.6-abcde.debian.security-status.security-poll-suffix".
-
-## Delegation
-If a distribution wants to host its own file with version information, we
-can delegate dist.security-status.secpoll.powerdns.com to their nameservers directly.
-