2 * Copyright 2002-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 * ECDSA low level APIs are deprecated for public use, but still ok for
14 #include "internal/deprecated.h"
18 #include <openssl/err.h>
19 #include <openssl/asn1t.h>
20 #include <openssl/objects.h>
21 #include "internal/nelem.h"
22 #include "crypto/asn1_dsa.h"
26 int EC_GROUP_get_basis_type(const EC_GROUP *group)
30 if (EC_GROUP_get_field_type(group) != NID_X9_62_characteristic_two_field)
31 /* everything else is currently not supported */
34 /* Find the last non-zero element of group->poly[] */
36 i < (int)OSSL_NELEM(group->poly) && group->poly[i] != 0;
41 return NID_X9_62_ppBasis;
43 return NID_X9_62_tpBasis;
45 /* everything else is currently not supported */
49 #ifndef OPENSSL_NO_EC2M
50 int EC_GROUP_get_trinomial_basis(const EC_GROUP *group, unsigned int *k)
55 if (EC_GROUP_get_field_type(group) != NID_X9_62_characteristic_two_field
56 || !((group->poly[0] != 0) && (group->poly[1] != 0)
57 && (group->poly[2] == 0))) {
58 ECerr(EC_F_EC_GROUP_GET_TRINOMIAL_BASIS,
59 ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
69 int EC_GROUP_get_pentanomial_basis(const EC_GROUP *group, unsigned int *k1,
70 unsigned int *k2, unsigned int *k3)
75 if (EC_GROUP_get_field_type(group) != NID_X9_62_characteristic_two_field
76 || !((group->poly[0] != 0) && (group->poly[1] != 0)
77 && (group->poly[2] != 0) && (group->poly[3] != 0)
78 && (group->poly[4] == 0))) {
79 ECerr(EC_F_EC_GROUP_GET_PENTANOMIAL_BASIS,
80 ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
95 /* some structures needed for the asn1 encoding */
96 typedef struct x9_62_pentanomial_st {
102 typedef struct x9_62_characteristic_two_st {
107 /* NID_X9_62_onBasis */
109 /* NID_X9_62_tpBasis */
110 ASN1_INTEGER *tpBasis;
111 /* NID_X9_62_ppBasis */
112 X9_62_PENTANOMIAL *ppBasis;
116 } X9_62_CHARACTERISTIC_TWO;
118 typedef struct x9_62_fieldid_st {
119 ASN1_OBJECT *fieldType;
122 /* NID_X9_62_prime_field */
124 /* NID_X9_62_characteristic_two_field */
125 X9_62_CHARACTERISTIC_TWO *char_two;
131 typedef struct x9_62_curve_st {
132 ASN1_OCTET_STRING *a;
133 ASN1_OCTET_STRING *b;
134 ASN1_BIT_STRING *seed;
137 struct ec_parameters_st {
139 X9_62_FIELDID *fieldID;
141 ASN1_OCTET_STRING *base;
143 ASN1_INTEGER *cofactor;
144 } /* ECPARAMETERS */ ;
146 struct ecpk_parameters_st {
149 ASN1_OBJECT *named_curve;
150 ECPARAMETERS *parameters;
151 ASN1_NULL *implicitlyCA;
153 } /* ECPKPARAMETERS */ ;
155 /* SEC1 ECPrivateKey */
156 typedef struct ec_privatekey_st {
158 ASN1_OCTET_STRING *privateKey;
159 ECPKPARAMETERS *parameters;
160 ASN1_BIT_STRING *publicKey;
163 /* the OpenSSL ASN.1 definitions */
164 ASN1_SEQUENCE(X9_62_PENTANOMIAL) = {
165 ASN1_EMBED(X9_62_PENTANOMIAL, k1, INT32),
166 ASN1_EMBED(X9_62_PENTANOMIAL, k2, INT32),
167 ASN1_EMBED(X9_62_PENTANOMIAL, k3, INT32)
168 } static_ASN1_SEQUENCE_END(X9_62_PENTANOMIAL)
170 DECLARE_ASN1_ALLOC_FUNCTIONS(X9_62_PENTANOMIAL)
171 IMPLEMENT_ASN1_ALLOC_FUNCTIONS(X9_62_PENTANOMIAL)
173 ASN1_ADB_TEMPLATE(char_two_def) = ASN1_SIMPLE(X9_62_CHARACTERISTIC_TWO, p.other, ASN1_ANY);
175 ASN1_ADB(X9_62_CHARACTERISTIC_TWO) = {
176 ADB_ENTRY(NID_X9_62_onBasis, ASN1_SIMPLE(X9_62_CHARACTERISTIC_TWO, p.onBasis, ASN1_NULL)),
177 ADB_ENTRY(NID_X9_62_tpBasis, ASN1_SIMPLE(X9_62_CHARACTERISTIC_TWO, p.tpBasis, ASN1_INTEGER)),
178 ADB_ENTRY(NID_X9_62_ppBasis, ASN1_SIMPLE(X9_62_CHARACTERISTIC_TWO, p.ppBasis, X9_62_PENTANOMIAL))
179 } ASN1_ADB_END(X9_62_CHARACTERISTIC_TWO, 0, type, 0, &char_two_def_tt, NULL);
181 ASN1_SEQUENCE(X9_62_CHARACTERISTIC_TWO) = {
182 ASN1_EMBED(X9_62_CHARACTERISTIC_TWO, m, INT32),
183 ASN1_SIMPLE(X9_62_CHARACTERISTIC_TWO, type, ASN1_OBJECT),
184 ASN1_ADB_OBJECT(X9_62_CHARACTERISTIC_TWO)
185 } static_ASN1_SEQUENCE_END(X9_62_CHARACTERISTIC_TWO)
187 DECLARE_ASN1_ALLOC_FUNCTIONS(X9_62_CHARACTERISTIC_TWO)
188 IMPLEMENT_ASN1_ALLOC_FUNCTIONS(X9_62_CHARACTERISTIC_TWO)
190 ASN1_ADB_TEMPLATE(fieldID_def) = ASN1_SIMPLE(X9_62_FIELDID, p.other, ASN1_ANY);
192 ASN1_ADB(X9_62_FIELDID) = {
193 ADB_ENTRY(NID_X9_62_prime_field, ASN1_SIMPLE(X9_62_FIELDID, p.prime, ASN1_INTEGER)),
194 ADB_ENTRY(NID_X9_62_characteristic_two_field, ASN1_SIMPLE(X9_62_FIELDID, p.char_two, X9_62_CHARACTERISTIC_TWO))
195 } ASN1_ADB_END(X9_62_FIELDID, 0, fieldType, 0, &fieldID_def_tt, NULL);
197 ASN1_SEQUENCE(X9_62_FIELDID) = {
198 ASN1_SIMPLE(X9_62_FIELDID, fieldType, ASN1_OBJECT),
199 ASN1_ADB_OBJECT(X9_62_FIELDID)
200 } static_ASN1_SEQUENCE_END(X9_62_FIELDID)
202 ASN1_SEQUENCE(X9_62_CURVE) = {
203 ASN1_SIMPLE(X9_62_CURVE, a, ASN1_OCTET_STRING),
204 ASN1_SIMPLE(X9_62_CURVE, b, ASN1_OCTET_STRING),
205 ASN1_OPT(X9_62_CURVE, seed, ASN1_BIT_STRING)
206 } static_ASN1_SEQUENCE_END(X9_62_CURVE)
208 ASN1_SEQUENCE(ECPARAMETERS) = {
209 ASN1_EMBED(ECPARAMETERS, version, INT32),
210 ASN1_SIMPLE(ECPARAMETERS, fieldID, X9_62_FIELDID),
211 ASN1_SIMPLE(ECPARAMETERS, curve, X9_62_CURVE),
212 ASN1_SIMPLE(ECPARAMETERS, base, ASN1_OCTET_STRING),
213 ASN1_SIMPLE(ECPARAMETERS, order, ASN1_INTEGER),
214 ASN1_OPT(ECPARAMETERS, cofactor, ASN1_INTEGER)
215 } ASN1_SEQUENCE_END(ECPARAMETERS)
217 DECLARE_ASN1_ALLOC_FUNCTIONS(ECPARAMETERS)
218 IMPLEMENT_ASN1_ALLOC_FUNCTIONS(ECPARAMETERS)
220 ASN1_CHOICE(ECPKPARAMETERS) = {
221 ASN1_SIMPLE(ECPKPARAMETERS, value.named_curve, ASN1_OBJECT),
222 ASN1_SIMPLE(ECPKPARAMETERS, value.parameters, ECPARAMETERS),
223 ASN1_SIMPLE(ECPKPARAMETERS, value.implicitlyCA, ASN1_NULL)
224 } ASN1_CHOICE_END(ECPKPARAMETERS)
226 DECLARE_ASN1_FUNCTIONS(ECPKPARAMETERS)
227 DECLARE_ASN1_ENCODE_FUNCTIONS_name(ECPKPARAMETERS, ECPKPARAMETERS)
228 IMPLEMENT_ASN1_FUNCTIONS(ECPKPARAMETERS)
230 ASN1_SEQUENCE(EC_PRIVATEKEY) = {
231 ASN1_EMBED(EC_PRIVATEKEY, version, INT32),
232 ASN1_SIMPLE(EC_PRIVATEKEY, privateKey, ASN1_OCTET_STRING),
233 ASN1_EXP_OPT(EC_PRIVATEKEY, parameters, ECPKPARAMETERS, 0),
234 ASN1_EXP_OPT(EC_PRIVATEKEY, publicKey, ASN1_BIT_STRING, 1)
235 } static_ASN1_SEQUENCE_END(EC_PRIVATEKEY)
237 DECLARE_ASN1_FUNCTIONS(EC_PRIVATEKEY)
238 DECLARE_ASN1_ENCODE_FUNCTIONS_name(EC_PRIVATEKEY, EC_PRIVATEKEY)
239 IMPLEMENT_ASN1_FUNCTIONS(EC_PRIVATEKEY)
241 /* some declarations of internal function */
243 /* ec_asn1_group2field() sets the values in a X9_62_FIELDID object */
244 static int ec_asn1_group2fieldid(const EC_GROUP *, X9_62_FIELDID *);
245 /* ec_asn1_group2curve() sets the values in a X9_62_CURVE object */
246 static int ec_asn1_group2curve(const EC_GROUP *, X9_62_CURVE *);
248 /* the function definitions */
250 static int ec_asn1_group2fieldid(const EC_GROUP *group, X9_62_FIELDID *field)
255 if (group == NULL || field == NULL)
258 /* clear the old values (if necessary) */
259 ASN1_OBJECT_free(field->fieldType);
260 ASN1_TYPE_free(field->p.other);
262 nid = EC_GROUP_get_field_type(group);
263 /* set OID for the field */
264 if ((field->fieldType = OBJ_nid2obj(nid)) == NULL) {
265 ECerr(EC_F_EC_ASN1_GROUP2FIELDID, ERR_R_OBJ_LIB);
269 if (nid == NID_X9_62_prime_field) {
270 if ((tmp = BN_new()) == NULL) {
271 ECerr(EC_F_EC_ASN1_GROUP2FIELDID, ERR_R_MALLOC_FAILURE);
274 /* the parameters are specified by the prime number p */
275 if (!EC_GROUP_get_curve(group, tmp, NULL, NULL, NULL)) {
276 ECerr(EC_F_EC_ASN1_GROUP2FIELDID, ERR_R_EC_LIB);
279 /* set the prime number */
280 field->p.prime = BN_to_ASN1_INTEGER(tmp, NULL);
281 if (field->p.prime == NULL) {
282 ECerr(EC_F_EC_ASN1_GROUP2FIELDID, ERR_R_ASN1_LIB);
285 } else if (nid == NID_X9_62_characteristic_two_field)
286 #ifdef OPENSSL_NO_EC2M
288 ECerr(EC_F_EC_ASN1_GROUP2FIELDID, EC_R_GF2M_NOT_SUPPORTED);
294 X9_62_CHARACTERISTIC_TWO *char_two;
296 field->p.char_two = X9_62_CHARACTERISTIC_TWO_new();
297 char_two = field->p.char_two;
299 if (char_two == NULL) {
300 ECerr(EC_F_EC_ASN1_GROUP2FIELDID, ERR_R_MALLOC_FAILURE);
304 char_two->m = (long)EC_GROUP_get_degree(group);
306 field_type = EC_GROUP_get_basis_type(group);
308 if (field_type == 0) {
309 ECerr(EC_F_EC_ASN1_GROUP2FIELDID, ERR_R_EC_LIB);
312 /* set base type OID */
313 if ((char_two->type = OBJ_nid2obj(field_type)) == NULL) {
314 ECerr(EC_F_EC_ASN1_GROUP2FIELDID, ERR_R_OBJ_LIB);
318 if (field_type == NID_X9_62_tpBasis) {
321 if (!EC_GROUP_get_trinomial_basis(group, &k))
324 char_two->p.tpBasis = ASN1_INTEGER_new();
325 if (char_two->p.tpBasis == NULL) {
326 ECerr(EC_F_EC_ASN1_GROUP2FIELDID, ERR_R_MALLOC_FAILURE);
329 if (!ASN1_INTEGER_set(char_two->p.tpBasis, (long)k)) {
330 ECerr(EC_F_EC_ASN1_GROUP2FIELDID, ERR_R_ASN1_LIB);
333 } else if (field_type == NID_X9_62_ppBasis) {
334 unsigned int k1, k2, k3;
336 if (!EC_GROUP_get_pentanomial_basis(group, &k1, &k2, &k3))
339 char_two->p.ppBasis = X9_62_PENTANOMIAL_new();
340 if (char_two->p.ppBasis == NULL) {
341 ECerr(EC_F_EC_ASN1_GROUP2FIELDID, ERR_R_MALLOC_FAILURE);
346 char_two->p.ppBasis->k1 = (long)k1;
347 char_two->p.ppBasis->k2 = (long)k2;
348 char_two->p.ppBasis->k3 = (long)k3;
349 } else { /* field_type == NID_X9_62_onBasis */
351 /* for ONB the parameters are (asn1) NULL */
352 char_two->p.onBasis = ASN1_NULL_new();
353 if (char_two->p.onBasis == NULL) {
354 ECerr(EC_F_EC_ASN1_GROUP2FIELDID, ERR_R_MALLOC_FAILURE);
361 ECerr(EC_F_EC_ASN1_GROUP2FIELDID, EC_R_UNSUPPORTED_FIELD);
372 static int ec_asn1_group2curve(const EC_GROUP *group, X9_62_CURVE *curve)
375 BIGNUM *tmp_1 = NULL, *tmp_2 = NULL;
376 unsigned char *a_buf = NULL, *b_buf = NULL;
379 if (!group || !curve || !curve->a || !curve->b)
382 if ((tmp_1 = BN_new()) == NULL || (tmp_2 = BN_new()) == NULL) {
383 ECerr(EC_F_EC_ASN1_GROUP2CURVE, ERR_R_MALLOC_FAILURE);
388 if (!EC_GROUP_get_curve(group, NULL, tmp_1, tmp_2, NULL)) {
389 ECerr(EC_F_EC_ASN1_GROUP2CURVE, ERR_R_EC_LIB);
394 * Per SEC 1, the curve coefficients must be padded up to size. See C.2's
395 * definition of Curve, C.1's definition of FieldElement, and 2.3.5's
396 * definition of how to encode the field elements.
398 len = ((size_t)EC_GROUP_get_degree(group) + 7) / 8;
399 if ((a_buf = OPENSSL_malloc(len)) == NULL
400 || (b_buf = OPENSSL_malloc(len)) == NULL) {
401 ECerr(EC_F_EC_ASN1_GROUP2CURVE, ERR_R_MALLOC_FAILURE);
404 if (BN_bn2binpad(tmp_1, a_buf, len) < 0
405 || BN_bn2binpad(tmp_2, b_buf, len) < 0) {
406 ECerr(EC_F_EC_ASN1_GROUP2CURVE, ERR_R_BN_LIB);
411 if (!ASN1_OCTET_STRING_set(curve->a, a_buf, len)
412 || !ASN1_OCTET_STRING_set(curve->b, b_buf, len)) {
413 ECerr(EC_F_EC_ASN1_GROUP2CURVE, ERR_R_ASN1_LIB);
417 /* set the seed (optional) */
420 if ((curve->seed = ASN1_BIT_STRING_new()) == NULL) {
421 ECerr(EC_F_EC_ASN1_GROUP2CURVE, ERR_R_MALLOC_FAILURE);
424 curve->seed->flags &= ~(ASN1_STRING_FLAG_BITS_LEFT | 0x07);
425 curve->seed->flags |= ASN1_STRING_FLAG_BITS_LEFT;
426 if (!ASN1_BIT_STRING_set(curve->seed, group->seed,
427 (int)group->seed_len)) {
428 ECerr(EC_F_EC_ASN1_GROUP2CURVE, ERR_R_ASN1_LIB);
432 ASN1_BIT_STRING_free(curve->seed);
446 ECPARAMETERS *EC_GROUP_get_ecparameters(const EC_GROUP *group,
447 ECPARAMETERS *params)
450 ECPARAMETERS *ret = NULL;
452 unsigned char *buffer = NULL;
453 const EC_POINT *point = NULL;
454 point_conversion_form_t form;
457 if (params == NULL) {
458 if ((ret = ECPARAMETERS_new()) == NULL) {
459 ECerr(EC_F_EC_GROUP_GET_ECPARAMETERS, ERR_R_MALLOC_FAILURE);
465 /* set the version (always one) */
466 ret->version = (long)0x1;
468 /* set the fieldID */
469 if (!ec_asn1_group2fieldid(group, ret->fieldID)) {
470 ECerr(EC_F_EC_GROUP_GET_ECPARAMETERS, ERR_R_EC_LIB);
475 if (!ec_asn1_group2curve(group, ret->curve)) {
476 ECerr(EC_F_EC_GROUP_GET_ECPARAMETERS, ERR_R_EC_LIB);
480 /* set the base point */
481 if ((point = EC_GROUP_get0_generator(group)) == NULL) {
482 ECerr(EC_F_EC_GROUP_GET_ECPARAMETERS, EC_R_UNDEFINED_GENERATOR);
486 form = EC_GROUP_get_point_conversion_form(group);
488 len = EC_POINT_point2buf(group, point, form, &buffer, NULL);
490 ECerr(EC_F_EC_GROUP_GET_ECPARAMETERS, ERR_R_EC_LIB);
493 if (ret->base == NULL && (ret->base = ASN1_OCTET_STRING_new()) == NULL) {
494 OPENSSL_free(buffer);
495 ECerr(EC_F_EC_GROUP_GET_ECPARAMETERS, ERR_R_MALLOC_FAILURE);
498 ASN1_STRING_set0(ret->base, buffer, len);
501 tmp = EC_GROUP_get0_order(group);
503 ECerr(EC_F_EC_GROUP_GET_ECPARAMETERS, ERR_R_EC_LIB);
506 ret->order = BN_to_ASN1_INTEGER(tmp, orig = ret->order);
507 if (ret->order == NULL) {
509 ECerr(EC_F_EC_GROUP_GET_ECPARAMETERS, ERR_R_ASN1_LIB);
513 /* set the cofactor (optional) */
514 tmp = EC_GROUP_get0_cofactor(group);
516 ret->cofactor = BN_to_ASN1_INTEGER(tmp, orig = ret->cofactor);
517 if (ret->cofactor == NULL) {
518 ret->cofactor = orig;
519 ECerr(EC_F_EC_GROUP_GET_ECPARAMETERS, ERR_R_ASN1_LIB);
528 ECPARAMETERS_free(ret);
532 ECPKPARAMETERS *EC_GROUP_get_ecpkparameters(const EC_GROUP *group,
533 ECPKPARAMETERS *params)
536 ECPKPARAMETERS *ret = params;
539 if ((ret = ECPKPARAMETERS_new()) == NULL) {
540 ECerr(EC_F_EC_GROUP_GET_ECPKPARAMETERS, ERR_R_MALLOC_FAILURE);
545 ASN1_OBJECT_free(ret->value.named_curve);
546 else if (ret->type == 1 && ret->value.parameters)
547 ECPARAMETERS_free(ret->value.parameters);
550 if (EC_GROUP_get_asn1_flag(group)) {
552 * use the asn1 OID to describe the elliptic curve parameters
554 tmp = EC_GROUP_get_curve_name(group);
557 if ((ret->value.named_curve = OBJ_nid2obj(tmp)) == NULL)
560 /* we don't know the nid => ERROR */
563 /* use the ECPARAMETERS structure */
565 if ((ret->value.parameters =
566 EC_GROUP_get_ecparameters(group, NULL)) == NULL)
571 ECPKPARAMETERS_free(ret);
577 EC_GROUP *EC_GROUP_new_from_ecparameters(const ECPARAMETERS *params)
580 EC_GROUP *ret = NULL, *dup = NULL;
581 BIGNUM *p = NULL, *a = NULL, *b = NULL;
582 EC_POINT *point = NULL;
584 int curve_name = NID_undef;
587 if (params->fieldID == NULL
588 || params->fieldID->fieldType == NULL
589 || params->fieldID->p.ptr == NULL) {
590 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, EC_R_ASN1_ERROR);
595 * Now extract the curve parameters a and b. Note that, although SEC 1
596 * specifies the length of their encodings, historical versions of OpenSSL
597 * encoded them incorrectly, so we must accept any length for backwards
600 if (params->curve == NULL
601 || params->curve->a == NULL || params->curve->a->data == NULL
602 || params->curve->b == NULL || params->curve->b->data == NULL) {
603 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, EC_R_ASN1_ERROR);
606 a = BN_bin2bn(params->curve->a->data, params->curve->a->length, NULL);
608 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, ERR_R_BN_LIB);
611 b = BN_bin2bn(params->curve->b->data, params->curve->b->length, NULL);
613 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, ERR_R_BN_LIB);
617 /* get the field parameters */
618 tmp = OBJ_obj2nid(params->fieldID->fieldType);
619 if (tmp == NID_X9_62_characteristic_two_field)
620 #ifdef OPENSSL_NO_EC2M
622 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, EC_R_GF2M_NOT_SUPPORTED);
627 X9_62_CHARACTERISTIC_TWO *char_two;
629 char_two = params->fieldID->p.char_two;
631 field_bits = char_two->m;
632 if (field_bits > OPENSSL_ECC_MAX_FIELD_BITS) {
633 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, EC_R_FIELD_TOO_LARGE);
637 if ((p = BN_new()) == NULL) {
638 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, ERR_R_MALLOC_FAILURE);
642 /* get the base type */
643 tmp = OBJ_obj2nid(char_two->type);
645 if (tmp == NID_X9_62_tpBasis) {
648 if (!char_two->p.tpBasis) {
649 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, EC_R_ASN1_ERROR);
653 tmp_long = ASN1_INTEGER_get(char_two->p.tpBasis);
655 if (!(char_two->m > tmp_long && tmp_long > 0)) {
656 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS,
657 EC_R_INVALID_TRINOMIAL_BASIS);
661 /* create the polynomial */
662 if (!BN_set_bit(p, (int)char_two->m))
664 if (!BN_set_bit(p, (int)tmp_long))
666 if (!BN_set_bit(p, 0))
668 } else if (tmp == NID_X9_62_ppBasis) {
669 X9_62_PENTANOMIAL *penta;
671 penta = char_two->p.ppBasis;
673 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, EC_R_ASN1_ERROR);
678 (char_two->m > penta->k3 && penta->k3 > penta->k2
679 && penta->k2 > penta->k1 && penta->k1 > 0)) {
680 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS,
681 EC_R_INVALID_PENTANOMIAL_BASIS);
685 /* create the polynomial */
686 if (!BN_set_bit(p, (int)char_two->m))
688 if (!BN_set_bit(p, (int)penta->k1))
690 if (!BN_set_bit(p, (int)penta->k2))
692 if (!BN_set_bit(p, (int)penta->k3))
694 if (!BN_set_bit(p, 0))
696 } else if (tmp == NID_X9_62_onBasis) {
697 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, EC_R_NOT_IMPLEMENTED);
701 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, EC_R_ASN1_ERROR);
705 /* create the EC_GROUP structure */
706 ret = EC_GROUP_new_curve_GF2m(p, a, b, NULL);
709 else if (tmp == NID_X9_62_prime_field) {
710 /* we have a curve over a prime field */
711 /* extract the prime number */
712 if (params->fieldID->p.prime == NULL) {
713 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, EC_R_ASN1_ERROR);
716 p = ASN1_INTEGER_to_BN(params->fieldID->p.prime, NULL);
718 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, ERR_R_ASN1_LIB);
722 if (BN_is_negative(p) || BN_is_zero(p)) {
723 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, EC_R_INVALID_FIELD);
727 field_bits = BN_num_bits(p);
728 if (field_bits > OPENSSL_ECC_MAX_FIELD_BITS) {
729 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, EC_R_FIELD_TOO_LARGE);
733 /* create the EC_GROUP structure */
734 ret = EC_GROUP_new_curve_GFp(p, a, b, NULL);
736 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, EC_R_INVALID_FIELD);
741 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, ERR_R_EC_LIB);
745 /* extract seed (optional) */
746 if (params->curve->seed != NULL) {
747 OPENSSL_free(ret->seed);
748 if ((ret->seed = OPENSSL_malloc(params->curve->seed->length)) == NULL) {
749 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, ERR_R_MALLOC_FAILURE);
752 memcpy(ret->seed, params->curve->seed->data,
753 params->curve->seed->length);
754 ret->seed_len = params->curve->seed->length;
757 if (params->order == NULL
758 || params->base == NULL
759 || params->base->data == NULL) {
760 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, EC_R_ASN1_ERROR);
764 if ((point = EC_POINT_new(ret)) == NULL)
767 /* set the point conversion form */
768 EC_GROUP_set_point_conversion_form(ret, (point_conversion_form_t)
769 (params->base->data[0] & ~0x01));
771 /* extract the ec point */
772 if (!EC_POINT_oct2point(ret, point, params->base->data,
773 params->base->length, NULL)) {
774 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, ERR_R_EC_LIB);
778 /* extract the order */
779 if ((a = ASN1_INTEGER_to_BN(params->order, a)) == NULL) {
780 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, ERR_R_ASN1_LIB);
783 if (BN_is_negative(a) || BN_is_zero(a)) {
784 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, EC_R_INVALID_GROUP_ORDER);
787 if (BN_num_bits(a) > (int)field_bits + 1) { /* Hasse bound */
788 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, EC_R_INVALID_GROUP_ORDER);
792 /* extract the cofactor (optional) */
793 if (params->cofactor == NULL) {
796 } else if ((b = ASN1_INTEGER_to_BN(params->cofactor, b)) == NULL) {
797 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, ERR_R_ASN1_LIB);
800 /* set the generator, order and cofactor (if present) */
801 if (!EC_GROUP_set_generator(ret, point, a, b)) {
802 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, ERR_R_EC_LIB);
807 * Check if the explicit parameters group just created matches one of the
810 * We create a copy of the group just built, so that we can remove optional
811 * fields for the lookup: we do this to avoid the possibility that one of
812 * the optional parameters is used to force the library into using a less
813 * performant and less secure EC_METHOD instead of the specialized one.
814 * In any case, `seed` is not really used in any computation, while a
815 * cofactor different from the one in the built-in table is just
816 * mathematically wrong anyway and should not be used.
818 if ((ctx = BN_CTX_new()) == NULL) {
819 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, ERR_R_BN_LIB);
822 if ((dup = EC_GROUP_dup(ret)) == NULL
823 || EC_GROUP_set_seed(dup, NULL, 0) != 1
824 || !EC_GROUP_set_generator(dup, point, a, NULL)) {
825 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, ERR_R_EC_LIB);
828 if ((curve_name = ec_curve_nid_from_params(dup, ctx)) != NID_undef) {
830 * The input explicit parameters successfully matched one of the
831 * built-in curves: often for built-in curves we have specialized
832 * methods with better performance and hardening.
834 * In this case we replace the `EC_GROUP` created through explicit
835 * parameters with one created from a named group.
837 EC_GROUP *named_group = NULL;
839 #ifndef OPENSSL_NO_EC_NISTP_64_GCC_128
841 * NID_wap_wsg_idm_ecid_wtls12 and NID_secp224r1 are both aliases for
842 * the same curve, we prefer the SECP nid when matching explicit
843 * parameters as that is associated with a specialized EC_METHOD.
845 if (curve_name == NID_wap_wsg_idm_ecid_wtls12)
846 curve_name = NID_secp224r1;
847 #endif /* !def(OPENSSL_NO_EC_NISTP_64_GCC_128) */
849 if ((named_group = EC_GROUP_new_by_curve_name(curve_name)) == NULL) {
850 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, ERR_R_EC_LIB);
857 * Set the flag so that EC_GROUPs created from explicit parameters are
858 * serialized using explicit parameters by default.
860 EC_GROUP_set_asn1_flag(ret, OPENSSL_EC_EXPLICIT_CURVE);
863 * If the input params do not contain the optional seed field we make
864 * sure it is not added to the returned group.
866 * The seed field is not really used inside libcrypto anyway, and
867 * adding it to parsed explicit parameter keys would alter their DER
868 * encoding output (because of the extra field) which could impact
869 * applications fingerprinting keys by their DER encoding.
871 if (params->curve->seed == NULL) {
872 if (EC_GROUP_set_seed(ret, NULL, 0) != 1)
889 EC_POINT_free(point);
896 EC_GROUP *EC_GROUP_new_from_ecpkparameters(const ECPKPARAMETERS *params)
898 EC_GROUP *ret = NULL;
901 if (params == NULL) {
902 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPKPARAMETERS, EC_R_MISSING_PARAMETERS);
906 if (params->type == 0) { /* the curve is given by an OID */
907 tmp = OBJ_obj2nid(params->value.named_curve);
908 if ((ret = EC_GROUP_new_by_curve_name(tmp)) == NULL) {
909 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPKPARAMETERS,
910 EC_R_EC_GROUP_NEW_BY_NAME_FAILURE);
913 EC_GROUP_set_asn1_flag(ret, OPENSSL_EC_NAMED_CURVE);
914 } else if (params->type == 1) { /* the parameters are given by a
915 * ECPARAMETERS structure */
916 ret = EC_GROUP_new_from_ecparameters(params->value.parameters);
918 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPKPARAMETERS, ERR_R_EC_LIB);
921 EC_GROUP_set_asn1_flag(ret, OPENSSL_EC_EXPLICIT_CURVE);
922 } else if (params->type == 2) { /* implicitlyCA */
925 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPKPARAMETERS, EC_R_ASN1_ERROR);
932 /* EC_GROUP <-> DER encoding of ECPKPARAMETERS */
934 EC_GROUP *d2i_ECPKParameters(EC_GROUP **a, const unsigned char **in, long len)
936 EC_GROUP *group = NULL;
937 ECPKPARAMETERS *params = NULL;
938 const unsigned char *p = *in;
940 if ((params = d2i_ECPKPARAMETERS(NULL, &p, len)) == NULL) {
941 ECerr(EC_F_D2I_ECPKPARAMETERS, EC_R_D2I_ECPKPARAMETERS_FAILURE);
942 ECPKPARAMETERS_free(params);
946 if ((group = EC_GROUP_new_from_ecpkparameters(params)) == NULL) {
947 ECerr(EC_F_D2I_ECPKPARAMETERS, EC_R_PKPARAMETERS2GROUP_FAILURE);
948 ECPKPARAMETERS_free(params);
957 ECPKPARAMETERS_free(params);
962 int i2d_ECPKParameters(const EC_GROUP *a, unsigned char **out)
965 ECPKPARAMETERS *tmp = EC_GROUP_get_ecpkparameters(a, NULL);
967 ECerr(EC_F_I2D_ECPKPARAMETERS, EC_R_GROUP2PKPARAMETERS_FAILURE);
970 if ((ret = i2d_ECPKPARAMETERS(tmp, out)) == 0) {
971 ECerr(EC_F_I2D_ECPKPARAMETERS, EC_R_I2D_ECPKPARAMETERS_FAILURE);
972 ECPKPARAMETERS_free(tmp);
975 ECPKPARAMETERS_free(tmp);
979 /* some EC_KEY functions */
981 EC_KEY *d2i_ECPrivateKey(EC_KEY **a, const unsigned char **in, long len)
984 EC_PRIVATEKEY *priv_key = NULL;
985 const unsigned char *p = *in;
987 if ((priv_key = d2i_EC_PRIVATEKEY(NULL, &p, len)) == NULL) {
988 ECerr(EC_F_D2I_ECPRIVATEKEY, ERR_R_EC_LIB);
992 if (a == NULL || *a == NULL) {
993 if ((ret = EC_KEY_new()) == NULL) {
994 ECerr(EC_F_D2I_ECPRIVATEKEY, ERR_R_MALLOC_FAILURE);
1000 if (priv_key->parameters) {
1001 EC_GROUP_free(ret->group);
1002 ret->group = EC_GROUP_new_from_ecpkparameters(priv_key->parameters);
1005 if (ret->group == NULL) {
1006 ECerr(EC_F_D2I_ECPRIVATEKEY, ERR_R_EC_LIB);
1010 ret->version = priv_key->version;
1012 if (priv_key->privateKey) {
1013 ASN1_OCTET_STRING *pkey = priv_key->privateKey;
1014 if (EC_KEY_oct2priv(ret, ASN1_STRING_get0_data(pkey),
1015 ASN1_STRING_length(pkey)) == 0)
1018 ECerr(EC_F_D2I_ECPRIVATEKEY, EC_R_MISSING_PRIVATE_KEY);
1022 EC_POINT_clear_free(ret->pub_key);
1023 ret->pub_key = EC_POINT_new(ret->group);
1024 if (ret->pub_key == NULL) {
1025 ECerr(EC_F_D2I_ECPRIVATEKEY, ERR_R_EC_LIB);
1029 if (priv_key->publicKey) {
1030 const unsigned char *pub_oct;
1033 pub_oct = ASN1_STRING_get0_data(priv_key->publicKey);
1034 pub_oct_len = ASN1_STRING_length(priv_key->publicKey);
1035 if (!EC_KEY_oct2key(ret, pub_oct, pub_oct_len, NULL)) {
1036 ECerr(EC_F_D2I_ECPRIVATEKEY, ERR_R_EC_LIB);
1040 if (ret->group->meth->keygenpub == NULL
1041 || ret->group->meth->keygenpub(ret) == 0)
1043 /* Remember the original private-key-only encoding. */
1044 ret->enc_flag |= EC_PKEY_NO_PUBKEY;
1049 EC_PRIVATEKEY_free(priv_key);
1055 if (a == NULL || *a != ret)
1057 EC_PRIVATEKEY_free(priv_key);
1061 int i2d_ECPrivateKey(const EC_KEY *a, unsigned char **out)
1063 int ret = 0, ok = 0;
1064 unsigned char *priv= NULL, *pub= NULL;
1065 size_t privlen = 0, publen = 0;
1067 EC_PRIVATEKEY *priv_key = NULL;
1069 if (a == NULL || a->group == NULL ||
1070 (!(a->enc_flag & EC_PKEY_NO_PUBKEY) && a->pub_key == NULL)) {
1071 ECerr(EC_F_I2D_ECPRIVATEKEY, ERR_R_PASSED_NULL_PARAMETER);
1075 if ((priv_key = EC_PRIVATEKEY_new()) == NULL) {
1076 ECerr(EC_F_I2D_ECPRIVATEKEY, ERR_R_MALLOC_FAILURE);
1080 priv_key->version = a->version;
1082 privlen = EC_KEY_priv2buf(a, &priv);
1085 ECerr(EC_F_I2D_ECPRIVATEKEY, ERR_R_EC_LIB);
1089 ASN1_STRING_set0(priv_key->privateKey, priv, privlen);
1092 if (!(a->enc_flag & EC_PKEY_NO_PARAMETERS)) {
1093 if ((priv_key->parameters =
1094 EC_GROUP_get_ecpkparameters(a->group,
1095 priv_key->parameters)) == NULL) {
1096 ECerr(EC_F_I2D_ECPRIVATEKEY, ERR_R_EC_LIB);
1101 if (!(a->enc_flag & EC_PKEY_NO_PUBKEY)) {
1102 priv_key->publicKey = ASN1_BIT_STRING_new();
1103 if (priv_key->publicKey == NULL) {
1104 ECerr(EC_F_I2D_ECPRIVATEKEY, ERR_R_MALLOC_FAILURE);
1108 publen = EC_KEY_key2buf(a, a->conv_form, &pub, NULL);
1111 ECerr(EC_F_I2D_ECPRIVATEKEY, ERR_R_EC_LIB);
1115 priv_key->publicKey->flags &= ~(ASN1_STRING_FLAG_BITS_LEFT | 0x07);
1116 priv_key->publicKey->flags |= ASN1_STRING_FLAG_BITS_LEFT;
1117 ASN1_STRING_set0(priv_key->publicKey, pub, publen);
1121 if ((ret = i2d_EC_PRIVATEKEY(priv_key, out)) == 0) {
1122 ECerr(EC_F_I2D_ECPRIVATEKEY, ERR_R_EC_LIB);
1127 OPENSSL_clear_free(priv, privlen);
1129 EC_PRIVATEKEY_free(priv_key);
1130 return (ok ? ret : 0);
1133 int i2d_ECParameters(const EC_KEY *a, unsigned char **out)
1136 ECerr(EC_F_I2D_ECPARAMETERS, ERR_R_PASSED_NULL_PARAMETER);
1139 return i2d_ECPKParameters(a->group, out);
1142 EC_KEY *d2i_ECParameters(EC_KEY **a, const unsigned char **in, long len)
1146 if (in == NULL || *in == NULL) {
1147 ECerr(EC_F_D2I_ECPARAMETERS, ERR_R_PASSED_NULL_PARAMETER);
1151 if (a == NULL || *a == NULL) {
1152 if ((ret = EC_KEY_new()) == NULL) {
1153 ECerr(EC_F_D2I_ECPARAMETERS, ERR_R_MALLOC_FAILURE);
1159 if (!d2i_ECPKParameters(&ret->group, in, len)) {
1160 ECerr(EC_F_D2I_ECPARAMETERS, ERR_R_EC_LIB);
1161 if (a == NULL || *a != ret)
1175 EC_KEY *o2i_ECPublicKey(EC_KEY **a, const unsigned char **in, long len)
1179 if (a == NULL || (*a) == NULL || (*a)->group == NULL) {
1181 * sorry, but a EC_GROUP-structure is necessary to set the public key
1183 ECerr(EC_F_O2I_ECPUBLICKEY, ERR_R_PASSED_NULL_PARAMETER);
1187 /* EC_KEY_opt2key updates dirty_cnt */
1188 if (!EC_KEY_oct2key(ret, *in, len, NULL)) {
1189 ECerr(EC_F_O2I_ECPUBLICKEY, ERR_R_EC_LIB);
1196 int i2o_ECPublicKey(const EC_KEY *a, unsigned char **out)
1202 ECerr(EC_F_I2O_ECPUBLICKEY, ERR_R_PASSED_NULL_PARAMETER);
1206 buf_len = EC_POINT_point2oct(a->group, a->pub_key,
1207 a->conv_form, NULL, 0, NULL);
1209 if (out == NULL || buf_len == 0)
1210 /* out == NULL => just return the length of the octet string */
1214 if ((*out = OPENSSL_malloc(buf_len)) == NULL) {
1215 ECerr(EC_F_I2O_ECPUBLICKEY, ERR_R_MALLOC_FAILURE);
1220 if (!EC_POINT_point2oct(a->group, a->pub_key, a->conv_form,
1221 *out, buf_len, NULL)) {
1222 ECerr(EC_F_I2O_ECPUBLICKEY, ERR_R_EC_LIB);
1234 DECLARE_ASN1_FUNCTIONS(ECDSA_SIG)
1235 DECLARE_ASN1_ENCODE_FUNCTIONS_name(ECDSA_SIG, ECDSA_SIG)
1237 #endif /* FIPS_MODULE */
1239 ECDSA_SIG *ECDSA_SIG_new(void)
1241 ECDSA_SIG *sig = OPENSSL_zalloc(sizeof(*sig));
1243 ECerr(EC_F_ECDSA_SIG_NEW, ERR_R_MALLOC_FAILURE);
1247 void ECDSA_SIG_free(ECDSA_SIG *sig)
1251 BN_clear_free(sig->r);
1252 BN_clear_free(sig->s);
1256 ECDSA_SIG *d2i_ECDSA_SIG(ECDSA_SIG **psig, const unsigned char **ppin, long len)
1262 if (psig != NULL && *psig != NULL) {
1265 sig = ECDSA_SIG_new();
1273 if (decode_der_dsa_sig(sig->r, sig->s, ppin, (size_t)len) == 0) {
1274 if (psig == NULL || *psig == NULL)
1275 ECDSA_SIG_free(sig);
1278 if (psig != NULL && *psig == NULL)
1283 int i2d_ECDSA_SIG(const ECDSA_SIG *sig, unsigned char **ppout)
1285 BUF_MEM *buf = NULL;
1289 if (ppout == NULL) {
1290 if (!WPACKET_init_null(&pkt, 0))
1292 } else if (*ppout == NULL) {
1293 if ((buf = BUF_MEM_new()) == NULL
1294 || !WPACKET_init_len(&pkt, buf, 0)) {
1299 if (!WPACKET_init_static_len(&pkt, *ppout, SIZE_MAX, 0))
1303 if (!encode_der_dsa_sig(&pkt, sig->r, sig->s)
1304 || !WPACKET_get_total_written(&pkt, &encoded_len)
1305 || !WPACKET_finish(&pkt)) {
1307 WPACKET_cleanup(&pkt);
1311 if (ppout != NULL) {
1312 if (*ppout == NULL) {
1313 *ppout = (unsigned char *)buf->data;
1317 *ppout += encoded_len;
1321 return (int)encoded_len;
1324 void ECDSA_SIG_get0(const ECDSA_SIG *sig, const BIGNUM **pr, const BIGNUM **ps)
1332 const BIGNUM *ECDSA_SIG_get0_r(const ECDSA_SIG *sig)
1337 const BIGNUM *ECDSA_SIG_get0_s(const ECDSA_SIG *sig)
1342 int ECDSA_SIG_set0(ECDSA_SIG *sig, BIGNUM *r, BIGNUM *s)
1344 if (r == NULL || s == NULL)
1346 BN_clear_free(sig->r);
1347 BN_clear_free(sig->s);
1353 int ECDSA_size(const EC_KEY *ec)
1357 const EC_GROUP *group;
1362 group = EC_KEY_get0_group(ec);
1366 bn = EC_GROUP_get0_order(group);
1370 sig.r = sig.s = (BIGNUM *)bn;
1371 ret = i2d_ECDSA_SIG(&sig, NULL);