2 * Copyright 2002-2018 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
12 #include <openssl/err.h>
13 #include <openssl/asn1t.h>
14 #include <openssl/objects.h>
15 #include "internal/nelem.h"
16 #include "crypto/asn1_dsa.h"
20 int EC_GROUP_get_basis_type(const EC_GROUP *group)
24 if (EC_METHOD_get_field_type(EC_GROUP_method_of(group)) !=
25 NID_X9_62_characteristic_two_field)
26 /* everything else is currently not supported */
29 /* Find the last non-zero element of group->poly[] */
31 i < (int)OSSL_NELEM(group->poly) && group->poly[i] != 0;
36 return NID_X9_62_ppBasis;
38 return NID_X9_62_tpBasis;
40 /* everything else is currently not supported */
44 #ifndef OPENSSL_NO_EC2M
45 int EC_GROUP_get_trinomial_basis(const EC_GROUP *group, unsigned int *k)
50 if (EC_METHOD_get_field_type(EC_GROUP_method_of(group)) !=
51 NID_X9_62_characteristic_two_field
52 || !((group->poly[0] != 0) && (group->poly[1] != 0)
53 && (group->poly[2] == 0))) {
54 ECerr(EC_F_EC_GROUP_GET_TRINOMIAL_BASIS,
55 ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
65 int EC_GROUP_get_pentanomial_basis(const EC_GROUP *group, unsigned int *k1,
66 unsigned int *k2, unsigned int *k3)
71 if (EC_METHOD_get_field_type(EC_GROUP_method_of(group)) !=
72 NID_X9_62_characteristic_two_field
73 || !((group->poly[0] != 0) && (group->poly[1] != 0)
74 && (group->poly[2] != 0) && (group->poly[3] != 0)
75 && (group->poly[4] == 0))) {
76 ECerr(EC_F_EC_GROUP_GET_PENTANOMIAL_BASIS,
77 ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
92 /* some structures needed for the asn1 encoding */
93 typedef struct x9_62_pentanomial_st {
99 typedef struct x9_62_characteristic_two_st {
104 /* NID_X9_62_onBasis */
106 /* NID_X9_62_tpBasis */
107 ASN1_INTEGER *tpBasis;
108 /* NID_X9_62_ppBasis */
109 X9_62_PENTANOMIAL *ppBasis;
113 } X9_62_CHARACTERISTIC_TWO;
115 typedef struct x9_62_fieldid_st {
116 ASN1_OBJECT *fieldType;
119 /* NID_X9_62_prime_field */
121 /* NID_X9_62_characteristic_two_field */
122 X9_62_CHARACTERISTIC_TWO *char_two;
128 typedef struct x9_62_curve_st {
129 ASN1_OCTET_STRING *a;
130 ASN1_OCTET_STRING *b;
131 ASN1_BIT_STRING *seed;
134 struct ec_parameters_st {
136 X9_62_FIELDID *fieldID;
138 ASN1_OCTET_STRING *base;
140 ASN1_INTEGER *cofactor;
141 } /* ECPARAMETERS */ ;
143 struct ecpk_parameters_st {
146 ASN1_OBJECT *named_curve;
147 ECPARAMETERS *parameters;
148 ASN1_NULL *implicitlyCA;
150 } /* ECPKPARAMETERS */ ;
152 /* SEC1 ECPrivateKey */
153 typedef struct ec_privatekey_st {
155 ASN1_OCTET_STRING *privateKey;
156 ECPKPARAMETERS *parameters;
157 ASN1_BIT_STRING *publicKey;
160 /* the OpenSSL ASN.1 definitions */
161 ASN1_SEQUENCE(X9_62_PENTANOMIAL) = {
162 ASN1_EMBED(X9_62_PENTANOMIAL, k1, INT32),
163 ASN1_EMBED(X9_62_PENTANOMIAL, k2, INT32),
164 ASN1_EMBED(X9_62_PENTANOMIAL, k3, INT32)
165 } static_ASN1_SEQUENCE_END(X9_62_PENTANOMIAL)
167 DECLARE_ASN1_ALLOC_FUNCTIONS(X9_62_PENTANOMIAL)
168 IMPLEMENT_ASN1_ALLOC_FUNCTIONS(X9_62_PENTANOMIAL)
170 ASN1_ADB_TEMPLATE(char_two_def) = ASN1_SIMPLE(X9_62_CHARACTERISTIC_TWO, p.other, ASN1_ANY);
172 ASN1_ADB(X9_62_CHARACTERISTIC_TWO) = {
173 ADB_ENTRY(NID_X9_62_onBasis, ASN1_SIMPLE(X9_62_CHARACTERISTIC_TWO, p.onBasis, ASN1_NULL)),
174 ADB_ENTRY(NID_X9_62_tpBasis, ASN1_SIMPLE(X9_62_CHARACTERISTIC_TWO, p.tpBasis, ASN1_INTEGER)),
175 ADB_ENTRY(NID_X9_62_ppBasis, ASN1_SIMPLE(X9_62_CHARACTERISTIC_TWO, p.ppBasis, X9_62_PENTANOMIAL))
176 } ASN1_ADB_END(X9_62_CHARACTERISTIC_TWO, 0, type, 0, &char_two_def_tt, NULL);
178 ASN1_SEQUENCE(X9_62_CHARACTERISTIC_TWO) = {
179 ASN1_EMBED(X9_62_CHARACTERISTIC_TWO, m, INT32),
180 ASN1_SIMPLE(X9_62_CHARACTERISTIC_TWO, type, ASN1_OBJECT),
181 ASN1_ADB_OBJECT(X9_62_CHARACTERISTIC_TWO)
182 } static_ASN1_SEQUENCE_END(X9_62_CHARACTERISTIC_TWO)
184 DECLARE_ASN1_ALLOC_FUNCTIONS(X9_62_CHARACTERISTIC_TWO)
185 IMPLEMENT_ASN1_ALLOC_FUNCTIONS(X9_62_CHARACTERISTIC_TWO)
187 ASN1_ADB_TEMPLATE(fieldID_def) = ASN1_SIMPLE(X9_62_FIELDID, p.other, ASN1_ANY);
189 ASN1_ADB(X9_62_FIELDID) = {
190 ADB_ENTRY(NID_X9_62_prime_field, ASN1_SIMPLE(X9_62_FIELDID, p.prime, ASN1_INTEGER)),
191 ADB_ENTRY(NID_X9_62_characteristic_two_field, ASN1_SIMPLE(X9_62_FIELDID, p.char_two, X9_62_CHARACTERISTIC_TWO))
192 } ASN1_ADB_END(X9_62_FIELDID, 0, fieldType, 0, &fieldID_def_tt, NULL);
194 ASN1_SEQUENCE(X9_62_FIELDID) = {
195 ASN1_SIMPLE(X9_62_FIELDID, fieldType, ASN1_OBJECT),
196 ASN1_ADB_OBJECT(X9_62_FIELDID)
197 } static_ASN1_SEQUENCE_END(X9_62_FIELDID)
199 ASN1_SEQUENCE(X9_62_CURVE) = {
200 ASN1_SIMPLE(X9_62_CURVE, a, ASN1_OCTET_STRING),
201 ASN1_SIMPLE(X9_62_CURVE, b, ASN1_OCTET_STRING),
202 ASN1_OPT(X9_62_CURVE, seed, ASN1_BIT_STRING)
203 } static_ASN1_SEQUENCE_END(X9_62_CURVE)
205 ASN1_SEQUENCE(ECPARAMETERS) = {
206 ASN1_EMBED(ECPARAMETERS, version, INT32),
207 ASN1_SIMPLE(ECPARAMETERS, fieldID, X9_62_FIELDID),
208 ASN1_SIMPLE(ECPARAMETERS, curve, X9_62_CURVE),
209 ASN1_SIMPLE(ECPARAMETERS, base, ASN1_OCTET_STRING),
210 ASN1_SIMPLE(ECPARAMETERS, order, ASN1_INTEGER),
211 ASN1_OPT(ECPARAMETERS, cofactor, ASN1_INTEGER)
212 } ASN1_SEQUENCE_END(ECPARAMETERS)
214 DECLARE_ASN1_ALLOC_FUNCTIONS(ECPARAMETERS)
215 IMPLEMENT_ASN1_ALLOC_FUNCTIONS(ECPARAMETERS)
217 ASN1_CHOICE(ECPKPARAMETERS) = {
218 ASN1_SIMPLE(ECPKPARAMETERS, value.named_curve, ASN1_OBJECT),
219 ASN1_SIMPLE(ECPKPARAMETERS, value.parameters, ECPARAMETERS),
220 ASN1_SIMPLE(ECPKPARAMETERS, value.implicitlyCA, ASN1_NULL)
221 } ASN1_CHOICE_END(ECPKPARAMETERS)
223 DECLARE_ASN1_FUNCTIONS(ECPKPARAMETERS)
224 DECLARE_ASN1_ENCODE_FUNCTIONS_name(ECPKPARAMETERS, ECPKPARAMETERS)
225 IMPLEMENT_ASN1_FUNCTIONS(ECPKPARAMETERS)
227 ASN1_SEQUENCE(EC_PRIVATEKEY) = {
228 ASN1_EMBED(EC_PRIVATEKEY, version, INT32),
229 ASN1_SIMPLE(EC_PRIVATEKEY, privateKey, ASN1_OCTET_STRING),
230 ASN1_EXP_OPT(EC_PRIVATEKEY, parameters, ECPKPARAMETERS, 0),
231 ASN1_EXP_OPT(EC_PRIVATEKEY, publicKey, ASN1_BIT_STRING, 1)
232 } static_ASN1_SEQUENCE_END(EC_PRIVATEKEY)
234 DECLARE_ASN1_FUNCTIONS(EC_PRIVATEKEY)
235 DECLARE_ASN1_ENCODE_FUNCTIONS_name(EC_PRIVATEKEY, EC_PRIVATEKEY)
236 IMPLEMENT_ASN1_FUNCTIONS(EC_PRIVATEKEY)
238 /* some declarations of internal function */
240 /* ec_asn1_group2field() sets the values in a X9_62_FIELDID object */
241 static int ec_asn1_group2fieldid(const EC_GROUP *, X9_62_FIELDID *);
242 /* ec_asn1_group2curve() sets the values in a X9_62_CURVE object */
243 static int ec_asn1_group2curve(const EC_GROUP *, X9_62_CURVE *);
245 /* the function definitions */
247 static int ec_asn1_group2fieldid(const EC_GROUP *group, X9_62_FIELDID *field)
252 if (group == NULL || field == NULL)
255 /* clear the old values (if necessary) */
256 ASN1_OBJECT_free(field->fieldType);
257 ASN1_TYPE_free(field->p.other);
259 nid = EC_METHOD_get_field_type(EC_GROUP_method_of(group));
260 /* set OID for the field */
261 if ((field->fieldType = OBJ_nid2obj(nid)) == NULL) {
262 ECerr(EC_F_EC_ASN1_GROUP2FIELDID, ERR_R_OBJ_LIB);
266 if (nid == NID_X9_62_prime_field) {
267 if ((tmp = BN_new()) == NULL) {
268 ECerr(EC_F_EC_ASN1_GROUP2FIELDID, ERR_R_MALLOC_FAILURE);
271 /* the parameters are specified by the prime number p */
272 if (!EC_GROUP_get_curve(group, tmp, NULL, NULL, NULL)) {
273 ECerr(EC_F_EC_ASN1_GROUP2FIELDID, ERR_R_EC_LIB);
276 /* set the prime number */
277 field->p.prime = BN_to_ASN1_INTEGER(tmp, NULL);
278 if (field->p.prime == NULL) {
279 ECerr(EC_F_EC_ASN1_GROUP2FIELDID, ERR_R_ASN1_LIB);
282 } else if (nid == NID_X9_62_characteristic_two_field)
283 #ifdef OPENSSL_NO_EC2M
285 ECerr(EC_F_EC_ASN1_GROUP2FIELDID, EC_R_GF2M_NOT_SUPPORTED);
291 X9_62_CHARACTERISTIC_TWO *char_two;
293 field->p.char_two = X9_62_CHARACTERISTIC_TWO_new();
294 char_two = field->p.char_two;
296 if (char_two == NULL) {
297 ECerr(EC_F_EC_ASN1_GROUP2FIELDID, ERR_R_MALLOC_FAILURE);
301 char_two->m = (long)EC_GROUP_get_degree(group);
303 field_type = EC_GROUP_get_basis_type(group);
305 if (field_type == 0) {
306 ECerr(EC_F_EC_ASN1_GROUP2FIELDID, ERR_R_EC_LIB);
309 /* set base type OID */
310 if ((char_two->type = OBJ_nid2obj(field_type)) == NULL) {
311 ECerr(EC_F_EC_ASN1_GROUP2FIELDID, ERR_R_OBJ_LIB);
315 if (field_type == NID_X9_62_tpBasis) {
318 if (!EC_GROUP_get_trinomial_basis(group, &k))
321 char_two->p.tpBasis = ASN1_INTEGER_new();
322 if (char_two->p.tpBasis == NULL) {
323 ECerr(EC_F_EC_ASN1_GROUP2FIELDID, ERR_R_MALLOC_FAILURE);
326 if (!ASN1_INTEGER_set(char_two->p.tpBasis, (long)k)) {
327 ECerr(EC_F_EC_ASN1_GROUP2FIELDID, ERR_R_ASN1_LIB);
330 } else if (field_type == NID_X9_62_ppBasis) {
331 unsigned int k1, k2, k3;
333 if (!EC_GROUP_get_pentanomial_basis(group, &k1, &k2, &k3))
336 char_two->p.ppBasis = X9_62_PENTANOMIAL_new();
337 if (char_two->p.ppBasis == NULL) {
338 ECerr(EC_F_EC_ASN1_GROUP2FIELDID, ERR_R_MALLOC_FAILURE);
343 char_two->p.ppBasis->k1 = (long)k1;
344 char_two->p.ppBasis->k2 = (long)k2;
345 char_two->p.ppBasis->k3 = (long)k3;
346 } else { /* field_type == NID_X9_62_onBasis */
348 /* for ONB the parameters are (asn1) NULL */
349 char_two->p.onBasis = ASN1_NULL_new();
350 if (char_two->p.onBasis == NULL) {
351 ECerr(EC_F_EC_ASN1_GROUP2FIELDID, ERR_R_MALLOC_FAILURE);
358 ECerr(EC_F_EC_ASN1_GROUP2FIELDID, EC_R_UNSUPPORTED_FIELD);
369 static int ec_asn1_group2curve(const EC_GROUP *group, X9_62_CURVE *curve)
372 BIGNUM *tmp_1 = NULL, *tmp_2 = NULL;
373 unsigned char *a_buf = NULL, *b_buf = NULL;
376 if (!group || !curve || !curve->a || !curve->b)
379 if ((tmp_1 = BN_new()) == NULL || (tmp_2 = BN_new()) == NULL) {
380 ECerr(EC_F_EC_ASN1_GROUP2CURVE, ERR_R_MALLOC_FAILURE);
385 if (!EC_GROUP_get_curve(group, NULL, tmp_1, tmp_2, NULL)) {
386 ECerr(EC_F_EC_ASN1_GROUP2CURVE, ERR_R_EC_LIB);
391 * Per SEC 1, the curve coefficients must be padded up to size. See C.2's
392 * definition of Curve, C.1's definition of FieldElement, and 2.3.5's
393 * definition of how to encode the field elements.
395 len = ((size_t)EC_GROUP_get_degree(group) + 7) / 8;
396 if ((a_buf = OPENSSL_malloc(len)) == NULL
397 || (b_buf = OPENSSL_malloc(len)) == NULL) {
398 ECerr(EC_F_EC_ASN1_GROUP2CURVE, ERR_R_MALLOC_FAILURE);
401 if (BN_bn2binpad(tmp_1, a_buf, len) < 0
402 || BN_bn2binpad(tmp_2, b_buf, len) < 0) {
403 ECerr(EC_F_EC_ASN1_GROUP2CURVE, ERR_R_BN_LIB);
408 if (!ASN1_OCTET_STRING_set(curve->a, a_buf, len)
409 || !ASN1_OCTET_STRING_set(curve->b, b_buf, len)) {
410 ECerr(EC_F_EC_ASN1_GROUP2CURVE, ERR_R_ASN1_LIB);
414 /* set the seed (optional) */
417 if ((curve->seed = ASN1_BIT_STRING_new()) == NULL) {
418 ECerr(EC_F_EC_ASN1_GROUP2CURVE, ERR_R_MALLOC_FAILURE);
421 curve->seed->flags &= ~(ASN1_STRING_FLAG_BITS_LEFT | 0x07);
422 curve->seed->flags |= ASN1_STRING_FLAG_BITS_LEFT;
423 if (!ASN1_BIT_STRING_set(curve->seed, group->seed,
424 (int)group->seed_len)) {
425 ECerr(EC_F_EC_ASN1_GROUP2CURVE, ERR_R_ASN1_LIB);
429 ASN1_BIT_STRING_free(curve->seed);
443 ECPARAMETERS *EC_GROUP_get_ecparameters(const EC_GROUP *group,
444 ECPARAMETERS *params)
447 ECPARAMETERS *ret = NULL;
449 unsigned char *buffer = NULL;
450 const EC_POINT *point = NULL;
451 point_conversion_form_t form;
454 if (params == NULL) {
455 if ((ret = ECPARAMETERS_new()) == NULL) {
456 ECerr(EC_F_EC_GROUP_GET_ECPARAMETERS, ERR_R_MALLOC_FAILURE);
462 /* set the version (always one) */
463 ret->version = (long)0x1;
465 /* set the fieldID */
466 if (!ec_asn1_group2fieldid(group, ret->fieldID)) {
467 ECerr(EC_F_EC_GROUP_GET_ECPARAMETERS, ERR_R_EC_LIB);
472 if (!ec_asn1_group2curve(group, ret->curve)) {
473 ECerr(EC_F_EC_GROUP_GET_ECPARAMETERS, ERR_R_EC_LIB);
477 /* set the base point */
478 if ((point = EC_GROUP_get0_generator(group)) == NULL) {
479 ECerr(EC_F_EC_GROUP_GET_ECPARAMETERS, EC_R_UNDEFINED_GENERATOR);
483 form = EC_GROUP_get_point_conversion_form(group);
485 len = EC_POINT_point2buf(group, point, form, &buffer, NULL);
487 ECerr(EC_F_EC_GROUP_GET_ECPARAMETERS, ERR_R_EC_LIB);
490 if (ret->base == NULL && (ret->base = ASN1_OCTET_STRING_new()) == NULL) {
491 OPENSSL_free(buffer);
492 ECerr(EC_F_EC_GROUP_GET_ECPARAMETERS, ERR_R_MALLOC_FAILURE);
495 ASN1_STRING_set0(ret->base, buffer, len);
498 tmp = EC_GROUP_get0_order(group);
500 ECerr(EC_F_EC_GROUP_GET_ECPARAMETERS, ERR_R_EC_LIB);
503 ret->order = BN_to_ASN1_INTEGER(tmp, orig = ret->order);
504 if (ret->order == NULL) {
506 ECerr(EC_F_EC_GROUP_GET_ECPARAMETERS, ERR_R_ASN1_LIB);
510 /* set the cofactor (optional) */
511 tmp = EC_GROUP_get0_cofactor(group);
513 ret->cofactor = BN_to_ASN1_INTEGER(tmp, orig = ret->cofactor);
514 if (ret->cofactor == NULL) {
515 ret->cofactor = orig;
516 ECerr(EC_F_EC_GROUP_GET_ECPARAMETERS, ERR_R_ASN1_LIB);
525 ECPARAMETERS_free(ret);
529 ECPKPARAMETERS *EC_GROUP_get_ecpkparameters(const EC_GROUP *group,
530 ECPKPARAMETERS *params)
533 ECPKPARAMETERS *ret = params;
536 if ((ret = ECPKPARAMETERS_new()) == NULL) {
537 ECerr(EC_F_EC_GROUP_GET_ECPKPARAMETERS, ERR_R_MALLOC_FAILURE);
542 ASN1_OBJECT_free(ret->value.named_curve);
543 else if (ret->type == 1 && ret->value.parameters)
544 ECPARAMETERS_free(ret->value.parameters);
547 if (EC_GROUP_get_asn1_flag(group)) {
549 * use the asn1 OID to describe the elliptic curve parameters
551 tmp = EC_GROUP_get_curve_name(group);
554 if ((ret->value.named_curve = OBJ_nid2obj(tmp)) == NULL)
557 /* we don't know the nid => ERROR */
560 /* use the ECPARAMETERS structure */
562 if ((ret->value.parameters =
563 EC_GROUP_get_ecparameters(group, NULL)) == NULL)
568 ECPKPARAMETERS_free(ret);
574 EC_GROUP *EC_GROUP_new_from_ecparameters(const ECPARAMETERS *params)
577 EC_GROUP *ret = NULL, *dup = NULL;
578 BIGNUM *p = NULL, *a = NULL, *b = NULL;
579 EC_POINT *point = NULL;
581 int curve_name = NID_undef;
584 if (params->fieldID == NULL
585 || params->fieldID->fieldType == NULL
586 || params->fieldID->p.ptr == NULL) {
587 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, EC_R_ASN1_ERROR);
592 * Now extract the curve parameters a and b. Note that, although SEC 1
593 * specifies the length of their encodings, historical versions of OpenSSL
594 * encoded them incorrectly, so we must accept any length for backwards
597 if (params->curve == NULL
598 || params->curve->a == NULL || params->curve->a->data == NULL
599 || params->curve->b == NULL || params->curve->b->data == NULL) {
600 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, EC_R_ASN1_ERROR);
603 a = BN_bin2bn(params->curve->a->data, params->curve->a->length, NULL);
605 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, ERR_R_BN_LIB);
608 b = BN_bin2bn(params->curve->b->data, params->curve->b->length, NULL);
610 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, ERR_R_BN_LIB);
614 /* get the field parameters */
615 tmp = OBJ_obj2nid(params->fieldID->fieldType);
616 if (tmp == NID_X9_62_characteristic_two_field)
617 #ifdef OPENSSL_NO_EC2M
619 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, EC_R_GF2M_NOT_SUPPORTED);
624 X9_62_CHARACTERISTIC_TWO *char_two;
626 char_two = params->fieldID->p.char_two;
628 field_bits = char_two->m;
629 if (field_bits > OPENSSL_ECC_MAX_FIELD_BITS) {
630 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, EC_R_FIELD_TOO_LARGE);
634 if ((p = BN_new()) == NULL) {
635 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, ERR_R_MALLOC_FAILURE);
639 /* get the base type */
640 tmp = OBJ_obj2nid(char_two->type);
642 if (tmp == NID_X9_62_tpBasis) {
645 if (!char_two->p.tpBasis) {
646 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, EC_R_ASN1_ERROR);
650 tmp_long = ASN1_INTEGER_get(char_two->p.tpBasis);
652 if (!(char_two->m > tmp_long && tmp_long > 0)) {
653 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS,
654 EC_R_INVALID_TRINOMIAL_BASIS);
658 /* create the polynomial */
659 if (!BN_set_bit(p, (int)char_two->m))
661 if (!BN_set_bit(p, (int)tmp_long))
663 if (!BN_set_bit(p, 0))
665 } else if (tmp == NID_X9_62_ppBasis) {
666 X9_62_PENTANOMIAL *penta;
668 penta = char_two->p.ppBasis;
670 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, EC_R_ASN1_ERROR);
675 (char_two->m > penta->k3 && penta->k3 > penta->k2
676 && penta->k2 > penta->k1 && penta->k1 > 0)) {
677 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS,
678 EC_R_INVALID_PENTANOMIAL_BASIS);
682 /* create the polynomial */
683 if (!BN_set_bit(p, (int)char_two->m))
685 if (!BN_set_bit(p, (int)penta->k1))
687 if (!BN_set_bit(p, (int)penta->k2))
689 if (!BN_set_bit(p, (int)penta->k3))
691 if (!BN_set_bit(p, 0))
693 } else if (tmp == NID_X9_62_onBasis) {
694 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, EC_R_NOT_IMPLEMENTED);
698 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, EC_R_ASN1_ERROR);
702 /* create the EC_GROUP structure */
703 ret = EC_GROUP_new_curve_GF2m(p, a, b, NULL);
706 else if (tmp == NID_X9_62_prime_field) {
707 /* we have a curve over a prime field */
708 /* extract the prime number */
709 if (params->fieldID->p.prime == NULL) {
710 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, EC_R_ASN1_ERROR);
713 p = ASN1_INTEGER_to_BN(params->fieldID->p.prime, NULL);
715 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, ERR_R_ASN1_LIB);
719 if (BN_is_negative(p) || BN_is_zero(p)) {
720 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, EC_R_INVALID_FIELD);
724 field_bits = BN_num_bits(p);
725 if (field_bits > OPENSSL_ECC_MAX_FIELD_BITS) {
726 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, EC_R_FIELD_TOO_LARGE);
730 /* create the EC_GROUP structure */
731 ret = EC_GROUP_new_curve_GFp(p, a, b, NULL);
733 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, EC_R_INVALID_FIELD);
738 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, ERR_R_EC_LIB);
742 /* extract seed (optional) */
743 if (params->curve->seed != NULL) {
744 OPENSSL_free(ret->seed);
745 if ((ret->seed = OPENSSL_malloc(params->curve->seed->length)) == NULL) {
746 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, ERR_R_MALLOC_FAILURE);
749 memcpy(ret->seed, params->curve->seed->data,
750 params->curve->seed->length);
751 ret->seed_len = params->curve->seed->length;
754 if (params->order == NULL
755 || params->base == NULL
756 || params->base->data == NULL) {
757 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, EC_R_ASN1_ERROR);
761 if ((point = EC_POINT_new(ret)) == NULL)
764 /* set the point conversion form */
765 EC_GROUP_set_point_conversion_form(ret, (point_conversion_form_t)
766 (params->base->data[0] & ~0x01));
768 /* extract the ec point */
769 if (!EC_POINT_oct2point(ret, point, params->base->data,
770 params->base->length, NULL)) {
771 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, ERR_R_EC_LIB);
775 /* extract the order */
776 if ((a = ASN1_INTEGER_to_BN(params->order, a)) == NULL) {
777 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, ERR_R_ASN1_LIB);
780 if (BN_is_negative(a) || BN_is_zero(a)) {
781 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, EC_R_INVALID_GROUP_ORDER);
784 if (BN_num_bits(a) > (int)field_bits + 1) { /* Hasse bound */
785 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, EC_R_INVALID_GROUP_ORDER);
789 /* extract the cofactor (optional) */
790 if (params->cofactor == NULL) {
793 } else if ((b = ASN1_INTEGER_to_BN(params->cofactor, b)) == NULL) {
794 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, ERR_R_ASN1_LIB);
797 /* set the generator, order and cofactor (if present) */
798 if (!EC_GROUP_set_generator(ret, point, a, b)) {
799 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, ERR_R_EC_LIB);
804 * Check if the explicit parameters group just created matches one of the
807 * We create a copy of the group just built, so that we can remove optional
808 * fields for the lookup: we do this to avoid the possibility that one of
809 * the optional parameters is used to force the library into using a less
810 * performant and less secure EC_METHOD instead of the specialized one.
811 * In any case, `seed` is not really used in any computation, while a
812 * cofactor different from the one in the built-in table is just
813 * mathematically wrong anyway and should not be used.
815 if ((ctx = BN_CTX_new()) == NULL) {
816 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, ERR_R_BN_LIB);
819 if ((dup = EC_GROUP_dup(ret)) == NULL
820 || EC_GROUP_set_seed(dup, NULL, 0) != 1
821 || !EC_GROUP_set_generator(dup, point, a, NULL)) {
822 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, ERR_R_EC_LIB);
825 if ((curve_name = ec_curve_nid_from_params(dup, ctx)) != NID_undef) {
827 * The input explicit parameters successfully matched one of the
828 * built-in curves: often for built-in curves we have specialized
829 * methods with better performance and hardening.
831 * In this case we replace the `EC_GROUP` created through explicit
832 * parameters with one created from a named group.
834 EC_GROUP *named_group = NULL;
836 #ifndef OPENSSL_NO_EC_NISTP_64_GCC_128
838 * NID_wap_wsg_idm_ecid_wtls12 and NID_secp224r1 are both aliases for
839 * the same curve, we prefer the SECP nid when matching explicit
840 * parameters as that is associated with a specialized EC_METHOD.
842 if (curve_name == NID_wap_wsg_idm_ecid_wtls12)
843 curve_name = NID_secp224r1;
844 #endif /* !def(OPENSSL_NO_EC_NISTP_64_GCC_128) */
846 if ((named_group = EC_GROUP_new_by_curve_name(curve_name)) == NULL) {
847 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPARAMETERS, ERR_R_EC_LIB);
854 * Set the flag so that EC_GROUPs created from explicit parameters are
855 * serialized using explicit parameters by default.
857 EC_GROUP_set_asn1_flag(ret, OPENSSL_EC_EXPLICIT_CURVE);
860 * If the input params do not contain the optional seed field we make
861 * sure it is not added to the returned group.
863 * The seed field is not really used inside libcrypto anyway, and
864 * adding it to parsed explicit parameter keys would alter their DER
865 * encoding output (because of the extra field) which could impact
866 * applications fingerprinting keys by their DER encoding.
868 if (params->curve->seed == NULL) {
869 if (EC_GROUP_set_seed(ret, NULL, 0) != 1)
886 EC_POINT_free(point);
893 EC_GROUP *EC_GROUP_new_from_ecpkparameters(const ECPKPARAMETERS *params)
895 EC_GROUP *ret = NULL;
898 if (params == NULL) {
899 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPKPARAMETERS, EC_R_MISSING_PARAMETERS);
903 if (params->type == 0) { /* the curve is given by an OID */
904 tmp = OBJ_obj2nid(params->value.named_curve);
905 if ((ret = EC_GROUP_new_by_curve_name(tmp)) == NULL) {
906 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPKPARAMETERS,
907 EC_R_EC_GROUP_NEW_BY_NAME_FAILURE);
910 EC_GROUP_set_asn1_flag(ret, OPENSSL_EC_NAMED_CURVE);
911 } else if (params->type == 1) { /* the parameters are given by a
912 * ECPARAMETERS structure */
913 ret = EC_GROUP_new_from_ecparameters(params->value.parameters);
915 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPKPARAMETERS, ERR_R_EC_LIB);
918 EC_GROUP_set_asn1_flag(ret, OPENSSL_EC_EXPLICIT_CURVE);
919 } else if (params->type == 2) { /* implicitlyCA */
922 ECerr(EC_F_EC_GROUP_NEW_FROM_ECPKPARAMETERS, EC_R_ASN1_ERROR);
929 /* EC_GROUP <-> DER encoding of ECPKPARAMETERS */
931 EC_GROUP *d2i_ECPKParameters(EC_GROUP **a, const unsigned char **in, long len)
933 EC_GROUP *group = NULL;
934 ECPKPARAMETERS *params = NULL;
935 const unsigned char *p = *in;
937 if ((params = d2i_ECPKPARAMETERS(NULL, &p, len)) == NULL) {
938 ECerr(EC_F_D2I_ECPKPARAMETERS, EC_R_D2I_ECPKPARAMETERS_FAILURE);
939 ECPKPARAMETERS_free(params);
943 if ((group = EC_GROUP_new_from_ecpkparameters(params)) == NULL) {
944 ECerr(EC_F_D2I_ECPKPARAMETERS, EC_R_PKPARAMETERS2GROUP_FAILURE);
945 ECPKPARAMETERS_free(params);
954 ECPKPARAMETERS_free(params);
959 int i2d_ECPKParameters(const EC_GROUP *a, unsigned char **out)
962 ECPKPARAMETERS *tmp = EC_GROUP_get_ecpkparameters(a, NULL);
964 ECerr(EC_F_I2D_ECPKPARAMETERS, EC_R_GROUP2PKPARAMETERS_FAILURE);
967 if ((ret = i2d_ECPKPARAMETERS(tmp, out)) == 0) {
968 ECerr(EC_F_I2D_ECPKPARAMETERS, EC_R_I2D_ECPKPARAMETERS_FAILURE);
969 ECPKPARAMETERS_free(tmp);
972 ECPKPARAMETERS_free(tmp);
976 /* some EC_KEY functions */
978 EC_KEY *d2i_ECPrivateKey(EC_KEY **a, const unsigned char **in, long len)
981 EC_PRIVATEKEY *priv_key = NULL;
982 const unsigned char *p = *in;
984 if ((priv_key = d2i_EC_PRIVATEKEY(NULL, &p, len)) == NULL) {
985 ECerr(EC_F_D2I_ECPRIVATEKEY, ERR_R_EC_LIB);
989 if (a == NULL || *a == NULL) {
990 if ((ret = EC_KEY_new()) == NULL) {
991 ECerr(EC_F_D2I_ECPRIVATEKEY, ERR_R_MALLOC_FAILURE);
997 if (priv_key->parameters) {
998 EC_GROUP_free(ret->group);
999 ret->group = EC_GROUP_new_from_ecpkparameters(priv_key->parameters);
1002 if (ret->group == NULL) {
1003 ECerr(EC_F_D2I_ECPRIVATEKEY, ERR_R_EC_LIB);
1007 ret->version = priv_key->version;
1009 if (priv_key->privateKey) {
1010 ASN1_OCTET_STRING *pkey = priv_key->privateKey;
1011 if (EC_KEY_oct2priv(ret, ASN1_STRING_get0_data(pkey),
1012 ASN1_STRING_length(pkey)) == 0)
1015 ECerr(EC_F_D2I_ECPRIVATEKEY, EC_R_MISSING_PRIVATE_KEY);
1019 EC_POINT_clear_free(ret->pub_key);
1020 ret->pub_key = EC_POINT_new(ret->group);
1021 if (ret->pub_key == NULL) {
1022 ECerr(EC_F_D2I_ECPRIVATEKEY, ERR_R_EC_LIB);
1026 if (priv_key->publicKey) {
1027 const unsigned char *pub_oct;
1030 pub_oct = ASN1_STRING_get0_data(priv_key->publicKey);
1031 pub_oct_len = ASN1_STRING_length(priv_key->publicKey);
1032 if (!EC_KEY_oct2key(ret, pub_oct, pub_oct_len, NULL)) {
1033 ECerr(EC_F_D2I_ECPRIVATEKEY, ERR_R_EC_LIB);
1037 if (ret->group->meth->keygenpub == NULL
1038 || ret->group->meth->keygenpub(ret) == 0)
1040 /* Remember the original private-key-only encoding. */
1041 ret->enc_flag |= EC_PKEY_NO_PUBKEY;
1046 EC_PRIVATEKEY_free(priv_key);
1051 if (a == NULL || *a != ret)
1053 EC_PRIVATEKEY_free(priv_key);
1057 int i2d_ECPrivateKey(const EC_KEY *a, unsigned char **out)
1059 int ret = 0, ok = 0;
1060 unsigned char *priv= NULL, *pub= NULL;
1061 size_t privlen = 0, publen = 0;
1063 EC_PRIVATEKEY *priv_key = NULL;
1065 if (a == NULL || a->group == NULL ||
1066 (!(a->enc_flag & EC_PKEY_NO_PUBKEY) && a->pub_key == NULL)) {
1067 ECerr(EC_F_I2D_ECPRIVATEKEY, ERR_R_PASSED_NULL_PARAMETER);
1071 if ((priv_key = EC_PRIVATEKEY_new()) == NULL) {
1072 ECerr(EC_F_I2D_ECPRIVATEKEY, ERR_R_MALLOC_FAILURE);
1076 priv_key->version = a->version;
1078 privlen = EC_KEY_priv2buf(a, &priv);
1081 ECerr(EC_F_I2D_ECPRIVATEKEY, ERR_R_EC_LIB);
1085 ASN1_STRING_set0(priv_key->privateKey, priv, privlen);
1088 if (!(a->enc_flag & EC_PKEY_NO_PARAMETERS)) {
1089 if ((priv_key->parameters =
1090 EC_GROUP_get_ecpkparameters(a->group,
1091 priv_key->parameters)) == NULL) {
1092 ECerr(EC_F_I2D_ECPRIVATEKEY, ERR_R_EC_LIB);
1097 if (!(a->enc_flag & EC_PKEY_NO_PUBKEY)) {
1098 priv_key->publicKey = ASN1_BIT_STRING_new();
1099 if (priv_key->publicKey == NULL) {
1100 ECerr(EC_F_I2D_ECPRIVATEKEY, ERR_R_MALLOC_FAILURE);
1104 publen = EC_KEY_key2buf(a, a->conv_form, &pub, NULL);
1107 ECerr(EC_F_I2D_ECPRIVATEKEY, ERR_R_EC_LIB);
1111 priv_key->publicKey->flags &= ~(ASN1_STRING_FLAG_BITS_LEFT | 0x07);
1112 priv_key->publicKey->flags |= ASN1_STRING_FLAG_BITS_LEFT;
1113 ASN1_STRING_set0(priv_key->publicKey, pub, publen);
1117 if ((ret = i2d_EC_PRIVATEKEY(priv_key, out)) == 0) {
1118 ECerr(EC_F_I2D_ECPRIVATEKEY, ERR_R_EC_LIB);
1123 OPENSSL_clear_free(priv, privlen);
1125 EC_PRIVATEKEY_free(priv_key);
1126 return (ok ? ret : 0);
1129 int i2d_ECParameters(const EC_KEY *a, unsigned char **out)
1132 ECerr(EC_F_I2D_ECPARAMETERS, ERR_R_PASSED_NULL_PARAMETER);
1135 return i2d_ECPKParameters(a->group, out);
1138 EC_KEY *d2i_ECParameters(EC_KEY **a, const unsigned char **in, long len)
1142 if (in == NULL || *in == NULL) {
1143 ECerr(EC_F_D2I_ECPARAMETERS, ERR_R_PASSED_NULL_PARAMETER);
1147 if (a == NULL || *a == NULL) {
1148 if ((ret = EC_KEY_new()) == NULL) {
1149 ECerr(EC_F_D2I_ECPARAMETERS, ERR_R_MALLOC_FAILURE);
1155 if (!d2i_ECPKParameters(&ret->group, in, len)) {
1156 ECerr(EC_F_D2I_ECPARAMETERS, ERR_R_EC_LIB);
1157 if (a == NULL || *a != ret)
1168 EC_KEY *o2i_ECPublicKey(EC_KEY **a, const unsigned char **in, long len)
1172 if (a == NULL || (*a) == NULL || (*a)->group == NULL) {
1174 * sorry, but a EC_GROUP-structure is necessary to set the public key
1176 ECerr(EC_F_O2I_ECPUBLICKEY, ERR_R_PASSED_NULL_PARAMETER);
1180 if (!EC_KEY_oct2key(ret, *in, len, NULL)) {
1181 ECerr(EC_F_O2I_ECPUBLICKEY, ERR_R_EC_LIB);
1188 int i2o_ECPublicKey(const EC_KEY *a, unsigned char **out)
1194 ECerr(EC_F_I2O_ECPUBLICKEY, ERR_R_PASSED_NULL_PARAMETER);
1198 buf_len = EC_POINT_point2oct(a->group, a->pub_key,
1199 a->conv_form, NULL, 0, NULL);
1201 if (out == NULL || buf_len == 0)
1202 /* out == NULL => just return the length of the octet string */
1206 if ((*out = OPENSSL_malloc(buf_len)) == NULL) {
1207 ECerr(EC_F_I2O_ECPUBLICKEY, ERR_R_MALLOC_FAILURE);
1212 if (!EC_POINT_point2oct(a->group, a->pub_key, a->conv_form,
1213 *out, buf_len, NULL)) {
1214 ECerr(EC_F_I2O_ECPUBLICKEY, ERR_R_EC_LIB);
1226 DECLARE_ASN1_FUNCTIONS(ECDSA_SIG)
1227 DECLARE_ASN1_ENCODE_FUNCTIONS_name(ECDSA_SIG, ECDSA_SIG)
1229 #endif /* FIPS_MODE */
1231 ECDSA_SIG *ECDSA_SIG_new(void)
1233 ECDSA_SIG *sig = OPENSSL_zalloc(sizeof(*sig));
1235 ECerr(EC_F_ECDSA_SIG_NEW, ERR_R_MALLOC_FAILURE);
1239 void ECDSA_SIG_free(ECDSA_SIG *sig)
1243 BN_clear_free(sig->r);
1244 BN_clear_free(sig->s);
1248 ECDSA_SIG *d2i_ECDSA_SIG(ECDSA_SIG **psig, const unsigned char **ppin, long len)
1254 if (psig != NULL && *psig != NULL) {
1257 sig = ECDSA_SIG_new();
1265 if (decode_der_dsa_sig(sig->r, sig->s, ppin, (size_t)len) == 0) {
1266 if (psig == NULL || *psig == NULL)
1267 ECDSA_SIG_free(sig);
1270 if (psig != NULL && *psig == NULL)
1275 int i2d_ECDSA_SIG(const ECDSA_SIG *sig, unsigned char **ppout)
1277 BUF_MEM *buf = NULL;
1281 if (ppout == NULL) {
1282 if (!WPACKET_init_null(&pkt, 0))
1284 } else if (*ppout == NULL) {
1285 if ((buf = BUF_MEM_new()) == NULL
1286 || !WPACKET_init_len(&pkt, buf, 0)) {
1291 if (!WPACKET_init_static_len(&pkt, *ppout, SIZE_MAX, 0))
1295 if (!encode_der_dsa_sig(&pkt, sig->r, sig->s)
1296 || !WPACKET_get_total_written(&pkt, &encoded_len)
1297 || !WPACKET_finish(&pkt)) {
1299 WPACKET_cleanup(&pkt);
1303 if (ppout != NULL) {
1304 if (*ppout == NULL) {
1305 *ppout = (unsigned char *)buf->data;
1309 *ppout += encoded_len;
1313 return (int)encoded_len;
1316 void ECDSA_SIG_get0(const ECDSA_SIG *sig, const BIGNUM **pr, const BIGNUM **ps)
1324 const BIGNUM *ECDSA_SIG_get0_r(const ECDSA_SIG *sig)
1329 const BIGNUM *ECDSA_SIG_get0_s(const ECDSA_SIG *sig)
1334 int ECDSA_SIG_set0(ECDSA_SIG *sig, BIGNUM *r, BIGNUM *s)
1336 if (r == NULL || s == NULL)
1338 BN_clear_free(sig->r);
1339 BN_clear_free(sig->s);
1346 int ECDSA_size(const EC_KEY *r)
1350 unsigned char buf[4];
1351 const EC_GROUP *group;
1355 group = EC_KEY_get0_group(r);
1359 i = EC_GROUP_order_bits(group);
1362 bs.length = (i + 7) / 8;
1364 bs.type = V_ASN1_INTEGER;
1365 /* If the top bit is set the asn1 encoding is 1 larger. */
1368 i = i2d_ASN1_INTEGER(&bs, NULL);
1369 i += i; /* r and s */
1370 ret = ASN1_object_size(1, i, V_ASN1_SEQUENCE);