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.Zone object is available.
  • Required inputs:
    • Child nameserver sets from GlueNameservers and ApexNameservers .
    • CDNSKEY and DNSKEY responses with DNSSEC enabled.
    • CDNSKEY and DNSKEY answer-section RRSIG records.
  • Profile/config knobs that affect behavior:
    • net.ipv4 and net.ipv6: disabled transports are skipped with transport debug tags.
    • resolver.defaults.parallel: parallel nameserver query and validation fanout.

Algorithm And Decision Flow

  1. Emit TEST_CASE_START.
  2. Build child nameserver set from the union of GlueNameservers and ApexNameservers (deduplicated by ns.String()), then deduplicate by IP.
  3. For each unique nameserver IP (parallelized):
    • If transport is disabled, emit IPV4_DISABLED or IPV6_DISABLED for rrtypes CDNSKEY and DNSKEY and skip.
    • Query CDNSKEY with DNSSEC enabled; require authoritative NOERROR and at least one CDNSKEY record to continue.
    • Collect CDNSKEY records and answer-section RRSIG records.
    • Query DNSKEY with DNSSEC enabled; collect the DNSKEY records owned by the zone apex and the answer-section RRSIG records when authoritative NOERROR with such DNSKEY records.
  4. If no nameserver produced CDNSKEY records, emit no DS17 findings.
  5. 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.
    • If no DNSKEY RRset for nameserver => DS17_CDNSKEY_WITHOUT_DNSKEY.
    • For each non-delete CDNSKEY:
      • If zone bit unset => DS17_CDNSKEY_IS_NON_ZONE and 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 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.
  6. Emit accumulated DS17 findings grouped by keytag or nameserver list as applicable.
  7. Emit TEST_CASE_END.

Per-NS Query and Delete Semantics (steps 2-5a)

child set = GlueNameservers ++ ApexNameservers; dedupe by IP

For each unique child NS IP (parallel; fan-out = resolver.defaults.parallel):

   transport disabled for CDNSKEY/DNSKEY -> IPV4_DISABLED / IPV6_DISABLED, skip
   query CDNSKEY at z.Name, DNSSEC=on
     AA + NOERROR + at least one CDNSKEY  -> record cdnskeyByNS[ns],
                                                    cdnskeyRRSIGByNS[ns]
   query DNSKEY at z.Name, DNSSEC=on
     AA + NOERROR + at least one DNSKEY   -> record dnskeyByNS[ns],
                                                    dnskeyRRSIGByNS[ns]

No NS with CDNSKEY records -> emit no DS17 findings (TEST_CASE_END only)

For each NS with CDNSKEY records:

   delete semantics:
     mixed delete and non-delete   -> DS17_MIXED_DELETE_CDNSKEY (addresses); stop ns
     only delete CDNSKEY           -> DS17_DELETE_CDNSKEY       (addresses); stop ns

   dnskeyByNS[ns] absent           -> DS17_CDNSKEY_WITHOUT_DNSKEY (addresses)
   continue with per-CDNSKEY validation below

Per-CDNSKEY Validation and RRSIG Check (step 5b-c)

For each non-delete CDNSKEY at ns (keytag = cdnskey.KeyTag()):

   zone bit unset                  -> DS17_CDNSKEY_IS_NON_ZONE (keytag, addresses)
                                      continue to next CDNSKEY
   SEP bit unset                   -> DS17_CDNSKEY_IS_NON_SEP  (keytag, addresses)

   matchingDNSKEYs = DNSKEYs in dnskeyByNS[ns] with same keytag
    +- empty                       -> DS17_CDNSKEY_MATCHES_NO_DNSKEY (keytag, addresses)
    +- non-empty:
         dnskeyRRSIGByNS[ns] lacks RRSIG with this keytag
            -> DS17_DNSKEY_NOT_SIGNED_BY_CDNSKEY   (keytag, addresses)
         cdnskeyRRSIGByNS[ns] lacks RRSIG with this keytag
            -> DS17_CDNSKEY_NOT_SIGNED_BY_CDNSKEY  (keytag, addresses)

