1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /* Instantiate a public key crypto key from an X.509 Certificate
4 * Copyright (C) 2012 Red Hat, Inc. All Rights Reserved.
5 * Written by David Howells (dhowells@redhat.com)
8 #define pr_fmt(fmt) "X.509: "fmt
11 #include <dm/devres.h>
12 #include <linux/compat.h>
13 #include <linux/err.h>
14 #include <linux/errno.h>
16 #include <linux/module.h>
18 #include <linux/kernel.h>
20 #include <linux/slab.h>
21 #include <keys/asymmetric-subtype.h>
22 #include <keys/asymmetric-parser.h>
23 #include <keys/system_keyring.h>
24 #include <crypto/hash.h>
25 #include "asymmetric_keys.h"
27 #include "x509_parser.h"
30 * Set up the signature parameters in an X.509 certificate. This involves
31 * digesting the signed data and extracting the signature.
33 int x509_get_sig_params(struct x509_certificate *cert)
35 struct public_key_signature *sig = cert->sig;
37 struct crypto_shash *tfm;
38 struct shash_desc *desc;
43 pr_devel("==>%s()\n", __func__);
45 if (!cert->pub->pkey_algo)
46 cert->unsupported_key = true;
49 cert->unsupported_sig = true;
51 /* We check the hash if we can - even if we can't then verify it */
52 if (!sig->hash_algo) {
53 cert->unsupported_sig = true;
57 sig->s = kmemdup(cert->raw_sig, cert->raw_sig_size, GFP_KERNEL);
61 sig->s_size = cert->raw_sig_size;
66 * This part (filling sig->digest) should be implemented if
67 * x509_check_for_self_signed() is enabled x509_cert_parse().
68 * Currently, this check won't affect UEFI secure boot.
72 /* Allocate the hashing algorithm we're going to need and find out how
73 * big the hash operational data will be.
75 tfm = crypto_alloc_shash(sig->hash_algo, 0, 0);
77 if (PTR_ERR(tfm) == -ENOENT) {
78 cert->unsupported_sig = true;
84 desc_size = crypto_shash_descsize(tfm) + sizeof(*desc);
85 sig->digest_size = crypto_shash_digestsize(tfm);
88 sig->digest = kmalloc(sig->digest_size, GFP_KERNEL);
92 desc = kzalloc(desc_size, GFP_KERNEL);
98 ret = crypto_shash_digest(desc, cert->tbs, cert->tbs_size, sig->digest);
102 ret = is_hash_blacklisted(sig->digest, sig->digest_size, "tbs");
103 if (ret == -EKEYREJECTED) {
104 pr_err("Cert %*phN is blacklisted\n",
105 sig->digest_size, sig->digest);
106 cert->blacklisted = true;
113 crypto_free_shash(tfm);
114 #endif /* __UBOOT__ */
115 pr_devel("<==%s() = %d\n", __func__, ret);
121 * Check for self-signedness in an X.509 cert and if found, check the signature
122 * immediately if we can.
124 int x509_check_for_self_signed(struct x509_certificate *cert)
128 pr_devel("==>%s()\n", __func__);
130 if (cert->raw_subject_size != cert->raw_issuer_size ||
131 memcmp(cert->raw_subject, cert->raw_issuer,
132 cert->raw_issuer_size) != 0)
133 goto not_self_signed;
135 if (cert->sig->auth_ids[0] || cert->sig->auth_ids[1]) {
136 /* If the AKID is present it may have one or two parts. If
137 * both are supplied, both must match.
139 bool a = asymmetric_key_id_same(cert->skid, cert->sig->auth_ids[1]);
140 bool b = asymmetric_key_id_same(cert->id, cert->sig->auth_ids[0]);
143 goto not_self_signed;
146 if (((a && !b) || (b && !a)) &&
147 cert->sig->auth_ids[0] && cert->sig->auth_ids[1])
152 if (strcmp(cert->pub->pkey_algo, cert->sig->pkey_algo) != 0)
155 ret = public_key_verify_signature(cert->pub, cert->sig);
157 if (ret == -ENOPKG) {
158 cert->unsupported_sig = true;
164 pr_devel("Cert Self-signature verified");
165 cert->self_signed = true;
168 pr_devel("<==%s() = %d\n", __func__, ret);
172 pr_devel("<==%s() = 0 [not]\n", __func__);
177 * Attempt to parse a data blob for a key as an X509 certificate.
179 static int x509_key_preparse(struct key_preparsed_payload *prep)
181 struct asymmetric_key_ids *kids;
182 struct x509_certificate *cert;
185 char *desc = NULL, *p;
188 cert = x509_cert_parse(prep->data, prep->datalen);
190 return PTR_ERR(cert);
192 pr_devel("Cert Issuer: %s\n", cert->issuer);
193 pr_devel("Cert Subject: %s\n", cert->subject);
195 if (cert->unsupported_key) {
197 goto error_free_cert;
200 pr_devel("Cert Key Algo: %s\n", cert->pub->pkey_algo);
201 pr_devel("Cert Valid period: %lld-%lld\n", cert->valid_from, cert->valid_to);
203 cert->pub->id_type = "X509";
205 if (cert->unsupported_sig) {
206 public_key_signature_free(cert->sig);
209 pr_devel("Cert Signature: %s + %s\n",
210 cert->sig->pkey_algo, cert->sig->hash_algo);
213 /* Don't permit addition of blacklisted keys */
215 if (cert->blacklisted)
216 goto error_free_cert;
218 /* Propose a description */
219 sulen = strlen(cert->subject);
220 if (cert->raw_skid) {
221 srlen = cert->raw_skid_size;
224 srlen = cert->raw_serial_size;
225 q = cert->raw_serial;
229 desc = kmalloc(sulen + 2 + srlen * 2 + 1, GFP_KERNEL);
231 goto error_free_cert;
232 p = memcpy(desc, cert->subject, sulen);
236 p = bin2hex(p, q, srlen);
239 kids = kmalloc(sizeof(struct asymmetric_key_ids), GFP_KERNEL);
241 goto error_free_desc;
242 kids->id[0] = cert->id;
243 kids->id[1] = cert->skid;
245 /* We're pinning the module by being linked against it */
246 __module_get(public_key_subtype.owner);
247 prep->payload.data[asym_subtype] = &public_key_subtype;
248 prep->payload.data[asym_key_ids] = kids;
249 prep->payload.data[asym_crypto] = cert->pub;
250 prep->payload.data[asym_auth] = cert->sig;
251 prep->description = desc;
252 prep->quotalen = 100;
254 /* We've finished with the certificate */
265 x509_free_certificate(cert);
269 static struct asymmetric_key_parser x509_key_parser = {
270 .owner = THIS_MODULE,
272 .parse = x509_key_preparse,
278 static int __init x509_key_init(void)
280 return register_asymmetric_key_parser(&x509_key_parser);
283 static void __exit x509_key_exit(void)
285 unregister_asymmetric_key_parser(&x509_key_parser);
288 module_init(x509_key_init);
289 module_exit(x509_key_exit);
290 #endif /* !__UBOOT__ */
292 MODULE_DESCRIPTION("X.509 certificate parser");
293 MODULE_AUTHOR("Red Hat, Inc.");
294 MODULE_LICENSE("GPL");