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