CDNSKEY RRSIG verification:
   cdnskeyRRSIGByNS[ns] empty      -> DS17_CDNSKEY_UNSIGNED (addresses)
   otherwise, for each CDNSKEY RRSIG (keyed by sig.KeyTag):
     no DNSKEY in dnskeyByNS[ns] with that keytag and algorithm
                                   -> DS17_CDNSKEY_SIGNED_BY_UNKNOWN_DNSKEY
                                      (keytag, addresses)
     verify CDNSKEY rrset against each matching DNSKEY:
        none validates             -> DS17_CDNSKEY_INVALID_RRSIG
                                      (keytag, reason, addresses)

emit TEST_CASE_END

Emitted Tags (Possible Set)

TagEmitted when
DS17_CDNSKEY_INVALID_RRSIGCDNSKEY RRSIG keytag and algorithm match DNSKEY(s), but signature verification fails (RFC 4035 section 5.3).
DS17_CDNSKEY_IS_NON_SEPCDNSKEY record has SEP bit unset (RFC 4034 section 2.1.1, RFC 6781 section 3.2.3).
DS17_CDNSKEY_IS_NON_ZONECDNSKEY record has zone bit unset (RFC 4034 sections 2.1.1 and 5.2).
DS17_CDNSKEY_MATCHES_NO_DNSKEYCDNSKEY keytag matches no DNSKEY keytag (RFC 4035 section 2.4).
DS17_CDNSKEY_NOT_SIGNED_BY_CDNSKEYCDNSKEY RRset has no RRSIG with CDNSKEY keytag.
DS17_CDNSKEY_SIGNED_BY_UNKNOWN_DNSKEYCDNSKEY RRset has an RRSIG whose keytag and algorithm no DNSKEY in the DNSKEY RRset carries (RFC 4035 section 5.3.1).
DS17_CDNSKEY_UNSIGNEDCDNSKEY RRset has no RRSIG records (RFC 4035 section 2.2).
DS17_CDNSKEY_WITHOUT_DNSKEYCDNSKEY RRset exists but DNSKEY RRset is missing.
DS17_DELETE_CDNSKEYNameserver CDNSKEY RRset consists only of delete CDNSKEY record(s) (RFC 8078 section 4).
DS17_DNSKEY_NOT_SIGNED_BY_CDNSKEYDNSKEY RRset has no RRSIG with CDNSKEY keytag (RFC 4035 section 2.4).
DS17_MIXED_DELETE_CDNSKEYDelete CDNSKEY record is mixed with non-delete CDNSKEY record(s) (RFC 8078 section 4).
IPV4_DISABLEDIPv4 transport is disabled for a queried nameserver (CDNSKEY, DNSKEY).
IPV6_DISABLEDIPv6 transport is disabled for a queried nameserver (CDNSKEY, DNSKEY).
TEST_CASE_ENDTestcase completion marker is emitted.
TEST_CASE_STARTTestcase start marker is emitted.

Tag Arguments

