TrueCloudLab/coredns
16
0
Fork 2
Code Issues Pull requests 3 Projects Releases Packages Wiki Activity Actions
coredns/middleware/dnssec
History
Miek Gieben 5301c5af5f Run golint and go vet (#276) 
Cleanup the errors and removed deadcode along the way. The leaves
some error laying around, mostly about commenting exported identifier.
We should look hard if those really are needed.
2016-09-21 17:01:19 +01:00
..
black_lies.go Add middleware/dnssec (#133) 2016-04-26 17:57:11 +01:00
black_lies_test.go Cleanup: put middleware helper functions in pkgs (#245) 2016-09-07 11:10:16 +01:00
cache.go Add middleware/dnssec (#133) 2016-04-26 17:57:11 +01:00
cache_test.go Cleanup: put middleware helper functions in pkgs (#245) 2016-09-07 11:10:16 +01:00
dnskey.go Cleanup: put middleware helper functions in pkgs (#245) 2016-09-07 11:10:16 +01:00
dnssec.go Cleanup: put middleware helper functions in pkgs (#245) 2016-09-07 11:10:16 +01:00
dnssec_test.go Cleanup: put middleware helper functions in pkgs (#245) 2016-09-07 11:10:16 +01:00
handler.go Cleanup: put middleware helper functions in pkgs (#245) 2016-09-07 11:10:16 +01:00
handler_test.go Cleanup: put middleware helper functions in pkgs (#245) 2016-09-07 11:10:16 +01:00
README.md Fs (#242) 2016-09-05 09:32:11 +01:00
responsewriter.go Run golint and go vet (#276) 2016-09-21 17:01:19 +01:00
rrsig.go Add middleware/dnssec (#133) 2016-04-26 17:57:11 +01:00
setup.go Cleanups and tests (#272) 2016-09-19 11:26:00 +01:00
setup_test.go Make CoreDNS a server type plugin for Caddy (#220) 2016-08-19 17:14:17 -07:00

README.md

dnssec

dnssec enables on-the-fly DNSSEC signing of served data.

Syntax

dnssec [zones...]
  • zones zones that should be signed. If empty, the zones from the configuration block are used.

If keys are not specified (see below), a key is generated and used for all signing operations. The DNSSEC signing will treat this key a CSK (common signing key), forgoing the ZSK/KSK split. All signing operations are done online. Authenticated denial of existence is implemented with NSEC black lies. Using ECDSA as an algorithm is preferred as this leads to smaller signatures (compared to RSA). NSEC3 is not supported.

A single signing key can be specified by using the key directive.

NOTE: Key generation has not been implemented yet.

TODO(miek): think about key rollovers, and how to do them automatically.

dnssec [zones... ] {
    key file [key...]
}
  • key file indicates that key file(s) should be read from disk. When multiple keys are specified, RRsets will be signed with all keys. Generating a key can be done with dnssec-keygen: dnssec-keygen -a ECDSAP256SHA256 <zonename>. A key created for zone A can be safely used for zone B.

Examples