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