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 <linux/compat.h>
12 #include <linux/errno.h>
14 #include <linux/module.h>
16 #include <linux/kernel.h>
18 #include <linux/slab.h>
19 #include <keys/asymmetric-subtype.h>
20 #include <keys/asymmetric-parser.h>
21 #include <keys/system_keyring.h>
22 #include <crypto/hash.h>
23 #include "asymmetric_keys.h"
25 #include "x509_parser.h"
28 * Set up the signature parameters in an X.509 certificate. This involves
29 * digesting the signed data and extracting the signature.
31 int x509_get_sig_params(struct x509_certificate *cert)
33 struct public_key_signature *sig = cert->sig;
35 struct crypto_shash *tfm;
36 struct shash_desc *desc;
41 pr_devel("==>%s()\n", __func__);
43 if (!cert->pub->pkey_algo)
44 cert->unsupported_key = true;
47 cert->unsupported_sig = true;
49 /* We check the hash if we can - even if we can't then verify it */
50 if (!sig->hash_algo) {
51 cert->unsupported_sig = true;
55 sig->s = kmemdup(cert->raw_sig, cert->raw_sig_size, GFP_KERNEL);
59 sig->s_size = cert->raw_sig_size;
64 * This part (filling sig->digest) should be implemented if
65 * x509_check_for_self_signed() is enabled x509_cert_parse().
66 * Currently, this check won't affect UEFI secure boot.
70 /* Allocate the hashing algorithm we're going to need and find out how
71 * big the hash operational data will be.
73 tfm = crypto_alloc_shash(sig->hash_algo, 0, 0);
75 if (PTR_ERR(tfm) == -ENOENT) {
76 cert->unsupported_sig = true;
82 desc_size = crypto_shash_descsize(tfm) + sizeof(*desc);
83 sig->digest_size = crypto_shash_digestsize(tfm);
86 sig->digest = kmalloc(sig->digest_size, GFP_KERNEL);
90 desc = kzalloc(desc_size, GFP_KERNEL);
96 ret = crypto_shash_digest(desc, cert->tbs, cert->tbs_size, sig->digest);
100 ret = is_hash_blacklisted(sig->digest, sig->digest_size, "tbs");
101 if (ret == -EKEYREJECTED) {
102 pr_err("Cert %*phN is blacklisted\n",
103 sig->digest_size, sig->digest);
104 cert->blacklisted = true;
111 crypto_free_shash(tfm);
112 #endif /* __UBOOT__ */
113 pr_devel("<==%s() = %d\n", __func__, ret);
119 * Check for self-signedness in an X.509 cert and if found, check the signature
120 * immediately if we can.
122 int x509_check_for_self_signed(struct x509_certificate *cert)
126 pr_devel("==>%s()\n", __func__);
128 if (cert->raw_subject_size != cert->raw_issuer_size ||
129 memcmp(cert->raw_subject, cert->raw_issuer,
130 cert->raw_issuer_size) != 0)
131 goto not_self_signed;
133 if (cert->sig->auth_ids[0] || cert->sig->auth_ids[1]) {
134 /* If the AKID is present it may have one or two parts. If
135 * both are supplied, both must match.
137 bool a = asymmetric_key_id_same(cert->skid, cert->sig->auth_ids[1]);
138 bool b = asymmetric_key_id_same(cert->id, cert->sig->auth_ids[0]);
141 goto not_self_signed;
144 if (((a && !b) || (b && !a)) &&
145 cert->sig->auth_ids[0] && cert->sig->auth_ids[1])
150 if (strcmp(cert->pub->pkey_algo, cert->sig->pkey_algo) != 0)
153 ret = public_key_verify_signature(cert->pub, cert->sig);
155 if (ret == -ENOPKG) {
156 cert->unsupported_sig = true;
162 pr_devel("Cert Self-signature verified");
163 cert->self_signed = true;
166 pr_devel("<==%s() = %d\n", __func__, ret);
170 pr_devel("<==%s() = 0 [not]\n", __func__);
175 * Attempt to parse a data blob for a key as an X509 certificate.
177 static int x509_key_preparse(struct key_preparsed_payload *prep)
179 struct asymmetric_key_ids *kids;
180 struct x509_certificate *cert;
183 char *desc = NULL, *p;
186 cert = x509_cert_parse(prep->data, prep->datalen);
188 return PTR_ERR(cert);
190 pr_devel("Cert Issuer: %s\n", cert->issuer);
191 pr_devel("Cert Subject: %s\n", cert->subject);
193 if (cert->unsupported_key) {
195 goto error_free_cert;
198 pr_devel("Cert Key Algo: %s\n", cert->pub->pkey_algo);
199 pr_devel("Cert Valid period: %lld-%lld\n", cert->valid_from, cert->valid_to);
201 cert->pub->id_type = "X509";
203 if (cert->unsupported_sig) {
204 public_key_signature_free(cert->sig);
207 pr_devel("Cert Signature: %s + %s\n",
208 cert->sig->pkey_algo, cert->sig->hash_algo);
211 /* Don't permit addition of blacklisted keys */
213 if (cert->blacklisted)
214 goto error_free_cert;
216 /* Propose a description */
217 sulen = strlen(cert->subject);
218 if (cert->raw_skid) {
219 srlen = cert->raw_skid_size;
222 srlen = cert->raw_serial_size;
223 q = cert->raw_serial;
227 desc = kmalloc(sulen + 2 + srlen * 2 + 1, GFP_KERNEL);
229 goto error_free_cert;
230 p = memcpy(desc, cert->subject, sulen);
234 p = bin2hex(p, q, srlen);
237 kids = kmalloc(sizeof(struct asymmetric_key_ids), GFP_KERNEL);
239 goto error_free_desc;
240 kids->id[0] = cert->id;
241 kids->id[1] = cert->skid;
243 /* We're pinning the module by being linked against it */
244 __module_get(public_key_subtype.owner);
245 prep->payload.data[asym_subtype] = &public_key_subtype;
246 prep->payload.data[asym_key_ids] = kids;
247 prep->payload.data[asym_crypto] = cert->pub;
248 prep->payload.data[asym_auth] = cert->sig;
249 prep->description = desc;
250 prep->quotalen = 100;
252 /* We've finished with the certificate */
263 x509_free_certificate(cert);
267 static struct asymmetric_key_parser x509_key_parser = {
268 .owner = THIS_MODULE,
270 .parse = x509_key_preparse,
276 static int __init x509_key_init(void)
278 return register_asymmetric_key_parser(&x509_key_parser);
281 static void __exit x509_key_exit(void)
283 unregister_asymmetric_key_parser(&x509_key_parser);
286 module_init(x509_key_init);
287 module_exit(x509_key_exit);
288 #endif /* !__UBOOT__ */
290 MODULE_DESCRIPTION("X.509 certificate parser");
291 MODULE_AUTHOR("Red Hat, Inc.");
292 MODULE_LICENSE("GPL");