1 // SPDX-License-Identifier: GPL-2.0+
3 * Elliptic Curve (Russian) Digital Signature Algorithm for Cryptographic API
5 * Copyright (c) 2019 Vitaly Chikunov <vt@altlinux.org>
8 * GOST 34.10-2018, GOST R 34.10-2012, RFC 7091, ISO/IEC 14888-3:2018.
10 * Historical references:
11 * GOST R 34.10-2001, RFC 4357, ISO/IEC 14888-3:2006/Amd 1:2010.
13 * This program is free software; you can redistribute it and/or modify it
14 * under the terms of the GNU General Public License as published by the Free
15 * Software Foundation; either version 2 of the License, or (at your option)
19 #include <linux/module.h>
20 #include <linux/crypto.h>
21 #include <crypto/streebog.h>
22 #include <crypto/internal/akcipher.h>
23 #include <crypto/internal/ecc.h>
24 #include <crypto/akcipher.h>
25 #include <linux/oid_registry.h>
26 #include <linux/scatterlist.h>
27 #include "ecrdsa_params.asn1.h"
28 #include "ecrdsa_pub_key.asn1.h"
29 #include "ecrdsa_defs.h"
31 #define ECRDSA_MAX_SIG_SIZE (2 * 512 / 8)
32 #define ECRDSA_MAX_DIGITS (512 / 64)
35 enum OID algo_oid; /* overall public key oid */
36 enum OID curve_oid; /* parameter */
37 enum OID digest_oid; /* parameter */
38 const struct ecc_curve *curve; /* curve from oid */
39 unsigned int digest_len; /* parameter (bytes) */
40 const char *digest; /* digest name from oid */
41 unsigned int key_len; /* @key length (bytes) */
42 const char *key; /* raw public key */
43 struct ecc_point pub_key;
44 u64 _pubp[2][ECRDSA_MAX_DIGITS]; /* point storage for @pub_key */
47 static const struct ecc_curve *get_curve_by_oid(enum OID oid)
51 case OID_gostTC26Sign256B:
54 case OID_gostTC26Sign256C:
57 case OID_gostTC26Sign256D:
59 case OID_gostTC26Sign512A:
61 case OID_gostTC26Sign512B:
63 /* The following two aren't implemented: */
64 case OID_gostTC26Sign256A:
65 case OID_gostTC26Sign512C:
71 static int ecrdsa_verify(struct akcipher_request *req)
73 struct crypto_akcipher *tfm = crypto_akcipher_reqtfm(req);
74 struct ecrdsa_ctx *ctx = akcipher_tfm_ctx(tfm);
75 unsigned char sig[ECRDSA_MAX_SIG_SIZE];
76 unsigned char digest[STREEBOG512_DIGEST_SIZE];
77 unsigned int ndigits = req->dst_len / sizeof(u64);
78 u64 r[ECRDSA_MAX_DIGITS]; /* witness (r) */
79 u64 _r[ECRDSA_MAX_DIGITS]; /* -r */
80 u64 s[ECRDSA_MAX_DIGITS]; /* second part of sig (s) */
81 u64 e[ECRDSA_MAX_DIGITS]; /* h \mod q */
82 u64 *v = e; /* e^{-1} \mod q */
83 u64 z1[ECRDSA_MAX_DIGITS];
85 struct ecc_point cc = ECC_POINT_INIT(s, e, ndigits); /* reuse s, e */
88 * Digest value, digest algorithm, and curve (modulus) should have the
89 * same length (256 or 512 bits), public key and signature should be
96 req->dst_len != ctx->digest_len ||
97 req->dst_len != ctx->curve->g.ndigits * sizeof(u64) ||
98 ctx->pub_key.ndigits != ctx->curve->g.ndigits ||
99 req->dst_len * 2 != req->src_len ||
100 WARN_ON(req->src_len > sizeof(sig)) ||
101 WARN_ON(req->dst_len > sizeof(digest)))
104 sg_copy_to_buffer(req->src, sg_nents_for_len(req->src, req->src_len),
106 sg_pcopy_to_buffer(req->src,
107 sg_nents_for_len(req->src,
108 req->src_len + req->dst_len),
109 digest, req->dst_len, req->src_len);
111 vli_from_be64(s, sig, ndigits);
112 vli_from_be64(r, sig + ndigits * sizeof(u64), ndigits);
114 /* Step 1: verify that 0 < r < q, 0 < s < q */
115 if (vli_is_zero(r, ndigits) ||
116 vli_cmp(r, ctx->curve->n, ndigits) == 1 ||
117 vli_is_zero(s, ndigits) ||
118 vli_cmp(s, ctx->curve->n, ndigits) == 1)
119 return -EKEYREJECTED;
121 /* Step 2: calculate hash (h) of the message (passed as input) */
122 /* Step 3: calculate e = h \mod q */
123 vli_from_le64(e, digest, ndigits);
124 if (vli_cmp(e, ctx->curve->n, ndigits) == 1)
125 vli_sub(e, e, ctx->curve->n, ndigits);
126 if (vli_is_zero(e, ndigits))
129 /* Step 4: calculate v = e^{-1} \mod q */
130 vli_mod_inv(v, e, ctx->curve->n, ndigits);
132 /* Step 5: calculate z_1 = sv \mod q, z_2 = -rv \mod q */
133 vli_mod_mult_slow(z1, s, v, ctx->curve->n, ndigits);
134 vli_sub(_r, ctx->curve->n, r, ndigits);
135 vli_mod_mult_slow(z2, _r, v, ctx->curve->n, ndigits);
137 /* Step 6: calculate point C = z_1P + z_2Q, and R = x_c \mod q */
138 ecc_point_mult_shamir(&cc, z1, &ctx->curve->g, z2, &ctx->pub_key,
140 if (vli_cmp(cc.x, ctx->curve->n, ndigits) == 1)
141 vli_sub(cc.x, cc.x, ctx->curve->n, ndigits);
143 /* Step 7: if R == r signature is valid */
144 if (!vli_cmp(cc.x, r, ndigits))
147 return -EKEYREJECTED;
150 int ecrdsa_param_curve(void *context, size_t hdrlen, unsigned char tag,
151 const void *value, size_t vlen)
153 struct ecrdsa_ctx *ctx = context;
155 ctx->curve_oid = look_up_OID(value, vlen);
158 ctx->curve = get_curve_by_oid(ctx->curve_oid);
162 /* Optional. If present should match expected digest algo OID. */
163 int ecrdsa_param_digest(void *context, size_t hdrlen, unsigned char tag,
164 const void *value, size_t vlen)
166 struct ecrdsa_ctx *ctx = context;
167 int digest_oid = look_up_OID(value, vlen);
169 if (digest_oid != ctx->digest_oid)
174 int ecrdsa_parse_pub_key(void *context, size_t hdrlen, unsigned char tag,
175 const void *value, size_t vlen)
177 struct ecrdsa_ctx *ctx = context;
184 static u8 *ecrdsa_unpack_u32(u32 *dst, void *src)
186 memcpy(dst, src, sizeof(u32));
187 return src + sizeof(u32);
190 /* Parse BER encoded subjectPublicKey. */
191 static int ecrdsa_set_pub_key(struct crypto_akcipher *tfm, const void *key,
194 struct ecrdsa_ctx *ctx = akcipher_tfm_ctx(tfm);
195 unsigned int ndigits;
200 err = asn1_ber_decoder(&ecrdsa_pub_key_decoder, ctx, key, keylen);
204 /* Key parameters is in the key after keylen. */
205 params = ecrdsa_unpack_u32(¶mlen,
206 ecrdsa_unpack_u32(&algo, (u8 *)key + keylen));
208 if (algo == OID_gost2012PKey256) {
209 ctx->digest = "streebog256";
210 ctx->digest_oid = OID_gost2012Digest256;
211 ctx->digest_len = 256 / 8;
212 } else if (algo == OID_gost2012PKey512) {
213 ctx->digest = "streebog512";
214 ctx->digest_oid = OID_gost2012Digest512;
215 ctx->digest_len = 512 / 8;
218 ctx->algo_oid = algo;
220 /* Parse SubjectPublicKeyInfo.AlgorithmIdentifier.parameters. */
221 err = asn1_ber_decoder(&ecrdsa_params_decoder, ctx, params, paramlen);
225 * Sizes of algo (set in digest_len) and curve should match
229 ctx->curve->g.ndigits * sizeof(u64) != ctx->digest_len)
232 * Key is two 256- or 512-bit coordinates which should match
235 if ((ctx->key_len != (2 * 256 / 8) &&
236 ctx->key_len != (2 * 512 / 8)) ||
237 ctx->key_len != ctx->curve->g.ndigits * sizeof(u64) * 2)
240 ndigits = ctx->key_len / sizeof(u64) / 2;
241 ctx->pub_key = ECC_POINT_INIT(ctx->_pubp[0], ctx->_pubp[1], ndigits);
242 vli_from_le64(ctx->pub_key.x, ctx->key, ndigits);
243 vli_from_le64(ctx->pub_key.y, ctx->key + ndigits * sizeof(u64),
246 if (ecc_is_pubkey_valid_partial(ctx->curve, &ctx->pub_key))
247 return -EKEYREJECTED;
252 static unsigned int ecrdsa_max_size(struct crypto_akcipher *tfm)
254 struct ecrdsa_ctx *ctx = akcipher_tfm_ctx(tfm);
257 * Verify doesn't need any output, so it's just informational
258 * for keyctl to determine the key bit size.
260 return ctx->pub_key.ndigits * sizeof(u64);
263 static void ecrdsa_exit_tfm(struct crypto_akcipher *tfm)
267 static struct akcipher_alg ecrdsa_alg = {
268 .verify = ecrdsa_verify,
269 .set_pub_key = ecrdsa_set_pub_key,
270 .max_size = ecrdsa_max_size,
271 .exit = ecrdsa_exit_tfm,
273 .cra_name = "ecrdsa",
274 .cra_driver_name = "ecrdsa-generic",
276 .cra_module = THIS_MODULE,
277 .cra_ctxsize = sizeof(struct ecrdsa_ctx),
281 static int __init ecrdsa_mod_init(void)
283 return crypto_register_akcipher(&ecrdsa_alg);
286 static void __exit ecrdsa_mod_fini(void)
288 crypto_unregister_akcipher(&ecrdsa_alg);
291 module_init(ecrdsa_mod_init);
292 module_exit(ecrdsa_mod_fini);
294 MODULE_LICENSE("GPL");
295 MODULE_AUTHOR("Vitaly Chikunov <vt@altlinux.org>");
296 MODULE_DESCRIPTION("EC-RDSA generic algorithm");
297 MODULE_ALIAS_CRYPTO("ecrdsa-generic");