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