]> git.ipfire.org Git - thirdparty/systemd.git/blob - src/resolve/resolved-dns-transaction.c
tree-wide: "unparseable" → "unparsable"
[thirdparty/systemd.git] / src / resolve / resolved-dns-transaction.c
1 /* SPDX-License-Identifier: LGPL-2.1+ */
2
3 #include "sd-messages.h"
4
5 #include "af-list.h"
6 #include "alloc-util.h"
7 #include "dns-domain.h"
8 #include "errno-list.h"
9 #include "errno-util.h"
10 #include "fd-util.h"
11 #include "random-util.h"
12 #include "resolved-dns-cache.h"
13 #include "resolved-dns-transaction.h"
14 #include "resolved-dnstls.h"
15 #include "resolved-llmnr.h"
16 #include "string-table.h"
17
18 #define TRANSACTIONS_MAX 4096
19 #define TRANSACTION_TCP_TIMEOUT_USEC (10U*USEC_PER_SEC)
20
21 /* After how much time to repeat classic DNS requests */
22 #define DNS_TIMEOUT_USEC (SD_RESOLVED_QUERY_TIMEOUT_USEC / DNS_TRANSACTION_ATTEMPTS_MAX)
23
24 static void dns_transaction_reset_answer(DnsTransaction *t) {
25 assert(t);
26
27 t->received = dns_packet_unref(t->received);
28 t->answer = dns_answer_unref(t->answer);
29 t->answer_rcode = 0;
30 t->answer_dnssec_result = _DNSSEC_RESULT_INVALID;
31 t->answer_source = _DNS_TRANSACTION_SOURCE_INVALID;
32 t->answer_authenticated = false;
33 t->answer_nsec_ttl = (uint32_t) -1;
34 t->answer_errno = 0;
35 }
36
37 static void dns_transaction_flush_dnssec_transactions(DnsTransaction *t) {
38 DnsTransaction *z;
39
40 assert(t);
41
42 while ((z = set_steal_first(t->dnssec_transactions))) {
43 set_remove(z->notify_transactions, t);
44 set_remove(z->notify_transactions_done, t);
45 dns_transaction_gc(z);
46 }
47 }
48
49 static void dns_transaction_close_connection(DnsTransaction *t) {
50 assert(t);
51
52 if (t->stream) {
53 /* Let's detach the stream from our transaction, in case something else keeps a reference to it. */
54 LIST_REMOVE(transactions_by_stream, t->stream->transactions, t);
55
56 /* Remove packet in case it's still in the queue */
57 dns_packet_unref(ordered_set_remove(t->stream->write_queue, t->sent));
58
59 t->stream = dns_stream_unref(t->stream);
60 }
61
62 t->dns_udp_event_source = sd_event_source_unref(t->dns_udp_event_source);
63 t->dns_udp_fd = safe_close(t->dns_udp_fd);
64 }
65
66 static void dns_transaction_stop_timeout(DnsTransaction *t) {
67 assert(t);
68
69 t->timeout_event_source = sd_event_source_unref(t->timeout_event_source);
70 }
71
72 DnsTransaction* dns_transaction_free(DnsTransaction *t) {
73 DnsQueryCandidate *c;
74 DnsZoneItem *i;
75 DnsTransaction *z;
76
77 if (!t)
78 return NULL;
79
80 log_debug("Freeing transaction %" PRIu16 ".", t->id);
81
82 dns_transaction_close_connection(t);
83 dns_transaction_stop_timeout(t);
84
85 dns_packet_unref(t->sent);
86 dns_transaction_reset_answer(t);
87
88 dns_server_unref(t->server);
89
90 if (t->scope) {
91 hashmap_remove_value(t->scope->transactions_by_key, t->key, t);
92 LIST_REMOVE(transactions_by_scope, t->scope->transactions, t);
93
94 if (t->id != 0)
95 hashmap_remove(t->scope->manager->dns_transactions, UINT_TO_PTR(t->id));
96 }
97
98 while ((c = set_steal_first(t->notify_query_candidates)))
99 set_remove(c->transactions, t);
100 set_free(t->notify_query_candidates);
101
102 while ((c = set_steal_first(t->notify_query_candidates_done)))
103 set_remove(c->transactions, t);
104 set_free(t->notify_query_candidates_done);
105
106 while ((i = set_steal_first(t->notify_zone_items)))
107 i->probe_transaction = NULL;
108 set_free(t->notify_zone_items);
109
110 while ((i = set_steal_first(t->notify_zone_items_done)))
111 i->probe_transaction = NULL;
112 set_free(t->notify_zone_items_done);
113
114 while ((z = set_steal_first(t->notify_transactions)))
115 set_remove(z->dnssec_transactions, t);
116 set_free(t->notify_transactions);
117
118 while ((z = set_steal_first(t->notify_transactions_done)))
119 set_remove(z->dnssec_transactions, t);
120 set_free(t->notify_transactions_done);
121
122 dns_transaction_flush_dnssec_transactions(t);
123 set_free(t->dnssec_transactions);
124
125 dns_answer_unref(t->validated_keys);
126 dns_resource_key_unref(t->key);
127
128 return mfree(t);
129 }
130
131 DEFINE_TRIVIAL_CLEANUP_FUNC(DnsTransaction*, dns_transaction_free);
132
133 bool dns_transaction_gc(DnsTransaction *t) {
134 assert(t);
135
136 if (t->block_gc > 0)
137 return true;
138
139 if (set_isempty(t->notify_query_candidates) &&
140 set_isempty(t->notify_query_candidates_done) &&
141 set_isempty(t->notify_zone_items) &&
142 set_isempty(t->notify_zone_items_done) &&
143 set_isempty(t->notify_transactions) &&
144 set_isempty(t->notify_transactions_done)) {
145 dns_transaction_free(t);
146 return false;
147 }
148
149 return true;
150 }
151
152 static uint16_t pick_new_id(Manager *m) {
153 uint16_t new_id;
154
155 /* Find a fresh, unused transaction id. Note that this loop is bounded because there's a limit on the number of
156 * transactions, and it's much lower than the space of IDs. */
157
158 assert_cc(TRANSACTIONS_MAX < 0xFFFF);
159
160 do
161 random_bytes(&new_id, sizeof(new_id));
162 while (new_id == 0 ||
163 hashmap_get(m->dns_transactions, UINT_TO_PTR(new_id)));
164
165 return new_id;
166 }
167
168 int dns_transaction_new(DnsTransaction **ret, DnsScope *s, DnsResourceKey *key) {
169 _cleanup_(dns_transaction_freep) DnsTransaction *t = NULL;
170 int r;
171
172 assert(ret);
173 assert(s);
174 assert(key);
175
176 /* Don't allow looking up invalid or pseudo RRs */
177 if (!dns_type_is_valid_query(key->type))
178 return -EINVAL;
179 if (dns_type_is_obsolete(key->type))
180 return -EOPNOTSUPP;
181
182 /* We only support the IN class */
183 if (!IN_SET(key->class, DNS_CLASS_IN, DNS_CLASS_ANY))
184 return -EOPNOTSUPP;
185
186 if (hashmap_size(s->manager->dns_transactions) >= TRANSACTIONS_MAX)
187 return -EBUSY;
188
189 r = hashmap_ensure_allocated(&s->manager->dns_transactions, NULL);
190 if (r < 0)
191 return r;
192
193 r = hashmap_ensure_allocated(&s->transactions_by_key, &dns_resource_key_hash_ops);
194 if (r < 0)
195 return r;
196
197 t = new0(DnsTransaction, 1);
198 if (!t)
199 return -ENOMEM;
200
201 t->dns_udp_fd = -1;
202 t->answer_source = _DNS_TRANSACTION_SOURCE_INVALID;
203 t->answer_dnssec_result = _DNSSEC_RESULT_INVALID;
204 t->answer_nsec_ttl = (uint32_t) -1;
205 t->key = dns_resource_key_ref(key);
206 t->current_feature_level = _DNS_SERVER_FEATURE_LEVEL_INVALID;
207 t->clamp_feature_level = _DNS_SERVER_FEATURE_LEVEL_INVALID;
208
209 t->id = pick_new_id(s->manager);
210
211 r = hashmap_put(s->manager->dns_transactions, UINT_TO_PTR(t->id), t);
212 if (r < 0) {
213 t->id = 0;
214 return r;
215 }
216
217 r = hashmap_replace(s->transactions_by_key, t->key, t);
218 if (r < 0) {
219 hashmap_remove(s->manager->dns_transactions, UINT_TO_PTR(t->id));
220 return r;
221 }
222
223 LIST_PREPEND(transactions_by_scope, s->transactions, t);
224 t->scope = s;
225
226 s->manager->n_transactions_total++;
227
228 if (ret)
229 *ret = t;
230
231 t = NULL;
232
233 return 0;
234 }
235
236 static void dns_transaction_shuffle_id(DnsTransaction *t) {
237 uint16_t new_id;
238 assert(t);
239
240 /* Pick a new ID for this transaction. */
241
242 new_id = pick_new_id(t->scope->manager);
243 assert_se(hashmap_remove_and_put(t->scope->manager->dns_transactions, UINT_TO_PTR(t->id), UINT_TO_PTR(new_id), t) >= 0);
244
245 log_debug("Transaction %" PRIu16 " is now %" PRIu16 ".", t->id, new_id);
246 t->id = new_id;
247
248 /* Make sure we generate a new packet with the new ID */
249 t->sent = dns_packet_unref(t->sent);
250 }
251
252 static void dns_transaction_tentative(DnsTransaction *t, DnsPacket *p) {
253 _cleanup_free_ char *pretty = NULL;
254 char key_str[DNS_RESOURCE_KEY_STRING_MAX];
255 DnsZoneItem *z;
256
257 assert(t);
258 assert(p);
259
260 if (manager_our_packet(t->scope->manager, p) != 0)
261 return;
262
263 (void) in_addr_to_string(p->family, &p->sender, &pretty);
264
265 log_debug("Transaction %" PRIu16 " for <%s> on scope %s on %s/%s got tentative packet from %s.",
266 t->id,
267 dns_resource_key_to_string(t->key, key_str, sizeof key_str),
268 dns_protocol_to_string(t->scope->protocol),
269 t->scope->link ? t->scope->link->ifname : "*",
270 af_to_name_short(t->scope->family),
271 strnull(pretty));
272
273 /* RFC 4795, Section 4.1 says that the peer with the
274 * lexicographically smaller IP address loses */
275 if (memcmp(&p->sender, &p->destination, FAMILY_ADDRESS_SIZE(p->family)) >= 0) {
276 log_debug("Peer has lexicographically larger IP address and thus lost in the conflict.");
277 return;
278 }
279
280 log_debug("We have the lexicographically larger IP address and thus lost in the conflict.");
281
282 t->block_gc++;
283
284 while ((z = set_first(t->notify_zone_items))) {
285 /* First, make sure the zone item drops the reference
286 * to us */
287 dns_zone_item_probe_stop(z);
288
289 /* Secondly, report this as conflict, so that we might
290 * look for a different hostname */
291 dns_zone_item_conflict(z);
292 }
293 t->block_gc--;
294
295 dns_transaction_gc(t);
296 }
297
298 void dns_transaction_complete(DnsTransaction *t, DnsTransactionState state) {
299 DnsQueryCandidate *c;
300 DnsZoneItem *z;
301 DnsTransaction *d;
302 const char *st;
303 char key_str[DNS_RESOURCE_KEY_STRING_MAX];
304
305 assert(t);
306 assert(!DNS_TRANSACTION_IS_LIVE(state));
307
308 if (state == DNS_TRANSACTION_DNSSEC_FAILED) {
309 dns_resource_key_to_string(t->key, key_str, sizeof key_str);
310
311 log_struct(LOG_NOTICE,
312 "MESSAGE_ID=" SD_MESSAGE_DNSSEC_FAILURE_STR,
313 LOG_MESSAGE("DNSSEC validation failed for question %s: %s", key_str, dnssec_result_to_string(t->answer_dnssec_result)),
314 "DNS_TRANSACTION=%" PRIu16, t->id,
315 "DNS_QUESTION=%s", key_str,
316 "DNSSEC_RESULT=%s", dnssec_result_to_string(t->answer_dnssec_result),
317 "DNS_SERVER=%s", dns_server_string(t->server),
318 "DNS_SERVER_FEATURE_LEVEL=%s", dns_server_feature_level_to_string(t->server->possible_feature_level));
319 }
320
321 /* Note that this call might invalidate the query. Callers
322 * should hence not attempt to access the query or transaction
323 * after calling this function. */
324
325 if (state == DNS_TRANSACTION_ERRNO)
326 st = errno_to_name(t->answer_errno);
327 else
328 st = dns_transaction_state_to_string(state);
329
330 log_debug("Transaction %" PRIu16 " for <%s> on scope %s on %s/%s now complete with <%s> from %s (%s).",
331 t->id,
332 dns_resource_key_to_string(t->key, key_str, sizeof key_str),
333 dns_protocol_to_string(t->scope->protocol),
334 t->scope->link ? t->scope->link->ifname : "*",
335 af_to_name_short(t->scope->family),
336 st,
337 t->answer_source < 0 ? "none" : dns_transaction_source_to_string(t->answer_source),
338 t->answer_authenticated ? "authenticated" : "unsigned");
339
340 t->state = state;
341
342 dns_transaction_close_connection(t);
343 dns_transaction_stop_timeout(t);
344
345 /* Notify all queries that are interested, but make sure the
346 * transaction isn't freed while we are still looking at it */
347 t->block_gc++;
348
349 SET_FOREACH_MOVE(c, t->notify_query_candidates_done, t->notify_query_candidates)
350 dns_query_candidate_notify(c);
351 SWAP_TWO(t->notify_query_candidates, t->notify_query_candidates_done);
352
353 SET_FOREACH_MOVE(z, t->notify_zone_items_done, t->notify_zone_items)
354 dns_zone_item_notify(z);
355 SWAP_TWO(t->notify_zone_items, t->notify_zone_items_done);
356 if (t->probing && t->state == DNS_TRANSACTION_ATTEMPTS_MAX_REACHED)
357 (void) dns_scope_announce(t->scope, false);
358
359 SET_FOREACH_MOVE(d, t->notify_transactions_done, t->notify_transactions)
360 dns_transaction_notify(d, t);
361 SWAP_TWO(t->notify_transactions, t->notify_transactions_done);
362
363 t->block_gc--;
364 dns_transaction_gc(t);
365 }
366
367 static int dns_transaction_pick_server(DnsTransaction *t) {
368 DnsServer *server;
369
370 assert(t);
371 assert(t->scope->protocol == DNS_PROTOCOL_DNS);
372
373 /* Pick a DNS server and a feature level for it. */
374
375 server = dns_scope_get_dns_server(t->scope);
376 if (!server)
377 return -ESRCH;
378
379 /* If we changed the server invalidate the feature level clamping, as the new server might have completely
380 * different properties. */
381 if (server != t->server)
382 t->clamp_feature_level = _DNS_SERVER_FEATURE_LEVEL_INVALID;
383
384 t->current_feature_level = dns_server_possible_feature_level(server);
385
386 /* Clamp the feature level if that is requested. */
387 if (t->clamp_feature_level != _DNS_SERVER_FEATURE_LEVEL_INVALID &&
388 t->current_feature_level > t->clamp_feature_level)
389 t->current_feature_level = t->clamp_feature_level;
390
391 log_debug("Using feature level %s for transaction %u.", dns_server_feature_level_to_string(t->current_feature_level), t->id);
392
393 if (server == t->server)
394 return 0;
395
396 dns_server_unref(t->server);
397 t->server = dns_server_ref(server);
398
399 t->n_picked_servers ++;
400
401 log_debug("Using DNS server %s for transaction %u.", dns_server_string(t->server), t->id);
402
403 return 1;
404 }
405
406 static void dns_transaction_retry(DnsTransaction *t, bool next_server) {
407 int r;
408
409 assert(t);
410
411 log_debug("Retrying transaction %" PRIu16 ".", t->id);
412
413 /* Before we try again, switch to a new server. */
414 if (next_server)
415 dns_scope_next_dns_server(t->scope);
416
417 r = dns_transaction_go(t);
418 if (r < 0) {
419 t->answer_errno = -r;
420 dns_transaction_complete(t, DNS_TRANSACTION_ERRNO);
421 }
422 }
423
424 static int dns_transaction_maybe_restart(DnsTransaction *t) {
425 int r;
426
427 assert(t);
428
429 /* Returns > 0 if the transaction was restarted, 0 if not */
430
431 if (!t->server)
432 return 0;
433
434 if (t->current_feature_level <= dns_server_possible_feature_level(t->server))
435 return 0;
436
437 /* The server's current feature level is lower than when we sent the original query. We learnt something from
438 the response or possibly an auxiliary DNSSEC response that we didn't know before. We take that as reason to
439 restart the whole transaction. This is a good idea to deal with servers that respond rubbish if we include
440 OPT RR or DO bit. One of these cases is documented here, for example:
441 https://open.nlnetlabs.nl/pipermail/dnssec-trigger/2014-November/000376.html */
442
443 log_debug("Server feature level is now lower than when we began our transaction. Restarting with new ID.");
444 dns_transaction_shuffle_id(t);
445
446 r = dns_transaction_go(t);
447 if (r < 0)
448 return r;
449
450 return 1;
451 }
452
453 static void on_transaction_stream_error(DnsTransaction *t, int error) {
454 assert(t);
455
456 dns_transaction_close_connection(t);
457
458 if (ERRNO_IS_DISCONNECT(error)) {
459 if (t->scope->protocol == DNS_PROTOCOL_LLMNR) {
460 /* If the LLMNR/TCP connection failed, the host doesn't support LLMNR, and we cannot answer the
461 * question on this scope. */
462 dns_transaction_complete(t, DNS_TRANSACTION_NOT_FOUND);
463 return;
464 }
465
466 dns_transaction_retry(t, true);
467 return;
468 }
469 if (error != 0) {
470 t->answer_errno = error;
471 dns_transaction_complete(t, DNS_TRANSACTION_ERRNO);
472 }
473 }
474
475 static int dns_transaction_on_stream_packet(DnsTransaction *t, DnsPacket *p) {
476 assert(t);
477 assert(p);
478
479 dns_transaction_close_connection(t);
480
481 if (dns_packet_validate_reply(p) <= 0) {
482 log_debug("Invalid TCP reply packet.");
483 dns_transaction_complete(t, DNS_TRANSACTION_INVALID_REPLY);
484 return 0;
485 }
486
487 dns_scope_check_conflicts(t->scope, p);
488
489 t->block_gc++;
490 dns_transaction_process_reply(t, p);
491 t->block_gc--;
492
493 /* If the response wasn't useful, then complete the transition
494 * now. After all, we are the worst feature set now with TCP
495 * sockets, and there's really no point in retrying. */
496 if (t->state == DNS_TRANSACTION_PENDING)
497 dns_transaction_complete(t, DNS_TRANSACTION_INVALID_REPLY);
498 else
499 dns_transaction_gc(t);
500
501 return 0;
502 }
503
504 static int on_stream_complete(DnsStream *s, int error) {
505 assert(s);
506
507 if (ERRNO_IS_DISCONNECT(error) && s->protocol != DNS_PROTOCOL_LLMNR) {
508 log_debug_errno(error, "Connection failure for DNS TCP stream: %m");
509
510 if (s->transactions) {
511 DnsTransaction *t;
512
513 t = s->transactions;
514 dns_server_packet_lost(t->server, IPPROTO_TCP, t->current_feature_level);
515 }
516 }
517
518 if (error != 0) {
519 DnsTransaction *t, *n;
520
521 LIST_FOREACH_SAFE(transactions_by_stream, t, n, s->transactions)
522 on_transaction_stream_error(t, error);
523 }
524
525 return 0;
526 }
527
528 static int on_stream_packet(DnsStream *s) {
529 _cleanup_(dns_packet_unrefp) DnsPacket *p = NULL;
530 DnsTransaction *t;
531
532 assert(s);
533
534 /* Take ownership of packet to be able to receive new packets */
535 p = dns_stream_take_read_packet(s);
536 assert(p);
537
538 t = hashmap_get(s->manager->dns_transactions, UINT_TO_PTR(DNS_PACKET_ID(p)));
539 if (t)
540 return dns_transaction_on_stream_packet(t, p);
541
542 /* Ignore incorrect transaction id as an old transaction can have been canceled. */
543 log_debug("Received unexpected TCP reply packet with id %" PRIu16 ", ignoring.", DNS_PACKET_ID(p));
544 return 0;
545 }
546
547 static uint16_t dns_port_for_feature_level(DnsServerFeatureLevel level) {
548 return DNS_SERVER_FEATURE_LEVEL_IS_TLS(level) ? 853 : 53;
549 }
550
551 static int dns_transaction_emit_tcp(DnsTransaction *t) {
552 _cleanup_(dns_stream_unrefp) DnsStream *s = NULL;
553 _cleanup_close_ int fd = -1;
554 union sockaddr_union sa;
555 DnsStreamType type;
556 int r;
557
558 assert(t);
559
560 dns_transaction_close_connection(t);
561
562 switch (t->scope->protocol) {
563
564 case DNS_PROTOCOL_DNS:
565 r = dns_transaction_pick_server(t);
566 if (r < 0)
567 return r;
568
569 if (!dns_server_dnssec_supported(t->server) && dns_type_is_dnssec(t->key->type))
570 return -EOPNOTSUPP;
571
572 r = dns_server_adjust_opt(t->server, t->sent, t->current_feature_level);
573 if (r < 0)
574 return r;
575
576 if (t->server->stream && (DNS_SERVER_FEATURE_LEVEL_IS_TLS(t->current_feature_level) == t->server->stream->encrypted))
577 s = dns_stream_ref(t->server->stream);
578 else
579 fd = dns_scope_socket_tcp(t->scope, AF_UNSPEC, NULL, t->server, dns_port_for_feature_level(t->current_feature_level), &sa);
580
581 type = DNS_STREAM_LOOKUP;
582 break;
583
584 case DNS_PROTOCOL_LLMNR:
585 /* When we already received a reply to this (but it was truncated), send to its sender address */
586 if (t->received)
587 fd = dns_scope_socket_tcp(t->scope, t->received->family, &t->received->sender, NULL, t->received->sender_port, &sa);
588 else {
589 union in_addr_union address;
590 int family = AF_UNSPEC;
591
592 /* Otherwise, try to talk to the owner of a
593 * the IP address, in case this is a reverse
594 * PTR lookup */
595
596 r = dns_name_address(dns_resource_key_name(t->key), &family, &address);
597 if (r < 0)
598 return r;
599 if (r == 0)
600 return -EINVAL;
601 if (family != t->scope->family)
602 return -ESRCH;
603
604 fd = dns_scope_socket_tcp(t->scope, family, &address, NULL, LLMNR_PORT, &sa);
605 }
606
607 type = DNS_STREAM_LLMNR_SEND;
608 break;
609
610 default:
611 return -EAFNOSUPPORT;
612 }
613
614 if (!s) {
615 if (fd < 0)
616 return fd;
617
618 r = dns_stream_new(t->scope->manager, &s, type, t->scope->protocol, fd, &sa);
619 if (r < 0)
620 return r;
621
622 fd = -1;
623
624 #if ENABLE_DNS_OVER_TLS
625 if (t->scope->protocol == DNS_PROTOCOL_DNS &&
626 DNS_SERVER_FEATURE_LEVEL_IS_TLS(t->current_feature_level)) {
627
628 assert(t->server);
629 r = dnstls_stream_connect_tls(s, t->server);
630 if (r < 0)
631 return r;
632 }
633 #endif
634
635 if (t->server) {
636 dns_server_unref_stream(t->server);
637 s->server = dns_server_ref(t->server);
638 t->server->stream = dns_stream_ref(s);
639 }
640
641 s->complete = on_stream_complete;
642 s->on_packet = on_stream_packet;
643
644 /* The interface index is difficult to determine if we are
645 * connecting to the local host, hence fill this in right away
646 * instead of determining it from the socket */
647 s->ifindex = dns_scope_ifindex(t->scope);
648 }
649
650 t->stream = TAKE_PTR(s);
651 LIST_PREPEND(transactions_by_stream, t->stream->transactions, t);
652
653 r = dns_stream_write_packet(t->stream, t->sent);
654 if (r < 0) {
655 dns_transaction_close_connection(t);
656 return r;
657 }
658
659 dns_transaction_reset_answer(t);
660
661 t->tried_stream = true;
662
663 return 0;
664 }
665
666 static void dns_transaction_cache_answer(DnsTransaction *t) {
667 assert(t);
668
669 /* For mDNS we cache whenever we get the packet, rather than
670 * in each transaction. */
671 if (!IN_SET(t->scope->protocol, DNS_PROTOCOL_DNS, DNS_PROTOCOL_LLMNR))
672 return;
673
674 /* Caching disabled? */
675 if (t->scope->manager->enable_cache == DNS_CACHE_MODE_NO)
676 return;
677
678 /* We never cache if this packet is from the local host, under
679 * the assumption that a locally running DNS server would
680 * cache this anyway, and probably knows better when to flush
681 * the cache then we could. */
682 if (!DNS_PACKET_SHALL_CACHE(t->received))
683 return;
684
685 dns_cache_put(&t->scope->cache,
686 t->scope->manager->enable_cache,
687 t->key,
688 t->answer_rcode,
689 t->answer,
690 t->answer_authenticated,
691 t->answer_nsec_ttl,
692 0,
693 t->received->family,
694 &t->received->sender);
695 }
696
697 static bool dns_transaction_dnssec_is_live(DnsTransaction *t) {
698 DnsTransaction *dt;
699 Iterator i;
700
701 assert(t);
702
703 SET_FOREACH(dt, t->dnssec_transactions, i)
704 if (DNS_TRANSACTION_IS_LIVE(dt->state))
705 return true;
706
707 return false;
708 }
709
710 static int dns_transaction_dnssec_ready(DnsTransaction *t) {
711 DnsTransaction *dt;
712 Iterator i;
713
714 assert(t);
715
716 /* Checks whether the auxiliary DNSSEC transactions of our transaction have completed, or are still
717 * ongoing. Returns 0, if we aren't ready for the DNSSEC validation, positive if we are. */
718
719 SET_FOREACH(dt, t->dnssec_transactions, i) {
720
721 switch (dt->state) {
722
723 case DNS_TRANSACTION_NULL:
724 case DNS_TRANSACTION_PENDING:
725 case DNS_TRANSACTION_VALIDATING:
726 /* Still ongoing */
727 return 0;
728
729 case DNS_TRANSACTION_RCODE_FAILURE:
730 if (!IN_SET(dt->answer_rcode, DNS_RCODE_NXDOMAIN, DNS_RCODE_SERVFAIL)) {
731 log_debug("Auxiliary DNSSEC RR query failed with rcode=%s.", dns_rcode_to_string(dt->answer_rcode));
732 goto fail;
733 }
734
735 /* Fall-through: NXDOMAIN/SERVFAIL is good enough for us. This is because some DNS servers
736 * erroneously return NXDOMAIN/SERVFAIL for empty non-terminals (Akamai...) or missing DS
737 * records (Facebook), and we need to handle that nicely, when asking for parent SOA or similar
738 * RRs to make unsigned proofs. */
739
740 case DNS_TRANSACTION_SUCCESS:
741 /* All good. */
742 break;
743
744 case DNS_TRANSACTION_DNSSEC_FAILED:
745 /* We handle DNSSEC failures different from other errors, as we care about the DNSSEC
746 * validationr result */
747
748 log_debug("Auxiliary DNSSEC RR query failed validation: %s", dnssec_result_to_string(dt->answer_dnssec_result));
749 t->answer_dnssec_result = dt->answer_dnssec_result; /* Copy error code over */
750 dns_transaction_complete(t, DNS_TRANSACTION_DNSSEC_FAILED);
751 return 0;
752
753 default:
754 log_debug("Auxiliary DNSSEC RR query failed with %s", dns_transaction_state_to_string(dt->state));
755 goto fail;
756 }
757 }
758
759 /* All is ready, we can go and validate */
760 return 1;
761
762 fail:
763 t->answer_dnssec_result = DNSSEC_FAILED_AUXILIARY;
764 dns_transaction_complete(t, DNS_TRANSACTION_DNSSEC_FAILED);
765 return 0;
766 }
767
768 static void dns_transaction_process_dnssec(DnsTransaction *t) {
769 int r;
770
771 assert(t);
772
773 /* Are there ongoing DNSSEC transactions? If so, let's wait for them. */
774 r = dns_transaction_dnssec_ready(t);
775 if (r < 0)
776 goto fail;
777 if (r == 0) /* We aren't ready yet (or one of our auxiliary transactions failed, and we shouldn't validate now */
778 return;
779
780 /* See if we learnt things from the additional DNSSEC transactions, that we didn't know before, and better
781 * restart the lookup immediately. */
782 r = dns_transaction_maybe_restart(t);
783 if (r < 0)
784 goto fail;
785 if (r > 0) /* Transaction got restarted... */
786 return;
787
788 /* All our auxiliary DNSSEC transactions are complete now. Try
789 * to validate our RRset now. */
790 r = dns_transaction_validate_dnssec(t);
791 if (r == -EBADMSG) {
792 dns_transaction_complete(t, DNS_TRANSACTION_INVALID_REPLY);
793 return;
794 }
795 if (r < 0)
796 goto fail;
797
798 if (t->answer_dnssec_result == DNSSEC_INCOMPATIBLE_SERVER &&
799 t->scope->dnssec_mode == DNSSEC_YES) {
800
801 /* We are not in automatic downgrade mode, and the server is bad. Let's try a different server, maybe
802 * that works. */
803
804 if (t->n_picked_servers < dns_scope_get_n_dns_servers(t->scope)) {
805 /* We tried fewer servers on this transaction than we know, let's try another one then */
806 dns_transaction_retry(t, true);
807 return;
808 }
809
810 /* OK, let's give up, apparently all servers we tried didn't work. */
811 dns_transaction_complete(t, DNS_TRANSACTION_DNSSEC_FAILED);
812 return;
813 }
814
815 if (!IN_SET(t->answer_dnssec_result,
816 _DNSSEC_RESULT_INVALID, /* No DNSSEC validation enabled */
817 DNSSEC_VALIDATED, /* Answer is signed and validated successfully */
818 DNSSEC_UNSIGNED, /* Answer is right-fully unsigned */
819 DNSSEC_INCOMPATIBLE_SERVER)) { /* Server does not do DNSSEC (Yay, we are downgrade attack vulnerable!) */
820 dns_transaction_complete(t, DNS_TRANSACTION_DNSSEC_FAILED);
821 return;
822 }
823
824 if (t->answer_dnssec_result == DNSSEC_INCOMPATIBLE_SERVER)
825 dns_server_warn_downgrade(t->server);
826
827 dns_transaction_cache_answer(t);
828
829 if (t->answer_rcode == DNS_RCODE_SUCCESS)
830 dns_transaction_complete(t, DNS_TRANSACTION_SUCCESS);
831 else
832 dns_transaction_complete(t, DNS_TRANSACTION_RCODE_FAILURE);
833
834 return;
835
836 fail:
837 t->answer_errno = -r;
838 dns_transaction_complete(t, DNS_TRANSACTION_ERRNO);
839 }
840
841 static int dns_transaction_has_positive_answer(DnsTransaction *t, DnsAnswerFlags *flags) {
842 int r;
843
844 assert(t);
845
846 /* Checks whether the answer is positive, i.e. either a direct
847 * answer to the question, or a CNAME/DNAME for it */
848
849 r = dns_answer_match_key(t->answer, t->key, flags);
850 if (r != 0)
851 return r;
852
853 r = dns_answer_find_cname_or_dname(t->answer, t->key, NULL, flags);
854 if (r != 0)
855 return r;
856
857 return false;
858 }
859
860 static int dns_transaction_fix_rcode(DnsTransaction *t) {
861 int r;
862
863 assert(t);
864
865 /* Fix up the RCODE to SUCCESS if we get at least one matching RR in a response. Note that this contradicts the
866 * DNS RFCs a bit. Specifically, RFC 6604 Section 3 clarifies that the RCODE shall say something about a
867 * CNAME/DNAME chain element coming after the last chain element contained in the message, and not the first
868 * one included. However, it also indicates that not all DNS servers implement this correctly. Moreover, when
869 * using DNSSEC we usually only can prove the first element of a CNAME/DNAME chain anyway, hence let's settle
870 * on always processing the RCODE as referring to the immediate look-up we do, i.e. the first element of a
871 * CNAME/DNAME chain. This way, we uniformly handle CNAME/DNAME chains, regardless if the DNS server
872 * incorrectly implements RCODE, whether DNSSEC is in use, or whether the DNS server only supplied us with an
873 * incomplete CNAME/DNAME chain.
874 *
875 * Or in other words: if we get at least one positive reply in a message we patch NXDOMAIN to become SUCCESS,
876 * and then rely on the CNAME chasing logic to figure out that there's actually a CNAME error with a new
877 * lookup. */
878
879 if (t->answer_rcode != DNS_RCODE_NXDOMAIN)
880 return 0;
881
882 r = dns_transaction_has_positive_answer(t, NULL);
883 if (r <= 0)
884 return r;
885
886 t->answer_rcode = DNS_RCODE_SUCCESS;
887 return 0;
888 }
889
890 void dns_transaction_process_reply(DnsTransaction *t, DnsPacket *p) {
891 usec_t ts;
892 int r;
893
894 assert(t);
895 assert(p);
896 assert(t->scope);
897 assert(t->scope->manager);
898
899 if (t->state != DNS_TRANSACTION_PENDING)
900 return;
901
902 /* Note that this call might invalidate the query. Callers
903 * should hence not attempt to access the query or transaction
904 * after calling this function. */
905
906 log_debug("Processing incoming packet on transaction %" PRIu16" (rcode=%s).",
907 t->id, dns_rcode_to_string(DNS_PACKET_RCODE(p)));
908
909 switch (t->scope->protocol) {
910
911 case DNS_PROTOCOL_LLMNR:
912 /* For LLMNR we will not accept any packets from other interfaces */
913
914 if (p->ifindex != dns_scope_ifindex(t->scope))
915 return;
916
917 if (p->family != t->scope->family)
918 return;
919
920 /* Tentative packets are not full responses but still
921 * useful for identifying uniqueness conflicts during
922 * probing. */
923 if (DNS_PACKET_LLMNR_T(p)) {
924 dns_transaction_tentative(t, p);
925 return;
926 }
927
928 break;
929
930 case DNS_PROTOCOL_MDNS:
931 /* For mDNS we will not accept any packets from other interfaces */
932
933 if (p->ifindex != dns_scope_ifindex(t->scope))
934 return;
935
936 if (p->family != t->scope->family)
937 return;
938
939 break;
940
941 case DNS_PROTOCOL_DNS:
942 /* Note that we do not need to verify the
943 * addresses/port numbers of incoming traffic, as we
944 * invoked connect() on our UDP socket in which case
945 * the kernel already does the needed verification for
946 * us. */
947 break;
948
949 default:
950 assert_not_reached("Invalid DNS protocol.");
951 }
952
953 if (t->received != p) {
954 dns_packet_unref(t->received);
955 t->received = dns_packet_ref(p);
956 }
957
958 t->answer_source = DNS_TRANSACTION_NETWORK;
959
960 if (p->ipproto == IPPROTO_TCP) {
961 if (DNS_PACKET_TC(p)) {
962 /* Truncated via TCP? Somebody must be fucking with us */
963 dns_transaction_complete(t, DNS_TRANSACTION_INVALID_REPLY);
964 return;
965 }
966
967 if (DNS_PACKET_ID(p) != t->id) {
968 /* Not the reply to our query? Somebody must be fucking with us */
969 dns_transaction_complete(t, DNS_TRANSACTION_INVALID_REPLY);
970 return;
971 }
972 }
973
974 assert_se(sd_event_now(t->scope->manager->event, clock_boottime_or_monotonic(), &ts) >= 0);
975
976 switch (t->scope->protocol) {
977
978 case DNS_PROTOCOL_DNS:
979 assert(t->server);
980
981 if (IN_SET(DNS_PACKET_RCODE(p), DNS_RCODE_FORMERR, DNS_RCODE_SERVFAIL, DNS_RCODE_NOTIMP)) {
982
983 /* Request failed, immediately try again with reduced features */
984
985 if (t->current_feature_level <= DNS_SERVER_FEATURE_LEVEL_UDP) {
986
987 /* This was already at UDP feature level? If so, it doesn't make sense to downgrade
988 * this transaction anymore, but let's see if it might make sense to send the request
989 * to a different DNS server instead. If not let's process the response, and accept the
990 * rcode. Note that we don't retry on TCP, since that's a suitable way to mitigate
991 * packet loss, but is not going to give us better rcodes should we actually have
992 * managed to get them already at UDP level. */
993
994 if (t->n_picked_servers < dns_scope_get_n_dns_servers(t->scope)) {
995 /* We tried fewer servers on this transaction than we know, let's try another one then */
996 dns_transaction_retry(t, true);
997 return;
998 }
999
1000 /* Give up, accept the rcode */
1001 log_debug("Server returned error: %s", dns_rcode_to_string(DNS_PACKET_RCODE(p)));
1002 break;
1003 }
1004
1005 /* Reduce this feature level by one and try again. */
1006 switch (t->current_feature_level) {
1007 case DNS_SERVER_FEATURE_LEVEL_TLS_DO:
1008 t->clamp_feature_level = DNS_SERVER_FEATURE_LEVEL_TLS_PLAIN;
1009 break;
1010 case DNS_SERVER_FEATURE_LEVEL_TLS_PLAIN + 1:
1011 /* Skip plain TLS when TLS is not supported */
1012 t->clamp_feature_level = DNS_SERVER_FEATURE_LEVEL_TLS_PLAIN - 1;
1013 break;
1014 default:
1015 t->clamp_feature_level = t->current_feature_level - 1;
1016 }
1017
1018 log_debug("Server returned error %s, retrying transaction with reduced feature level %s.",
1019 dns_rcode_to_string(DNS_PACKET_RCODE(p)),
1020 dns_server_feature_level_to_string(t->clamp_feature_level));
1021
1022 dns_transaction_retry(t, false /* use the same server */);
1023 return;
1024 }
1025
1026 if (DNS_PACKET_RCODE(p) == DNS_RCODE_REFUSED) {
1027 /* This server refused our request? If so, try again, use a different server */
1028 log_debug("Server returned REFUSED, switching servers, and retrying.");
1029 dns_transaction_retry(t, true /* pick a new server */);
1030 return;
1031 }
1032
1033 if (DNS_PACKET_TC(p))
1034 dns_server_packet_truncated(t->server, t->current_feature_level);
1035
1036 break;
1037
1038 case DNS_PROTOCOL_LLMNR:
1039 case DNS_PROTOCOL_MDNS:
1040 dns_scope_packet_received(t->scope, ts - t->start_usec);
1041 break;
1042
1043 default:
1044 assert_not_reached("Invalid DNS protocol.");
1045 }
1046
1047 if (DNS_PACKET_TC(p)) {
1048
1049 /* Truncated packets for mDNS are not allowed. Give up immediately. */
1050 if (t->scope->protocol == DNS_PROTOCOL_MDNS) {
1051 dns_transaction_complete(t, DNS_TRANSACTION_INVALID_REPLY);
1052 return;
1053 }
1054
1055 log_debug("Reply truncated, retrying via TCP.");
1056
1057 /* Response was truncated, let's try again with good old TCP */
1058 r = dns_transaction_emit_tcp(t);
1059 if (r == -ESRCH) {
1060 /* No servers found? Damn! */
1061 dns_transaction_complete(t, DNS_TRANSACTION_NO_SERVERS);
1062 return;
1063 }
1064 if (r == -EOPNOTSUPP) {
1065 /* Tried to ask for DNSSEC RRs, on a server that doesn't do DNSSEC */
1066 dns_transaction_complete(t, DNS_TRANSACTION_RR_TYPE_UNSUPPORTED);
1067 return;
1068 }
1069 if (r < 0) {
1070 /* On LLMNR, if we cannot connect to the host,
1071 * we immediately give up */
1072 if (t->scope->protocol != DNS_PROTOCOL_DNS)
1073 goto fail;
1074
1075 /* On DNS, couldn't send? Try immediately again, with a new server */
1076 dns_transaction_retry(t, true);
1077 }
1078
1079 return;
1080 }
1081
1082 /* After the superficial checks, actually parse the message. */
1083 r = dns_packet_extract(p);
1084 if (r < 0) {
1085 dns_transaction_complete(t, DNS_TRANSACTION_INVALID_REPLY);
1086 return;
1087 }
1088
1089 if (t->server) {
1090 /* Report that we successfully received a valid packet with a good rcode after we initially got a bad
1091 * rcode and subsequently downgraded the protocol */
1092
1093 if (IN_SET(DNS_PACKET_RCODE(p), DNS_RCODE_SUCCESS, DNS_RCODE_NXDOMAIN) &&
1094 t->clamp_feature_level != _DNS_SERVER_FEATURE_LEVEL_INVALID)
1095 dns_server_packet_rcode_downgrade(t->server, t->clamp_feature_level);
1096
1097 /* Report that the OPT RR was missing */
1098 if (!p->opt)
1099 dns_server_packet_bad_opt(t->server, t->current_feature_level);
1100
1101 /* Report that we successfully received a packet */
1102 dns_server_packet_received(t->server, p->ipproto, t->current_feature_level, p->size);
1103 }
1104
1105 /* See if we know things we didn't know before that indicate we better restart the lookup immediately. */
1106 r = dns_transaction_maybe_restart(t);
1107 if (r < 0)
1108 goto fail;
1109 if (r > 0) /* Transaction got restarted... */
1110 return;
1111
1112 if (IN_SET(t->scope->protocol, DNS_PROTOCOL_DNS, DNS_PROTOCOL_LLMNR, DNS_PROTOCOL_MDNS)) {
1113
1114 /* When dealing with protocols other than mDNS only consider responses with
1115 * equivalent query section to the request. For mDNS this check doesn't make
1116 * sense, because the section 6 of RFC6762 states that "Multicast DNS responses MUST NOT
1117 * contain any questions in the Question Section". */
1118 if (t->scope->protocol != DNS_PROTOCOL_MDNS) {
1119 r = dns_packet_is_reply_for(p, t->key);
1120 if (r < 0)
1121 goto fail;
1122 if (r == 0) {
1123 dns_transaction_complete(t, DNS_TRANSACTION_INVALID_REPLY);
1124 return;
1125 }
1126 }
1127
1128 /* Install the answer as answer to the transaction */
1129 dns_answer_unref(t->answer);
1130 t->answer = dns_answer_ref(p->answer);
1131 t->answer_rcode = DNS_PACKET_RCODE(p);
1132 t->answer_dnssec_result = _DNSSEC_RESULT_INVALID;
1133 t->answer_authenticated = false;
1134
1135 r = dns_transaction_fix_rcode(t);
1136 if (r < 0)
1137 goto fail;
1138
1139 /* Block GC while starting requests for additional DNSSEC RRs */
1140 t->block_gc++;
1141 r = dns_transaction_request_dnssec_keys(t);
1142 t->block_gc--;
1143
1144 /* Maybe the transaction is ready for GC'ing now? If so, free it and return. */
1145 if (!dns_transaction_gc(t))
1146 return;
1147
1148 /* Requesting additional keys might have resulted in
1149 * this transaction to fail, since the auxiliary
1150 * request failed for some reason. If so, we are not
1151 * in pending state anymore, and we should exit
1152 * quickly. */
1153 if (t->state != DNS_TRANSACTION_PENDING)
1154 return;
1155 if (r < 0)
1156 goto fail;
1157 if (r > 0) {
1158 /* There are DNSSEC transactions pending now. Update the state accordingly. */
1159 t->state = DNS_TRANSACTION_VALIDATING;
1160 dns_transaction_close_connection(t);
1161 dns_transaction_stop_timeout(t);
1162 return;
1163 }
1164 }
1165
1166 dns_transaction_process_dnssec(t);
1167 return;
1168
1169 fail:
1170 t->answer_errno = -r;
1171 dns_transaction_complete(t, DNS_TRANSACTION_ERRNO);
1172 }
1173
1174 static int on_dns_packet(sd_event_source *s, int fd, uint32_t revents, void *userdata) {
1175 _cleanup_(dns_packet_unrefp) DnsPacket *p = NULL;
1176 DnsTransaction *t = userdata;
1177 int r;
1178
1179 assert(t);
1180 assert(t->scope);
1181
1182 r = manager_recv(t->scope->manager, fd, DNS_PROTOCOL_DNS, &p);
1183 if (ERRNO_IS_DISCONNECT(-r)) {
1184 usec_t usec;
1185
1186 /* UDP connection failures get reported via ICMP and then are possibly delivered to us on the
1187 * next recvmsg(). Treat this like a lost packet. */
1188
1189 log_debug_errno(r, "Connection failure for DNS UDP packet: %m");
1190 assert_se(sd_event_now(t->scope->manager->event, clock_boottime_or_monotonic(), &usec) >= 0);
1191 dns_server_packet_lost(t->server, IPPROTO_UDP, t->current_feature_level);
1192
1193 dns_transaction_retry(t, true);
1194 return 0;
1195 }
1196 if (r < 0) {
1197 dns_transaction_complete(t, DNS_TRANSACTION_ERRNO);
1198 t->answer_errno = -r;
1199 return 0;
1200 }
1201 if (r == 0)
1202 /* Spurious wakeup without any data */
1203 return 0;
1204
1205 r = dns_packet_validate_reply(p);
1206 if (r < 0) {
1207 log_debug_errno(r, "Received invalid DNS packet as response, ignoring: %m");
1208 return 0;
1209 }
1210 if (r == 0) {
1211 log_debug("Received inappropriate DNS packet as response, ignoring.");
1212 return 0;
1213 }
1214
1215 if (DNS_PACKET_ID(p) != t->id) {
1216 log_debug("Received packet with incorrect transaction ID, ignoring.");
1217 return 0;
1218 }
1219
1220 dns_transaction_process_reply(t, p);
1221 return 0;
1222 }
1223
1224 static int dns_transaction_emit_udp(DnsTransaction *t) {
1225 int r;
1226
1227 assert(t);
1228
1229 if (t->scope->protocol == DNS_PROTOCOL_DNS) {
1230
1231 r = dns_transaction_pick_server(t);
1232 if (r < 0)
1233 return r;
1234
1235 if (t->current_feature_level < DNS_SERVER_FEATURE_LEVEL_UDP || DNS_SERVER_FEATURE_LEVEL_IS_TLS(t->current_feature_level))
1236 return -EAGAIN; /* Sorry, can't do UDP, try TCP! */
1237
1238 if (!dns_server_dnssec_supported(t->server) && dns_type_is_dnssec(t->key->type))
1239 return -EOPNOTSUPP;
1240
1241 if (r > 0 || t->dns_udp_fd < 0) { /* Server changed, or no connection yet. */
1242 int fd;
1243
1244 dns_transaction_close_connection(t);
1245
1246 fd = dns_scope_socket_udp(t->scope, t->server, 53);
1247 if (fd < 0)
1248 return fd;
1249
1250 r = sd_event_add_io(t->scope->manager->event, &t->dns_udp_event_source, fd, EPOLLIN, on_dns_packet, t);
1251 if (r < 0) {
1252 safe_close(fd);
1253 return r;
1254 }
1255
1256 (void) sd_event_source_set_description(t->dns_udp_event_source, "dns-transaction-udp");
1257 t->dns_udp_fd = fd;
1258 }
1259
1260 r = dns_server_adjust_opt(t->server, t->sent, t->current_feature_level);
1261 if (r < 0)
1262 return r;
1263 } else
1264 dns_transaction_close_connection(t);
1265
1266 r = dns_scope_emit_udp(t->scope, t->dns_udp_fd, t->sent);
1267 if (r < 0)
1268 return r;
1269
1270 dns_transaction_reset_answer(t);
1271
1272 return 0;
1273 }
1274
1275 static int on_transaction_timeout(sd_event_source *s, usec_t usec, void *userdata) {
1276 DnsTransaction *t = userdata;
1277
1278 assert(s);
1279 assert(t);
1280
1281 if (!t->initial_jitter_scheduled || t->initial_jitter_elapsed) {
1282 /* Timeout reached? Increase the timeout for the server used */
1283 switch (t->scope->protocol) {
1284
1285 case DNS_PROTOCOL_DNS:
1286 assert(t->server);
1287 dns_server_packet_lost(t->server, t->stream ? IPPROTO_TCP : IPPROTO_UDP, t->current_feature_level);
1288 break;
1289
1290 case DNS_PROTOCOL_LLMNR:
1291 case DNS_PROTOCOL_MDNS:
1292 dns_scope_packet_lost(t->scope, usec - t->start_usec);
1293 break;
1294
1295 default:
1296 assert_not_reached("Invalid DNS protocol.");
1297 }
1298
1299 if (t->initial_jitter_scheduled)
1300 t->initial_jitter_elapsed = true;
1301 }
1302
1303 log_debug("Timeout reached on transaction %" PRIu16 ".", t->id);
1304
1305 dns_transaction_retry(t, true);
1306 return 0;
1307 }
1308
1309 static usec_t transaction_get_resend_timeout(DnsTransaction *t) {
1310 assert(t);
1311 assert(t->scope);
1312
1313 switch (t->scope->protocol) {
1314
1315 case DNS_PROTOCOL_DNS:
1316
1317 /* When we do TCP, grant a much longer timeout, as in this case there's no need for us to quickly
1318 * resend, as the kernel does that anyway for us, and we really don't want to interrupt it in that
1319 * needlessly. */
1320 if (t->stream)
1321 return TRANSACTION_TCP_TIMEOUT_USEC;
1322
1323 return DNS_TIMEOUT_USEC;
1324
1325 case DNS_PROTOCOL_MDNS:
1326 assert(t->n_attempts > 0);
1327 if (t->probing)
1328 return MDNS_PROBING_INTERVAL_USEC;
1329 else
1330 return (1 << (t->n_attempts - 1)) * USEC_PER_SEC;
1331
1332 case DNS_PROTOCOL_LLMNR:
1333 return t->scope->resend_timeout;
1334
1335 default:
1336 assert_not_reached("Invalid DNS protocol.");
1337 }
1338 }
1339
1340 static int dns_transaction_prepare(DnsTransaction *t, usec_t ts) {
1341 int r;
1342
1343 assert(t);
1344
1345 dns_transaction_stop_timeout(t);
1346
1347 if (!dns_scope_network_good(t->scope)) {
1348 dns_transaction_complete(t, DNS_TRANSACTION_NETWORK_DOWN);
1349 return 0;
1350 }
1351
1352 if (t->n_attempts >= TRANSACTION_ATTEMPTS_MAX(t->scope->protocol)) {
1353 DnsTransactionState result;
1354
1355 if (t->scope->protocol == DNS_PROTOCOL_LLMNR)
1356 /* If we didn't find anything on LLMNR, it's not an error, but a failure to resolve
1357 * the name. */
1358 result = DNS_TRANSACTION_NOT_FOUND;
1359 else
1360 result = DNS_TRANSACTION_ATTEMPTS_MAX_REACHED;
1361
1362 dns_transaction_complete(t, result);
1363 return 0;
1364 }
1365
1366 if (t->scope->protocol == DNS_PROTOCOL_LLMNR && t->tried_stream) {
1367 /* If we already tried via a stream, then we don't
1368 * retry on LLMNR. See RFC 4795, Section 2.7. */
1369 dns_transaction_complete(t, DNS_TRANSACTION_ATTEMPTS_MAX_REACHED);
1370 return 0;
1371 }
1372
1373 t->n_attempts++;
1374 t->start_usec = ts;
1375
1376 dns_transaction_reset_answer(t);
1377 dns_transaction_flush_dnssec_transactions(t);
1378
1379 /* Check the trust anchor. Do so only on classic DNS, since DNSSEC does not apply otherwise. */
1380 if (t->scope->protocol == DNS_PROTOCOL_DNS) {
1381 r = dns_trust_anchor_lookup_positive(&t->scope->manager->trust_anchor, t->key, &t->answer);
1382 if (r < 0)
1383 return r;
1384 if (r > 0) {
1385 t->answer_rcode = DNS_RCODE_SUCCESS;
1386 t->answer_source = DNS_TRANSACTION_TRUST_ANCHOR;
1387 t->answer_authenticated = true;
1388 dns_transaction_complete(t, DNS_TRANSACTION_SUCCESS);
1389 return 0;
1390 }
1391
1392 if (dns_name_is_root(dns_resource_key_name(t->key)) &&
1393 t->key->type == DNS_TYPE_DS) {
1394
1395 /* Hmm, this is a request for the root DS? A
1396 * DS RR doesn't exist in the root zone, and
1397 * if our trust anchor didn't know it either,
1398 * this means we cannot do any DNSSEC logic
1399 * anymore. */
1400
1401 if (t->scope->dnssec_mode == DNSSEC_ALLOW_DOWNGRADE) {
1402 /* We are in downgrade mode. In this
1403 * case, synthesize an unsigned empty
1404 * response, so that the any lookup
1405 * depending on this one can continue
1406 * assuming there was no DS, and hence
1407 * the root zone was unsigned. */
1408
1409 t->answer_rcode = DNS_RCODE_SUCCESS;
1410 t->answer_source = DNS_TRANSACTION_TRUST_ANCHOR;
1411 t->answer_authenticated = false;
1412 dns_transaction_complete(t, DNS_TRANSACTION_SUCCESS);
1413 } else
1414 /* If we are not in downgrade mode,
1415 * then fail the lookup, because we
1416 * cannot reasonably answer it. There
1417 * might be DS RRs, but we don't know
1418 * them, and the DNS server won't tell
1419 * them to us (and even if it would,
1420 * we couldn't validate and trust them. */
1421 dns_transaction_complete(t, DNS_TRANSACTION_NO_TRUST_ANCHOR);
1422
1423 return 0;
1424 }
1425 }
1426
1427 /* Check the zone, but only if this transaction is not used
1428 * for probing or verifying a zone item. */
1429 if (set_isempty(t->notify_zone_items)) {
1430
1431 r = dns_zone_lookup(&t->scope->zone, t->key, dns_scope_ifindex(t->scope), &t->answer, NULL, NULL);
1432 if (r < 0)
1433 return r;
1434 if (r > 0) {
1435 t->answer_rcode = DNS_RCODE_SUCCESS;
1436 t->answer_source = DNS_TRANSACTION_ZONE;
1437 t->answer_authenticated = true;
1438 dns_transaction_complete(t, DNS_TRANSACTION_SUCCESS);
1439 return 0;
1440 }
1441 }
1442
1443 /* Check the cache, but only if this transaction is not used
1444 * for probing or verifying a zone item. */
1445 if (set_isempty(t->notify_zone_items)) {
1446
1447 /* Before trying the cache, let's make sure we figured out a
1448 * server to use. Should this cause a change of server this
1449 * might flush the cache. */
1450 (void) dns_scope_get_dns_server(t->scope);
1451
1452 /* Let's then prune all outdated entries */
1453 dns_cache_prune(&t->scope->cache);
1454
1455 r = dns_cache_lookup(&t->scope->cache, t->key, t->clamp_ttl, &t->answer_rcode, &t->answer, &t->answer_authenticated);
1456 if (r < 0)
1457 return r;
1458 if (r > 0) {
1459 t->answer_source = DNS_TRANSACTION_CACHE;
1460 if (t->answer_rcode == DNS_RCODE_SUCCESS)
1461 dns_transaction_complete(t, DNS_TRANSACTION_SUCCESS);
1462 else
1463 dns_transaction_complete(t, DNS_TRANSACTION_RCODE_FAILURE);
1464 return 0;
1465 }
1466 }
1467
1468 return 1;
1469 }
1470
1471 static int dns_transaction_make_packet_mdns(DnsTransaction *t) {
1472
1473 _cleanup_(dns_packet_unrefp) DnsPacket *p = NULL;
1474 bool add_known_answers = false;
1475 DnsTransaction *other;
1476 Iterator i;
1477 DnsResourceKey *tkey;
1478 _cleanup_set_free_ Set *keys = NULL;
1479 unsigned qdcount;
1480 unsigned nscount = 0;
1481 usec_t ts;
1482 int r;
1483
1484 assert(t);
1485 assert(t->scope->protocol == DNS_PROTOCOL_MDNS);
1486
1487 /* Discard any previously prepared packet, so we can start over and coalesce again */
1488 t->sent = dns_packet_unref(t->sent);
1489
1490 r = dns_packet_new_query(&p, t->scope->protocol, 0, false);
1491 if (r < 0)
1492 return r;
1493
1494 r = dns_packet_append_key(p, t->key, 0, NULL);
1495 if (r < 0)
1496 return r;
1497
1498 qdcount = 1;
1499
1500 if (dns_key_is_shared(t->key))
1501 add_known_answers = true;
1502
1503 if (t->key->type == DNS_TYPE_ANY) {
1504 r = set_ensure_put(&keys, &dns_resource_key_hash_ops, t->key);
1505 if (r < 0)
1506 return r;
1507 }
1508
1509 /*
1510 * For mDNS, we want to coalesce as many open queries in pending transactions into one single
1511 * query packet on the wire as possible. To achieve that, we iterate through all pending transactions
1512 * in our current scope, and see whether their timing constraints allow them to be sent.
1513 */
1514
1515 assert_se(sd_event_now(t->scope->manager->event, clock_boottime_or_monotonic(), &ts) >= 0);
1516
1517 LIST_FOREACH(transactions_by_scope, other, t->scope->transactions) {
1518
1519 /* Skip ourselves */
1520 if (other == t)
1521 continue;
1522
1523 if (other->state != DNS_TRANSACTION_PENDING)
1524 continue;
1525
1526 if (other->next_attempt_after > ts)
1527 continue;
1528
1529 if (qdcount >= UINT16_MAX)
1530 break;
1531
1532 r = dns_packet_append_key(p, other->key, 0, NULL);
1533
1534 /*
1535 * If we can't stuff more questions into the packet, just give up.
1536 * One of the 'other' transactions will fire later and take care of the rest.
1537 */
1538 if (r == -EMSGSIZE)
1539 break;
1540
1541 if (r < 0)
1542 return r;
1543
1544 r = dns_transaction_prepare(other, ts);
1545 if (r <= 0)
1546 continue;
1547
1548 ts += transaction_get_resend_timeout(other);
1549
1550 r = sd_event_add_time(
1551 other->scope->manager->event,
1552 &other->timeout_event_source,
1553 clock_boottime_or_monotonic(),
1554 ts, 0,
1555 on_transaction_timeout, other);
1556 if (r < 0)
1557 return r;
1558
1559 (void) sd_event_source_set_description(other->timeout_event_source, "dns-transaction-timeout");
1560
1561 other->state = DNS_TRANSACTION_PENDING;
1562 other->next_attempt_after = ts;
1563
1564 qdcount++;
1565
1566 if (dns_key_is_shared(other->key))
1567 add_known_answers = true;
1568
1569 if (other->key->type == DNS_TYPE_ANY) {
1570 r = set_ensure_put(&keys, &dns_resource_key_hash_ops, other->key);
1571 if (r < 0)
1572 return r;
1573 }
1574 }
1575
1576 DNS_PACKET_HEADER(p)->qdcount = htobe16(qdcount);
1577
1578 /* Append known answer section if we're asking for any shared record */
1579 if (add_known_answers) {
1580 r = dns_cache_export_shared_to_packet(&t->scope->cache, p);
1581 if (r < 0)
1582 return r;
1583 }
1584
1585 SET_FOREACH(tkey, keys, i) {
1586 _cleanup_(dns_answer_unrefp) DnsAnswer *answer = NULL;
1587 bool tentative;
1588
1589 r = dns_zone_lookup(&t->scope->zone, tkey, t->scope->link->ifindex, &answer, NULL, &tentative);
1590 if (r < 0)
1591 return r;
1592
1593 r = dns_packet_append_answer(p, answer);
1594 if (r < 0)
1595 return r;
1596
1597 nscount += dns_answer_size(answer);
1598 }
1599 DNS_PACKET_HEADER(p)->nscount = htobe16(nscount);
1600
1601 t->sent = TAKE_PTR(p);
1602
1603 return 0;
1604 }
1605
1606 static int dns_transaction_make_packet(DnsTransaction *t) {
1607 _cleanup_(dns_packet_unrefp) DnsPacket *p = NULL;
1608 int r;
1609
1610 assert(t);
1611
1612 if (t->scope->protocol == DNS_PROTOCOL_MDNS)
1613 return dns_transaction_make_packet_mdns(t);
1614
1615 if (t->sent)
1616 return 0;
1617
1618 r = dns_packet_new_query(&p, t->scope->protocol, 0, t->scope->dnssec_mode != DNSSEC_NO);
1619 if (r < 0)
1620 return r;
1621
1622 r = dns_packet_append_key(p, t->key, 0, NULL);
1623 if (r < 0)
1624 return r;
1625
1626 DNS_PACKET_HEADER(p)->qdcount = htobe16(1);
1627 DNS_PACKET_HEADER(p)->id = t->id;
1628
1629 t->sent = TAKE_PTR(p);
1630
1631 return 0;
1632 }
1633
1634 int dns_transaction_go(DnsTransaction *t) {
1635 usec_t ts;
1636 int r;
1637 char key_str[DNS_RESOURCE_KEY_STRING_MAX];
1638
1639 assert(t);
1640
1641 /* Returns > 0 if the transaction is now pending, returns 0 if could be processed immediately and has finished
1642 * now. */
1643
1644 assert_se(sd_event_now(t->scope->manager->event, clock_boottime_or_monotonic(), &ts) >= 0);
1645
1646 r = dns_transaction_prepare(t, ts);
1647 if (r <= 0)
1648 return r;
1649
1650 log_debug("Transaction %" PRIu16 " for <%s> scope %s on %s/%s.",
1651 t->id,
1652 dns_resource_key_to_string(t->key, key_str, sizeof key_str),
1653 dns_protocol_to_string(t->scope->protocol),
1654 t->scope->link ? t->scope->link->ifname : "*",
1655 af_to_name_short(t->scope->family));
1656
1657 if (!t->initial_jitter_scheduled &&
1658 IN_SET(t->scope->protocol, DNS_PROTOCOL_LLMNR, DNS_PROTOCOL_MDNS)) {
1659 usec_t jitter, accuracy;
1660
1661 /* RFC 4795 Section 2.7 suggests all queries should be
1662 * delayed by a random time from 0 to JITTER_INTERVAL. */
1663
1664 t->initial_jitter_scheduled = true;
1665
1666 random_bytes(&jitter, sizeof(jitter));
1667
1668 switch (t->scope->protocol) {
1669
1670 case DNS_PROTOCOL_LLMNR:
1671 jitter %= LLMNR_JITTER_INTERVAL_USEC;
1672 accuracy = LLMNR_JITTER_INTERVAL_USEC;
1673 break;
1674
1675 case DNS_PROTOCOL_MDNS:
1676 jitter %= MDNS_JITTER_RANGE_USEC;
1677 jitter += MDNS_JITTER_MIN_USEC;
1678 accuracy = MDNS_JITTER_RANGE_USEC;
1679 break;
1680 default:
1681 assert_not_reached("bad protocol");
1682 }
1683
1684 r = sd_event_add_time(
1685 t->scope->manager->event,
1686 &t->timeout_event_source,
1687 clock_boottime_or_monotonic(),
1688 ts + jitter, accuracy,
1689 on_transaction_timeout, t);
1690 if (r < 0)
1691 return r;
1692
1693 (void) sd_event_source_set_description(t->timeout_event_source, "dns-transaction-timeout");
1694
1695 t->n_attempts = 0;
1696 t->next_attempt_after = ts;
1697 t->state = DNS_TRANSACTION_PENDING;
1698
1699 log_debug("Delaying %s transaction for " USEC_FMT "us.", dns_protocol_to_string(t->scope->protocol), jitter);
1700 return 0;
1701 }
1702
1703 /* Otherwise, we need to ask the network */
1704 r = dns_transaction_make_packet(t);
1705 if (r < 0)
1706 return r;
1707
1708 if (t->scope->protocol == DNS_PROTOCOL_LLMNR &&
1709 (dns_name_endswith(dns_resource_key_name(t->key), "in-addr.arpa") > 0 ||
1710 dns_name_endswith(dns_resource_key_name(t->key), "ip6.arpa") > 0)) {
1711
1712 /* RFC 4795, Section 2.4. says reverse lookups shall
1713 * always be made via TCP on LLMNR */
1714 r = dns_transaction_emit_tcp(t);
1715 } else {
1716 /* Try via UDP, and if that fails due to large size or lack of
1717 * support try via TCP */
1718 r = dns_transaction_emit_udp(t);
1719 if (r == -EMSGSIZE)
1720 log_debug("Sending query via TCP since it is too large.");
1721 else if (r == -EAGAIN)
1722 log_debug("Sending query via TCP since UDP isn't supported.");
1723 if (IN_SET(r, -EMSGSIZE, -EAGAIN))
1724 r = dns_transaction_emit_tcp(t);
1725 }
1726
1727 if (r == -ESRCH) {
1728 /* No servers to send this to? */
1729 dns_transaction_complete(t, DNS_TRANSACTION_NO_SERVERS);
1730 return 0;
1731 }
1732 if (r == -EOPNOTSUPP) {
1733 /* Tried to ask for DNSSEC RRs, on a server that doesn't do DNSSEC */
1734 dns_transaction_complete(t, DNS_TRANSACTION_RR_TYPE_UNSUPPORTED);
1735 return 0;
1736 }
1737 if (t->scope->protocol == DNS_PROTOCOL_LLMNR && ERRNO_IS_DISCONNECT(-r)) {
1738 /* On LLMNR, if we cannot connect to a host via TCP when doing reverse lookups. This means we cannot
1739 * answer this request with this protocol. */
1740 dns_transaction_complete(t, DNS_TRANSACTION_NOT_FOUND);
1741 return 0;
1742 }
1743 if (r < 0) {
1744 if (t->scope->protocol != DNS_PROTOCOL_DNS)
1745 return r;
1746
1747 /* Couldn't send? Try immediately again, with a new server */
1748 dns_scope_next_dns_server(t->scope);
1749
1750 return dns_transaction_go(t);
1751 }
1752
1753 ts += transaction_get_resend_timeout(t);
1754
1755 r = sd_event_add_time(
1756 t->scope->manager->event,
1757 &t->timeout_event_source,
1758 clock_boottime_or_monotonic(),
1759 ts, 0,
1760 on_transaction_timeout, t);
1761 if (r < 0)
1762 return r;
1763
1764 (void) sd_event_source_set_description(t->timeout_event_source, "dns-transaction-timeout");
1765
1766 t->state = DNS_TRANSACTION_PENDING;
1767 t->next_attempt_after = ts;
1768
1769 return 1;
1770 }
1771
1772 static int dns_transaction_find_cyclic(DnsTransaction *t, DnsTransaction *aux) {
1773 DnsTransaction *n;
1774 Iterator i;
1775 int r;
1776
1777 assert(t);
1778 assert(aux);
1779
1780 /* Try to find cyclic dependencies between transaction objects */
1781
1782 if (t == aux)
1783 return 1;
1784
1785 SET_FOREACH(n, aux->dnssec_transactions, i) {
1786 r = dns_transaction_find_cyclic(t, n);
1787 if (r != 0)
1788 return r;
1789 }
1790
1791 return 0;
1792 }
1793
1794 static int dns_transaction_add_dnssec_transaction(DnsTransaction *t, DnsResourceKey *key, DnsTransaction **ret) {
1795 _cleanup_(dns_transaction_gcp) DnsTransaction *aux = NULL;
1796 int r;
1797
1798 assert(t);
1799 assert(ret);
1800 assert(key);
1801
1802 aux = dns_scope_find_transaction(t->scope, key, true);
1803 if (!aux) {
1804 r = dns_transaction_new(&aux, t->scope, key);
1805 if (r < 0)
1806 return r;
1807 } else {
1808 if (set_contains(t->dnssec_transactions, aux)) {
1809 *ret = aux;
1810 return 0;
1811 }
1812
1813 r = dns_transaction_find_cyclic(t, aux);
1814 if (r < 0)
1815 return r;
1816 if (r > 0) {
1817 char s[DNS_RESOURCE_KEY_STRING_MAX], saux[DNS_RESOURCE_KEY_STRING_MAX];
1818
1819 return log_debug_errno(SYNTHETIC_ERRNO(ELOOP),
1820 "Potential cyclic dependency, refusing to add transaction %" PRIu16 " (%s) as dependency for %" PRIu16 " (%s).",
1821 aux->id,
1822 dns_resource_key_to_string(t->key, s, sizeof s),
1823 t->id,
1824 dns_resource_key_to_string(aux->key, saux, sizeof saux));
1825 }
1826 }
1827
1828 r = set_ensure_allocated(&aux->notify_transactions_done, NULL);
1829 if (r < 0)
1830 return r;
1831
1832 r = set_ensure_put(&t->dnssec_transactions, NULL, aux);
1833 if (r < 0)
1834 return r;;
1835
1836 r = set_ensure_put(&aux->notify_transactions, NULL, t);
1837 if (r < 0) {
1838 (void) set_remove(t->dnssec_transactions, aux);
1839 return r;
1840 }
1841
1842 *ret = TAKE_PTR(aux);
1843 return 1;
1844 }
1845
1846 static int dns_transaction_request_dnssec_rr(DnsTransaction *t, DnsResourceKey *key) {
1847 _cleanup_(dns_answer_unrefp) DnsAnswer *a = NULL;
1848 DnsTransaction *aux;
1849 int r;
1850
1851 assert(t);
1852 assert(key);
1853
1854 /* Try to get the data from the trust anchor */
1855 r = dns_trust_anchor_lookup_positive(&t->scope->manager->trust_anchor, key, &a);
1856 if (r < 0)
1857 return r;
1858 if (r > 0) {
1859 r = dns_answer_extend(&t->validated_keys, a);
1860 if (r < 0)
1861 return r;
1862
1863 return 0;
1864 }
1865
1866 /* This didn't work, ask for it via the network/cache then. */
1867 r = dns_transaction_add_dnssec_transaction(t, key, &aux);
1868 if (r == -ELOOP) /* This would result in a cyclic dependency */
1869 return 0;
1870 if (r < 0)
1871 return r;
1872
1873 if (aux->state == DNS_TRANSACTION_NULL) {
1874 r = dns_transaction_go(aux);
1875 if (r < 0)
1876 return r;
1877 }
1878
1879 return 1;
1880 }
1881
1882 static int dns_transaction_negative_trust_anchor_lookup(DnsTransaction *t, const char *name) {
1883 int r;
1884
1885 assert(t);
1886
1887 /* Check whether the specified name is in the NTA
1888 * database, either in the global one, or the link-local
1889 * one. */
1890
1891 r = dns_trust_anchor_lookup_negative(&t->scope->manager->trust_anchor, name);
1892 if (r != 0)
1893 return r;
1894
1895 if (!t->scope->link)
1896 return 0;
1897
1898 return set_contains(t->scope->link->dnssec_negative_trust_anchors, name);
1899 }
1900
1901 static int dns_transaction_has_unsigned_negative_answer(DnsTransaction *t) {
1902 int r;
1903
1904 assert(t);
1905
1906 /* Checks whether the answer is negative, and lacks NSEC/NSEC3
1907 * RRs to prove it */
1908
1909 r = dns_transaction_has_positive_answer(t, NULL);
1910 if (r < 0)
1911 return r;
1912 if (r > 0)
1913 return false;
1914
1915 /* Is this key explicitly listed as a negative trust anchor?
1916 * If so, it's nothing we need to care about */
1917 r = dns_transaction_negative_trust_anchor_lookup(t, dns_resource_key_name(t->key));
1918 if (r < 0)
1919 return r;
1920 if (r > 0)
1921 return false;
1922
1923 /* The answer does not contain any RRs that match to the
1924 * question. If so, let's see if there are any NSEC/NSEC3 RRs
1925 * included. If not, the answer is unsigned. */
1926
1927 r = dns_answer_contains_nsec_or_nsec3(t->answer);
1928 if (r < 0)
1929 return r;
1930 if (r > 0)
1931 return false;
1932
1933 return true;
1934 }
1935
1936 static int dns_transaction_is_primary_response(DnsTransaction *t, DnsResourceRecord *rr) {
1937 int r;
1938
1939 assert(t);
1940 assert(rr);
1941
1942 /* Check if the specified RR is the "primary" response,
1943 * i.e. either matches the question precisely or is a
1944 * CNAME/DNAME for it. */
1945
1946 r = dns_resource_key_match_rr(t->key, rr, NULL);
1947 if (r != 0)
1948 return r;
1949
1950 return dns_resource_key_match_cname_or_dname(t->key, rr->key, NULL);
1951 }
1952
1953 static bool dns_transaction_dnssec_supported(DnsTransaction *t) {
1954 assert(t);
1955
1956 /* Checks whether our transaction's DNS server is assumed to be compatible with DNSSEC. Returns false as soon
1957 * as we changed our mind about a server, and now believe it is incompatible with DNSSEC. */
1958
1959 if (t->scope->protocol != DNS_PROTOCOL_DNS)
1960 return false;
1961
1962 /* If we have picked no server, then we are working from the cache or some other source, and DNSSEC might well
1963 * be supported, hence return true. */
1964 if (!t->server)
1965 return true;
1966
1967 /* Note that we do not check the feature level actually used for the transaction but instead the feature level
1968 * the server is known to support currently, as the transaction feature level might be lower than what the
1969 * server actually supports, since we might have downgraded this transaction's feature level because we got a
1970 * SERVFAIL earlier and wanted to check whether downgrading fixes it. */
1971
1972 return dns_server_dnssec_supported(t->server);
1973 }
1974
1975 static bool dns_transaction_dnssec_supported_full(DnsTransaction *t) {
1976 DnsTransaction *dt;
1977 Iterator i;
1978
1979 assert(t);
1980
1981 /* Checks whether our transaction our any of the auxiliary transactions couldn't do DNSSEC. */
1982
1983 if (!dns_transaction_dnssec_supported(t))
1984 return false;
1985
1986 SET_FOREACH(dt, t->dnssec_transactions, i)
1987 if (!dns_transaction_dnssec_supported(dt))
1988 return false;
1989
1990 return true;
1991 }
1992
1993 int dns_transaction_request_dnssec_keys(DnsTransaction *t) {
1994 DnsResourceRecord *rr;
1995
1996 int r;
1997
1998 assert(t);
1999
2000 /*
2001 * Retrieve all auxiliary RRs for the answer we got, so that
2002 * we can verify signatures or prove that RRs are rightfully
2003 * unsigned. Specifically:
2004 *
2005 * - For RRSIG we get the matching DNSKEY
2006 * - For DNSKEY we get the matching DS
2007 * - For unsigned SOA/NS we get the matching DS
2008 * - For unsigned CNAME/DNAME/DS we get the parent SOA RR
2009 * - For other unsigned RRs we get the matching SOA RR
2010 * - For SOA/NS queries with no matching response RR, and no NSEC/NSEC3, the DS RR
2011 * - For DS queries with no matching response RRs, and no NSEC/NSEC3, the parent's SOA RR
2012 * - For other queries with no matching response RRs, and no NSEC/NSEC3, the SOA RR
2013 */
2014
2015 if (t->scope->dnssec_mode == DNSSEC_NO)
2016 return 0;
2017 if (t->answer_source != DNS_TRANSACTION_NETWORK)
2018 return 0; /* We only need to validate stuff from the network */
2019 if (!dns_transaction_dnssec_supported(t))
2020 return 0; /* If we can't do DNSSEC anyway there's no point in getting the auxiliary RRs */
2021
2022 DNS_ANSWER_FOREACH(rr, t->answer) {
2023
2024 if (dns_type_is_pseudo(rr->key->type))
2025 continue;
2026
2027 /* If this RR is in the negative trust anchor, we don't need to validate it. */
2028 r = dns_transaction_negative_trust_anchor_lookup(t, dns_resource_key_name(rr->key));
2029 if (r < 0)
2030 return r;
2031 if (r > 0)
2032 continue;
2033
2034 switch (rr->key->type) {
2035
2036 case DNS_TYPE_RRSIG: {
2037 /* For each RRSIG we request the matching DNSKEY */
2038 _cleanup_(dns_resource_key_unrefp) DnsResourceKey *dnskey = NULL;
2039
2040 /* If this RRSIG is about a DNSKEY RR and the
2041 * signer is the same as the owner, then we
2042 * already have the DNSKEY, and we don't have
2043 * to look for more. */
2044 if (rr->rrsig.type_covered == DNS_TYPE_DNSKEY) {
2045 r = dns_name_equal(rr->rrsig.signer, dns_resource_key_name(rr->key));
2046 if (r < 0)
2047 return r;
2048 if (r > 0)
2049 continue;
2050 }
2051
2052 /* If the signer is not a parent of our
2053 * original query, then this is about an
2054 * auxiliary RRset, but not anything we asked
2055 * for. In this case we aren't interested,
2056 * because we don't want to request additional
2057 * RRs for stuff we didn't really ask for, and
2058 * also to avoid request loops, where
2059 * additional RRs from one transaction result
2060 * in another transaction whose additional RRs
2061 * point back to the original transaction, and
2062 * we deadlock. */
2063 r = dns_name_endswith(dns_resource_key_name(t->key), rr->rrsig.signer);
2064 if (r < 0)
2065 return r;
2066 if (r == 0)
2067 continue;
2068
2069 dnskey = dns_resource_key_new(rr->key->class, DNS_TYPE_DNSKEY, rr->rrsig.signer);
2070 if (!dnskey)
2071 return -ENOMEM;
2072
2073 log_debug("Requesting DNSKEY to validate transaction %" PRIu16" (%s, RRSIG with key tag: %" PRIu16 ").",
2074 t->id, dns_resource_key_name(rr->key), rr->rrsig.key_tag);
2075 r = dns_transaction_request_dnssec_rr(t, dnskey);
2076 if (r < 0)
2077 return r;
2078 break;
2079 }
2080
2081 case DNS_TYPE_DNSKEY: {
2082 /* For each DNSKEY we request the matching DS */
2083 _cleanup_(dns_resource_key_unrefp) DnsResourceKey *ds = NULL;
2084
2085 /* If the DNSKEY we are looking at is not for
2086 * zone we are interested in, nor any of its
2087 * parents, we aren't interested, and don't
2088 * request it. After all, we don't want to end
2089 * up in request loops, and want to keep
2090 * additional traffic down. */
2091
2092 r = dns_name_endswith(dns_resource_key_name(t->key), dns_resource_key_name(rr->key));
2093 if (r < 0)
2094 return r;
2095 if (r == 0)
2096 continue;
2097
2098 ds = dns_resource_key_new(rr->key->class, DNS_TYPE_DS, dns_resource_key_name(rr->key));
2099 if (!ds)
2100 return -ENOMEM;
2101
2102 log_debug("Requesting DS to validate transaction %" PRIu16" (%s, DNSKEY with key tag: %" PRIu16 ").",
2103 t->id, dns_resource_key_name(rr->key), dnssec_keytag(rr, false));
2104 r = dns_transaction_request_dnssec_rr(t, ds);
2105 if (r < 0)
2106 return r;
2107
2108 break;
2109 }
2110
2111 case DNS_TYPE_SOA:
2112 case DNS_TYPE_NS: {
2113 _cleanup_(dns_resource_key_unrefp) DnsResourceKey *ds = NULL;
2114
2115 /* For an unsigned SOA or NS, try to acquire
2116 * the matching DS RR, as we are at a zone cut
2117 * then, and whether a DS exists tells us
2118 * whether the zone is signed. Do so only if
2119 * this RR matches our original question,
2120 * however. */
2121
2122 r = dns_resource_key_match_rr(t->key, rr, NULL);
2123 if (r < 0)
2124 return r;
2125 if (r == 0) {
2126 /* Hmm, so this SOA RR doesn't match our original question. In this case, maybe this is
2127 * a negative reply, and we need the a SOA RR's TTL in order to cache a negative entry?
2128 * If so, we need to validate it, too. */
2129
2130 r = dns_answer_match_key(t->answer, t->key, NULL);
2131 if (r < 0)
2132 return r;
2133 if (r > 0) /* positive reply, we won't need the SOA and hence don't need to validate
2134 * it. */
2135 continue;
2136
2137 /* Only bother with this if the SOA/NS RR we are looking at is actually a parent of
2138 * what we are looking for, otherwise there's no value in it for us. */
2139 r = dns_name_endswith(dns_resource_key_name(t->key), dns_resource_key_name(rr->key));
2140 if (r < 0)
2141 return r;
2142 if (r == 0)
2143 continue;
2144 }
2145
2146 r = dnssec_has_rrsig(t->answer, rr->key);
2147 if (r < 0)
2148 return r;
2149 if (r > 0)
2150 continue;
2151
2152 ds = dns_resource_key_new(rr->key->class, DNS_TYPE_DS, dns_resource_key_name(rr->key));
2153 if (!ds)
2154 return -ENOMEM;
2155
2156 log_debug("Requesting DS to validate transaction %" PRIu16 " (%s, unsigned SOA/NS RRset).",
2157 t->id, dns_resource_key_name(rr->key));
2158 r = dns_transaction_request_dnssec_rr(t, ds);
2159 if (r < 0)
2160 return r;
2161
2162 break;
2163 }
2164
2165 case DNS_TYPE_DS:
2166 case DNS_TYPE_CNAME:
2167 case DNS_TYPE_DNAME: {
2168 _cleanup_(dns_resource_key_unrefp) DnsResourceKey *soa = NULL;
2169 const char *name;
2170
2171 /* CNAMEs and DNAMEs cannot be located at a
2172 * zone apex, hence ask for the parent SOA for
2173 * unsigned CNAME/DNAME RRs, maybe that's the
2174 * apex. But do all that only if this is
2175 * actually a response to our original
2176 * question.
2177 *
2178 * Similar for DS RRs, which are signed when
2179 * the parent SOA is signed. */
2180
2181 r = dns_transaction_is_primary_response(t, rr);
2182 if (r < 0)
2183 return r;
2184 if (r == 0)
2185 continue;
2186
2187 r = dnssec_has_rrsig(t->answer, rr->key);
2188 if (r < 0)
2189 return r;
2190 if (r > 0)
2191 continue;
2192
2193 r = dns_answer_has_dname_for_cname(t->answer, rr);
2194 if (r < 0)
2195 return r;
2196 if (r > 0)
2197 continue;
2198
2199 name = dns_resource_key_name(rr->key);
2200 r = dns_name_parent(&name);
2201 if (r < 0)
2202 return r;
2203 if (r == 0)
2204 continue;
2205
2206 soa = dns_resource_key_new(rr->key->class, DNS_TYPE_SOA, name);
2207 if (!soa)
2208 return -ENOMEM;
2209
2210 log_debug("Requesting parent SOA to validate transaction %" PRIu16 " (%s, unsigned CNAME/DNAME/DS RRset).",
2211 t->id, dns_resource_key_name(rr->key));
2212 r = dns_transaction_request_dnssec_rr(t, soa);
2213 if (r < 0)
2214 return r;
2215
2216 break;
2217 }
2218
2219 default: {
2220 _cleanup_(dns_resource_key_unrefp) DnsResourceKey *soa = NULL;
2221
2222 /* For other unsigned RRsets (including
2223 * NSEC/NSEC3!), look for proof the zone is
2224 * unsigned, by requesting the SOA RR of the
2225 * zone. However, do so only if they are
2226 * directly relevant to our original
2227 * question. */
2228
2229 r = dns_transaction_is_primary_response(t, rr);
2230 if (r < 0)
2231 return r;
2232 if (r == 0)
2233 continue;
2234
2235 r = dnssec_has_rrsig(t->answer, rr->key);
2236 if (r < 0)
2237 return r;
2238 if (r > 0)
2239 continue;
2240
2241 soa = dns_resource_key_new(rr->key->class, DNS_TYPE_SOA, dns_resource_key_name(rr->key));
2242 if (!soa)
2243 return -ENOMEM;
2244
2245 log_debug("Requesting SOA to validate transaction %" PRIu16 " (%s, unsigned non-SOA/NS RRset <%s>).",
2246 t->id, dns_resource_key_name(rr->key), dns_resource_record_to_string(rr));
2247 r = dns_transaction_request_dnssec_rr(t, soa);
2248 if (r < 0)
2249 return r;
2250 break;
2251 }}
2252 }
2253
2254 /* Above, we requested everything necessary to validate what
2255 * we got. Now, let's request what we need to validate what we
2256 * didn't get... */
2257
2258 r = dns_transaction_has_unsigned_negative_answer(t);
2259 if (r < 0)
2260 return r;
2261 if (r > 0) {
2262 const char *name;
2263 uint16_t type = 0;
2264
2265 name = dns_resource_key_name(t->key);
2266
2267 /* If this was a SOA or NS request, then check if there's a DS RR for the same domain. Note that this
2268 * could also be used as indication that we are not at a zone apex, but in real world setups there are
2269 * too many broken DNS servers (Hello, incapdns.net!) where non-terminal zones return NXDOMAIN even
2270 * though they have further children. If this was a DS request, then it's signed when the parent zone
2271 * is signed, hence ask the parent SOA in that case. If this was any other RR then ask for the SOA RR,
2272 * to see if that is signed. */
2273
2274 if (t->key->type == DNS_TYPE_DS) {
2275 r = dns_name_parent(&name);
2276 if (r > 0) {
2277 type = DNS_TYPE_SOA;
2278 log_debug("Requesting parent SOA (→ %s) to validate transaction %" PRIu16 " (%s, unsigned empty DS response).",
2279 name, t->id, dns_resource_key_name(t->key));
2280 } else
2281 name = NULL;
2282
2283 } else if (IN_SET(t->key->type, DNS_TYPE_SOA, DNS_TYPE_NS)) {
2284
2285 type = DNS_TYPE_DS;
2286 log_debug("Requesting DS (→ %s) to validate transaction %" PRIu16 " (%s, unsigned empty SOA/NS response).",
2287 name, t->id, name);
2288
2289 } else {
2290 type = DNS_TYPE_SOA;
2291 log_debug("Requesting SOA (→ %s) to validate transaction %" PRIu16 " (%s, unsigned empty non-SOA/NS/DS response).",
2292 name, t->id, name);
2293 }
2294
2295 if (name) {
2296 _cleanup_(dns_resource_key_unrefp) DnsResourceKey *soa = NULL;
2297
2298 soa = dns_resource_key_new(t->key->class, type, name);
2299 if (!soa)
2300 return -ENOMEM;
2301
2302 r = dns_transaction_request_dnssec_rr(t, soa);
2303 if (r < 0)
2304 return r;
2305 }
2306 }
2307
2308 return dns_transaction_dnssec_is_live(t);
2309 }
2310
2311 void dns_transaction_notify(DnsTransaction *t, DnsTransaction *source) {
2312 assert(t);
2313 assert(source);
2314
2315 /* Invoked whenever any of our auxiliary DNSSEC transactions completed its work. If the state is still PENDING,
2316 we are still in the loop that adds further DNSSEC transactions, hence don't check if we are ready yet. If
2317 the state is VALIDATING however, we should check if we are complete now. */
2318
2319 if (t->state == DNS_TRANSACTION_VALIDATING)
2320 dns_transaction_process_dnssec(t);
2321 }
2322
2323 static int dns_transaction_validate_dnskey_by_ds(DnsTransaction *t) {
2324 DnsResourceRecord *rr;
2325 int ifindex, r;
2326
2327 assert(t);
2328
2329 /* Add all DNSKEY RRs from the answer that are validated by DS
2330 * RRs from the list of validated keys to the list of
2331 * validated keys. */
2332
2333 DNS_ANSWER_FOREACH_IFINDEX(rr, ifindex, t->answer) {
2334
2335 r = dnssec_verify_dnskey_by_ds_search(rr, t->validated_keys);
2336 if (r < 0)
2337 return r;
2338 if (r == 0)
2339 continue;
2340
2341 /* If so, the DNSKEY is validated too. */
2342 r = dns_answer_add_extend(&t->validated_keys, rr, ifindex, DNS_ANSWER_AUTHENTICATED);
2343 if (r < 0)
2344 return r;
2345 }
2346
2347 return 0;
2348 }
2349
2350 static int dns_transaction_requires_rrsig(DnsTransaction *t, DnsResourceRecord *rr) {
2351 int r;
2352
2353 assert(t);
2354 assert(rr);
2355
2356 /* Checks if the RR we are looking for must be signed with an
2357 * RRSIG. This is used for positive responses. */
2358
2359 if (t->scope->dnssec_mode == DNSSEC_NO)
2360 return false;
2361
2362 if (dns_type_is_pseudo(rr->key->type))
2363 return -EINVAL;
2364
2365 r = dns_transaction_negative_trust_anchor_lookup(t, dns_resource_key_name(rr->key));
2366 if (r < 0)
2367 return r;
2368 if (r > 0)
2369 return false;
2370
2371 switch (rr->key->type) {
2372
2373 case DNS_TYPE_RRSIG:
2374 /* RRSIGs are the signatures themselves, they need no signing. */
2375 return false;
2376
2377 case DNS_TYPE_SOA:
2378 case DNS_TYPE_NS: {
2379 DnsTransaction *dt;
2380 Iterator i;
2381
2382 /* For SOA or NS RRs we look for a matching DS transaction */
2383
2384 SET_FOREACH(dt, t->dnssec_transactions, i) {
2385
2386 if (dt->key->class != rr->key->class)
2387 continue;
2388 if (dt->key->type != DNS_TYPE_DS)
2389 continue;
2390
2391 r = dns_name_equal(dns_resource_key_name(dt->key), dns_resource_key_name(rr->key));
2392 if (r < 0)
2393 return r;
2394 if (r == 0)
2395 continue;
2396
2397 /* We found a DS transactions for the SOA/NS
2398 * RRs we are looking at. If it discovered signed DS
2399 * RRs, then we need to be signed, too. */
2400
2401 if (!dt->answer_authenticated)
2402 return false;
2403
2404 return dns_answer_match_key(dt->answer, dt->key, NULL);
2405 }
2406
2407 /* We found nothing that proves this is safe to leave
2408 * this unauthenticated, hence ask inist on
2409 * authentication. */
2410 return true;
2411 }
2412
2413 case DNS_TYPE_DS:
2414 case DNS_TYPE_CNAME:
2415 case DNS_TYPE_DNAME: {
2416 const char *parent = NULL;
2417 DnsTransaction *dt;
2418 Iterator i;
2419
2420 /*
2421 * CNAME/DNAME RRs cannot be located at a zone apex, hence look directly for the parent SOA.
2422 *
2423 * DS RRs are signed if the parent is signed, hence also look at the parent SOA
2424 */
2425
2426 SET_FOREACH(dt, t->dnssec_transactions, i) {
2427
2428 if (dt->key->class != rr->key->class)
2429 continue;
2430 if (dt->key->type != DNS_TYPE_SOA)
2431 continue;
2432
2433 if (!parent) {
2434 parent = dns_resource_key_name(rr->key);
2435 r = dns_name_parent(&parent);
2436 if (r < 0)
2437 return r;
2438 if (r == 0) {
2439 if (rr->key->type == DNS_TYPE_DS)
2440 return true;
2441
2442 /* A CNAME/DNAME without a parent? That's sooo weird. */
2443 return log_debug_errno(SYNTHETIC_ERRNO(EBADMSG),
2444 "Transaction %" PRIu16 " claims CNAME/DNAME at root. Refusing.", t->id);
2445 }
2446 }
2447
2448 r = dns_name_equal(dns_resource_key_name(dt->key), parent);
2449 if (r < 0)
2450 return r;
2451 if (r == 0)
2452 continue;
2453
2454 return t->answer_authenticated;
2455 }
2456
2457 return true;
2458 }
2459
2460 default: {
2461 DnsTransaction *dt;
2462 Iterator i;
2463
2464 /* Any other kind of RR (including DNSKEY/NSEC/NSEC3). Let's see if our SOA lookup was authenticated */
2465
2466 SET_FOREACH(dt, t->dnssec_transactions, i) {
2467
2468 if (dt->key->class != rr->key->class)
2469 continue;
2470 if (dt->key->type != DNS_TYPE_SOA)
2471 continue;
2472
2473 r = dns_name_equal(dns_resource_key_name(dt->key), dns_resource_key_name(rr->key));
2474 if (r < 0)
2475 return r;
2476 if (r == 0)
2477 continue;
2478
2479 /* We found the transaction that was supposed to find
2480 * the SOA RR for us. It was successful, but found no
2481 * RR for us. This means we are not at a zone cut. In
2482 * this case, we require authentication if the SOA
2483 * lookup was authenticated too. */
2484 return t->answer_authenticated;
2485 }
2486
2487 return true;
2488 }}
2489 }
2490
2491 static int dns_transaction_in_private_tld(DnsTransaction *t, const DnsResourceKey *key) {
2492 DnsTransaction *dt;
2493 const char *tld;
2494 Iterator i;
2495 int r;
2496
2497 /* If DNSSEC downgrade mode is on, checks whether the
2498 * specified RR is one level below a TLD we have proven not to
2499 * exist. In such a case we assume that this is a private
2500 * domain, and permit it.
2501 *
2502 * This detects cases like the Fritz!Box router networks. Each
2503 * Fritz!Box router serves a private "fritz.box" zone, in the
2504 * non-existing TLD "box". Requests for the "fritz.box" domain
2505 * are served by the router itself, while requests for the
2506 * "box" domain will result in NXDOMAIN.
2507 *
2508 * Note that this logic is unable to detect cases where a
2509 * router serves a private DNS zone directly under
2510 * non-existing TLD. In such a case we cannot detect whether
2511 * the TLD is supposed to exist or not, as all requests we
2512 * make for it will be answered by the router's zone, and not
2513 * by the root zone. */
2514
2515 assert(t);
2516
2517 if (t->scope->dnssec_mode != DNSSEC_ALLOW_DOWNGRADE)
2518 return false; /* In strict DNSSEC mode what doesn't exist, doesn't exist */
2519
2520 tld = dns_resource_key_name(key);
2521 r = dns_name_parent(&tld);
2522 if (r < 0)
2523 return r;
2524 if (r == 0)
2525 return false; /* Already the root domain */
2526
2527 if (!dns_name_is_single_label(tld))
2528 return false;
2529
2530 SET_FOREACH(dt, t->dnssec_transactions, i) {
2531
2532 if (dt->key->class != key->class)
2533 continue;
2534
2535 r = dns_name_equal(dns_resource_key_name(dt->key), tld);
2536 if (r < 0)
2537 return r;
2538 if (r == 0)
2539 continue;
2540
2541 /* We found an auxiliary lookup we did for the TLD. If
2542 * that returned with NXDOMAIN, we know the TLD didn't
2543 * exist, and hence this might be a private zone. */
2544
2545 return dt->answer_rcode == DNS_RCODE_NXDOMAIN;
2546 }
2547
2548 return false;
2549 }
2550
2551 static int dns_transaction_requires_nsec(DnsTransaction *t) {
2552 char key_str[DNS_RESOURCE_KEY_STRING_MAX];
2553 DnsTransaction *dt;
2554 const char *name;
2555 uint16_t type = 0;
2556 Iterator i;
2557 int r;
2558
2559 assert(t);
2560
2561 /* Checks if we need to insist on NSEC/NSEC3 RRs for proving
2562 * this negative reply */
2563
2564 if (t->scope->dnssec_mode == DNSSEC_NO)
2565 return false;
2566
2567 if (dns_type_is_pseudo(t->key->type))
2568 return -EINVAL;
2569
2570 r = dns_transaction_negative_trust_anchor_lookup(t, dns_resource_key_name(t->key));
2571 if (r < 0)
2572 return r;
2573 if (r > 0)
2574 return false;
2575
2576 r = dns_transaction_in_private_tld(t, t->key);
2577 if (r < 0)
2578 return r;
2579 if (r > 0) {
2580 /* The lookup is from a TLD that is proven not to
2581 * exist, and we are in downgrade mode, hence ignore
2582 * that fact that we didn't get any NSEC RRs. */
2583
2584 log_info("Detected a negative query %s in a private DNS zone, permitting unsigned response.",
2585 dns_resource_key_to_string(t->key, key_str, sizeof key_str));
2586 return false;
2587 }
2588
2589 name = dns_resource_key_name(t->key);
2590
2591 if (t->key->type == DNS_TYPE_DS) {
2592
2593 /* We got a negative reply for this DS lookup? DS RRs are signed when their parent zone is signed,
2594 * hence check the parent SOA in this case. */
2595
2596 r = dns_name_parent(&name);
2597 if (r < 0)
2598 return r;
2599 if (r == 0)
2600 return true;
2601
2602 type = DNS_TYPE_SOA;
2603
2604 } else if (IN_SET(t->key->type, DNS_TYPE_SOA, DNS_TYPE_NS))
2605 /* We got a negative reply for this SOA/NS lookup? If so, check if there's a DS RR for this */
2606 type = DNS_TYPE_DS;
2607 else
2608 /* For all other negative replies, check for the SOA lookup */
2609 type = DNS_TYPE_SOA;
2610
2611 /* For all other RRs we check the SOA on the same level to see
2612 * if it's signed. */
2613
2614 SET_FOREACH(dt, t->dnssec_transactions, i) {
2615
2616 if (dt->key->class != t->key->class)
2617 continue;
2618 if (dt->key->type != type)
2619 continue;
2620
2621 r = dns_name_equal(dns_resource_key_name(dt->key), name);
2622 if (r < 0)
2623 return r;
2624 if (r == 0)
2625 continue;
2626
2627 return dt->answer_authenticated;
2628 }
2629
2630 /* If in doubt, require NSEC/NSEC3 */
2631 return true;
2632 }
2633
2634 static int dns_transaction_dnskey_authenticated(DnsTransaction *t, DnsResourceRecord *rr) {
2635 DnsResourceRecord *rrsig;
2636 bool found = false;
2637 int r;
2638
2639 /* Checks whether any of the DNSKEYs used for the RRSIGs for
2640 * the specified RRset is authenticated (i.e. has a matching
2641 * DS RR). */
2642
2643 r = dns_transaction_negative_trust_anchor_lookup(t, dns_resource_key_name(rr->key));
2644 if (r < 0)
2645 return r;
2646 if (r > 0)
2647 return false;
2648
2649 DNS_ANSWER_FOREACH(rrsig, t->answer) {
2650 DnsTransaction *dt;
2651 Iterator i;
2652
2653 r = dnssec_key_match_rrsig(rr->key, rrsig);
2654 if (r < 0)
2655 return r;
2656 if (r == 0)
2657 continue;
2658
2659 SET_FOREACH(dt, t->dnssec_transactions, i) {
2660
2661 if (dt->key->class != rr->key->class)
2662 continue;
2663
2664 if (dt->key->type == DNS_TYPE_DNSKEY) {
2665
2666 r = dns_name_equal(dns_resource_key_name(dt->key), rrsig->rrsig.signer);
2667 if (r < 0)
2668 return r;
2669 if (r == 0)
2670 continue;
2671
2672 /* OK, we found an auxiliary DNSKEY
2673 * lookup. If that lookup is
2674 * authenticated, report this. */
2675
2676 if (dt->answer_authenticated)
2677 return true;
2678
2679 found = true;
2680
2681 } else if (dt->key->type == DNS_TYPE_DS) {
2682
2683 r = dns_name_equal(dns_resource_key_name(dt->key), rrsig->rrsig.signer);
2684 if (r < 0)
2685 return r;
2686 if (r == 0)
2687 continue;
2688
2689 /* OK, we found an auxiliary DS
2690 * lookup. If that lookup is
2691 * authenticated and non-zero, we
2692 * won! */
2693
2694 if (!dt->answer_authenticated)
2695 return false;
2696
2697 return dns_answer_match_key(dt->answer, dt->key, NULL);
2698 }
2699 }
2700 }
2701
2702 return found ? false : -ENXIO;
2703 }
2704
2705 static int dns_transaction_known_signed(DnsTransaction *t, DnsResourceRecord *rr) {
2706 assert(t);
2707 assert(rr);
2708
2709 /* We know that the root domain is signed, hence if it appears
2710 * not to be signed, there's a problem with the DNS server */
2711
2712 return rr->key->class == DNS_CLASS_IN &&
2713 dns_name_is_root(dns_resource_key_name(rr->key));
2714 }
2715
2716 static int dns_transaction_check_revoked_trust_anchors(DnsTransaction *t) {
2717 DnsResourceRecord *rr;
2718 int r;
2719
2720 assert(t);
2721
2722 /* Maybe warn the user that we encountered a revoked DNSKEY
2723 * for a key from our trust anchor. Note that we don't care
2724 * whether the DNSKEY can be authenticated or not. It's
2725 * sufficient if it is self-signed. */
2726
2727 DNS_ANSWER_FOREACH(rr, t->answer) {
2728 r = dns_trust_anchor_check_revoked(&t->scope->manager->trust_anchor, rr, t->answer);
2729 if (r < 0)
2730 return r;
2731 }
2732
2733 return 0;
2734 }
2735
2736 static int dns_transaction_invalidate_revoked_keys(DnsTransaction *t) {
2737 bool changed;
2738 int r;
2739
2740 assert(t);
2741
2742 /* Removes all DNSKEY/DS objects from t->validated_keys that
2743 * our trust anchors database considers revoked. */
2744
2745 do {
2746 DnsResourceRecord *rr;
2747
2748 changed = false;
2749
2750 DNS_ANSWER_FOREACH(rr, t->validated_keys) {
2751 r = dns_trust_anchor_is_revoked(&t->scope->manager->trust_anchor, rr);
2752 if (r < 0)
2753 return r;
2754 if (r > 0) {
2755 r = dns_answer_remove_by_rr(&t->validated_keys, rr);
2756 if (r < 0)
2757 return r;
2758
2759 assert(r > 0);
2760 changed = true;
2761 break;
2762 }
2763 }
2764 } while (changed);
2765
2766 return 0;
2767 }
2768
2769 static int dns_transaction_copy_validated(DnsTransaction *t) {
2770 DnsTransaction *dt;
2771 Iterator i;
2772 int r;
2773
2774 assert(t);
2775
2776 /* Copy all validated RRs from the auxiliary DNSSEC transactions into our set of validated RRs */
2777
2778 SET_FOREACH(dt, t->dnssec_transactions, i) {
2779
2780 if (DNS_TRANSACTION_IS_LIVE(dt->state))
2781 continue;
2782
2783 if (!dt->answer_authenticated)
2784 continue;
2785
2786 r = dns_answer_extend(&t->validated_keys, dt->answer);
2787 if (r < 0)
2788 return r;
2789 }
2790
2791 return 0;
2792 }
2793
2794 typedef enum {
2795 DNSSEC_PHASE_DNSKEY, /* Phase #1, only validate DNSKEYs */
2796 DNSSEC_PHASE_NSEC, /* Phase #2, only validate NSEC+NSEC3 */
2797 DNSSEC_PHASE_ALL, /* Phase #3, validate everything else */
2798 } Phase;
2799
2800 static int dnssec_validate_records(
2801 DnsTransaction *t,
2802 Phase phase,
2803 bool *have_nsec,
2804 DnsAnswer **validated) {
2805
2806 DnsResourceRecord *rr;
2807 int r;
2808
2809 /* Returns negative on error, 0 if validation failed, 1 to restart validation, 2 when finished. */
2810
2811 DNS_ANSWER_FOREACH(rr, t->answer) {
2812 DnsResourceRecord *rrsig = NULL;
2813 DnssecResult result;
2814
2815 switch (rr->key->type) {
2816 case DNS_TYPE_RRSIG:
2817 continue;
2818
2819 case DNS_TYPE_DNSKEY:
2820 /* We validate DNSKEYs only in the DNSKEY and ALL phases */
2821 if (phase == DNSSEC_PHASE_NSEC)
2822 continue;
2823 break;
2824
2825 case DNS_TYPE_NSEC:
2826 case DNS_TYPE_NSEC3:
2827 *have_nsec = true;
2828
2829 /* We validate NSEC/NSEC3 only in the NSEC and ALL phases */
2830 if (phase == DNSSEC_PHASE_DNSKEY)
2831 continue;
2832 break;
2833
2834 default:
2835 /* We validate all other RRs only in the ALL phases */
2836 if (phase != DNSSEC_PHASE_ALL)
2837 continue;
2838 }
2839
2840 r = dnssec_verify_rrset_search(t->answer, rr->key, t->validated_keys, USEC_INFINITY, &result, &rrsig);
2841 if (r < 0)
2842 return r;
2843
2844 log_debug("Looking at %s: %s", strna(dns_resource_record_to_string(rr)), dnssec_result_to_string(result));
2845
2846 if (result == DNSSEC_VALIDATED) {
2847
2848 if (rr->key->type == DNS_TYPE_DNSKEY) {
2849 /* If we just validated a DNSKEY RRset, then let's add these keys to
2850 * the set of validated keys for this transaction. */
2851
2852 r = dns_answer_copy_by_key(&t->validated_keys, t->answer, rr->key, DNS_ANSWER_AUTHENTICATED);
2853 if (r < 0)
2854 return r;
2855
2856 /* Some of the DNSKEYs we just added might already have been revoked,
2857 * remove them again in that case. */
2858 r = dns_transaction_invalidate_revoked_keys(t);
2859 if (r < 0)
2860 return r;
2861 }
2862
2863 /* Add the validated RRset to the new list of validated
2864 * RRsets, and remove it from the unvalidated RRsets.
2865 * We mark the RRset as authenticated and cacheable. */
2866 r = dns_answer_move_by_key(validated, &t->answer, rr->key, DNS_ANSWER_AUTHENTICATED|DNS_ANSWER_CACHEABLE);
2867 if (r < 0)
2868 return r;
2869
2870 manager_dnssec_verdict(t->scope->manager, DNSSEC_SECURE, rr->key);
2871
2872 /* Exit the loop, we dropped something from the answer, start from the beginning */
2873 return 1;
2874 }
2875
2876 /* If we haven't read all DNSKEYs yet a negative result of the validation is irrelevant, as
2877 * there might be more DNSKEYs coming. Similar, if we haven't read all NSEC/NSEC3 RRs yet,
2878 * we cannot do positive wildcard proofs yet, as those require the NSEC/NSEC3 RRs. */
2879 if (phase != DNSSEC_PHASE_ALL)
2880 continue;
2881
2882 if (result == DNSSEC_VALIDATED_WILDCARD) {
2883 bool authenticated = false;
2884 const char *source;
2885
2886 /* This RRset validated, but as a wildcard. This means we need
2887 * to prove via NSEC/NSEC3 that no matching non-wildcard RR exists. */
2888
2889 /* First step, determine the source of synthesis */
2890 r = dns_resource_record_source(rrsig, &source);
2891 if (r < 0)
2892 return r;
2893
2894 r = dnssec_test_positive_wildcard(*validated,
2895 dns_resource_key_name(rr->key),
2896 source,
2897 rrsig->rrsig.signer,
2898 &authenticated);
2899
2900 /* Unless the NSEC proof showed that the key really doesn't exist something is off. */
2901 if (r == 0)
2902 result = DNSSEC_INVALID;
2903 else {
2904 r = dns_answer_move_by_key(validated, &t->answer, rr->key,
2905 authenticated ? (DNS_ANSWER_AUTHENTICATED|DNS_ANSWER_CACHEABLE) : 0);
2906 if (r < 0)
2907 return r;
2908
2909 manager_dnssec_verdict(t->scope->manager, authenticated ? DNSSEC_SECURE : DNSSEC_INSECURE, rr->key);
2910
2911 /* Exit the loop, we dropped something from the answer, start from the beginning */
2912 return 1;
2913 }
2914 }
2915
2916 if (result == DNSSEC_NO_SIGNATURE) {
2917 r = dns_transaction_requires_rrsig(t, rr);
2918 if (r < 0)
2919 return r;
2920 if (r == 0) {
2921 /* Data does not require signing. In that case, just copy it over,
2922 * but remember that this is by no means authenticated. */
2923 r = dns_answer_move_by_key(validated, &t->answer, rr->key, 0);
2924 if (r < 0)
2925 return r;
2926
2927 manager_dnssec_verdict(t->scope->manager, DNSSEC_INSECURE, rr->key);
2928 return 1;
2929 }
2930
2931 r = dns_transaction_known_signed(t, rr);
2932 if (r < 0)
2933 return r;
2934 if (r > 0) {
2935 /* This is an RR we know has to be signed. If it isn't this means
2936 * the server is not attaching RRSIGs, hence complain. */
2937
2938 dns_server_packet_rrsig_missing(t->server, t->current_feature_level);
2939
2940 if (t->scope->dnssec_mode == DNSSEC_ALLOW_DOWNGRADE) {
2941
2942 /* Downgrading is OK? If so, just consider the information unsigned */
2943
2944 r = dns_answer_move_by_key(validated, &t->answer, rr->key, 0);
2945 if (r < 0)
2946 return r;
2947
2948 manager_dnssec_verdict(t->scope->manager, DNSSEC_INSECURE, rr->key);
2949 return 1;
2950 }
2951
2952 /* Otherwise, fail */
2953 t->answer_dnssec_result = DNSSEC_INCOMPATIBLE_SERVER;
2954 return 0;
2955 }
2956
2957 r = dns_transaction_in_private_tld(t, rr->key);
2958 if (r < 0)
2959 return r;
2960 if (r > 0) {
2961 char s[DNS_RESOURCE_KEY_STRING_MAX];
2962
2963 /* The data is from a TLD that is proven not to exist, and we are in downgrade
2964 * mode, hence ignore the fact that this was not signed. */
2965
2966 log_info("Detected RRset %s is in a private DNS zone, permitting unsigned RRs.",
2967 dns_resource_key_to_string(rr->key, s, sizeof s));
2968
2969 r = dns_answer_move_by_key(validated, &t->answer, rr->key, 0);
2970 if (r < 0)
2971 return r;
2972
2973 manager_dnssec_verdict(t->scope->manager, DNSSEC_INSECURE, rr->key);
2974 return 1;
2975 }
2976 }
2977
2978 if (IN_SET(result,
2979 DNSSEC_MISSING_KEY,
2980 DNSSEC_SIGNATURE_EXPIRED,
2981 DNSSEC_UNSUPPORTED_ALGORITHM)) {
2982
2983 r = dns_transaction_dnskey_authenticated(t, rr);
2984 if (r < 0 && r != -ENXIO)
2985 return r;
2986 if (r == 0) {
2987 /* The DNSKEY transaction was not authenticated, this means there's
2988 * no DS for this, which means it's OK if no keys are found for this signature. */
2989
2990 r = dns_answer_move_by_key(validated, &t->answer, rr->key, 0);
2991 if (r < 0)
2992 return r;
2993
2994 manager_dnssec_verdict(t->scope->manager, DNSSEC_INSECURE, rr->key);
2995 return 1;
2996 }
2997 }
2998
2999 r = dns_transaction_is_primary_response(t, rr);
3000 if (r < 0)
3001 return r;
3002 if (r > 0) {
3003 /* Look for a matching DNAME for this CNAME */
3004 r = dns_answer_has_dname_for_cname(t->answer, rr);
3005 if (r < 0)
3006 return r;
3007 if (r == 0) {
3008 /* Also look among the stuff we already validated */
3009 r = dns_answer_has_dname_for_cname(*validated, rr);
3010 if (r < 0)
3011 return r;
3012 }
3013
3014 if (r == 0) {
3015 if (IN_SET(result,
3016 DNSSEC_INVALID,
3017 DNSSEC_SIGNATURE_EXPIRED,
3018 DNSSEC_NO_SIGNATURE))
3019 manager_dnssec_verdict(t->scope->manager, DNSSEC_BOGUS, rr->key);
3020 else /* DNSSEC_MISSING_KEY or DNSSEC_UNSUPPORTED_ALGORITHM */
3021 manager_dnssec_verdict(t->scope->manager, DNSSEC_INDETERMINATE, rr->key);
3022
3023 /* This is a primary response to our question, and it failed validation.
3024 * That's fatal. */
3025 t->answer_dnssec_result = result;
3026 return 0;
3027 }
3028
3029 /* This is a primary response, but we do have a DNAME RR
3030 * in the RR that can replay this CNAME, hence rely on
3031 * that, and we can remove the CNAME in favour of it. */
3032 }
3033
3034 /* This is just some auxiliary data. Just remove the RRset and continue. */
3035 r = dns_answer_remove_by_key(&t->answer, rr->key);
3036 if (r < 0)
3037 return r;
3038
3039 /* We dropped something from the answer, start from the beginning. */
3040 return 1;
3041 }
3042
3043 return 2; /* Finito. */
3044 }
3045
3046 int dns_transaction_validate_dnssec(DnsTransaction *t) {
3047 _cleanup_(dns_answer_unrefp) DnsAnswer *validated = NULL;
3048 Phase phase;
3049 DnsAnswerFlags flags;
3050 int r;
3051 char key_str[DNS_RESOURCE_KEY_STRING_MAX];
3052
3053 assert(t);
3054
3055 /* We have now collected all DS and DNSKEY RRs in
3056 * t->validated_keys, let's see which RRs we can now
3057 * authenticate with that. */
3058
3059 if (t->scope->dnssec_mode == DNSSEC_NO)
3060 return 0;
3061
3062 /* Already validated */
3063 if (t->answer_dnssec_result != _DNSSEC_RESULT_INVALID)
3064 return 0;
3065
3066 /* Our own stuff needs no validation */
3067 if (IN_SET(t->answer_source, DNS_TRANSACTION_ZONE, DNS_TRANSACTION_TRUST_ANCHOR)) {
3068 t->answer_dnssec_result = DNSSEC_VALIDATED;
3069 t->answer_authenticated = true;
3070 return 0;
3071 }
3072
3073 /* Cached stuff is not affected by validation. */
3074 if (t->answer_source != DNS_TRANSACTION_NETWORK)
3075 return 0;
3076
3077 if (!dns_transaction_dnssec_supported_full(t)) {
3078 /* The server does not support DNSSEC, or doesn't augment responses with RRSIGs. */
3079 t->answer_dnssec_result = DNSSEC_INCOMPATIBLE_SERVER;
3080 log_debug("Not validating response for %" PRIu16 ", used server feature level does not support DNSSEC.", t->id);
3081 return 0;
3082 }
3083
3084 log_debug("Validating response from transaction %" PRIu16 " (%s).",
3085 t->id,
3086 dns_resource_key_to_string(t->key, key_str, sizeof key_str));
3087
3088 /* First, see if this response contains any revoked trust
3089 * anchors we care about */
3090 r = dns_transaction_check_revoked_trust_anchors(t);
3091 if (r < 0)
3092 return r;
3093
3094 /* Third, copy all RRs we acquired successfully from auxiliary RRs over. */
3095 r = dns_transaction_copy_validated(t);
3096 if (r < 0)
3097 return r;
3098
3099 /* Second, see if there are DNSKEYs we already know a
3100 * validated DS for. */
3101 r = dns_transaction_validate_dnskey_by_ds(t);
3102 if (r < 0)
3103 return r;
3104
3105 /* Fourth, remove all DNSKEY and DS RRs again that our trust
3106 * anchor says are revoked. After all we might have marked
3107 * some keys revoked above, but they might still be lingering
3108 * in our validated_keys list. */
3109 r = dns_transaction_invalidate_revoked_keys(t);
3110 if (r < 0)
3111 return r;
3112
3113 phase = DNSSEC_PHASE_DNSKEY;
3114 for (;;) {
3115 bool have_nsec = false;
3116
3117 r = dnssec_validate_records(t, phase, &have_nsec, &validated);
3118 if (r <= 0)
3119 return r;
3120
3121 /* Try again as long as we managed to achieve something */
3122 if (r == 1)
3123 continue;
3124
3125 if (phase == DNSSEC_PHASE_DNSKEY && have_nsec) {
3126 /* OK, we processed all DNSKEYs, and there are NSEC/NSEC3 RRs, look at those now. */
3127 phase = DNSSEC_PHASE_NSEC;
3128 continue;
3129 }
3130
3131 if (phase != DNSSEC_PHASE_ALL) {
3132 /* OK, we processed all DNSKEYs and NSEC/NSEC3 RRs, look at all the rest now.
3133 * Note that in this third phase we start to remove RRs we couldn't validate. */
3134 phase = DNSSEC_PHASE_ALL;
3135 continue;
3136 }
3137
3138 /* We're done */
3139 break;
3140 }
3141
3142 dns_answer_unref(t->answer);
3143 t->answer = TAKE_PTR(validated);
3144
3145 /* At this point the answer only contains validated
3146 * RRsets. Now, let's see if it actually answers the question
3147 * we asked. If so, great! If it doesn't, then see if
3148 * NSEC/NSEC3 can prove this. */
3149 r = dns_transaction_has_positive_answer(t, &flags);
3150 if (r > 0) {
3151 /* Yes, it answers the question! */
3152
3153 if (flags & DNS_ANSWER_AUTHENTICATED) {
3154 /* The answer is fully authenticated, yay. */
3155 t->answer_dnssec_result = DNSSEC_VALIDATED;
3156 t->answer_rcode = DNS_RCODE_SUCCESS;
3157 t->answer_authenticated = true;
3158 } else {
3159 /* The answer is not fully authenticated. */
3160 t->answer_dnssec_result = DNSSEC_UNSIGNED;
3161 t->answer_authenticated = false;
3162 }
3163
3164 } else if (r == 0) {
3165 DnssecNsecResult nr;
3166 bool authenticated = false;
3167
3168 /* Bummer! Let's check NSEC/NSEC3 */
3169 r = dnssec_nsec_test(t->answer, t->key, &nr, &authenticated, &t->answer_nsec_ttl);
3170 if (r < 0)
3171 return r;
3172
3173 switch (nr) {
3174
3175 case DNSSEC_NSEC_NXDOMAIN:
3176 /* NSEC proves the domain doesn't exist. Very good. */
3177 log_debug("Proved NXDOMAIN via NSEC/NSEC3 for transaction %u (%s)", t->id, key_str);
3178 t->answer_dnssec_result = DNSSEC_VALIDATED;
3179 t->answer_rcode = DNS_RCODE_NXDOMAIN;
3180 t->answer_authenticated = authenticated;
3181
3182 manager_dnssec_verdict(t->scope->manager, authenticated ? DNSSEC_SECURE : DNSSEC_INSECURE, t->key);
3183 break;
3184
3185 case DNSSEC_NSEC_NODATA:
3186 /* NSEC proves that there's no data here, very good. */
3187 log_debug("Proved NODATA via NSEC/NSEC3 for transaction %u (%s)", t->id, key_str);
3188 t->answer_dnssec_result = DNSSEC_VALIDATED;
3189 t->answer_rcode = DNS_RCODE_SUCCESS;
3190 t->answer_authenticated = authenticated;
3191
3192 manager_dnssec_verdict(t->scope->manager, authenticated ? DNSSEC_SECURE : DNSSEC_INSECURE, t->key);
3193 break;
3194
3195 case DNSSEC_NSEC_OPTOUT:
3196 /* NSEC3 says the data might not be signed */
3197 log_debug("Data is NSEC3 opt-out via NSEC/NSEC3 for transaction %u (%s)", t->id, key_str);
3198 t->answer_dnssec_result = DNSSEC_UNSIGNED;
3199 t->answer_authenticated = false;
3200
3201 manager_dnssec_verdict(t->scope->manager, DNSSEC_INSECURE, t->key);
3202 break;
3203
3204 case DNSSEC_NSEC_NO_RR:
3205 /* No NSEC data? Bummer! */
3206
3207 r = dns_transaction_requires_nsec(t);
3208 if (r < 0)
3209 return r;
3210 if (r > 0) {
3211 t->answer_dnssec_result = DNSSEC_NO_SIGNATURE;
3212 manager_dnssec_verdict(t->scope->manager, DNSSEC_BOGUS, t->key);
3213 } else {
3214 t->answer_dnssec_result = DNSSEC_UNSIGNED;
3215 t->answer_authenticated = false;
3216 manager_dnssec_verdict(t->scope->manager, DNSSEC_INSECURE, t->key);
3217 }
3218
3219 break;
3220
3221 case DNSSEC_NSEC_UNSUPPORTED_ALGORITHM:
3222 /* We don't know the NSEC3 algorithm used? */
3223 t->answer_dnssec_result = DNSSEC_UNSUPPORTED_ALGORITHM;
3224 manager_dnssec_verdict(t->scope->manager, DNSSEC_INDETERMINATE, t->key);
3225 break;
3226
3227 case DNSSEC_NSEC_FOUND:
3228 case DNSSEC_NSEC_CNAME:
3229 /* NSEC says it needs to be there, but we couldn't find it? Bummer! */
3230 t->answer_dnssec_result = DNSSEC_NSEC_MISMATCH;
3231 manager_dnssec_verdict(t->scope->manager, DNSSEC_BOGUS, t->key);
3232 break;
3233
3234 default:
3235 assert_not_reached("Unexpected NSEC result.");
3236 }
3237 }
3238
3239 return 1;
3240 }
3241
3242 static const char* const dns_transaction_state_table[_DNS_TRANSACTION_STATE_MAX] = {
3243 [DNS_TRANSACTION_NULL] = "null",
3244 [DNS_TRANSACTION_PENDING] = "pending",
3245 [DNS_TRANSACTION_VALIDATING] = "validating",
3246 [DNS_TRANSACTION_RCODE_FAILURE] = "rcode-failure",
3247 [DNS_TRANSACTION_SUCCESS] = "success",
3248 [DNS_TRANSACTION_NO_SERVERS] = "no-servers",
3249 [DNS_TRANSACTION_TIMEOUT] = "timeout",
3250 [DNS_TRANSACTION_ATTEMPTS_MAX_REACHED] = "attempts-max-reached",
3251 [DNS_TRANSACTION_INVALID_REPLY] = "invalid-reply",
3252 [DNS_TRANSACTION_ERRNO] = "errno",
3253 [DNS_TRANSACTION_ABORTED] = "aborted",
3254 [DNS_TRANSACTION_DNSSEC_FAILED] = "dnssec-failed",
3255 [DNS_TRANSACTION_NO_TRUST_ANCHOR] = "no-trust-anchor",
3256 [DNS_TRANSACTION_RR_TYPE_UNSUPPORTED] = "rr-type-unsupported",
3257 [DNS_TRANSACTION_NETWORK_DOWN] = "network-down",
3258 [DNS_TRANSACTION_NOT_FOUND] = "not-found",
3259 };
3260 DEFINE_STRING_TABLE_LOOKUP(dns_transaction_state, DnsTransactionState);
3261
3262 static const char* const dns_transaction_source_table[_DNS_TRANSACTION_SOURCE_MAX] = {
3263 [DNS_TRANSACTION_NETWORK] = "network",
3264 [DNS_TRANSACTION_CACHE] = "cache",
3265 [DNS_TRANSACTION_ZONE] = "zone",
3266 [DNS_TRANSACTION_TRUST_ANCHOR] = "trust-anchor",
3267 };
3268 DEFINE_STRING_TABLE_LOOKUP(dns_transaction_source, DnsTransactionSource);