DNSSEC08
Status: Final
Purpose
- Verify that DNSKEY RRset signatures are present, time-valid, algorithm-supported, and cryptographically match DNSKEY records at child nameservers.
Preconditions And Inputs
- Preconditions:
- A
zone.Zoneobject is available.
- A
- Required inputs:
- Child nameserver sets from
GlueNameserversandApexNameservers. - DNSKEY query responses with DNSSEC enabled from child nameservers.
- Child nameserver sets from
- Profile/config knobs that affect behavior:
net.ipv4andnet.ipv6: disabled transports are skipped with transport debug tags.resolver.defaults.parallel: parallel DNSKEY-query execution fanout.
Algorithm And Decision Flow
- Emit
TEST_CASE_START. - Build nameserver set from the union of
GlueNameserversandApexNameservers(deduplicated byns.String()), then deduplicate by IP. - For each unique nameserver IP (parallelized):
- If transport is disabled, emit
IPV4_DISABLEDorIPV6_DISABLEDfor query typeDNSKEYand skip. - Query child apex
DNSKEYwith DNSSEC enabled. - Require response message,
RCODE=NOERROR, andAA=true; otherwise skip nameserver. - Require at least one answer-section DNSKEY record owned by the zone apex; otherwise skip nameserver. These records alone form the key set; a DNSKEY under another owner is ignored.
- If no
RRSIGanswer records, mark nameserver inDNSKEY without RRSIG. - Else evaluate each answer-section RRSIG record:
- If inception is in future, mark
DNSKEY RRSIG not yet validby keytag. - Else if expiration is in past, mark
DNSKEY RRSIG expiredby keytag. - Else if signature algorithm is unsupported, mark
Algo Not Supported By ZMby keytag+algo. - Else find DNSKEYs matching the RRSIG keytag and algorithm:
- If none found, mark
No matching DNSKEY. - Else verify signature against matching DNSKEY candidates:
- If verification reports unsupported algorithm (
dns.ErrAlg), markAlgo Not Supported By ZM. - Else if no candidate validates, mark
RRSIG not valid by DNSKEY.
- If verification reports unsupported algorithm (
- If none found, mark
- If inception is in future, mark
- If transport is disabled, emit
- Emit accumulated findings:
DS08_MISSING_RRSIG_IN_RESPONSEDS08_DNSKEY_RRSIG_NOT_YET_VALIDDS08_DNSKEY_RRSIG_EXPIREDDS08_NO_MATCHING_DNSKEYDS08_RRSIG_NOT_VALID_BY_DNSKEYDS08_ALGO_NOT_SUPPORTED_BY_ZM
- Collect nameserver IPs that had RRSIGs and emitted no DS08 failure; if non-empty emit
DS08_DNSKEY_RRSIG_VALID. - Emit
TEST_CASE_END.
Per-NS DNSKEY RRSIG Verification (steps 2-6)
Emitted Tags (Possible Set)
| Tag | Emitted when |
|---|---|
DS08_ALGO_NOT_SUPPORTED_BY_ZM | RRSIG verification requires an unsupported DNSSEC algorithm. |
DS08_DNSKEY_RRSIG_VALID | At least one nameserver returned DNSKEY with RRSIG and all RRSIG checks passed. |
DS08_DNSKEY_RRSIG_EXPIRED | DNSKEY-related RRSIG expiration is before packet test time (RFC 4034 section 3.1.5). |
DS08_DNSKEY_RRSIG_NOT_YET_VALID | DNSKEY-related RRSIG inception is after packet test time (RFC 4034 section 3.1.5). |
DS08_MISSING_RRSIG_IN_RESPONSE | DNSKEY answer exists but contains no RRSIG records (RFC 4035 sections 2.2 and 3.1.1). |
DS08_NO_MATCHING_DNSKEY | RRSIG keytag has no matching DNSKEY in DNSKEY RRset (RFC 4035 section 5.3.1). |
DS08_RRSIG_NOT_VALID_BY_DNSKEY | Matching DNSKEY candidates exist but none validate the RRSIG (RFC 4035 section 5.3.3). |
DS08_RSA_EXPONENT_UNSUPPORTED | RRSIG could not be checked only because the matching DNSKEY is an RSA key whose public exponent exceeds what the local verifier supports (more than 64 bits). |
IPV4_DISABLED | IPv4 transport is disabled for a queried nameserver (DNSKEY). |
IPV6_DISABLED | IPv6 transport is disabled for a queried nameserver (DNSKEY). |
TEST_CASE_END | Testcase completion marker is emitted. |
TEST_CASE_START | Testcase start marker is emitted. |
Tag Arguments
| Tag | Argument key | Type | Meaning |
|---|---|---|---|
DS08_ALGO_NOT_SUPPORTED_BY_ZM | keytag | int | RRSIG keytag associated with unsupported algorithm. |
DS08_ALGO_NOT_SUPPORTED_BY_ZM | algo_num | int | Unsupported DNSSEC algorithm number. |
DS08_ALGO_NOT_SUPPORTED_BY_ZM | algo_mnemo | string | Unsupported DNSSEC algorithm mnemonic. |
DS08_ALGO_NOT_SUPPORTED_BY_ZM | addresses | array<string> | Structured child nameserver IP list. |
DS08_DNSKEY_RRSIG_EXPIRED | keytag | int | RRSIG keytag with expired validity window. |
DS08_DNSKEY_RRSIG_EXPIRED | addresses | array<string> | Structured child nameserver IP list. |
DS08_DNSKEY_RRSIG_NOT_YET_VALID | keytag | int | RRSIG keytag with not-yet-valid validity window. |
DS08_DNSKEY_RRSIG_NOT_YET_VALID | addresses | array<string> | Structured child nameserver IP list. |
DS08_DNSKEY_RRSIG_VALID | addresses | array<string> | Structured child nameserver IP list where all DNSKEY RRSIG checks passed. |
DS08_MISSING_RRSIG_IN_RESPONSE | addresses | array<string> | Structured child nameserver IP list lacking RRSIG in DNSKEY response. |
DS08_NO_MATCHING_DNSKEY | keytag | int | RRSIG keytag with no DNSKEY of that keytag and algorithm in DNSKEY RRset. |
DS08_NO_MATCHING_DNSKEY | addresses | array<string> | Structured child nameserver IP list. |
DS08_RRSIG_NOT_VALID_BY_DNSKEY | keytag | int | RRSIG keytag that failed DNSKEY verification. |
DS08_RRSIG_NOT_VALID_BY_DNSKEY | reason | string | labels when the Labels field does not fit the owner and Signer’s Name, signature otherwise (Implementation Notes). |
DS08_RRSIG_NOT_VALID_BY_DNSKEY | addresses | array<string> | Structured child nameserver IP list. |
DS08_RSA_EXPONENT_UNSUPPORTED | keytag | int | RRSIG keytag whose matching DNSKEY RSA public exponent the local verifier cannot use. |
DS08_RSA_EXPONENT_UNSUPPORTED | addresses | array<string> | Structured child nameserver IP list. |
IPV4_DISABLED | ns | string | Nameserver identity (ns name only; use address for IP) skipped on IPv4. |
IPV4_DISABLED | address | string | Nameserver IP address for the same endpoint. |
IPV4_DISABLED | query_type | string | Query type skipped (DNSKEY). |
IPV6_DISABLED | ns | string | Nameserver identity (ns name only; use address for IP) skipped on IPv6. |
IPV6_DISABLED | address | string | Nameserver IP address for the same endpoint. |
IPV6_DISABLED | query_type | string | Query type skipped (DNSKEY). |
TEST_CASE_END | testcase | string | Testcase display name (DNSSEC08). |
TEST_CASE_START | testcase | string | Testcase display name (DNSSEC08). |
Severity Levels Per Tag
| Tag | Level | Notes |
|---|---|---|
DS08_ALGO_NOT_SUPPORTED_BY_ZM | NOTICE | Default from share/profile.json (test_levels.DNSSEC). |
DS08_DNSKEY_RRSIG_EXPIRED | ERROR | Default from share/profile.json (test_levels.DNSSEC). |
DS08_DNSKEY_RRSIG_NOT_YET_VALID | ERROR | Default from share/profile.json (test_levels.DNSSEC). |
DS08_DNSKEY_RRSIG_VALID | INFO | Default from share/profile.json (test_levels.DNSSEC). |
DS08_MISSING_RRSIG_IN_RESPONSE | ERROR | Default from share/profile.json (test_levels.DNSSEC). |
DS08_NO_MATCHING_DNSKEY | ERROR | Default from share/profile.json (test_levels.DNSSEC). |
DS08_RRSIG_NOT_VALID_BY_DNSKEY | ERROR | Default from share/profile.json (test_levels.DNSSEC). |
DS08_RSA_EXPONENT_UNSUPPORTED | NOTICE | Default from share/profile.json (test_levels.DNSSEC); carries zero score penalty (scoring TagPenalties). |
IPV4_DISABLED | DEBUG2 | Default from share/profile.json (test_levels.DNSSEC). |
IPV6_DISABLED | DEBUG2 | Default from share/profile.json (test_levels.DNSSEC). |
TEST_CASE_END | DEBUG | Default from share/profile.json (test_levels.DNSSEC). |
TEST_CASE_START | DEBUG | Default from share/profile.json (test_levels.DNSSEC). |
Differences From Upstream
- Differences (Upstream vs Gonemaster):
- Upstream: procedure text describes evaluation of DNSKEY RRSIG records (covering the DNSKEY RRset). Gonemaster: evaluates all answer-section RRSIG records and does not explicitly filter on
TypeCovered == DNSKEYbefore classification. - Upstream: does not explicitly specify testcase boundary and per-query transport debug emissions in this testcase summary. Gonemaster: emits
TEST_CASE_START,TEST_CASE_END,IPV4_DISABLED, andIPV6_DISABLED.
- Upstream: procedure text describes evaluation of DNSKEY RRSIG records (covering the DNSKEY RRset). Gonemaster: evaluates all answer-section RRSIG records and does not explicitly filter on
- Potential upstream report:
no
Edge Cases And Limitations
- Nameserver evaluation is deduplicated by IP; repeated names on one IP share one query outcome.
- Responses failing shape checks (
Msg,NOERROR,AA, apex DNSKEY presence) are silently skipped for DS08 findings. - Unsupported algorithm can be detected either before verification (
dnssecAlgorithmSupported) or during verification (dns.ErrAlg). - Large RSA public exponent handling: an RSA DNSKEY the DNS library refuses (an exponent of more than 4 bytes or greater than 2^31-1, which RFC 3110 section 2 permits up to 4096 bits, or a leading zero byte in the exponent or modulus, which RFC 3110 section 2 prohibits) is verified by gonemaster’s own RSA path instead, so its RRSIGs pass or fail like any other. Only when the exponent exceeds 64 bits is the finding reclassified from the
ERRORDS08_RRSIG_NOT_VALID_BY_DNSKEYto theNOTICEDS08_RSA_EXPONENT_UNSUPPORTED. Such a nameserver is treated as indeterminate and is not counted as aDS08_DNSKEY_RRSIG_VALIDpass. - An RRSIG past the first 8 over its RRset is not considered, and a DNSKEY past the first 4 with the key tag and algorithm of an RRSIG is not tried. A zone whose only valid signature or only verifying key lies past a cut is reported from what was considered: an RRSIG that no considered key verifies yields
DS08_RRSIG_NOT_VALID_BY_DNSKEY.
Implementation Notes
- RRSIG verification is bounded: at most 8 RRSIGs over one RRset are considered, and at most 4 DNSKEYs with the key tag and algorithm of an RRSIG are tried for it, each in response order. RFC 4035 section 5.3.1 requires trying every DNSKEY that matches an RRSIG; a key tag is not a unique identifier (RFC 4034 Appendix B), so a zone chooses how many keys match, and the caps depart from that requirement. A cut logs
LIMIT_REACHEDwithboundrrsigs_per_rrsetorkeys_per_tag, once per testcase (DNSSEC Limits ). Each RRSIG is verified over one copy of the RRset. An RRSIG does not verify when its Labels field exceeds the label count of the RRset owner (RFC 4035 section 5.3.1). It also fails when the owner name rebuilt from that field (RFC 4035 section 5.3.2) is not at or below the Signer’s Name, or is the Signer’s Name but differs from the RRset owner.DS08_RRSIG_NOT_VALID_BY_DNSKEYcarriesreasonlabelsfor such an RRSIG andsignaturefor any other failure, one finding per key tag and reason.