TagArgument keyTypeMeaning
DS17_CDNSKEY_INVALID_RRSIGkeytagintRRSIG keytag with invalid signature.
DS17_CDNSKEY_INVALID_RRSIGreasonstringlabels when the Labels field does not fit the owner and Signer’s Name, signature otherwise (Implementation Notes).
DS17_CDNSKEY_INVALID_RRSIGaddressesarray<string>Structured child nameserver IP list.
DS17_CDNSKEY_IS_NON_SEPkeytagintCDNSKEY keytag with SEP bit unset.
DS17_CDNSKEY_IS_NON_SEPaddressesarray<string>Structured child nameserver IP list.
DS17_CDNSKEY_IS_NON_ZONEkeytagintCDNSKEY keytag with zone bit unset.
DS17_CDNSKEY_IS_NON_ZONEaddressesarray<string>Structured child nameserver IP list.
DS17_CDNSKEY_MATCHES_NO_DNSKEYkeytagintCDNSKEY keytag not found in DNSKEY RRset.
DS17_CDNSKEY_MATCHES_NO_DNSKEYaddressesarray<string>Structured child nameserver IP list.
DS17_CDNSKEY_NOT_SIGNED_BY_CDNSKEYkeytagintCDNSKEY keytag missing from CDNSKEY RRset RRSIG keytags.
DS17_CDNSKEY_NOT_SIGNED_BY_CDNSKEYaddressesarray<string>Structured child nameserver IP list.
DS17_CDNSKEY_SIGNED_BY_UNKNOWN_DNSKEYkeytagintCDNSKEY RRSIG keytag with no DNSKEY match.
DS17_CDNSKEY_SIGNED_BY_UNKNOWN_DNSKEYaddressesarray<string>Structured child nameserver IP list.
DS17_CDNSKEY_UNSIGNEDaddressesarray<string>Structured child nameserver IP list.
DS17_CDNSKEY_WITHOUT_DNSKEYaddressesarray<string>Structured child nameserver IP list.
DS17_DELETE_CDNSKEYaddressesarray<string>Structured child nameserver IP list.
DS17_DNSKEY_NOT_SIGNED_BY_CDNSKEYkeytagintCDNSKEY keytag missing from DNSKEY RRset RRSIG keytags.
DS17_DNSKEY_NOT_SIGNED_BY_CDNSKEYaddressesarray<string>Structured child nameserver IP list.
DS17_MIXED_DELETE_CDNSKEYaddressesarray<string>Structured child nameserver IP list.
IPV4_DISABLEDnsstringNameserver identity (ns name only; use address for IP) skipped on IPv4.
IPV4_DISABLEDaddressstringNameserver IP address for the same endpoint.
IPV4_DISABLEDquery_typestringQuery type skipped (CDNSKEY or DNSKEY).
IPV6_DISABLEDnsstringNameserver identity (ns name only; use address for IP) skipped on IPv6.
IPV6_DISABLEDaddressstringNameserver IP address for the same endpoint.
IPV6_DISABLEDquery_typestringQuery type skipped (CDNSKEY or DNSKEY).
TEST_CASE_ENDtestcasestringTestcase display name (DNSSEC17).
TEST_CASE_STARTtestcasestringTestcase display name (DNSSEC17).

Severity Levels Per Tag

TagLevelNotes
DS17_CDNSKEY_INVALID_RRSIGERRORDefault from share/profile.json (test_levels.DNSSEC).
DS17_CDNSKEY_IS_NON_SEPNOTICEDefault from share/profile.json (test_levels.DNSSEC).
DS17_CDNSKEY_IS_NON_ZONEERRORDefault from share/profile.json (test_levels.DNSSEC).
DS17_CDNSKEY_MATCHES_NO_DNSKEYWARNINGDefault from share/profile.json (test_levels.DNSSEC).
DS17_CDNSKEY_NOT_SIGNED_BY_CDNSKEYNOTICEDefault from share/profile.json (test_levels.DNSSEC).
DS17_CDNSKEY_SIGNED_BY_UNKNOWN_DNSKEYERRORDefault from share/profile.json (test_levels.DNSSEC).
DS17_CDNSKEY_UNSIGNEDERRORDefault from share/profile.json (test_levels.DNSSEC).
DS17_CDNSKEY_WITHOUT_DNSKEYERRORDefault from share/profile.json (test_levels.DNSSEC).
DS17_DELETE_CDNSKEYINFODefault from share/profile.json (test_levels.DNSSEC).
DS17_DNSKEY_NOT_SIGNED_BY_CDNSKEYWARNINGDefault from share/profile.json (test_levels.DNSSEC).
DS17_MIXED_DELETE_CDNSKEYERRORDefault from share/profile.json (test_levels.DNSSEC).
IPV4_DISABLEDDEBUG2Default from share/profile.json (test_levels.DNSSEC).
IPV6_DISABLEDDEBUG2Default from share/profile.json (test_levels.DNSSEC).
TEST_CASE_ENDDEBUGDefault from share/profile.json (test_levels.DNSSEC).
TEST_CASE_STARTDEBUGDefault 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_DISABLED and/or IPV6_DISABLED in that case.
    • Upstream: signature checks are described at RRset/signature level. Gonemaster: the checks for DS17_DNSKEY_NOT_SIGNED_BY_CDNSKEY and DS17_CDNSKEY_NOT_SIGNED_BY_CDNSKEY are 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, and IPV6_DISABLED.
  • 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_REACHED with bound rrsigs_per_rrset or keys_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_RRSIG carries reason labels for such an RRSIG and signature for any other failure, one finding per key tag and reason.