xref: /linux/fs/verity/signature.c (revision ca853314e78b0a65c20b6a889a23c31f918d4aa2)
1 // SPDX-License-Identifier: GPL-2.0
2 /*
3  * Verification of builtin signatures
4  *
5  * Copyright 2019 Google LLC
6  */
7 
8 #include "fsverity_private.h"
9 
10 #include <linux/cred.h>
11 #include <linux/key.h>
12 #include <linux/slab.h>
13 #include <linux/verification.h>
14 
15 /*
16  * /proc/sys/fs/verity/require_signatures
17  * If 1, all verity files must have a valid builtin signature.
18  */
19 static int fsverity_require_signatures;
20 
21 /*
22  * Keyring that contains the trusted X.509 certificates.
23  *
24  * Only root (kuid=0) can modify this.  Also, root may use
25  * keyctl_restrict_keyring() to prevent any more additions.
26  */
27 static struct key *fsverity_keyring;
28 
29 /**
30  * fsverity_verify_signature() - check a verity file's signature
31  * @vi: the file's fsverity_info
32  * @desc: the file's fsverity_descriptor
33  * @desc_size: size of @desc
34  *
35  * If the file's fs-verity descriptor includes a signature of the file digest,
36  * verify it against the certificates in the fs-verity keyring.
37  *
38  * Return: 0 on success (signature valid or not required); -errno on failure
39  */
40 int fsverity_verify_signature(const struct fsverity_info *vi,
41 			      const struct fsverity_descriptor *desc,
42 			      size_t desc_size)
43 {
44 	const struct inode *inode = vi->inode;
45 	const struct fsverity_hash_alg *hash_alg = vi->tree_params.hash_alg;
46 	const u32 sig_size = le32_to_cpu(desc->sig_size);
47 	struct fsverity_formatted_digest *d;
48 	int err;
49 
50 	if (sig_size == 0) {
51 		if (fsverity_require_signatures) {
52 			fsverity_err(inode,
53 				     "require_signatures=1, rejecting unsigned file!");
54 			return -EPERM;
55 		}
56 		return 0;
57 	}
58 
59 	if (sig_size > desc_size - sizeof(*desc)) {
60 		fsverity_err(inode, "Signature overflows verity descriptor");
61 		return -EBADMSG;
62 	}
63 
64 	d = kzalloc(sizeof(*d) + hash_alg->digest_size, GFP_KERNEL);
65 	if (!d)
66 		return -ENOMEM;
67 	memcpy(d->magic, "FSVerity", 8);
68 	d->digest_algorithm = cpu_to_le16(hash_alg - fsverity_hash_algs);
69 	d->digest_size = cpu_to_le16(hash_alg->digest_size);
70 	memcpy(d->digest, vi->file_digest, hash_alg->digest_size);
71 
72 	err = verify_pkcs7_signature(d, sizeof(*d) + hash_alg->digest_size,
73 				     desc->signature, sig_size,
74 				     fsverity_keyring,
75 				     VERIFYING_UNSPECIFIED_SIGNATURE,
76 				     NULL, NULL);
77 	kfree(d);
78 
79 	if (err) {
80 		if (err == -ENOKEY)
81 			fsverity_err(inode,
82 				     "File's signing cert isn't in the fs-verity keyring");
83 		else if (err == -EKEYREJECTED)
84 			fsverity_err(inode, "Incorrect file signature");
85 		else if (err == -EBADMSG)
86 			fsverity_err(inode, "Malformed file signature");
87 		else
88 			fsverity_err(inode, "Error %d verifying file signature",
89 				     err);
90 		return err;
91 	}
92 
93 	pr_debug("Valid signature for file digest %s:%*phN\n",
94 		 hash_alg->name, hash_alg->digest_size, vi->file_digest);
95 	return 0;
96 }
97 
98 #ifdef CONFIG_SYSCTL
99 static struct ctl_table_header *fsverity_sysctl_header;
100 
101 static const struct ctl_path fsverity_sysctl_path[] = {
102 	{ .procname = "fs", },
103 	{ .procname = "verity", },
104 	{ }
105 };
106 
107 static struct ctl_table fsverity_sysctl_table[] = {
108 	{
109 		.procname       = "require_signatures",
110 		.data           = &fsverity_require_signatures,
111 		.maxlen         = sizeof(int),
112 		.mode           = 0644,
113 		.proc_handler   = proc_dointvec_minmax,
114 		.extra1         = SYSCTL_ZERO,
115 		.extra2         = SYSCTL_ONE,
116 	},
117 	{ }
118 };
119 
120 static int __init fsverity_sysctl_init(void)
121 {
122 	fsverity_sysctl_header = register_sysctl_paths(fsverity_sysctl_path,
123 						       fsverity_sysctl_table);
124 	if (!fsverity_sysctl_header) {
125 		pr_err("sysctl registration failed!\n");
126 		return -ENOMEM;
127 	}
128 	return 0;
129 }
130 #else /* !CONFIG_SYSCTL */
131 static inline int __init fsverity_sysctl_init(void)
132 {
133 	return 0;
134 }
135 #endif /* !CONFIG_SYSCTL */
136 
137 int __init fsverity_init_signature(void)
138 {
139 	struct key *ring;
140 	int err;
141 
142 	ring = keyring_alloc(".fs-verity", KUIDT_INIT(0), KGIDT_INIT(0),
143 			     current_cred(), KEY_POS_SEARCH |
144 				KEY_USR_VIEW | KEY_USR_READ | KEY_USR_WRITE |
145 				KEY_USR_SEARCH | KEY_USR_SETATTR,
146 			     KEY_ALLOC_NOT_IN_QUOTA, NULL, NULL);
147 	if (IS_ERR(ring))
148 		return PTR_ERR(ring);
149 
150 	err = fsverity_sysctl_init();
151 	if (err)
152 		goto err_put_ring;
153 
154 	fsverity_keyring = ring;
155 	return 0;
156 
157 err_put_ring:
158 	key_put(ring);
159 	return err;
160 }
161