1 /* SPDX-License-Identifier: LGPL-2.1-or-later */
5 #include "alloc-util.h"
6 #include "btrfs-util.h"
7 #include "capability-util.h"
9 #include "dirent-util.h"
12 #include "hostname-util.h"
14 #include "memory-util.h"
15 #include "path-util.h"
16 #include "process-util.h"
17 #include "pull-common.h"
20 #include "signal-util.h"
21 #include "siphash24.h"
22 #include "string-util.h"
26 #define FILENAME_ESCAPE "/.#\"\'"
27 #define HASH_URL_THRESHOLD_LENGTH (_POSIX_PATH_MAX - 16)
29 int pull_find_old_etags(
31 const char *image_root
,
43 image_root
= "/var/lib/machines";
45 _cleanup_free_
char *escaped_url
= xescape(url
, FILENAME_ESCAPE
);
49 _cleanup_closedir_
DIR *d
= opendir(image_root
);
51 if (errno
== ENOENT
) {
59 _cleanup_strv_free_
char **ans
= NULL
;
61 FOREACH_DIRENT_ALL(de
, d
, return -errno
) {
62 _cleanup_free_
char *u
= NULL
;
65 if (de
->d_type
!= DT_UNKNOWN
&&
70 a
= startswith(de
->d_name
, prefix
);
76 a
= startswith(a
, escaped_url
);
80 a
= startswith(a
, ".");
85 b
= endswith(de
->d_name
, suffix
);
89 b
= strchr(de
->d_name
, 0);
94 ssize_t l
= cunescape_length(a
, b
- a
, 0, &u
);
96 assert(l
>= INT8_MIN
);
100 if (!http_etag_is_valid(u
))
103 r
= strv_consume(&ans
, TAKE_PTR(u
));
108 *etags
= TAKE_PTR(ans
);
113 static int hash_url(const char *url
, char **ret
) {
115 static const sd_id128_t k
= SD_ID128_ARRAY(df
,89,16,87,01,cc
,42,30,98,ab
,4a
,19,a6
,a5
,63,4f
);
119 h
= siphash24(url
, strlen(url
), k
.bytes
);
120 if (asprintf(ret
, "%"PRIx64
, h
) < 0)
126 int pull_make_path(const char *url
, const char *etag
, const char *image_root
, const char *prefix
, const char *suffix
, char **ret
) {
127 _cleanup_free_
char *escaped_url
= NULL
, *escaped_etag
= NULL
;
134 image_root
= "/var/lib/machines";
136 escaped_url
= xescape(url
, FILENAME_ESCAPE
);
141 escaped_etag
= xescape(etag
, FILENAME_ESCAPE
);
146 path
= strjoin(image_root
, "/", strempty(prefix
), escaped_url
, escaped_etag
? "." : "",
147 strempty(escaped_etag
), strempty(suffix
));
151 /* URLs might make the path longer than the maximum allowed length for a file name.
152 * When that happens, a URL hash is used instead. Paths returned by this function
153 * can be later used with tempfn_random() which adds 16 bytes to the resulting name. */
154 if (strlen(path
) >= HASH_URL_THRESHOLD_LENGTH
) {
155 _cleanup_free_
char *hash
= NULL
;
160 r
= hash_url(url
, &hash
);
164 path
= strjoin(image_root
, "/", strempty(prefix
), hash
, escaped_etag
? "." : "",
165 strempty(escaped_etag
), strempty(suffix
));
174 int pull_make_auxiliary_job(
177 int (*strip_suffixes
)(const char *name
, char **ret
),
181 PullJobOpenDisk on_open_disk
,
182 PullJobFinished on_finished
,
185 _cleanup_free_
char *last_component
= NULL
, *ll
= NULL
, *auxiliary_url
= NULL
;
186 _cleanup_(pull_job_unrefp
) PullJob
*job
= NULL
;
192 assert(strip_suffixes
);
195 r
= import_url_last_component(url
, &last_component
);
199 r
= strip_suffixes(last_component
, &ll
);
203 q
= strjoina(ll
, suffix
);
205 r
= import_url_change_last_component(url
, q
, &auxiliary_url
);
209 r
= pull_job_new(&job
, auxiliary_url
, glue
, userdata
);
213 job
->on_open_disk
= on_open_disk
;
214 job
->on_finished
= on_finished
;
215 job
->compressed_max
= job
->uncompressed_max
= 1ULL * 1024ULL * 1024ULL;
216 job
->calc_checksum
= IN_SET(verify
, IMPORT_VERIFY_CHECKSUM
, IMPORT_VERIFY_SIGNATURE
);
218 *ret
= TAKE_PTR(job
);
222 static bool is_checksum_file(const char *fn
) {
223 /* Returns true if the specified filename refers to a checksum file we grok */
228 return streq(fn
, "SHA256SUMS") || endswith(fn
, ".sha256");
231 static bool is_signature_file(const char *fn
) {
232 /* Returns true if the specified filename refers to a signature file we grok (reminder:
233 * suse-style .sha256 files are inline signed) */
238 return streq(fn
, "SHA256SUMS.gpg") || endswith(fn
, ".sha256");
241 int pull_make_verification_jobs(
242 PullJob
**ret_checksum_job
,
243 PullJob
**ret_signature_job
,
245 const char *checksum
, /* set if literal checksum verification is requested, in which case 'verify' is set to _IMPORT_VERIFY_INVALID */
248 PullJobFinished on_finished
,
251 _cleanup_(pull_job_unrefp
) PullJob
*checksum_job
= NULL
, *signature_job
= NULL
;
252 _cleanup_free_
char *fn
= NULL
;
255 assert(ret_checksum_job
);
256 assert(ret_signature_job
);
257 assert(verify
== _IMPORT_VERIFY_INVALID
|| verify
< _IMPORT_VERIFY_MAX
);
258 assert(verify
== _IMPORT_VERIFY_INVALID
|| verify
>= 0);
259 assert((verify
< 0) || !checksum
);
263 /* If verification is turned off, or if the checksum to validate is already specified we don't need
264 * to download a checksum file or signature, hence shortcut things */
265 if (verify
== IMPORT_VERIFY_NO
|| checksum
) {
266 *ret_checksum_job
= *ret_signature_job
= NULL
;
270 r
= import_url_last_component(url
, &fn
);
271 if (r
< 0 && r
!= -EADDRNOTAVAIL
) /* EADDRNOTAVAIL means there was no last component, which is OK for
272 * us, we'll just assume it's not a checksum/signature file */
275 /* Acquire the checksum file if verification or signature verification is requested and the main file
276 * to acquire isn't a checksum or signature file anyway */
277 if (verify
!= IMPORT_VERIFY_NO
&& !is_checksum_file(fn
) && !is_signature_file(fn
)) {
278 _cleanup_free_
char *checksum_url
= NULL
;
279 const char *suffixed
= NULL
;
281 /* Queue jobs for the checksum file for the image. */
284 suffixed
= strjoina(fn
, ".sha256"); /* Start with the suse-style checksum (if there's a base filename) */
286 suffixed
= "SHA256SUMS";
288 r
= import_url_change_last_component(url
, suffixed
, &checksum_url
);
292 r
= pull_job_new(&checksum_job
, checksum_url
, glue
, userdata
);
296 checksum_job
->on_finished
= on_finished
;
297 checksum_job
->uncompressed_max
= checksum_job
->compressed_max
= 1ULL * 1024ULL * 1024ULL;
298 checksum_job
->on_not_found
= pull_job_restart_with_sha256sum
; /* if this fails, look for ubuntu-style checksum */
301 if (verify
== IMPORT_VERIFY_SIGNATURE
&& !is_signature_file(fn
)) {
302 _cleanup_free_
char *signature_url
= NULL
;
304 /* Queue job for the SHA256SUMS.gpg file for the image. */
305 r
= import_url_change_last_component(url
, "SHA256SUMS.gpg", &signature_url
);
309 r
= pull_job_new(&signature_job
, signature_url
, glue
, userdata
);
313 signature_job
->on_finished
= on_finished
;
314 signature_job
->uncompressed_max
= signature_job
->compressed_max
= 1ULL * 1024ULL * 1024ULL;
317 *ret_checksum_job
= TAKE_PTR(checksum_job
);
318 *ret_signature_job
= TAKE_PTR(signature_job
);
322 static int verify_one(PullJob
*checksum_job
, PullJob
*job
) {
323 _cleanup_free_
char *fn
= NULL
;
324 const char *line
, *p
;
327 assert(checksum_job
);
332 assert(IN_SET(job
->state
, PULL_JOB_DONE
, PULL_JOB_FAILED
));
334 /* Don't verify the checksum if we didn't actually successfully download something new */
335 if (job
->state
!= PULL_JOB_DONE
)
339 if (job
->etag_exists
)
342 assert(job
->calc_checksum
);
343 assert(job
->checksum
);
345 r
= import_url_last_component(job
->url
, &fn
);
347 return log_error_errno(r
, "Failed to extract filename from URL '%s': %m", job
->url
);
349 if (!filename_is_valid(fn
))
350 return log_error_errno(SYNTHETIC_ERRNO(EBADMSG
),
351 "Cannot verify checksum, could not determine server-side file name.");
353 if (is_checksum_file(fn
) || is_signature_file(fn
)) /* We cannot verify checksum files or signature files with a checksum file */
354 return log_error_errno(SYNTHETIC_ERRNO(ELOOP
),
355 "Cannot verify checksum/signature files via themselves.");
357 line
= strjoina(job
->checksum
, " *", fn
, "\n"); /* string for binary mode */
358 p
= memmem_safe(checksum_job
->payload
,
359 checksum_job
->payload_size
,
363 line
= strjoina(job
->checksum
, " ", fn
, "\n"); /* string for text mode */
364 p
= memmem_safe(checksum_job
->payload
,
365 checksum_job
->payload_size
,
370 /* Only counts if found at beginning of a line */
371 if (!p
|| (p
!= (char*) checksum_job
->payload
&& p
[-1] != '\n'))
372 return log_error_errno(SYNTHETIC_ERRNO(EBADMSG
),
373 "DOWNLOAD INVALID: Checksum of %s file did not check out, file has been tampered with.", fn
);
375 log_info("SHA256 checksum of %s is valid.", job
->url
);
379 static int verify_gpg(
380 const void *payload
, size_t payload_size
,
381 const void *signature
, size_t signature_size
) {
383 _cleanup_close_pair_
int gpg_pipe
[2] = PIPE_EBADF
;
384 char sig_file_path
[] = "/tmp/sigXXXXXX", gpg_home
[] = "/tmp/gpghomeXXXXXX";
385 _cleanup_(sigkill_waitp
) pid_t pid
= 0;
386 bool gpg_home_created
= false;
389 assert(payload
|| payload_size
== 0);
390 assert(signature
|| signature_size
== 0);
392 r
= pipe2(gpg_pipe
, O_CLOEXEC
);
394 return log_error_errno(errno
, "Failed to create pipe for gpg: %m");
396 if (signature_size
> 0) {
397 _cleanup_close_
int sig_file
= -EBADF
;
399 sig_file
= mkostemp(sig_file_path
, O_RDWR
);
401 return log_error_errno(errno
, "Failed to create temporary file: %m");
403 r
= loop_write(sig_file
, signature
, signature_size
, false);
405 log_error_errno(r
, "Failed to write to temporary file: %m");
410 if (!mkdtemp(gpg_home
)) {
411 r
= log_error_errno(errno
, "Failed to create temporary home for gpg: %m");
415 gpg_home_created
= true;
417 r
= safe_fork("(gpg)", FORK_RESET_SIGNALS
|FORK_DEATHSIG
|FORK_LOG
|FORK_RLIMIT_NOFILE_SAFE
, &pid
);
421 const char *cmd
[] = {
424 "--no-default-keyring",
425 "--no-auto-key-locate",
426 "--no-auto-check-trustdb",
428 "--trust-model=always",
429 NULL
, /* --homedir= */
430 NULL
, /* --keyring= */
432 NULL
, /* signature file */
434 NULL
/* trailing NULL */
436 size_t k
= ELEMENTSOF(cmd
) - 6;
440 gpg_pipe
[1] = safe_close(gpg_pipe
[1]);
442 r
= rearrange_stdio(TAKE_FD(gpg_pipe
[0]), -EBADF
, STDERR_FILENO
);
444 log_error_errno(r
, "Failed to rearrange stdin/stdout: %m");
448 cmd
[k
++] = strjoina("--homedir=", gpg_home
);
450 /* We add the user keyring only to the command line arguments, if it's around since gpg fails
452 if (access(USER_KEYRING_PATH
, F_OK
) >= 0)
453 cmd
[k
++] = "--keyring=" USER_KEYRING_PATH
;
455 cmd
[k
++] = "--keyring=" VENDOR_KEYRING_PATH
;
457 cmd
[k
++] = "--verify";
459 cmd
[k
++] = sig_file_path
;
464 execvp("gpg2", (char * const *) cmd
);
465 execvp("gpg", (char * const *) cmd
);
466 log_error_errno(errno
, "Failed to execute gpg: %m");
470 gpg_pipe
[0] = safe_close(gpg_pipe
[0]);
472 r
= loop_write(gpg_pipe
[1], payload
, payload_size
, false);
474 log_error_errno(r
, "Failed to write to pipe: %m");
478 gpg_pipe
[1] = safe_close(gpg_pipe
[1]);
480 r
= wait_for_terminate_and_check("gpg", TAKE_PID(pid
), WAIT_LOG_ABNORMAL
);
483 if (r
!= EXIT_SUCCESS
)
484 r
= log_error_errno(SYNTHETIC_ERRNO(EBADMSG
),
485 "DOWNLOAD INVALID: Signature verification failed.");
487 log_info("Signature verification succeeded.");
492 if (signature_size
> 0)
493 (void) unlink(sig_file_path
);
495 if (gpg_home_created
)
496 (void) rm_rf(gpg_home
, REMOVE_ROOT
|REMOVE_PHYSICAL
);
501 int pull_verify(ImportVerify verify
,
502 const char *checksum
, /* Verify with literal checksum */
504 PullJob
*checksum_job
,
505 PullJob
*signature_job
,
506 PullJob
*settings_job
,
507 PullJob
*roothash_job
,
508 PullJob
*roothash_signature_job
,
509 PullJob
*verity_job
) {
511 _cleanup_free_
char *fn
= NULL
;
512 VerificationStyle style
;
516 assert(verify
== _IMPORT_VERIFY_INVALID
|| verify
< _IMPORT_VERIFY_MAX
);
517 assert(verify
== _IMPORT_VERIFY_INVALID
|| verify
>= 0);
518 assert((verify
< 0) || !checksum
);
520 assert(main_job
->state
== PULL_JOB_DONE
);
522 if (verify
== IMPORT_VERIFY_NO
) /* verification turned off */
526 /* Verification by literal checksum */
527 assert(!checksum_job
);
528 assert(!signature_job
);
529 assert(!settings_job
);
530 assert(!roothash_job
);
531 assert(!roothash_signature_job
);
534 assert(main_job
->calc_checksum
);
535 assert(main_job
->checksum
);
537 if (!strcaseeq(checksum
, main_job
->checksum
))
538 return log_error_errno(SYNTHETIC_ERRNO(EBADMSG
),
539 "DOWNLOAD INVALID: Checksum of %s file did not check out, file has been tampered with.",
545 r
= import_url_last_component(main_job
->url
, &fn
);
547 return log_error_errno(r
, "Failed to extract filename from URL '%s': %m", main_job
->url
);
549 if (is_signature_file(fn
))
550 return log_error_errno(SYNTHETIC_ERRNO(ELOOP
),
551 "Main download is a signature file, can't verify it.");
553 if (is_checksum_file(fn
)) {
554 log_debug("Main download is a checksum file, can't validate its checksum with itself, skipping.");
555 verify_job
= main_job
;
558 assert(main_job
->calc_checksum
);
559 assert(main_job
->checksum
);
560 assert(checksum_job
);
561 assert(checksum_job
->state
== PULL_JOB_DONE
);
563 if (!checksum_job
->payload
|| checksum_job
->payload_size
<= 0)
564 return log_error_errno(SYNTHETIC_ERRNO(EBADMSG
),
565 "Checksum is empty, cannot verify.");
567 FOREACH_POINTER(j
, main_job
, settings_job
, roothash_job
, roothash_signature_job
, verity_job
) {
568 r
= verify_one(checksum_job
, j
);
573 verify_job
= checksum_job
;
576 if (verify
!= IMPORT_VERIFY_SIGNATURE
)
581 r
= verification_style_from_url(verify_job
->url
, &style
);
583 return log_error_errno(r
, "Failed to determine verification style from URL '%s': %m", verify_job
->url
);
585 if (style
== VERIFICATION_PER_DIRECTORY
) {
586 assert(signature_job
);
587 assert(signature_job
->state
== PULL_JOB_DONE
);
589 if (!signature_job
->payload
|| signature_job
->payload_size
<= 0)
590 return log_error_errno(SYNTHETIC_ERRNO(EBADMSG
),
591 "Signature is empty, cannot verify.");
593 return verify_gpg(verify_job
->payload
, verify_job
->payload_size
, signature_job
->payload
, signature_job
->payload_size
);
595 return verify_gpg(verify_job
->payload
, verify_job
->payload_size
, NULL
, 0);
598 int verification_style_from_url(const char *url
, VerificationStyle
*ret
) {
599 _cleanup_free_
char *last
= NULL
;
605 /* Determines which kind of verification style is appropriate for this url */
607 r
= import_url_last_component(url
, &last
);
611 if (streq(last
, "SHA256SUMS")) {
612 *ret
= VERIFICATION_PER_DIRECTORY
;
616 if (endswith(last
, ".sha256")) {
617 *ret
= VERIFICATION_PER_FILE
;
624 int pull_job_restart_with_sha256sum(PullJob
*j
, char **ret
) {
625 VerificationStyle style
;
630 /* Generic implementation of a PullJobNotFound handler, that restarts the job requesting SHA256SUMS */
632 r
= verification_style_from_url(j
->url
, &style
);
634 return log_error_errno(r
, "Failed to determine verification style of URL '%s': %m", j
->url
);
636 if (style
== VERIFICATION_PER_DIRECTORY
) /* Nothing to do anymore */
639 assert(style
== VERIFICATION_PER_FILE
); /* This must have been .sha256 style URL before */
641 log_debug("Got 404 for %s, now trying to get SHA256SUMS instead.", j
->url
);
643 r
= import_url_change_last_component(j
->url
, "SHA256SUMS", ret
);
645 return log_error_errno(r
, "Failed to replace SHA256SUMS suffix: %m");
650 bool pull_validate_local(const char *name
, PullFlags flags
) {
652 if (FLAGS_SET(flags
, PULL_DIRECT
))
653 return path_is_valid(name
);
655 return hostname_is_valid(name
, 0);
658 int pull_url_needs_checksum(const char *url
) {
659 _cleanup_free_
char *fn
= NULL
;
662 /* Returns true if we need to validate this resource via a hash value. This returns true for all
663 * files — except for gpg signature files and SHA256SUMS files and the like, which are validated with
664 * a validation tool like gpg. */
666 r
= import_url_last_component(url
, &fn
);
667 if (r
== -EADDRNOTAVAIL
) /* no last component? then let's assume it's not a signature/checksum file */
672 return !is_checksum_file(fn
) && !is_signature_file(fn
);