2 * Copyright 2006-2020 The OpenSSL Project Authors. All Rights Reserved.
4 * Licensed under the Apache License 2.0 (the "License"). You may not use
5 * this file except in compliance with the License. You can obtain a copy
6 * in the file LICENSE in the source distribution or at
7 * https://www.openssl.org/source/license.html
11 * ECDH and ECDSA low level APIs are deprecated for public use, but still ok
14 #include "internal/deprecated.h"
17 #include "internal/cryptlib.h"
18 #include <openssl/asn1t.h>
19 #include <openssl/x509.h>
20 #include <openssl/ec.h>
22 #include <openssl/evp.h>
23 #include "crypto/evp.h"
25 /* EC pkey context structure */
28 /* Key and paramgen group */
32 /* Duplicate key if custom cofactor needed */
35 signed char cofactor_mode
;
36 /* KDF (if any) to use for ECDH */
38 /* Message digest to use for key derivation */
40 /* User key material */
41 unsigned char *kdf_ukm
;
43 /* KDF output length */
47 static int pkey_ec_init(EVP_PKEY_CTX
*ctx
)
51 if ((dctx
= OPENSSL_zalloc(sizeof(*dctx
))) == NULL
) {
52 ERR_raise(ERR_LIB_EC
, ERR_R_MALLOC_FAILURE
);
56 dctx
->cofactor_mode
= -1;
57 dctx
->kdf_type
= EVP_PKEY_ECDH_KDF_NONE
;
62 static int pkey_ec_copy(EVP_PKEY_CTX
*dst
, const EVP_PKEY_CTX
*src
)
64 EC_PKEY_CTX
*dctx
, *sctx
;
65 if (!pkey_ec_init(dst
))
69 if (sctx
->gen_group
) {
70 dctx
->gen_group
= EC_GROUP_dup(sctx
->gen_group
);
77 dctx
->co_key
= EC_KEY_dup(sctx
->co_key
);
81 dctx
->kdf_type
= sctx
->kdf_type
;
82 dctx
->kdf_md
= sctx
->kdf_md
;
83 dctx
->kdf_outlen
= sctx
->kdf_outlen
;
85 dctx
->kdf_ukm
= OPENSSL_memdup(sctx
->kdf_ukm
, sctx
->kdf_ukmlen
);
90 dctx
->kdf_ukmlen
= sctx
->kdf_ukmlen
;
94 static void pkey_ec_cleanup(EVP_PKEY_CTX
*ctx
)
96 EC_PKEY_CTX
*dctx
= ctx
->data
;
98 EC_GROUP_free(dctx
->gen_group
);
99 EC_KEY_free(dctx
->co_key
);
100 OPENSSL_free(dctx
->kdf_ukm
);
106 static int pkey_ec_sign(EVP_PKEY_CTX
*ctx
, unsigned char *sig
, size_t *siglen
,
107 const unsigned char *tbs
, size_t tbslen
)
111 EC_PKEY_CTX
*dctx
= ctx
->data
;
112 EC_KEY
*ec
= ctx
->pkey
->pkey
.ec
;
113 const int sig_sz
= ECDSA_size(ec
);
115 /* ensure cast to size_t is safe */
116 if (!ossl_assert(sig_sz
> 0))
120 *siglen
= (size_t)sig_sz
;
124 if (*siglen
< (size_t)sig_sz
) {
125 ERR_raise(ERR_LIB_EC
, EC_R_BUFFER_TOO_SMALL
);
129 type
= (dctx
->md
!= NULL
) ? EVP_MD_type(dctx
->md
) : NID_sha1
;
131 ret
= ECDSA_sign(type
, tbs
, tbslen
, sig
, &sltmp
, ec
);
135 *siglen
= (size_t)sltmp
;
139 static int pkey_ec_verify(EVP_PKEY_CTX
*ctx
,
140 const unsigned char *sig
, size_t siglen
,
141 const unsigned char *tbs
, size_t tbslen
)
144 EC_PKEY_CTX
*dctx
= ctx
->data
;
145 EC_KEY
*ec
= ctx
->pkey
->pkey
.ec
;
148 type
= EVP_MD_type(dctx
->md
);
152 ret
= ECDSA_verify(type
, tbs
, tbslen
, sig
, siglen
, ec
);
157 #ifndef OPENSSL_NO_EC
158 static int pkey_ec_derive(EVP_PKEY_CTX
*ctx
, unsigned char *key
, size_t *keylen
)
162 const EC_POINT
*pubkey
= NULL
;
164 EC_PKEY_CTX
*dctx
= ctx
->data
;
165 if (!ctx
->pkey
|| !ctx
->peerkey
) {
166 ERR_raise(ERR_LIB_EC
, EC_R_KEYS_NOT_SET
);
170 eckey
= dctx
->co_key
? dctx
->co_key
: ctx
->pkey
->pkey
.ec
;
173 const EC_GROUP
*group
;
174 group
= EC_KEY_get0_group(eckey
);
175 *keylen
= (EC_GROUP_get_degree(group
) + 7) / 8;
178 pubkey
= EC_KEY_get0_public_key(ctx
->peerkey
->pkey
.ec
);
181 * NB: unlike PKCS#3 DH, if *outlen is less than maximum size this is not
182 * an error, the result is truncated.
187 ret
= ECDH_compute_key(key
, outlen
, pubkey
, eckey
, 0);
194 static int pkey_ec_kdf_derive(EVP_PKEY_CTX
*ctx
,
195 unsigned char *key
, size_t *keylen
)
197 EC_PKEY_CTX
*dctx
= ctx
->data
;
198 unsigned char *ktmp
= NULL
;
201 if (dctx
->kdf_type
== EVP_PKEY_ECDH_KDF_NONE
)
202 return pkey_ec_derive(ctx
, key
, keylen
);
204 *keylen
= dctx
->kdf_outlen
;
207 if (*keylen
!= dctx
->kdf_outlen
)
209 if (!pkey_ec_derive(ctx
, NULL
, &ktmplen
))
211 if ((ktmp
= OPENSSL_malloc(ktmplen
)) == NULL
) {
212 ERR_raise(ERR_LIB_EC
, ERR_R_MALLOC_FAILURE
);
215 if (!pkey_ec_derive(ctx
, ktmp
, &ktmplen
))
218 if (!ecdh_KDF_X9_63(key
, *keylen
, ktmp
, ktmplen
,
219 dctx
->kdf_ukm
, dctx
->kdf_ukmlen
, dctx
->kdf_md
,
220 ctx
->libctx
, ctx
->propquery
))
225 OPENSSL_clear_free(ktmp
, ktmplen
);
230 static int pkey_ec_ctrl(EVP_PKEY_CTX
*ctx
, int type
, int p1
, void *p2
)
232 EC_PKEY_CTX
*dctx
= ctx
->data
;
235 case EVP_PKEY_CTRL_EC_PARAMGEN_CURVE_NID
:
236 group
= EC_GROUP_new_by_curve_name(p1
);
238 ERR_raise(ERR_LIB_EC
, EC_R_INVALID_CURVE
);
241 EC_GROUP_free(dctx
->gen_group
);
242 dctx
->gen_group
= group
;
245 case EVP_PKEY_CTRL_EC_PARAM_ENC
:
246 if (!dctx
->gen_group
) {
247 ERR_raise(ERR_LIB_EC
, EC_R_NO_PARAMETERS_SET
);
250 EC_GROUP_set_asn1_flag(dctx
->gen_group
, p1
);
253 #ifndef OPENSSL_NO_EC
254 case EVP_PKEY_CTRL_EC_ECDH_COFACTOR
:
256 if (dctx
->cofactor_mode
!= -1)
257 return dctx
->cofactor_mode
;
259 EC_KEY
*ec_key
= ctx
->pkey
->pkey
.ec
;
260 return EC_KEY_get_flags(ec_key
) & EC_FLAG_COFACTOR_ECDH
? 1 : 0;
262 } else if (p1
< -1 || p1
> 1)
264 dctx
->cofactor_mode
= p1
;
266 EC_KEY
*ec_key
= ctx
->pkey
->pkey
.ec
;
269 /* If cofactor is 1 cofactor mode does nothing */
270 if (BN_is_one(ec_key
->group
->cofactor
))
273 dctx
->co_key
= EC_KEY_dup(ec_key
);
278 EC_KEY_set_flags(dctx
->co_key
, EC_FLAG_COFACTOR_ECDH
);
280 EC_KEY_clear_flags(dctx
->co_key
, EC_FLAG_COFACTOR_ECDH
);
282 EC_KEY_free(dctx
->co_key
);
288 case EVP_PKEY_CTRL_EC_KDF_TYPE
:
290 return dctx
->kdf_type
;
291 if (p1
!= EVP_PKEY_ECDH_KDF_NONE
&& p1
!= EVP_PKEY_ECDH_KDF_X9_63
)
296 case EVP_PKEY_CTRL_EC_KDF_MD
:
300 case EVP_PKEY_CTRL_GET_EC_KDF_MD
:
301 *(const EVP_MD
**)p2
= dctx
->kdf_md
;
304 case EVP_PKEY_CTRL_EC_KDF_OUTLEN
:
307 dctx
->kdf_outlen
= (size_t)p1
;
310 case EVP_PKEY_CTRL_GET_EC_KDF_OUTLEN
:
311 *(int *)p2
= dctx
->kdf_outlen
;
314 case EVP_PKEY_CTRL_EC_KDF_UKM
:
315 OPENSSL_free(dctx
->kdf_ukm
);
318 dctx
->kdf_ukmlen
= p1
;
320 dctx
->kdf_ukmlen
= 0;
323 case EVP_PKEY_CTRL_GET_EC_KDF_UKM
:
324 *(unsigned char **)p2
= dctx
->kdf_ukm
;
325 return dctx
->kdf_ukmlen
;
327 case EVP_PKEY_CTRL_MD
:
328 if (EVP_MD_type((const EVP_MD
*)p2
) != NID_sha1
&&
329 EVP_MD_type((const EVP_MD
*)p2
) != NID_ecdsa_with_SHA1
&&
330 EVP_MD_type((const EVP_MD
*)p2
) != NID_sha224
&&
331 EVP_MD_type((const EVP_MD
*)p2
) != NID_sha256
&&
332 EVP_MD_type((const EVP_MD
*)p2
) != NID_sha384
&&
333 EVP_MD_type((const EVP_MD
*)p2
) != NID_sha512
&&
334 EVP_MD_type((const EVP_MD
*)p2
) != NID_sha3_224
&&
335 EVP_MD_type((const EVP_MD
*)p2
) != NID_sha3_256
&&
336 EVP_MD_type((const EVP_MD
*)p2
) != NID_sha3_384
&&
337 EVP_MD_type((const EVP_MD
*)p2
) != NID_sha3_512
&&
338 EVP_MD_type((const EVP_MD
*)p2
) != NID_sm3
) {
339 ERR_raise(ERR_LIB_EC
, EC_R_INVALID_DIGEST_TYPE
);
345 case EVP_PKEY_CTRL_GET_MD
:
346 *(const EVP_MD
**)p2
= dctx
->md
;
349 case EVP_PKEY_CTRL_PEER_KEY
:
350 /* Default behaviour is OK */
351 case EVP_PKEY_CTRL_DIGESTINIT
:
352 case EVP_PKEY_CTRL_PKCS7_SIGN
:
353 case EVP_PKEY_CTRL_CMS_SIGN
:
362 static int pkey_ec_ctrl_str(EVP_PKEY_CTX
*ctx
,
363 const char *type
, const char *value
)
365 if (strcmp(type
, "ec_paramgen_curve") == 0) {
367 nid
= EC_curve_nist2nid(value
);
368 if (nid
== NID_undef
)
369 nid
= OBJ_sn2nid(value
);
370 if (nid
== NID_undef
)
371 nid
= OBJ_ln2nid(value
);
372 if (nid
== NID_undef
) {
373 ERR_raise(ERR_LIB_EC
, EC_R_INVALID_CURVE
);
376 return EVP_PKEY_CTX_set_ec_paramgen_curve_nid(ctx
, nid
);
377 } else if (strcmp(type
, "ec_param_enc") == 0) {
379 if (strcmp(value
, "explicit") == 0)
381 else if (strcmp(value
, "named_curve") == 0)
382 param_enc
= OPENSSL_EC_NAMED_CURVE
;
385 return EVP_PKEY_CTX_set_ec_param_enc(ctx
, param_enc
);
386 } else if (strcmp(type
, "ecdh_kdf_md") == 0) {
388 if ((md
= EVP_get_digestbyname(value
)) == NULL
) {
389 ERR_raise(ERR_LIB_EC
, EC_R_INVALID_DIGEST
);
392 return EVP_PKEY_CTX_set_ecdh_kdf_md(ctx
, md
);
393 } else if (strcmp(type
, "ecdh_cofactor_mode") == 0) {
395 co_mode
= atoi(value
);
396 return EVP_PKEY_CTX_set_ecdh_cofactor_mode(ctx
, co_mode
);
402 static int pkey_ec_paramgen(EVP_PKEY_CTX
*ctx
, EVP_PKEY
*pkey
)
405 EC_PKEY_CTX
*dctx
= ctx
->data
;
408 if (dctx
->gen_group
== NULL
) {
409 ERR_raise(ERR_LIB_EC
, EC_R_NO_PARAMETERS_SET
);
415 if (!(ret
= EC_KEY_set_group(ec
, dctx
->gen_group
))
416 || !ossl_assert(ret
= EVP_PKEY_assign_EC_KEY(pkey
, ec
)))
421 static int pkey_ec_keygen(EVP_PKEY_CTX
*ctx
, EVP_PKEY
*pkey
)
424 EC_PKEY_CTX
*dctx
= ctx
->data
;
427 if (ctx
->pkey
== NULL
&& dctx
->gen_group
== NULL
) {
428 ERR_raise(ERR_LIB_EC
, EC_R_NO_PARAMETERS_SET
);
434 if (!ossl_assert(EVP_PKEY_assign_EC_KEY(pkey
, ec
))) {
438 /* Note: if error is returned, we count on caller to free pkey->pkey.ec */
439 if (ctx
->pkey
!= NULL
)
440 ret
= EVP_PKEY_copy_parameters(pkey
, ctx
->pkey
);
442 ret
= EC_KEY_set_group(ec
, dctx
->gen_group
);
444 return ret
? EC_KEY_generate_key(ec
) : 0;
447 static const EVP_PKEY_METHOD ec_pkey_meth
= {
477 #ifndef OPENSSL_NO_EC
486 const EVP_PKEY_METHOD
*ec_pkey_method(void)
488 return &ec_pkey_meth
;