1 /* SPDX-License-Identifier: LGPL-2.1-or-later */
3 #include "sd-messages.h"
5 #include "alloc-util.h"
6 #include "conf-files.h"
8 #include "dns-domain.h"
11 #include "hexdecoct.h"
12 #include "nulstr-util.h"
13 #include "parse-util.h"
14 #include "resolved-dns-dnssec.h"
15 #include "resolved-dns-trust-anchor.h"
17 #include "sort-util.h"
18 #include "string-util.h"
21 static const char trust_anchor_dirs
[] = CONF_PATHS_NULSTR("dnssec-trust-anchors.d");
23 /* The second DS RR from https://data.iana.org/root-anchors/root-anchors.xml, retrieved February 2017 */
24 static const uint8_t root_digest2
[] =
25 { 0xE0, 0x6D, 0x44, 0xB8, 0x0B, 0x8F, 0x1D, 0x39, 0xA9, 0x5C, 0x0B, 0x0D, 0x7C, 0x65, 0xD0, 0x84,
26 0x58, 0xE8, 0x80, 0x40, 0x9B, 0xBC, 0x68, 0x34, 0x57, 0x10, 0x42, 0x37, 0xC7, 0xF8, 0xEC, 0x8D };
28 static bool dns_trust_anchor_knows_domain_positive(DnsTrustAnchor
*d
, const char *name
) {
31 /* Returns true if there's an entry for the specified domain
32 * name in our trust anchor */
35 hashmap_contains(d
->positive_by_key
, &DNS_RESOURCE_KEY_CONST(DNS_CLASS_IN
, DNS_TYPE_DNSKEY
, name
)) ||
36 hashmap_contains(d
->positive_by_key
, &DNS_RESOURCE_KEY_CONST(DNS_CLASS_IN
, DNS_TYPE_DS
, name
));
39 static int add_root_ksk(
48 _cleanup_(dns_resource_record_unrefp
) DnsResourceRecord
*rr
= NULL
;
51 rr
= dns_resource_record_new(key
);
55 rr
->ds
.key_tag
= key_tag
;
56 rr
->ds
.algorithm
= algorithm
;
57 rr
->ds
.digest_type
= digest_type
;
58 rr
->ds
.digest_size
= digest_size
;
59 rr
->ds
.digest
= memdup(digest
, rr
->ds
.digest_size
);
63 r
= dns_answer_add(answer
, rr
, 0, DNS_ANSWER_AUTHENTICATED
, NULL
);
70 static int dns_trust_anchor_add_builtin_positive(DnsTrustAnchor
*d
) {
71 _cleanup_(dns_answer_unrefp
) DnsAnswer
*answer
= NULL
;
72 _cleanup_(dns_resource_key_unrefp
) DnsResourceKey
*key
= NULL
;
77 r
= hashmap_ensure_allocated(&d
->positive_by_key
, &dns_resource_key_hash_ops
);
81 /* Only add the built-in trust anchor if there's neither a DS nor a DNSKEY defined for the root domain. That
82 * way users have an easy way to override the root domain DS/DNSKEY data. */
83 if (dns_trust_anchor_knows_domain_positive(d
, "."))
86 key
= dns_resource_key_new(DNS_CLASS_IN
, DNS_TYPE_DS
, "");
90 answer
= dns_answer_new(2);
94 /* Add the currently valid RRs from https://data.iana.org/root-anchors/root-anchors.xml */
95 r
= add_root_ksk(answer
, key
, 20326, DNSSEC_ALGORITHM_RSASHA256
, DNSSEC_DIGEST_SHA256
, root_digest2
, sizeof(root_digest2
));
99 r
= hashmap_put(d
->positive_by_key
, key
, answer
);
107 static int dns_trust_anchor_add_builtin_negative(DnsTrustAnchor
*d
) {
109 static const char private_domains
[] =
110 /* RFC 6761 says that .test is a special domain for
111 * testing and not to be installed in the root zone */
114 /* RFC 6761 says that these reverse IP lookup ranges
115 * are for private addresses, and hence should not
116 * show up in the root zone */
118 "16.172.in-addr.arpa\0"
119 "17.172.in-addr.arpa\0"
120 "18.172.in-addr.arpa\0"
121 "19.172.in-addr.arpa\0"
122 "20.172.in-addr.arpa\0"
123 "21.172.in-addr.arpa\0"
124 "22.172.in-addr.arpa\0"
125 "23.172.in-addr.arpa\0"
126 "24.172.in-addr.arpa\0"
127 "25.172.in-addr.arpa\0"
128 "26.172.in-addr.arpa\0"
129 "27.172.in-addr.arpa\0"
130 "28.172.in-addr.arpa\0"
131 "29.172.in-addr.arpa\0"
132 "30.172.in-addr.arpa\0"
133 "31.172.in-addr.arpa\0"
134 "168.192.in-addr.arpa\0"
136 /* The same, but for IPv6. */
139 /* RFC 6762 reserves the .local domain for Multicast
140 * DNS, it hence cannot appear in the root zone. (Note
141 * that we by default do not route .local traffic to
142 * DNS anyway, except when a configured search domain
146 /* These two are well known, popular private zone
147 * TLDs, that are blocked from delegation, according
149 * http://icannwiki.com/Name_Collision#NGPC_Resolution
151 * There's also ongoing work on making this official
153 * https://www.ietf.org/archive/id/draft-chapin-additional-reserved-tlds-02.txt */
157 /* The following four TLDs are suggested for private
158 * zones in RFC 6762, Appendix G, and are hence very
159 * unlikely to be made official TLDs any day soon */
165 /* Defined by RFC 8375. The most official choice. */
168 /* RFC 8880 says because the 'ipv4only.arpa' zone has to
169 * be an insecure delegation, DNSSEC cannot be used to
170 * protect these answers from tampering by malicious
171 * devices on the path */
173 "170.0.0.192.in-addr.arpa\0"
174 "171.0.0.192.in-addr.arpa\0";
180 /* Only add the built-in trust anchor if there's no negative
181 * trust anchor defined at all. This enables easy overriding
182 * of negative trust anchors. */
184 if (!set_isempty(d
->negative_by_name
))
187 r
= set_ensure_allocated(&d
->negative_by_name
, &dns_name_hash_ops
);
191 /* We add a couple of domains as default negative trust
192 * anchors, where it's very unlikely they will be installed in
193 * the root zone. If they exist they must be private, and thus
196 NULSTR_FOREACH(name
, private_domains
) {
197 if (dns_trust_anchor_knows_domain_positive(d
, name
))
200 r
= set_put_strdup(&d
->negative_by_name
, name
);
208 static int dns_trust_anchor_load_positive(DnsTrustAnchor
*d
, const char *path
, unsigned line
, const char *s
) {
209 _cleanup_(dns_resource_record_unrefp
) DnsResourceRecord
*rr
= NULL
;
210 _cleanup_free_
char *domain
= NULL
, *class = NULL
, *type
= NULL
;
211 _cleanup_(dns_answer_unrefp
) DnsAnswer
*answer
= NULL
;
212 DnsAnswer
*old_answer
= NULL
;
219 r
= extract_first_word(&p
, &domain
, NULL
, EXTRACT_UNQUOTE
);
221 return log_warning_errno(r
, "Unable to parse domain in line %s:%u: %m", path
, line
);
223 r
= dns_name_is_valid(domain
);
225 return log_warning_errno(r
, "Failed to check validity of domain name '%s', at line %s:%u, ignoring line: %m", domain
, path
, line
);
227 log_warning("Domain name %s is invalid, at line %s:%u, ignoring line.", domain
, path
, line
);
231 r
= extract_many_words(&p
, NULL
, 0, &class, &type
, NULL
);
233 return log_warning_errno(r
, "Unable to parse class and type in line %s:%u: %m", path
, line
);
235 log_warning("Missing class or type in line %s:%u", path
, line
);
239 if (!strcaseeq(class, "IN")) {
240 log_warning("RR class %s is not supported, ignoring line %s:%u.", class, path
, line
);
244 if (strcaseeq(type
, "DS")) {
245 _cleanup_free_
char *key_tag
= NULL
, *algorithm
= NULL
, *digest_type
= NULL
;
246 _cleanup_free_
void *dd
= NULL
;
251 r
= extract_many_words(&p
, NULL
, 0, &key_tag
, &algorithm
, &digest_type
, NULL
);
253 log_warning_errno(r
, "Failed to parse DS parameters on line %s:%u: %m", path
, line
);
257 log_warning("Missing DS parameters on line %s:%u", path
, line
);
261 r
= safe_atou16(key_tag
, &kt
);
263 return log_warning_errno(r
, "Failed to parse DS key tag %s on line %s:%u: %m", key_tag
, path
, line
);
265 a
= dnssec_algorithm_from_string(algorithm
);
267 log_warning("Failed to parse DS algorithm %s on line %s:%u", algorithm
, path
, line
);
271 dt
= dnssec_digest_from_string(digest_type
);
273 log_warning("Failed to parse DS digest type %s on line %s:%u", digest_type
, path
, line
);
278 log_warning("Missing DS digest on line %s:%u", path
, line
);
282 r
= unhexmem(p
, strlen(p
), &dd
, &l
);
284 log_warning("Failed to parse DS digest %s on line %s:%u", p
, path
, line
);
288 rr
= dns_resource_record_new_full(DNS_CLASS_IN
, DNS_TYPE_DS
, domain
);
293 rr
->ds
.algorithm
= a
;
294 rr
->ds
.digest_type
= dt
;
295 rr
->ds
.digest_size
= l
;
296 rr
->ds
.digest
= TAKE_PTR(dd
);
298 } else if (strcaseeq(type
, "DNSKEY")) {
299 _cleanup_free_
char *flags
= NULL
, *protocol
= NULL
, *algorithm
= NULL
;
300 _cleanup_free_
void *k
= NULL
;
305 r
= extract_many_words(&p
, NULL
, 0, &flags
, &protocol
, &algorithm
, NULL
);
307 return log_warning_errno(r
, "Failed to parse DNSKEY parameters on line %s:%u: %m", path
, line
);
309 log_warning("Missing DNSKEY parameters on line %s:%u", path
, line
);
313 if (!streq(protocol
, "3")) {
314 log_warning("DNSKEY Protocol is not 3 on line %s:%u", path
, line
);
318 r
= safe_atou16(flags
, &f
);
320 return log_warning_errno(r
, "Failed to parse DNSKEY flags field %s on line %s:%u", flags
, path
, line
);
321 if ((f
& DNSKEY_FLAG_ZONE_KEY
) == 0) {
322 log_warning("DNSKEY lacks zone key bit set on line %s:%u", path
, line
);
325 if ((f
& DNSKEY_FLAG_REVOKE
)) {
326 log_warning("DNSKEY is already revoked on line %s:%u", path
, line
);
330 a
= dnssec_algorithm_from_string(algorithm
);
332 log_warning("Failed to parse DNSKEY algorithm %s on line %s:%u", algorithm
, path
, line
);
337 log_warning("Missing DNSKEY key on line %s:%u", path
, line
);
341 r
= unbase64mem(p
, strlen(p
), &k
, &l
);
343 return log_warning_errno(r
, "Failed to parse DNSKEY key data %s on line %s:%u", p
, path
, line
);
345 rr
= dns_resource_record_new_full(DNS_CLASS_IN
, DNS_TYPE_DNSKEY
, domain
);
349 rr
->dnskey
.flags
= f
;
350 rr
->dnskey
.protocol
= 3;
351 rr
->dnskey
.algorithm
= a
;
352 rr
->dnskey
.key_size
= l
;
353 rr
->dnskey
.key
= TAKE_PTR(k
);
356 log_warning("RR type %s is not supported, ignoring line %s:%u.", type
, path
, line
);
360 r
= hashmap_ensure_allocated(&d
->positive_by_key
, &dns_resource_key_hash_ops
);
364 old_answer
= hashmap_get(d
->positive_by_key
, rr
->key
);
365 answer
= dns_answer_ref(old_answer
);
367 r
= dns_answer_add_extend(&answer
, rr
, 0, DNS_ANSWER_AUTHENTICATED
, NULL
);
369 return log_error_errno(r
, "Failed to add trust anchor RR: %m");
371 r
= hashmap_replace(d
->positive_by_key
, rr
->key
, answer
);
373 return log_error_errno(r
, "Failed to add answer to trust anchor: %m");
375 old_answer
= dns_answer_unref(old_answer
);
381 static int dns_trust_anchor_load_negative(DnsTrustAnchor
*d
, const char *path
, unsigned line
, const char *s
) {
382 _cleanup_free_
char *domain
= NULL
;
389 r
= extract_first_word(&p
, &domain
, NULL
, EXTRACT_UNQUOTE
);
391 return log_warning_errno(r
, "Unable to parse line %s:%u: %m", path
, line
);
393 r
= dns_name_is_valid(domain
);
395 return log_warning_errno(r
, "Failed to check validity of domain name '%s', at line %s:%u, ignoring line: %m", domain
, path
, line
);
397 log_warning("Domain name %s is invalid, at line %s:%u, ignoring line.", domain
, path
, line
);
402 log_warning("Trailing garbage at line %s:%u, ignoring line.", path
, line
);
406 r
= set_ensure_consume(&d
->negative_by_name
, &dns_name_hash_ops
, TAKE_PTR(domain
));
413 static int dns_trust_anchor_load_files(
416 int (*loader
)(DnsTrustAnchor
*d
, const char *path
, unsigned n
, const char *line
)) {
418 _cleanup_strv_free_
char **files
= NULL
;
425 r
= conf_files_list_nulstr(&files
, suffix
, NULL
, 0, trust_anchor_dirs
);
427 return log_error_errno(r
, "Failed to enumerate %s trust anchor files: %m", suffix
);
429 STRV_FOREACH(f
, files
) {
430 _cleanup_fclose_
FILE *g
= NULL
;
438 log_warning_errno(errno
, "Failed to open '%s', ignoring: %m", *f
);
443 _cleanup_free_
char *line
= NULL
;
445 r
= read_stripped_line(g
, LONG_LINE_MAX
, &line
);
447 log_warning_errno(r
, "Failed to read '%s', ignoring: %m", *f
);
461 (void) loader(d
, *f
, n
, line
);
468 static int domain_name_cmp(char * const *a
, char * const *b
) {
469 return dns_name_compare_func(*a
, *b
);
472 static int dns_trust_anchor_dump(DnsTrustAnchor
*d
) {
477 if (hashmap_isempty(d
->positive_by_key
))
478 log_info("No positive trust anchors defined.");
480 log_info("Positive Trust Anchors:");
481 HASHMAP_FOREACH(a
, d
->positive_by_key
) {
482 DnsResourceRecord
*rr
;
484 DNS_ANSWER_FOREACH(rr
, a
)
485 log_info("%s", dns_resource_record_to_string(rr
));
489 if (set_isempty(d
->negative_by_name
))
490 log_info("No negative trust anchors defined.");
492 _cleanup_free_
char **l
= NULL
, *j
= NULL
;
494 l
= set_get_strv(d
->negative_by_name
);
498 typesafe_qsort(l
, set_size(d
->negative_by_name
), domain_name_cmp
);
500 j
= strv_join(l
, " ");
504 log_info("Negative trust anchors: %s", j
);
510 int dns_trust_anchor_load(DnsTrustAnchor
*d
) {
515 /* If loading things from disk fails, we don't consider this fatal */
516 (void) dns_trust_anchor_load_files(d
, ".positive", dns_trust_anchor_load_positive
);
517 (void) dns_trust_anchor_load_files(d
, ".negative", dns_trust_anchor_load_negative
);
519 /* However, if the built-in DS fails, then we have a problem. */
520 r
= dns_trust_anchor_add_builtin_positive(d
);
522 return log_error_errno(r
, "Failed to add built-in positive trust anchor: %m");
524 r
= dns_trust_anchor_add_builtin_negative(d
);
526 return log_error_errno(r
, "Failed to add built-in negative trust anchor: %m");
528 dns_trust_anchor_dump(d
);
533 void dns_trust_anchor_flush(DnsTrustAnchor
*d
) {
536 d
->positive_by_key
= hashmap_free_with_destructor(d
->positive_by_key
, dns_answer_unref
);
537 d
->revoked_by_rr
= set_free_with_destructor(d
->revoked_by_rr
, dns_resource_record_unref
);
538 d
->negative_by_name
= set_free_free(d
->negative_by_name
);
541 int dns_trust_anchor_lookup_positive(DnsTrustAnchor
*d
, const DnsResourceKey
*key
, DnsAnswer
**ret
) {
548 /* We only serve DS and DNSKEY RRs. */
549 if (!IN_SET(key
->type
, DNS_TYPE_DS
, DNS_TYPE_DNSKEY
))
552 a
= hashmap_get(d
->positive_by_key
, key
);
556 *ret
= dns_answer_ref(a
);
560 int dns_trust_anchor_lookup_negative(DnsTrustAnchor
*d
, const char *name
) {
567 /* If the domain is listed as-is in the NTA database, then that counts */
568 if (set_contains(d
->negative_by_name
, name
))
571 /* If the domain isn't listed as NTA, but is listed as positive trust anchor, then that counts. See RFC
572 * 7646, section 1.1 */
573 if (hashmap_contains(d
->positive_by_key
, &DNS_RESOURCE_KEY_CONST(DNS_CLASS_IN
, DNS_TYPE_DS
, name
)))
576 if (hashmap_contains(d
->positive_by_key
, &DNS_RESOURCE_KEY_CONST(DNS_CLASS_IN
, DNS_TYPE_KEY
, name
)))
579 /* And now, let's look at the parent, and check that too */
580 r
= dns_name_parent(&name
);
590 static int dns_trust_anchor_revoked_put(DnsTrustAnchor
*d
, DnsResourceRecord
*rr
) {
595 r
= set_ensure_put(&d
->revoked_by_rr
, &dns_resource_record_hash_ops
, rr
);
599 dns_resource_record_ref(rr
);
604 static int dns_trust_anchor_remove_revoked(DnsTrustAnchor
*d
, DnsResourceRecord
*rr
) {
605 _cleanup_(dns_answer_unrefp
) DnsAnswer
*new_answer
= NULL
;
606 DnsAnswer
*old_answer
;
610 /* Remember that this is a revoked trust anchor RR */
611 r
= dns_trust_anchor_revoked_put(d
, rr
);
615 /* Remove this from the positive trust anchor */
616 old_answer
= hashmap_get(d
->positive_by_key
, rr
->key
);
620 new_answer
= dns_answer_ref(old_answer
);
622 r
= dns_answer_remove_by_rr(&new_answer
, rr
);
626 /* We found the key! Warn the user */
627 log_struct(LOG_WARNING
,
628 "MESSAGE_ID=" SD_MESSAGE_DNSSEC_TRUST_ANCHOR_REVOKED_STR
,
629 LOG_MESSAGE("DNSSEC trust anchor %s has been revoked.\n"
630 "Please update the trust anchor, or upgrade your operating system.",
631 strna(dns_resource_record_to_string(rr
))),
632 "TRUST_ANCHOR=%s", dns_resource_record_to_string(rr
));
634 if (dns_answer_size(new_answer
) <= 0) {
635 assert_se(hashmap_remove(d
->positive_by_key
, rr
->key
) == old_answer
);
636 dns_answer_unref(old_answer
);
640 item
= ordered_set_first(new_answer
->items
);
641 r
= hashmap_replace(d
->positive_by_key
, item
->rr
->key
, new_answer
);
645 TAKE_PTR(new_answer
);
646 dns_answer_unref(old_answer
);
650 static int dns_trust_anchor_check_revoked_one(DnsTrustAnchor
*d
, DnsResourceRecord
*revoked_dnskey
) {
655 assert(revoked_dnskey
);
656 assert(revoked_dnskey
->key
->type
== DNS_TYPE_DNSKEY
);
657 assert(revoked_dnskey
->dnskey
.flags
& DNSKEY_FLAG_REVOKE
);
659 a
= hashmap_get(d
->positive_by_key
, revoked_dnskey
->key
);
661 DnsResourceRecord
*anchor
;
663 /* First, look for the precise DNSKEY in our trust anchor database */
665 DNS_ANSWER_FOREACH(anchor
, a
) {
667 if (anchor
->dnskey
.protocol
!= revoked_dnskey
->dnskey
.protocol
)
670 if (anchor
->dnskey
.algorithm
!= revoked_dnskey
->dnskey
.algorithm
)
673 if (anchor
->dnskey
.key_size
!= revoked_dnskey
->dnskey
.key_size
)
676 /* Note that we allow the REVOKE bit to be
677 * different! It will be set in the revoked
678 * key, but unset in our version of it */
679 if (((anchor
->dnskey
.flags
^ revoked_dnskey
->dnskey
.flags
) | DNSKEY_FLAG_REVOKE
) != DNSKEY_FLAG_REVOKE
)
682 if (memcmp(anchor
->dnskey
.key
, revoked_dnskey
->dnskey
.key
, anchor
->dnskey
.key_size
) != 0)
685 dns_trust_anchor_remove_revoked(d
, anchor
);
690 a
= hashmap_get(d
->positive_by_key
, &DNS_RESOURCE_KEY_CONST(revoked_dnskey
->key
->class, DNS_TYPE_DS
, dns_resource_key_name(revoked_dnskey
->key
)));
692 DnsResourceRecord
*anchor
;
694 /* Second, look for DS RRs matching this DNSKEY in our trust anchor database */
696 DNS_ANSWER_FOREACH(anchor
, a
) {
698 /* We set mask_revoke to true here, since our
699 * DS fingerprint will be the one of the
700 * unrevoked DNSKEY, but the one we got passed
701 * here has the bit set. */
702 r
= dnssec_verify_dnskey_by_ds(revoked_dnskey
, anchor
, true);
708 dns_trust_anchor_remove_revoked(d
, anchor
);
716 int dns_trust_anchor_check_revoked(DnsTrustAnchor
*d
, DnsResourceRecord
*dnskey
, DnsAnswer
*rrs
) {
717 DnsResourceRecord
*rrsig
;
723 /* Looks if "dnskey" is a self-signed RR that has been revoked
724 * and matches one of our trust anchor entries. If so, removes
725 * it from the trust anchor and returns > 0. */
727 if (dnskey
->key
->type
!= DNS_TYPE_DNSKEY
)
730 /* Is this DNSKEY revoked? */
731 if ((dnskey
->dnskey
.flags
& DNSKEY_FLAG_REVOKE
) == 0)
734 /* Could this be interesting to us at all? If not,
735 * there's no point in looking for and verifying a
736 * self-signed RRSIG. */
737 if (!dns_trust_anchor_knows_domain_positive(d
, dns_resource_key_name(dnskey
->key
)))
740 /* Look for a self-signed RRSIG in the other rrs belonging to this DNSKEY */
741 DNS_ANSWER_FOREACH(rrsig
, rrs
) {
744 if (rrsig
->key
->type
!= DNS_TYPE_RRSIG
)
747 r
= dnssec_rrsig_match_dnskey(rrsig
, dnskey
, true);
753 r
= dnssec_verify_rrset(rrs
, dnskey
->key
, rrsig
, dnskey
, USEC_INFINITY
, &result
);
756 if (result
!= DNSSEC_VALIDATED
)
759 /* Bingo! This is a revoked self-signed DNSKEY. Let's
760 * see if this precise one exists in our trust anchor
762 r
= dns_trust_anchor_check_revoked_one(d
, dnskey
);
772 int dns_trust_anchor_is_revoked(DnsTrustAnchor
*d
, DnsResourceRecord
*rr
) {
775 if (!IN_SET(rr
->key
->type
, DNS_TYPE_DS
, DNS_TYPE_DNSKEY
))
778 return set_contains(d
->revoked_by_rr
, rr
);