DNSSEC17
Status: Final
Purpose
- Validate CDNSKEY RRsets against DNSKEY data and CDNSKEY signatures, including delete semantics and signature/keytag consistency checks.
Preconditions And Inputs
- Preconditions:
- A
zone.Zoneobject is available.
- A
- Required inputs:
- Child nameserver sets from
GlueNameserversandApexNameservers. - CDNSKEY and DNSKEY responses with DNSSEC enabled.
- CDNSKEY and DNSKEY answer-section RRSIG records.
- 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 nameserver query and validation fanout.
Algorithm And Decision Flow
- Emit
TEST_CASE_START. - Build child 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 rrtypesCDNSKEYandDNSKEYand skip. - Query
CDNSKEYwith DNSSEC enabled; require authoritativeNOERRORand at least one CDNSKEY record to continue. - Collect CDNSKEY records and answer-section RRSIG records.
- Query
DNSKEYwith DNSSEC enabled; collect the DNSKEY records owned by the zone apex and the answer-section RRSIG records when authoritativeNOERRORwith such DNSKEY records.
- If transport is disabled, emit
- If no nameserver produced CDNSKEY records, emit no DS17 findings.
- For each nameserver with CDNSKEY records (parallelized validation):
- Detect delete semantics:
- Mixed delete/non-delete CDNSKEY =>
DS17_MIXED_DELETE_CDNSKEY. - Only delete CDNSKEY =>
DS17_DELETE_CDNSKEY. - In both delete cases, remaining CDNSKEY validations are skipped for that nameserver.
- Mixed delete/non-delete CDNSKEY =>
- If no DNSKEY RRset for nameserver =>
DS17_CDNSKEY_WITHOUT_DNSKEY. - For each non-delete CDNSKEY:
- If zone bit unset =>
DS17_CDNSKEY_IS_NON_ZONEand skip remaining checks for this CDNSKEY. - If SEP bit unset =>
DS17_CDNSKEY_IS_NON_SEP. - If no matching DNSKEY keytag =>
DS17_CDNSKEY_MATCHES_NO_DNSKEY. - Else:
- If DNSKEY RRSIG set lacks CDNSKEY keytag =>
DS17_DNSKEY_NOT_SIGNED_BY_CDNSKEY. - If CDNSKEY RRSIG set lacks CDNSKEY keytag =>
DS17_CDNSKEY_NOT_SIGNED_BY_CDNSKEY.
- If DNSKEY RRSIG set lacks CDNSKEY keytag =>
- If zone bit unset =>
- If CDNSKEY RRset has no RRSIG records =>
DS17_CDNSKEY_UNSIGNED. - Else for each CDNSKEY RRSIG:
- If no DNSKEY matches the RRSIG keytag and algorithm =>
DS17_CDNSKEY_SIGNED_BY_UNKNOWN_DNSKEY. - Else if cryptographic verification fails for all matching DNSKEY records =>
DS17_CDNSKEY_INVALID_RRSIG.
- If no DNSKEY matches the RRSIG keytag and algorithm =>
- Detect delete semantics:
- Emit accumulated DS17 findings grouped by keytag or nameserver list as applicable.
- Emit
TEST_CASE_END.
Per-NS Query and Delete Semantics (steps 2-5a)
Per-CDNSKEY Validation and RRSIG Check (step 5b-c)
Emitted Tags (Possible Set)
| Tag | Emitted when |
|---|---|
DS17_CDNSKEY_INVALID_RRSIG | CDNSKEY RRSIG keytag and algorithm match DNSKEY(s), but signature verification fails (RFC 4035 section 5.3). |
DS17_CDNSKEY_IS_NON_SEP | CDNSKEY record has SEP bit unset (RFC 4034 section 2.1.1, RFC 6781 section 3.2.3). |
DS17_CDNSKEY_IS_NON_ZONE | CDNSKEY record has zone bit unset (RFC 4034 sections 2.1.1 and 5.2). |
DS17_CDNSKEY_MATCHES_NO_DNSKEY | CDNSKEY keytag matches no DNSKEY keytag (RFC 4035 section 2.4). |
DS17_CDNSKEY_NOT_SIGNED_BY_CDNSKEY | CDNSKEY RRset has no RRSIG with CDNSKEY keytag. |
DS17_CDNSKEY_SIGNED_BY_UNKNOWN_DNSKEY | CDNSKEY RRset has an RRSIG whose keytag and algorithm no DNSKEY in the DNSKEY RRset carries (RFC 4035 section 5.3.1). |
DS17_CDNSKEY_UNSIGNED | CDNSKEY RRset has no RRSIG records (RFC 4035 section 2.2). |
DS17_CDNSKEY_WITHOUT_DNSKEY | CDNSKEY RRset exists but DNSKEY RRset is missing. |
DS17_DELETE_CDNSKEY | Nameserver CDNSKEY RRset consists only of delete CDNSKEY record(s) (RFC 8078 section 4). |
DS17_DNSKEY_NOT_SIGNED_BY_CDNSKEY | DNSKEY RRset has no RRSIG with CDNSKEY keytag (RFC 4035 section 2.4). |
DS17_MIXED_DELETE_CDNSKEY | Delete CDNSKEY record is mixed with non-delete CDNSKEY record(s) (RFC 8078 section 4). |
IPV4_DISABLED | IPv4 transport is disabled for a queried nameserver (CDNSKEY, DNSKEY). |
IPV6_DISABLED | IPv6 transport is disabled for a queried nameserver (CDNSKEY, DNSKEY). |
TEST_CASE_END | Testcase completion marker is emitted. |
TEST_CASE_START | Testcase start marker is emitted. |
Tag Arguments
| Tag | Argument key | Type | Meaning |
|---|---|---|---|
DS17_CDNSKEY_INVALID_RRSIG | keytag | int | RRSIG keytag with invalid signature. |
DS17_CDNSKEY_INVALID_RRSIG | reason | string | labels when the Labels field does not fit the owner and Signer’s Name, signature otherwise (Implementation Notes). |
DS17_CDNSKEY_INVALID_RRSIG | addresses | array<string> | Structured child nameserver IP list. |
DS17_CDNSKEY_IS_NON_SEP | keytag | int | CDNSKEY keytag with SEP bit unset. |
DS17_CDNSKEY_IS_NON_SEP | addresses | array<string> | Structured child nameserver IP list. |
DS17_CDNSKEY_IS_NON_ZONE | keytag | int | CDNSKEY keytag with zone bit unset. |
DS17_CDNSKEY_IS_NON_ZONE | addresses | array<string> | Structured child nameserver IP list. |
DS17_CDNSKEY_MATCHES_NO_DNSKEY | keytag | int | CDNSKEY keytag not found in DNSKEY RRset. |
DS17_CDNSKEY_MATCHES_NO_DNSKEY | addresses | array<string> | Structured child nameserver IP list. |
DS17_CDNSKEY_NOT_SIGNED_BY_CDNSKEY | keytag | int | CDNSKEY keytag missing from CDNSKEY RRset RRSIG keytags. |
DS17_CDNSKEY_NOT_SIGNED_BY_CDNSKEY | addresses | array<string> | Structured child nameserver IP list. |
DS17_CDNSKEY_SIGNED_BY_UNKNOWN_DNSKEY | keytag | int | CDNSKEY RRSIG keytag with no DNSKEY match. |
DS17_CDNSKEY_SIGNED_BY_UNKNOWN_DNSKEY | addresses | array<string> | Structured child nameserver IP list. |
DS17_CDNSKEY_UNSIGNED | addresses | array<string> | Structured child nameserver IP list. |
DS17_CDNSKEY_WITHOUT_DNSKEY | addresses | array<string> | Structured child nameserver IP list. |
DS17_DELETE_CDNSKEY | addresses | array<string> | Structured child nameserver IP list. |
DS17_DNSKEY_NOT_SIGNED_BY_CDNSKEY | keytag | int | CDNSKEY keytag missing from DNSKEY RRset RRSIG keytags. |
DS17_DNSKEY_NOT_SIGNED_BY_CDNSKEY | addresses | array<string> | Structured child nameserver IP list. |
DS17_MIXED_DELETE_CDNSKEY | 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 (CDNSKEY or 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 (CDNSKEY or DNSKEY). |
TEST_CASE_END | testcase | string | Testcase display name (DNSSEC17). |
TEST_CASE_START | testcase | string | Testcase display name (DNSSEC17). |
Severity Levels Per Tag
| Tag | Level | Notes |
|---|---|---|
DS17_CDNSKEY_INVALID_RRSIG | ERROR | Default from share/profile.json (test_levels.DNSSEC). |
DS17_CDNSKEY_IS_NON_SEP | NOTICE | Default from share/profile.json (test_levels.DNSSEC). |
DS17_CDNSKEY_IS_NON_ZONE | ERROR | Default from share/profile.json (test_levels.DNSSEC). |
DS17_CDNSKEY_MATCHES_NO_DNSKEY | WARNING | Default from share/profile.json (test_levels.DNSSEC). |
DS17_CDNSKEY_NOT_SIGNED_BY_CDNSKEY | NOTICE | Default from share/profile.json (test_levels.DNSSEC). |
DS17_CDNSKEY_SIGNED_BY_UNKNOWN_DNSKEY | ERROR | Default from share/profile.json (test_levels.DNSSEC). |
DS17_CDNSKEY_UNSIGNED | ERROR | Default from share/profile.json (test_levels.DNSSEC). |
DS17_CDNSKEY_WITHOUT_DNSKEY | ERROR | Default from share/profile.json (test_levels.DNSSEC). |
DS17_DELETE_CDNSKEY | INFO | Default from share/profile.json (test_levels.DNSSEC). |
DS17_DNSKEY_NOT_SIGNED_BY_CDNSKEY | WARNING | Default from share/profile.json (test_levels.DNSSEC). |
DS17_MIXED_DELETE_CDNSKEY | ERROR | Default from share/profile.json (test_levels.DNSSEC). |
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: describes this testcase as producing no output when no CDNSKEY is found. Gonemaster: emits only
TEST_CASE_START,TEST_CASE_END, and, if any transport is disabled,IPV4_DISABLEDand/orIPV6_DISABLEDin that case. - Upstream: signature checks are described at RRset/signature level. Gonemaster: the checks for
DS17_DNSKEY_NOT_SIGNED_BY_CDNSKEYandDS17_CDNSKEY_NOT_SIGNED_BY_CDNSKEYare implemented as keytag-presence checks in RRSIG sets, not full per-signature validation. - Upstream: does not explicitly specify testcase boundary and transport-disabled debug emissions in this testcase summary. Gonemaster: emits
TEST_CASE_START,TEST_CASE_END,IPV4_DISABLED, andIPV6_DISABLED.
- Upstream: describes this testcase as producing no output when no CDNSKEY is found. Gonemaster: emits only
- Potential upstream report:
no
Edge Cases And Limitations
- Delete semantics short-circuit further CDNSKEY validation for that nameserver.
- Non-zone CDNSKEY records are flagged and then skipped from subsequent matching/signing checks for that record.
- Nameserver evaluation is deduplicated by IP.
- 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
DS17_CDNSKEY_INVALID_RRSIG.
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.DS17_CDNSKEY_INVALID_RRSIGcarriesreasonlabelsfor such an RRSIG andsignaturefor any other failure, one finding per key tag and reason.