1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /* In-software asymmetric public-key crypto subtype
4 * See Documentation/crypto/asymmetric-keys.rst
6 * Copyright (C) 2012 Red Hat, Inc. All Rights Reserved.
7 * Written by David Howells (dhowells@redhat.com)
10 #define pr_fmt(fmt) "PKEY: "fmt
11 #include <linux/module.h>
12 #include <linux/export.h>
13 #include <linux/kernel.h>
14 #include <linux/slab.h>
15 #include <linux/seq_file.h>
16 #include <linux/scatterlist.h>
17 #include <linux/asn1.h>
18 #include <keys/asymmetric-subtype.h>
19 #include <crypto/public_key.h>
20 #include <crypto/akcipher.h>
21 #include <crypto/sm2.h>
22 #include <crypto/sm3_base.h>
24 MODULE_DESCRIPTION("In-software asymmetric public-key subtype");
25 MODULE_AUTHOR("Red Hat, Inc.");
26 MODULE_LICENSE("GPL");
29 * Provide a part of a description of the key for /proc/keys.
31 static void public_key_describe(const struct key *asymmetric_key,
34 struct public_key *key = asymmetric_key->payload.data[asym_crypto];
37 seq_printf(m, "%s.%s", key->id_type, key->pkey_algo);
41 * Destroy a public key algorithm key.
43 void public_key_free(struct public_key *key)
51 EXPORT_SYMBOL_GPL(public_key_free);
54 * Destroy a public key algorithm key.
56 static void public_key_destroy(void *payload0, void *payload3)
58 public_key_free(payload0);
59 public_key_signature_free(payload3);
63 * Given a public_key, and an encoding and hash_algo to be used for signing
64 * and/or verification with that key, determine the name of the corresponding
65 * akcipher algorithm. Also check that encoding and hash_algo are allowed.
68 software_key_determine_akcipher(const struct public_key *pkey,
69 const char *encoding, const char *hash_algo,
70 char alg_name[CRYPTO_MAX_ALG_NAME])
77 if (strcmp(pkey->pkey_algo, "rsa") == 0) {
79 * RSA signatures usually use EMSA-PKCS1-1_5 [RFC3447 sec 8.2].
81 if (strcmp(encoding, "pkcs1") == 0) {
83 n = snprintf(alg_name, CRYPTO_MAX_ALG_NAME,
87 n = snprintf(alg_name, CRYPTO_MAX_ALG_NAME,
89 pkey->pkey_algo, hash_algo);
90 return n >= CRYPTO_MAX_ALG_NAME ? -EINVAL : 0;
92 if (strcmp(encoding, "raw") != 0)
95 * Raw RSA cannot differentiate between different hash
100 } else if (strncmp(pkey->pkey_algo, "ecdsa", 5) == 0) {
101 if (strcmp(encoding, "x962") != 0)
104 * ECDSA signatures are taken over a raw hash, so they don't
105 * differentiate between different hash algorithms. That means
106 * that the verifier should hard-code a specific hash algorithm.
107 * Unfortunately, in practice ECDSA is used with multiple SHAs,
108 * so we have to allow all of them and not just one.
112 if (strcmp(hash_algo, "sha1") != 0 &&
113 strcmp(hash_algo, "sha224") != 0 &&
114 strcmp(hash_algo, "sha256") != 0 &&
115 strcmp(hash_algo, "sha384") != 0 &&
116 strcmp(hash_algo, "sha512") != 0)
118 } else if (strcmp(pkey->pkey_algo, "sm2") == 0) {
119 if (strcmp(encoding, "raw") != 0)
123 if (strcmp(hash_algo, "sm3") != 0)
125 } else if (strcmp(pkey->pkey_algo, "ecrdsa") == 0) {
126 if (strcmp(encoding, "raw") != 0)
130 if (strcmp(hash_algo, "streebog256") != 0 &&
131 strcmp(hash_algo, "streebog512") != 0)
134 /* Unknown public key algorithm */
137 if (strscpy(alg_name, pkey->pkey_algo, CRYPTO_MAX_ALG_NAME) < 0)
142 static u8 *pkey_pack_u32(u8 *dst, u32 val)
144 memcpy(dst, &val, sizeof(val));
145 return dst + sizeof(val);
149 * Query information about a key.
151 static int software_key_query(const struct kernel_pkey_params *params,
152 struct kernel_pkey_query *info)
154 struct crypto_akcipher *tfm;
155 struct public_key *pkey = params->key->payload.data[asym_crypto];
156 char alg_name[CRYPTO_MAX_ALG_NAME];
160 ret = software_key_determine_akcipher(pkey, params->encoding,
161 params->hash_algo, alg_name);
165 tfm = crypto_alloc_akcipher(alg_name, 0, 0);
170 key = kmalloc(pkey->keylen + sizeof(u32) * 2 + pkey->paramlen,
174 memcpy(key, pkey->key, pkey->keylen);
175 ptr = key + pkey->keylen;
176 ptr = pkey_pack_u32(ptr, pkey->algo);
177 ptr = pkey_pack_u32(ptr, pkey->paramlen);
178 memcpy(ptr, pkey->params, pkey->paramlen);
180 if (pkey->key_is_private)
181 ret = crypto_akcipher_set_priv_key(tfm, key, pkey->keylen);
183 ret = crypto_akcipher_set_pub_key(tfm, key, pkey->keylen);
187 len = crypto_akcipher_maxsize(tfm);
188 info->key_size = len * 8;
190 if (strncmp(pkey->pkey_algo, "ecdsa", 5) == 0) {
192 * ECDSA key sizes are much smaller than RSA, and thus could
193 * operate on (hashed) inputs that are larger than key size.
194 * For example SHA384-hashed input used with secp256r1
195 * based keys. Set max_data_size to be at least as large as
196 * the largest supported hash size (SHA512)
198 info->max_data_size = 64;
201 * Verify takes ECDSA-Sig (described in RFC 5480) as input,
202 * which is actually 2 'key_size'-bit integers encoded in
203 * ASN.1. Account for the ASN.1 encoding overhead here.
205 info->max_sig_size = 2 * (len + 3) + 2;
207 info->max_data_size = len;
208 info->max_sig_size = len;
211 info->max_enc_size = len;
212 info->max_dec_size = len;
213 info->supported_ops = (KEYCTL_SUPPORTS_ENCRYPT |
214 KEYCTL_SUPPORTS_VERIFY);
215 if (pkey->key_is_private)
216 info->supported_ops |= (KEYCTL_SUPPORTS_DECRYPT |
217 KEYCTL_SUPPORTS_SIGN);
223 crypto_free_akcipher(tfm);
224 pr_devel("<==%s() = %d\n", __func__, ret);
229 * Do encryption, decryption and signing ops.
231 static int software_key_eds_op(struct kernel_pkey_params *params,
232 const void *in, void *out)
234 const struct public_key *pkey = params->key->payload.data[asym_crypto];
235 struct akcipher_request *req;
236 struct crypto_akcipher *tfm;
237 struct crypto_wait cwait;
238 struct scatterlist in_sg, out_sg;
239 char alg_name[CRYPTO_MAX_ALG_NAME];
243 pr_devel("==>%s()\n", __func__);
245 ret = software_key_determine_akcipher(pkey, params->encoding,
246 params->hash_algo, alg_name);
250 tfm = crypto_alloc_akcipher(alg_name, 0, 0);
255 req = akcipher_request_alloc(tfm, GFP_KERNEL);
259 key = kmalloc(pkey->keylen + sizeof(u32) * 2 + pkey->paramlen,
264 memcpy(key, pkey->key, pkey->keylen);
265 ptr = key + pkey->keylen;
266 ptr = pkey_pack_u32(ptr, pkey->algo);
267 ptr = pkey_pack_u32(ptr, pkey->paramlen);
268 memcpy(ptr, pkey->params, pkey->paramlen);
270 if (pkey->key_is_private)
271 ret = crypto_akcipher_set_priv_key(tfm, key, pkey->keylen);
273 ret = crypto_akcipher_set_pub_key(tfm, key, pkey->keylen);
277 sg_init_one(&in_sg, in, params->in_len);
278 sg_init_one(&out_sg, out, params->out_len);
279 akcipher_request_set_crypt(req, &in_sg, &out_sg, params->in_len,
281 crypto_init_wait(&cwait);
282 akcipher_request_set_callback(req, CRYPTO_TFM_REQ_MAY_BACKLOG |
283 CRYPTO_TFM_REQ_MAY_SLEEP,
284 crypto_req_done, &cwait);
286 /* Perform the encryption calculation. */
287 switch (params->op) {
288 case kernel_pkey_encrypt:
289 ret = crypto_akcipher_encrypt(req);
291 case kernel_pkey_decrypt:
292 ret = crypto_akcipher_decrypt(req);
294 case kernel_pkey_sign:
295 ret = crypto_akcipher_sign(req);
301 ret = crypto_wait_req(ret, &cwait);
308 akcipher_request_free(req);
310 crypto_free_akcipher(tfm);
311 pr_devel("<==%s() = %d\n", __func__, ret);
315 #if IS_REACHABLE(CONFIG_CRYPTO_SM2)
316 static int cert_sig_digest_update(const struct public_key_signature *sig,
317 struct crypto_akcipher *tfm_pkey)
319 struct crypto_shash *tfm;
320 struct shash_desc *desc;
322 unsigned char dgst[SM3_DIGEST_SIZE];
327 /* SM2 signatures always use the SM3 hash algorithm */
328 if (!sig->hash_algo || strcmp(sig->hash_algo, "sm3") != 0)
331 ret = sm2_compute_z_digest(tfm_pkey, SM2_DEFAULT_USERID,
332 SM2_DEFAULT_USERID_LEN, dgst);
336 tfm = crypto_alloc_shash(sig->hash_algo, 0, 0);
340 desc_size = crypto_shash_descsize(tfm) + sizeof(*desc);
341 desc = kzalloc(desc_size, GFP_KERNEL);
349 ret = crypto_shash_init(desc);
351 goto error_free_desc;
353 ret = crypto_shash_update(desc, dgst, SM3_DIGEST_SIZE);
355 goto error_free_desc;
357 ret = crypto_shash_finup(desc, sig->data, sig->data_size, sig->digest);
362 crypto_free_shash(tfm);
366 static inline int cert_sig_digest_update(
367 const struct public_key_signature *sig,
368 struct crypto_akcipher *tfm_pkey)
372 #endif /* ! IS_REACHABLE(CONFIG_CRYPTO_SM2) */
375 * Verify a signature using a public key.
377 int public_key_verify_signature(const struct public_key *pkey,
378 const struct public_key_signature *sig)
380 struct crypto_wait cwait;
381 struct crypto_akcipher *tfm;
382 struct akcipher_request *req;
383 struct scatterlist src_sg[2];
384 char alg_name[CRYPTO_MAX_ALG_NAME];
388 pr_devel("==>%s()\n", __func__);
395 * If the signature specifies a public key algorithm, it *must* match
396 * the key's actual public key algorithm.
398 * Small exception: ECDSA signatures don't specify the curve, but ECDSA
399 * keys do. So the strings can mismatch slightly in that case:
400 * "ecdsa-nist-*" for the key, but "ecdsa" for the signature.
402 if (sig->pkey_algo) {
403 if (strcmp(pkey->pkey_algo, sig->pkey_algo) != 0 &&
404 (strncmp(pkey->pkey_algo, "ecdsa-", 6) != 0 ||
405 strcmp(sig->pkey_algo, "ecdsa") != 0))
406 return -EKEYREJECTED;
409 ret = software_key_determine_akcipher(pkey, sig->encoding,
410 sig->hash_algo, alg_name);
414 tfm = crypto_alloc_akcipher(alg_name, 0, 0);
419 req = akcipher_request_alloc(tfm, GFP_KERNEL);
423 key = kmalloc(pkey->keylen + sizeof(u32) * 2 + pkey->paramlen,
428 memcpy(key, pkey->key, pkey->keylen);
429 ptr = key + pkey->keylen;
430 ptr = pkey_pack_u32(ptr, pkey->algo);
431 ptr = pkey_pack_u32(ptr, pkey->paramlen);
432 memcpy(ptr, pkey->params, pkey->paramlen);
434 if (pkey->key_is_private)
435 ret = crypto_akcipher_set_priv_key(tfm, key, pkey->keylen);
437 ret = crypto_akcipher_set_pub_key(tfm, key, pkey->keylen);
441 if (strcmp(pkey->pkey_algo, "sm2") == 0 && sig->data_size) {
442 ret = cert_sig_digest_update(sig, tfm);
447 sg_init_table(src_sg, 2);
448 sg_set_buf(&src_sg[0], sig->s, sig->s_size);
449 sg_set_buf(&src_sg[1], sig->digest, sig->digest_size);
450 akcipher_request_set_crypt(req, src_sg, NULL, sig->s_size,
452 crypto_init_wait(&cwait);
453 akcipher_request_set_callback(req, CRYPTO_TFM_REQ_MAY_BACKLOG |
454 CRYPTO_TFM_REQ_MAY_SLEEP,
455 crypto_req_done, &cwait);
456 ret = crypto_wait_req(crypto_akcipher_verify(req), &cwait);
461 akcipher_request_free(req);
463 crypto_free_akcipher(tfm);
464 pr_devel("<==%s() = %d\n", __func__, ret);
465 if (WARN_ON_ONCE(ret > 0))
469 EXPORT_SYMBOL_GPL(public_key_verify_signature);
471 static int public_key_verify_signature_2(const struct key *key,
472 const struct public_key_signature *sig)
474 const struct public_key *pk = key->payload.data[asym_crypto];
475 return public_key_verify_signature(pk, sig);
479 * Public key algorithm asymmetric key subtype
481 struct asymmetric_key_subtype public_key_subtype = {
482 .owner = THIS_MODULE,
483 .name = "public_key",
484 .name_len = sizeof("public_key") - 1,
485 .describe = public_key_describe,
486 .destroy = public_key_destroy,
487 .query = software_key_query,
488 .eds_op = software_key_eds_op,
489 .verify_signature = public_key_verify_signature_2,
491 EXPORT_SYMBOL_GPL(public_key_subtype);