blob: 725e176df22eabc8a9ee5efec42c9a7302001949 [file] [log] [blame]
Manuel Pégourié-Gonnard39d2adb2012-10-31 09:26:55 +01001/*
Manuel Pégourié-Gonnard32b04c12013-12-02 15:49:09 +01002 * Elliptic curves over GF(p): generic functions
Manuel Pégourié-Gonnard39d2adb2012-10-31 09:26:55 +01003 *
Manuel Pégourié-Gonnard6fb81872015-07-27 11:11:48 +02004 * Copyright (C) 2006-2015, ARM Limited, All Rights Reserved
Manuel Pégourié-Gonnard37ff1402015-09-04 14:21:07 +02005 * SPDX-License-Identifier: Apache-2.0
6 *
7 * Licensed under the Apache License, Version 2.0 (the "License"); you may
8 * not use this file except in compliance with the License.
9 * You may obtain a copy of the License at
10 *
11 * http://www.apache.org/licenses/LICENSE-2.0
12 *
13 * Unless required by applicable law or agreed to in writing, software
14 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
15 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16 * See the License for the specific language governing permissions and
17 * limitations under the License.
Manuel Pégourié-Gonnard39d2adb2012-10-31 09:26:55 +010018 *
Manuel Pégourié-Gonnardfe446432015-03-06 13:17:10 +000019 * This file is part of mbed TLS (https://tls.mbed.org)
Manuel Pégourié-Gonnard39d2adb2012-10-31 09:26:55 +010020 */
21
22/*
23 * References:
24 *
Manuel Pégourié-Gonnard883f3132012-11-02 09:40:25 +010025 * SEC1 http://www.secg.org/index.php?action=secg,docs_secg
Manuel Pégourié-Gonnardd070f512012-11-08 17:40:51 +010026 * GECC = Guide to Elliptic Curve Cryptography - Hankerson, Menezes, Vanstone
Manuel Pégourié-Gonnard62aad142012-11-10 00:27:12 +010027 * FIPS 186-3 http://csrc.nist.gov/publications/fips/fips186-3/fips_186-3.pdf
Manuel Pégourié-Gonnard1a967282013-02-09 17:03:58 +010028 * RFC 4492 for the related TLS structures and constants
Nicholas Wilson08f3ef12015-11-10 13:10:01 +000029 * RFC 7748 for the Curve448 and Curve25519 curve definitions
Manuel Pégourié-Gonnard07de4b12013-09-02 16:26:04 +020030 *
Manuel Pégourié-Gonnard07894332015-06-23 00:18:41 +020031 * [Curve25519] http://cr.yp.to/ecdh/curve25519-20060209.pdf
Manuel Pégourié-Gonnardfe0af402013-12-04 18:14:55 +010032 *
Manuel Pégourié-Gonnard998930a2015-04-03 13:48:06 +020033 * [2] CORON, Jean-S'ebastien. Resistance against differential power analysis
Manuel Pégourié-Gonnard07de4b12013-09-02 16:26:04 +020034 * for elliptic curve cryptosystems. In : Cryptographic Hardware and
35 * Embedded Systems. Springer Berlin Heidelberg, 1999. p. 292-302.
36 * <http://link.springer.com/chapter/10.1007/3-540-48059-5_25>
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +010037 *
Manuel Pégourié-Gonnard998930a2015-04-03 13:48:06 +020038 * [3] HEDABOU, Mustapha, PINEL, Pierre, et B'EN'ETEAU, Lucien. A comb method to
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +010039 * render ECC resistant against Side Channel Attacks. IACR Cryptology
40 * ePrint Archive, 2004, vol. 2004, p. 342.
41 * <http://eprint.iacr.org/2004/342.pdf>
Manuel Pégourié-Gonnard39d2adb2012-10-31 09:26:55 +010042 */
43
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020044#if !defined(MBEDTLS_CONFIG_FILE)
Manuel Pégourié-Gonnard7f809972015-03-09 17:05:11 +000045#include "mbedtls/config.h"
Manuel Pégourié-Gonnardcef4ad22014-04-29 12:39:06 +020046#else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020047#include MBEDTLS_CONFIG_FILE
Manuel Pégourié-Gonnardcef4ad22014-04-29 12:39:06 +020048#endif
Manuel Pégourié-Gonnard39d2adb2012-10-31 09:26:55 +010049
Janos Follath683c5822018-12-07 12:09:25 +000050/**
51 * \brief Function level alternative implementation.
52 *
53 * The MBEDTLS_ECP_INTERNAL_ALT macro enables alternative implementations to
54 * replace certain functions in this module. The alternative implementations are
55 * typically hardware accelerators and need to activate the hardware before the
56 * computation starts and deactivate it after it finishes. The
57 * mbedtls_internal_ecp_init() and mbedtls_internal_ecp_free() functions serve
58 * this purpose.
59 *
60 * To preserve the correct functionality the following conditions must hold:
61 *
62 * - The alternative implementation must be activated by
63 * mbedtls_internal_ecp_init() before any of the replaceable functions is
64 * called.
65 * - mbedtls_internal_ecp_free() must \b only be called when the alternative
66 * implementation is activated.
67 * - mbedtls_internal_ecp_init() must \b not be called when the alternative
68 * implementation is activated.
69 * - Public functions must not return while the alternative implementation is
70 * activated.
71 * - Replaceable functions are guarded by \c MBEDTLS_ECP_XXX_ALT macros and
72 * before calling them an \code if( mbedtls_internal_ecp_grp_capable( grp ) )
73 * \endcode ensures that the alternative implementation supports the current
74 * group.
75 */
76#if defined(MBEDTLS_ECP_INTERNAL_ALT)
77#endif
78
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020079#if defined(MBEDTLS_ECP_C)
Manuel Pégourié-Gonnard39d2adb2012-10-31 09:26:55 +010080
Manuel Pégourié-Gonnard7f809972015-03-09 17:05:11 +000081#include "mbedtls/ecp.h"
Janos Follath430d3372016-11-03 14:25:37 +000082#include "mbedtls/threading.h"
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -050083#include "mbedtls/platform_util.h"
Paul Bakker6e339b52013-07-03 13:37:05 +020084
Rich Evans00ab4702015-02-06 13:43:58 +000085#include <string.h>
86
Janos Follathb0697532016-08-18 12:38:46 +010087#if !defined(MBEDTLS_ECP_ALT)
88
Hanno Becker4f8e8e52018-12-14 15:08:03 +000089/* Parameter validation macros based on platform_util.h */
90#define ECP_VALIDATE_RET( cond ) \
91 MBEDTLS_INTERNAL_VALIDATE_RET( cond, MBEDTLS_ERR_ECP_BAD_INPUT_DATA )
92#define ECP_VALIDATE( cond ) \
93 MBEDTLS_INTERNAL_VALIDATE( cond )
94
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020095#if defined(MBEDTLS_PLATFORM_C)
Manuel Pégourié-Gonnard7f809972015-03-09 17:05:11 +000096#include "mbedtls/platform.h"
Paul Bakker6e339b52013-07-03 13:37:05 +020097#else
Rich Evans00ab4702015-02-06 13:43:58 +000098#include <stdlib.h>
Manuel Pégourié-Gonnard981732b2015-02-17 15:46:45 +000099#include <stdio.h>
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200100#define mbedtls_printf printf
Manuel Pégourié-Gonnard7551cb92015-05-26 16:04:06 +0200101#define mbedtls_calloc calloc
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200102#define mbedtls_free free
Paul Bakker6e339b52013-07-03 13:37:05 +0200103#endif
104
Janos Follath47d28f02016-11-01 13:22:05 +0000105#include "mbedtls/ecp_internal.h"
Janos Follathb0697532016-08-18 12:38:46 +0100106
Manuel Pégourié-Gonnard0223ab92015-10-05 11:40:01 +0100107#if ( defined(__ARMCC_VERSION) || defined(_MSC_VER) ) && \
108 !defined(inline) && !defined(__cplusplus)
Paul Bakker6a6087e2013-10-28 18:53:08 +0100109#define inline __inline
Manuel Pégourié-Gonnard20af64d2015-07-07 18:33:39 +0200110#endif
Paul Bakker6a6087e2013-10-28 18:53:08 +0100111
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200112#if defined(MBEDTLS_SELF_TEST)
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +0100113/*
Manuel Pégourié-Gonnard91814812013-11-21 20:23:55 +0100114 * Counts of point addition and doubling, and field multiplications.
Manuel Pégourié-Gonnard07de4b12013-09-02 16:26:04 +0200115 * Used to test resistance of point multiplication to simple timing attacks.
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +0100116 */
Manuel Pégourié-Gonnard43863ee2013-12-01 16:51:27 +0100117static unsigned long add_count, dbl_count, mul_count;
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +0100118#endif
119
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +0200120#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard054433c2017-03-22 11:18:33 +0100121/*
122 * Maximum number of "basic operations" to be done in a row.
Manuel Pégourié-Gonnard7037e222017-08-23 14:30:36 +0200123 *
124 * Default value 0 means that ECC operations will not yield.
125 * Note that regardless of the value of ecp_max_ops, always at
126 * least one step is performed before yielding.
127 *
128 * Setting ecp_max_ops=1 can be suitable for testing purposes
129 * as it will interrupt computation at all possible points.
Manuel Pégourié-Gonnard054433c2017-03-22 11:18:33 +0100130 */
131static unsigned ecp_max_ops = 0;
132
133/*
134 * Set ecp_max_ops
135 */
136void mbedtls_ecp_set_max_ops( unsigned max_ops )
137{
138 ecp_max_ops = max_ops;
139}
Manuel Pégourié-Gonnard510d5ca2017-03-08 11:41:47 +0100140
141/*
Manuel Pégourié-Gonnarda0c5bcc2017-04-21 11:33:57 +0200142 * Check if restart is enabled
143 */
Manuel Pégourié-Gonnardb843b152018-10-16 10:41:31 +0200144int mbedtls_ecp_restart_is_enabled( void )
Manuel Pégourié-Gonnarda0c5bcc2017-04-21 11:33:57 +0200145{
146 return( ecp_max_ops != 0 );
147}
148
149/*
Manuel Pégourié-Gonnard54dd6522017-04-20 13:36:18 +0200150 * Restart sub-context for ecp_mul_comb()
Manuel Pégourié-Gonnard510d5ca2017-03-08 11:41:47 +0100151 */
Manuel Pégourié-Gonnard54dd6522017-04-20 13:36:18 +0200152struct mbedtls_ecp_restart_mul
153{
Manuel Pégourié-Gonnard8962ddb2017-03-14 12:11:21 +0100154 mbedtls_ecp_point R; /* current intermediate result */
Manuel Pégourié-Gonnardc5d844b2017-03-15 13:06:28 +0100155 size_t i; /* current index in various loops, 0 outside */
Manuel Pégourié-Gonnardc9c0aa62017-03-16 14:53:26 +0100156 mbedtls_ecp_point *T; /* table for precomputed points */
157 unsigned char T_size; /* number of points in table T */
Manuel Pégourié-Gonnard4ed1dab2017-08-24 11:02:04 +0200158 enum { /* what were we doing last time we returned? */
159 ecp_rsm_init = 0, /* nothing so far, dummy initial state */
160 ecp_rsm_pre_dbl, /* precompute 2^n multiples */
Manuel Pégourié-Gonnard45fd0162017-03-22 08:24:42 +0100161 ecp_rsm_pre_norm_dbl, /* normalize precomputed 2^n multiples */
162 ecp_rsm_pre_add, /* precompute remaining points by adding */
163 ecp_rsm_pre_norm_add, /* normalize all precomputed points */
Manuel Pégourié-Gonnard4ed1dab2017-08-24 11:02:04 +0200164 ecp_rsm_comb_core, /* ecp_mul_comb_core() */
Manuel Pégourié-Gonnard45fd0162017-03-22 08:24:42 +0100165 ecp_rsm_final_norm, /* do the final normalization */
Manuel Pégourié-Gonnard2fad7ae2017-03-14 13:13:13 +0100166 } state;
Manuel Pégourié-Gonnard77af79a2017-03-14 10:58:00 +0100167};
Manuel Pégourié-Gonnard510d5ca2017-03-08 11:41:47 +0100168
169/*
Manuel Pégourié-Gonnard54dd6522017-04-20 13:36:18 +0200170 * Init restart_mul sub-context
Manuel Pégourié-Gonnard510d5ca2017-03-08 11:41:47 +0100171 */
Manuel Pégourié-Gonnarddb4a8eb2017-08-23 18:18:22 +0200172static void ecp_restart_rsm_init( mbedtls_ecp_restart_mul_ctx *ctx )
Manuel Pégourié-Gonnard77af79a2017-03-14 10:58:00 +0100173{
Manuel Pégourié-Gonnard5bd38b12017-08-23 16:55:59 +0200174 mbedtls_ecp_point_init( &ctx->R );
175 ctx->i = 0;
176 ctx->T = NULL;
177 ctx->T_size = 0;
178 ctx->state = ecp_rsm_init;
Manuel Pégourié-Gonnard77af79a2017-03-14 10:58:00 +0100179}
180
181/*
Manuel Pégourié-Gonnard54dd6522017-04-20 13:36:18 +0200182 * Free the components of a restart_mul sub-context
Manuel Pégourié-Gonnard77af79a2017-03-14 10:58:00 +0100183 */
Manuel Pégourié-Gonnarddb4a8eb2017-08-23 18:18:22 +0200184static void ecp_restart_rsm_free( mbedtls_ecp_restart_mul_ctx *ctx )
Manuel Pégourié-Gonnard77af79a2017-03-14 10:58:00 +0100185{
Manuel Pégourié-Gonnardc9c0aa62017-03-16 14:53:26 +0100186 unsigned char i;
187
Manuel Pégourié-Gonnard77af79a2017-03-14 10:58:00 +0100188 if( ctx == NULL )
189 return;
Manuel Pégourié-Gonnard78d564a2017-03-14 11:48:38 +0100190
Manuel Pégourié-Gonnard8962ddb2017-03-14 12:11:21 +0100191 mbedtls_ecp_point_free( &ctx->R );
Manuel Pégourié-Gonnard2fad7ae2017-03-14 13:13:13 +0100192
Manuel Pégourié-Gonnard31f0ef72017-05-17 10:05:58 +0200193 if( ctx->T != NULL )
194 {
Manuel Pégourié-Gonnardc9c0aa62017-03-16 14:53:26 +0100195 for( i = 0; i < ctx->T_size; i++ )
196 mbedtls_ecp_point_free( ctx->T + i );
197 mbedtls_free( ctx->T );
198 }
199
Manuel Pégourié-Gonnarddb4a8eb2017-08-23 18:18:22 +0200200 ecp_restart_rsm_init( ctx );
Manuel Pégourié-Gonnard77af79a2017-03-14 10:58:00 +0100201}
Manuel Pégourié-Gonnard2fad7ae2017-03-14 13:13:13 +0100202
203/*
Manuel Pégourié-Gonnard54dd6522017-04-20 13:36:18 +0200204 * Restart context for ecp_muladd()
205 */
206struct mbedtls_ecp_restart_muladd
207{
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +0200208 mbedtls_ecp_point mP; /* mP value */
209 mbedtls_ecp_point R; /* R intermediate result */
210 enum { /* what should we do next? */
211 ecp_rsma_mul1 = 0, /* first multiplication */
212 ecp_rsma_mul2, /* second multiplication */
213 ecp_rsma_add, /* addition */
214 ecp_rsma_norm, /* normalization */
215 } state;
Manuel Pégourié-Gonnard54dd6522017-04-20 13:36:18 +0200216};
217
218/*
219 * Init restart_muladd sub-context
220 */
Manuel Pégourié-Gonnarddb4a8eb2017-08-23 18:18:22 +0200221static void ecp_restart_ma_init( mbedtls_ecp_restart_muladd_ctx *ctx )
Manuel Pégourié-Gonnard54dd6522017-04-20 13:36:18 +0200222{
Manuel Pégourié-Gonnard5bd38b12017-08-23 16:55:59 +0200223 mbedtls_ecp_point_init( &ctx->mP );
224 mbedtls_ecp_point_init( &ctx->R );
225 ctx->state = ecp_rsma_mul1;
Manuel Pégourié-Gonnard54dd6522017-04-20 13:36:18 +0200226}
227
228/*
229 * Free the components of a restart_muladd sub-context
230 */
Manuel Pégourié-Gonnarddb4a8eb2017-08-23 18:18:22 +0200231static void ecp_restart_ma_free( mbedtls_ecp_restart_muladd_ctx *ctx )
Manuel Pégourié-Gonnard54dd6522017-04-20 13:36:18 +0200232{
233 if( ctx == NULL )
234 return;
235
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +0200236 mbedtls_ecp_point_free( &ctx->mP );
237 mbedtls_ecp_point_free( &ctx->R );
238
Manuel Pégourié-Gonnarddb4a8eb2017-08-23 18:18:22 +0200239 ecp_restart_ma_init( ctx );
Manuel Pégourié-Gonnard54dd6522017-04-20 13:36:18 +0200240}
241
242/*
Manuel Pégourié-Gonnardb739a712017-04-19 10:11:56 +0200243 * Initialize a restart context
244 */
245void mbedtls_ecp_restart_init( mbedtls_ecp_restart_ctx *ctx )
246{
Hanno Becker80f71682018-12-18 23:44:43 +0000247 ECP_VALIDATE( ctx != NULL );
Manuel Pégourié-Gonnard5bd38b12017-08-23 16:55:59 +0200248 ctx->ops_done = 0;
249 ctx->depth = 0;
250 ctx->rsm = NULL;
251 ctx->ma = NULL;
Manuel Pégourié-Gonnardb739a712017-04-19 10:11:56 +0200252}
253
254/*
255 * Free the components of a restart context
256 */
257void mbedtls_ecp_restart_free( mbedtls_ecp_restart_ctx *ctx )
258{
259 if( ctx == NULL )
260 return;
261
Manuel Pégourié-Gonnarddb4a8eb2017-08-23 18:18:22 +0200262 ecp_restart_rsm_free( ctx->rsm );
Manuel Pégourié-Gonnardb739a712017-04-19 10:11:56 +0200263 mbedtls_free( ctx->rsm );
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +0200264
Manuel Pégourié-Gonnarddb4a8eb2017-08-23 18:18:22 +0200265 ecp_restart_ma_free( ctx->ma );
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +0200266 mbedtls_free( ctx->ma );
Manuel Pégourié-Gonnard5bd38b12017-08-23 16:55:59 +0200267
268 mbedtls_ecp_restart_init( ctx );
Manuel Pégourié-Gonnardb739a712017-04-19 10:11:56 +0200269}
270
271/*
Manuel Pégourié-Gonnard2fad7ae2017-03-14 13:13:13 +0100272 * Check if we can do the next step
273 */
Manuel Pégourié-Gonnardc7511482017-04-20 16:31:00 +0200274int mbedtls_ecp_check_budget( const mbedtls_ecp_group *grp,
275 mbedtls_ecp_restart_ctx *rs_ctx,
276 unsigned ops )
Manuel Pégourié-Gonnard2fad7ae2017-03-14 13:13:13 +0100277{
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000278 ECP_VALIDATE_RET( grp != NULL );
279
Manuel Pégourié-Gonnard646393b2017-04-20 10:03:45 +0200280 if( rs_ctx != NULL && ecp_max_ops != 0 )
Manuel Pégourié-Gonnard2fad7ae2017-03-14 13:13:13 +0100281 {
Manuel Pégourié-Gonnarde6854492017-03-20 14:35:19 +0100282 /* scale depending on curve size: the chosen reference is 256-bit,
283 * and multiplication is quadratic. Round to the closest integer. */
284 if( grp->pbits >= 512 )
285 ops *= 4;
286 else if( grp->pbits >= 384 )
287 ops *= 2;
288
Hanno Beckerb10c6602018-10-26 13:50:13 +0100289 /* Avoid infinite loops: always allow first step.
290 * Because of that, however, it's not generally true
291 * that ops_done <= ecp_max_ops, so the check
292 * ops_done > ecp_max_ops below is mandatory. */
293 if( ( rs_ctx->ops_done != 0 ) &&
294 ( rs_ctx->ops_done > ecp_max_ops ||
295 ops > ecp_max_ops - rs_ctx->ops_done ) )
296 {
Manuel Pégourié-Gonnard2fad7ae2017-03-14 13:13:13 +0100297 return( MBEDTLS_ERR_ECP_IN_PROGRESS );
Hanno Beckerb10c6602018-10-26 13:50:13 +0100298 }
Manuel Pégourié-Gonnard2fad7ae2017-03-14 13:13:13 +0100299
Manuel Pégourié-Gonnarde6854492017-03-20 14:35:19 +0100300 /* update running count */
Manuel Pégourié-Gonnard646393b2017-04-20 10:03:45 +0200301 rs_ctx->ops_done += ops;
Manuel Pégourié-Gonnard2fad7ae2017-03-14 13:13:13 +0100302 }
303
304 return( 0 );
305}
306
Manuel Pégourié-Gonnarddb4a8eb2017-08-23 18:18:22 +0200307/* Call this when entering a function that needs its own sub-context */
Manuel Pégourié-Gonnarda58e0112018-10-16 10:42:47 +0200308#define ECP_RS_ENTER( SUB ) do { \
309 /* reset ops count for this call if top-level */ \
310 if( rs_ctx != NULL && rs_ctx->depth++ == 0 ) \
311 rs_ctx->ops_done = 0; \
312 \
313 /* set up our own sub-context if needed */ \
314 if( mbedtls_ecp_restart_is_enabled() && \
315 rs_ctx != NULL && rs_ctx->SUB == NULL ) \
316 { \
317 rs_ctx->SUB = mbedtls_calloc( 1, sizeof( *rs_ctx->SUB ) ); \
318 if( rs_ctx->SUB == NULL ) \
319 return( MBEDTLS_ERR_ECP_ALLOC_FAILED ); \
320 \
321 ecp_restart_## SUB ##_init( rs_ctx->SUB ); \
322 } \
Manuel Pégourié-Gonnarddb4a8eb2017-08-23 18:18:22 +0200323} while( 0 )
324
325/* Call this when leaving a function that needs its own sub-context */
Manuel Pégourié-Gonnarda58e0112018-10-16 10:42:47 +0200326#define ECP_RS_LEAVE( SUB ) do { \
327 /* clear our sub-context when not in progress (done or error) */ \
328 if( rs_ctx != NULL && rs_ctx->SUB != NULL && \
329 ret != MBEDTLS_ERR_ECP_IN_PROGRESS ) \
330 { \
331 ecp_restart_## SUB ##_free( rs_ctx->SUB ); \
332 mbedtls_free( rs_ctx->SUB ); \
333 rs_ctx->SUB = NULL; \
334 } \
335 \
336 if( rs_ctx != NULL ) \
337 rs_ctx->depth--; \
Manuel Pégourié-Gonnarddb4a8eb2017-08-23 18:18:22 +0200338} while( 0 )
339
340#else /* MBEDTLS_ECP_RESTARTABLE */
341
342#define ECP_RS_ENTER( sub ) (void) rs_ctx;
343#define ECP_RS_LEAVE( sub ) (void) rs_ctx;
344
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +0200345#endif /* MBEDTLS_ECP_RESTARTABLE */
Manuel Pégourié-Gonnard054433c2017-03-22 11:18:33 +0100346
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200347#if defined(MBEDTLS_ECP_DP_SECP192R1_ENABLED) || \
348 defined(MBEDTLS_ECP_DP_SECP224R1_ENABLED) || \
349 defined(MBEDTLS_ECP_DP_SECP256R1_ENABLED) || \
350 defined(MBEDTLS_ECP_DP_SECP384R1_ENABLED) || \
351 defined(MBEDTLS_ECP_DP_SECP521R1_ENABLED) || \
352 defined(MBEDTLS_ECP_DP_BP256R1_ENABLED) || \
353 defined(MBEDTLS_ECP_DP_BP384R1_ENABLED) || \
354 defined(MBEDTLS_ECP_DP_BP512R1_ENABLED) || \
355 defined(MBEDTLS_ECP_DP_SECP192K1_ENABLED) || \
356 defined(MBEDTLS_ECP_DP_SECP224K1_ENABLED) || \
357 defined(MBEDTLS_ECP_DP_SECP256K1_ENABLED)
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +0200358#define ECP_SHORTWEIERSTRASS
Manuel Pégourié-Gonnard7c94d8b2013-12-04 23:15:46 +0100359#endif
360
Nicholas Wilson08f3ef12015-11-10 13:10:01 +0000361#if defined(MBEDTLS_ECP_DP_CURVE25519_ENABLED) || \
362 defined(MBEDTLS_ECP_DP_CURVE448_ENABLED)
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +0200363#define ECP_MONTGOMERY
Manuel Pégourié-Gonnard7c94d8b2013-12-04 23:15:46 +0100364#endif
365
366/*
367 * Curve types: internal for now, might be exposed later
368 */
369typedef enum
370{
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +0200371 ECP_TYPE_NONE = 0,
372 ECP_TYPE_SHORT_WEIERSTRASS, /* y^2 = x^3 + a x + b */
373 ECP_TYPE_MONTGOMERY, /* y^2 = x^3 + a x^2 + x */
Manuel Pégourié-Gonnard7c94d8b2013-12-04 23:15:46 +0100374} ecp_curve_type;
375
Manuel Pégourié-Gonnard1e8c8ec2012-10-31 19:24:21 +0100376/*
Manuel Pégourié-Gonnard568c9cf2013-09-16 17:30:04 +0200377 * List of supported curves:
378 * - internal ID
Manuel Pégourié-Gonnard8195c1a2013-10-07 19:40:41 +0200379 * - TLS NamedCurve ID (RFC 4492 sec. 5.1.1, RFC 7071 sec. 2)
Manuel Pégourié-Gonnard568c9cf2013-09-16 17:30:04 +0200380 * - size in bits
Manuel Pégourié-Gonnard8195c1a2013-10-07 19:40:41 +0200381 * - readable name
Gergely Budaie40c4692014-01-22 11:22:20 +0100382 *
Manuel Pégourié-Gonnardac719412014-02-04 14:48:50 +0100383 * Curves are listed in order: largest curves first, and for a given size,
384 * fastest curves first. This provides the default order for the SSL module.
Manuel Pégourié-Gonnard88db5da2015-06-15 14:34:59 +0200385 *
386 * Reminder: update profiles in x509_crt.c when adding a new curves!
Manuel Pégourié-Gonnard568c9cf2013-09-16 17:30:04 +0200387 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200388static const mbedtls_ecp_curve_info ecp_supported_curves[] =
Manuel Pégourié-Gonnard568c9cf2013-09-16 17:30:04 +0200389{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200390#if defined(MBEDTLS_ECP_DP_SECP521R1_ENABLED)
391 { MBEDTLS_ECP_DP_SECP521R1, 25, 521, "secp521r1" },
Manuel Pégourié-Gonnard568c9cf2013-09-16 17:30:04 +0200392#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200393#if defined(MBEDTLS_ECP_DP_BP512R1_ENABLED)
394 { MBEDTLS_ECP_DP_BP512R1, 28, 512, "brainpoolP512r1" },
Gergely Budaie40c4692014-01-22 11:22:20 +0100395#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200396#if defined(MBEDTLS_ECP_DP_SECP384R1_ENABLED)
397 { MBEDTLS_ECP_DP_SECP384R1, 24, 384, "secp384r1" },
Manuel Pégourié-Gonnard568c9cf2013-09-16 17:30:04 +0200398#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200399#if defined(MBEDTLS_ECP_DP_BP384R1_ENABLED)
400 { MBEDTLS_ECP_DP_BP384R1, 27, 384, "brainpoolP384r1" },
Gergely Budaie40c4692014-01-22 11:22:20 +0100401#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200402#if defined(MBEDTLS_ECP_DP_SECP256R1_ENABLED)
403 { MBEDTLS_ECP_DP_SECP256R1, 23, 256, "secp256r1" },
Manuel Pégourié-Gonnard568c9cf2013-09-16 17:30:04 +0200404#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200405#if defined(MBEDTLS_ECP_DP_SECP256K1_ENABLED)
406 { MBEDTLS_ECP_DP_SECP256K1, 22, 256, "secp256k1" },
Manuel Pégourié-Gonnardac719412014-02-04 14:48:50 +0100407#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200408#if defined(MBEDTLS_ECP_DP_BP256R1_ENABLED)
409 { MBEDTLS_ECP_DP_BP256R1, 26, 256, "brainpoolP256r1" },
Gergely Budaie40c4692014-01-22 11:22:20 +0100410#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200411#if defined(MBEDTLS_ECP_DP_SECP224R1_ENABLED)
412 { MBEDTLS_ECP_DP_SECP224R1, 21, 224, "secp224r1" },
Manuel Pégourié-Gonnard568c9cf2013-09-16 17:30:04 +0200413#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200414#if defined(MBEDTLS_ECP_DP_SECP224K1_ENABLED)
415 { MBEDTLS_ECP_DP_SECP224K1, 20, 224, "secp224k1" },
Manuel Pégourié-Gonnard9bcff392014-01-10 18:26:48 +0100416#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200417#if defined(MBEDTLS_ECP_DP_SECP192R1_ENABLED)
418 { MBEDTLS_ECP_DP_SECP192R1, 19, 192, "secp192r1" },
Manuel Pégourié-Gonnardac719412014-02-04 14:48:50 +0100419#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200420#if defined(MBEDTLS_ECP_DP_SECP192K1_ENABLED)
421 { MBEDTLS_ECP_DP_SECP192K1, 18, 192, "secp192k1" },
Manuel Pégourié-Gonnard9bcff392014-01-10 18:26:48 +0100422#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200423 { MBEDTLS_ECP_DP_NONE, 0, 0, NULL },
Manuel Pégourié-Gonnard568c9cf2013-09-16 17:30:04 +0200424};
Manuel Pégourié-Gonnardac719412014-02-04 14:48:50 +0100425
Manuel Pégourié-Gonnardba782bb2014-07-08 13:31:34 +0200426#define ECP_NB_CURVES sizeof( ecp_supported_curves ) / \
427 sizeof( ecp_supported_curves[0] )
428
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200429static mbedtls_ecp_group_id ecp_supported_grp_id[ECP_NB_CURVES];
Manuel Pégourié-Gonnard568c9cf2013-09-16 17:30:04 +0200430
431/*
Manuel Pégourié-Gonnardda179e42013-09-18 15:31:24 +0200432 * List of supported curves and associated info
433 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200434const mbedtls_ecp_curve_info *mbedtls_ecp_curve_list( void )
Manuel Pégourié-Gonnardda179e42013-09-18 15:31:24 +0200435{
Paul Bakkerd8bb8262014-06-17 14:06:49 +0200436 return( ecp_supported_curves );
Manuel Pégourié-Gonnardda179e42013-09-18 15:31:24 +0200437}
438
439/*
Manuel Pégourié-Gonnardac719412014-02-04 14:48:50 +0100440 * List of supported curves, group ID only
441 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200442const mbedtls_ecp_group_id *mbedtls_ecp_grp_id_list( void )
Manuel Pégourié-Gonnardac719412014-02-04 14:48:50 +0100443{
444 static int init_done = 0;
445
446 if( ! init_done )
447 {
448 size_t i = 0;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200449 const mbedtls_ecp_curve_info *curve_info;
Manuel Pégourié-Gonnardac719412014-02-04 14:48:50 +0100450
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200451 for( curve_info = mbedtls_ecp_curve_list();
452 curve_info->grp_id != MBEDTLS_ECP_DP_NONE;
Manuel Pégourié-Gonnardac719412014-02-04 14:48:50 +0100453 curve_info++ )
454 {
455 ecp_supported_grp_id[i++] = curve_info->grp_id;
456 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200457 ecp_supported_grp_id[i] = MBEDTLS_ECP_DP_NONE;
Manuel Pégourié-Gonnardac719412014-02-04 14:48:50 +0100458
459 init_done = 1;
460 }
461
Paul Bakkerd8bb8262014-06-17 14:06:49 +0200462 return( ecp_supported_grp_id );
Manuel Pégourié-Gonnardac719412014-02-04 14:48:50 +0100463}
464
465/*
466 * Get the curve info for the internal identifier
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +0200467 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200468const mbedtls_ecp_curve_info *mbedtls_ecp_curve_info_from_grp_id( mbedtls_ecp_group_id grp_id )
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +0200469{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200470 const mbedtls_ecp_curve_info *curve_info;
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +0200471
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200472 for( curve_info = mbedtls_ecp_curve_list();
473 curve_info->grp_id != MBEDTLS_ECP_DP_NONE;
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +0200474 curve_info++ )
475 {
476 if( curve_info->grp_id == grp_id )
477 return( curve_info );
478 }
479
480 return( NULL );
481}
482
483/*
484 * Get the curve info from the TLS identifier
485 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200486const mbedtls_ecp_curve_info *mbedtls_ecp_curve_info_from_tls_id( uint16_t tls_id )
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +0200487{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200488 const mbedtls_ecp_curve_info *curve_info;
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +0200489
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200490 for( curve_info = mbedtls_ecp_curve_list();
491 curve_info->grp_id != MBEDTLS_ECP_DP_NONE;
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +0200492 curve_info++ )
493 {
494 if( curve_info->tls_id == tls_id )
495 return( curve_info );
496 }
497
498 return( NULL );
499}
500
501/*
Manuel Pégourié-Gonnard0267e3d2013-11-30 15:10:14 +0100502 * Get the curve info from the name
503 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200504const mbedtls_ecp_curve_info *mbedtls_ecp_curve_info_from_name( const char *name )
Manuel Pégourié-Gonnard0267e3d2013-11-30 15:10:14 +0100505{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200506 const mbedtls_ecp_curve_info *curve_info;
Manuel Pégourié-Gonnard0267e3d2013-11-30 15:10:14 +0100507
Hanno Beckerb7a04a72018-12-18 23:50:21 +0000508 if( name == NULL )
509 return( NULL );
510
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200511 for( curve_info = mbedtls_ecp_curve_list();
512 curve_info->grp_id != MBEDTLS_ECP_DP_NONE;
Manuel Pégourié-Gonnard0267e3d2013-11-30 15:10:14 +0100513 curve_info++ )
514 {
Manuel Pégourié-Gonnardcb46fd82015-05-28 17:06:07 +0200515 if( strcmp( curve_info->name, name ) == 0 )
Manuel Pégourié-Gonnard0267e3d2013-11-30 15:10:14 +0100516 return( curve_info );
517 }
518
519 return( NULL );
520}
521
522/*
Manuel Pégourié-Gonnard7c94d8b2013-12-04 23:15:46 +0100523 * Get the type of a curve
Manuel Pégourié-Gonnard312d2e82013-12-04 11:08:01 +0100524 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200525static inline ecp_curve_type ecp_get_type( const mbedtls_ecp_group *grp )
Manuel Pégourié-Gonnard312d2e82013-12-04 11:08:01 +0100526{
Manuel Pégourié-Gonnard7c94d8b2013-12-04 23:15:46 +0100527 if( grp->G.X.p == NULL )
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +0200528 return( ECP_TYPE_NONE );
Manuel Pégourié-Gonnard7c94d8b2013-12-04 23:15:46 +0100529
530 if( grp->G.Y.p == NULL )
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +0200531 return( ECP_TYPE_MONTGOMERY );
Manuel Pégourié-Gonnard7c94d8b2013-12-04 23:15:46 +0100532 else
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +0200533 return( ECP_TYPE_SHORT_WEIERSTRASS );
Manuel Pégourié-Gonnard312d2e82013-12-04 11:08:01 +0100534}
535
536/*
Manuel Pégourié-Gonnardb505c272012-11-05 17:27:54 +0100537 * Initialize (the components of) a point
Manuel Pégourié-Gonnardae180d02012-11-02 18:14:40 +0100538 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200539void mbedtls_ecp_point_init( mbedtls_ecp_point *pt )
Manuel Pégourié-Gonnardae180d02012-11-02 18:14:40 +0100540{
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000541 ECP_VALIDATE( pt != NULL );
Manuel Pégourié-Gonnardae180d02012-11-02 18:14:40 +0100542
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200543 mbedtls_mpi_init( &pt->X );
544 mbedtls_mpi_init( &pt->Y );
545 mbedtls_mpi_init( &pt->Z );
Manuel Pégourié-Gonnardb505c272012-11-05 17:27:54 +0100546}
547
548/*
549 * Initialize (the components of) a group
550 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200551void mbedtls_ecp_group_init( mbedtls_ecp_group *grp )
Manuel Pégourié-Gonnardb505c272012-11-05 17:27:54 +0100552{
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000553 ECP_VALIDATE( grp != NULL );
Manuel Pégourié-Gonnardb505c272012-11-05 17:27:54 +0100554
Manuel Pégourié-Gonnard95e2eca2018-06-20 10:29:47 +0200555 grp->id = MBEDTLS_ECP_DP_NONE;
Manuel Pégourié-Gonnard5bd38b12017-08-23 16:55:59 +0200556 mbedtls_mpi_init( &grp->P );
557 mbedtls_mpi_init( &grp->A );
558 mbedtls_mpi_init( &grp->B );
559 mbedtls_ecp_point_init( &grp->G );
560 mbedtls_mpi_init( &grp->N );
561 grp->pbits = 0;
562 grp->nbits = 0;
563 grp->h = 0;
564 grp->modp = NULL;
565 grp->t_pre = NULL;
566 grp->t_post = NULL;
567 grp->t_data = NULL;
568 grp->T = NULL;
569 grp->T_size = 0;
Manuel Pégourié-Gonnardae180d02012-11-02 18:14:40 +0100570}
571
572/*
Manuel Pégourié-Gonnardb8c6e0e2013-07-01 13:40:52 +0200573 * Initialize (the components of) a key pair
574 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200575void mbedtls_ecp_keypair_init( mbedtls_ecp_keypair *key )
Manuel Pégourié-Gonnardb8c6e0e2013-07-01 13:40:52 +0200576{
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000577 ECP_VALIDATE( key != NULL );
Manuel Pégourié-Gonnardb8c6e0e2013-07-01 13:40:52 +0200578
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200579 mbedtls_ecp_group_init( &key->grp );
580 mbedtls_mpi_init( &key->d );
581 mbedtls_ecp_point_init( &key->Q );
Manuel Pégourié-Gonnardb8c6e0e2013-07-01 13:40:52 +0200582}
583
584/*
Manuel Pégourié-Gonnard1e8c8ec2012-10-31 19:24:21 +0100585 * Unallocate (the components of) a point
586 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200587void mbedtls_ecp_point_free( mbedtls_ecp_point *pt )
Manuel Pégourié-Gonnard1e8c8ec2012-10-31 19:24:21 +0100588{
589 if( pt == NULL )
590 return;
591
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200592 mbedtls_mpi_free( &( pt->X ) );
593 mbedtls_mpi_free( &( pt->Y ) );
594 mbedtls_mpi_free( &( pt->Z ) );
Manuel Pégourié-Gonnard1e8c8ec2012-10-31 19:24:21 +0100595}
596
597/*
598 * Unallocate (the components of) a group
599 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200600void mbedtls_ecp_group_free( mbedtls_ecp_group *grp )
Manuel Pégourié-Gonnard1e8c8ec2012-10-31 19:24:21 +0100601{
Manuel Pégourié-Gonnard161ef962013-09-17 19:13:10 +0200602 size_t i;
603
Manuel Pégourié-Gonnard1e8c8ec2012-10-31 19:24:21 +0100604 if( grp == NULL )
605 return;
606
Manuel Pégourié-Gonnard1f82b042013-12-06 12:51:50 +0100607 if( grp->h != 1 )
608 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200609 mbedtls_mpi_free( &grp->P );
610 mbedtls_mpi_free( &grp->A );
611 mbedtls_mpi_free( &grp->B );
612 mbedtls_ecp_point_free( &grp->G );
613 mbedtls_mpi_free( &grp->N );
Manuel Pégourié-Gonnard1f82b042013-12-06 12:51:50 +0100614 }
Manuel Pégourié-Gonnardc9727702013-09-16 18:56:28 +0200615
Manuel Pégourié-Gonnard161ef962013-09-17 19:13:10 +0200616 if( grp->T != NULL )
617 {
618 for( i = 0; i < grp->T_size; i++ )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200619 mbedtls_ecp_point_free( &grp->T[i] );
620 mbedtls_free( grp->T );
Manuel Pégourié-Gonnard161ef962013-09-17 19:13:10 +0200621 }
622
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -0500623 mbedtls_platform_zeroize( grp, sizeof( mbedtls_ecp_group ) );
Manuel Pégourié-Gonnard1e8c8ec2012-10-31 19:24:21 +0100624}
Manuel Pégourié-Gonnard39d2adb2012-10-31 09:26:55 +0100625
Manuel Pégourié-Gonnard883f3132012-11-02 09:40:25 +0100626/*
Manuel Pégourié-Gonnardb8c6e0e2013-07-01 13:40:52 +0200627 * Unallocate (the components of) a key pair
628 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200629void mbedtls_ecp_keypair_free( mbedtls_ecp_keypair *key )
Manuel Pégourié-Gonnardb8c6e0e2013-07-01 13:40:52 +0200630{
Paul Bakker66d5d072014-06-17 16:39:18 +0200631 if( key == NULL )
Manuel Pégourié-Gonnardb8c6e0e2013-07-01 13:40:52 +0200632 return;
633
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200634 mbedtls_ecp_group_free( &key->grp );
635 mbedtls_mpi_free( &key->d );
636 mbedtls_ecp_point_free( &key->Q );
Manuel Pégourié-Gonnardb8c6e0e2013-07-01 13:40:52 +0200637}
638
639/*
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +0200640 * Copy the contents of a point
641 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200642int mbedtls_ecp_copy( mbedtls_ecp_point *P, const mbedtls_ecp_point *Q )
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +0200643{
644 int ret;
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000645 ECP_VALIDATE_RET( P != NULL );
646 ECP_VALIDATE_RET( Q != NULL );
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +0200647
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200648 MBEDTLS_MPI_CHK( mbedtls_mpi_copy( &P->X, &Q->X ) );
649 MBEDTLS_MPI_CHK( mbedtls_mpi_copy( &P->Y, &Q->Y ) );
650 MBEDTLS_MPI_CHK( mbedtls_mpi_copy( &P->Z, &Q->Z ) );
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +0200651
652cleanup:
653 return( ret );
654}
655
656/*
657 * Copy the contents of a group object
658 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200659int mbedtls_ecp_group_copy( mbedtls_ecp_group *dst, const mbedtls_ecp_group *src )
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +0200660{
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000661 ECP_VALIDATE_RET( dst != NULL );
662 ECP_VALIDATE_RET( src != NULL );
663
664 return( mbedtls_ecp_group_load( dst, src->id ) );
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +0200665}
666
667/*
Manuel Pégourié-Gonnardae180d02012-11-02 18:14:40 +0100668 * Set point to zero
669 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200670int mbedtls_ecp_set_zero( mbedtls_ecp_point *pt )
Manuel Pégourié-Gonnardae180d02012-11-02 18:14:40 +0100671{
Manuel Pégourié-Gonnard1c2782c2012-11-19 20:16:28 +0100672 int ret;
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000673 ECP_VALIDATE_RET( pt != NULL );
Manuel Pégourié-Gonnard1c2782c2012-11-19 20:16:28 +0100674
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200675 MBEDTLS_MPI_CHK( mbedtls_mpi_lset( &pt->X , 1 ) );
676 MBEDTLS_MPI_CHK( mbedtls_mpi_lset( &pt->Y , 1 ) );
677 MBEDTLS_MPI_CHK( mbedtls_mpi_lset( &pt->Z , 0 ) );
Manuel Pégourié-Gonnard1c2782c2012-11-19 20:16:28 +0100678
679cleanup:
680 return( ret );
Manuel Pégourié-Gonnardae180d02012-11-02 18:14:40 +0100681}
682
683/*
Manuel Pégourié-Gonnard6545ca72013-01-26 16:05:22 +0100684 * Tell if a point is zero
685 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200686int mbedtls_ecp_is_zero( mbedtls_ecp_point *pt )
Manuel Pégourié-Gonnard6545ca72013-01-26 16:05:22 +0100687{
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000688 ECP_VALIDATE_RET( pt != NULL );
689
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200690 return( mbedtls_mpi_cmp_int( &pt->Z, 0 ) == 0 );
Manuel Pégourié-Gonnard6545ca72013-01-26 16:05:22 +0100691}
692
693/*
Brian J Murrayf343de12018-10-22 16:40:49 -0700694 * Compare two points lazily
Manuel Pégourié-Gonnard6029a852015-08-11 15:44:41 +0200695 */
696int mbedtls_ecp_point_cmp( const mbedtls_ecp_point *P,
697 const mbedtls_ecp_point *Q )
698{
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000699 ECP_VALIDATE_RET( P != NULL );
700 ECP_VALIDATE_RET( Q != NULL );
701
Manuel Pégourié-Gonnard6029a852015-08-11 15:44:41 +0200702 if( mbedtls_mpi_cmp_mpi( &P->X, &Q->X ) == 0 &&
703 mbedtls_mpi_cmp_mpi( &P->Y, &Q->Y ) == 0 &&
704 mbedtls_mpi_cmp_mpi( &P->Z, &Q->Z ) == 0 )
705 {
706 return( 0 );
707 }
708
709 return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
710}
711
712/*
Manuel Pégourié-Gonnard847395a2012-11-05 13:13:44 +0100713 * Import a non-zero point from ASCII strings
714 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200715int mbedtls_ecp_point_read_string( mbedtls_ecp_point *P, int radix,
Manuel Pégourié-Gonnard847395a2012-11-05 13:13:44 +0100716 const char *x, const char *y )
717{
Manuel Pégourié-Gonnard47123252012-11-10 14:44:24 +0100718 int ret;
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000719 ECP_VALIDATE_RET( P != NULL );
720 ECP_VALIDATE_RET( x != NULL );
721 ECP_VALIDATE_RET( y != NULL );
Manuel Pégourié-Gonnard847395a2012-11-05 13:13:44 +0100722
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200723 MBEDTLS_MPI_CHK( mbedtls_mpi_read_string( &P->X, radix, x ) );
724 MBEDTLS_MPI_CHK( mbedtls_mpi_read_string( &P->Y, radix, y ) );
725 MBEDTLS_MPI_CHK( mbedtls_mpi_lset( &P->Z, 1 ) );
Manuel Pégourié-Gonnard847395a2012-11-05 13:13:44 +0100726
727cleanup:
728 return( ret );
729}
730
731/*
Manuel Pégourié-Gonnard37d218a2012-11-24 15:19:55 +0100732 * Export a point into unsigned binary data (SEC1 2.3.3)
Manuel Pégourié-Gonnarde19feb52012-11-24 14:10:14 +0100733 */
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000734int mbedtls_ecp_point_write_binary( const mbedtls_ecp_group *grp,
735 const mbedtls_ecp_point *P,
736 int format, size_t *olen,
737 unsigned char *buf, size_t buflen )
Manuel Pégourié-Gonnarde19feb52012-11-24 14:10:14 +0100738{
Paul Bakkera280d0f2013-04-08 13:40:17 +0200739 int ret = 0;
Manuel Pégourié-Gonnarde19feb52012-11-24 14:10:14 +0100740 size_t plen;
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000741 ECP_VALIDATE_RET( grp != NULL );
742 ECP_VALIDATE_RET( P != NULL );
743 ECP_VALIDATE_RET( olen != NULL );
744 ECP_VALIDATE_RET( buf != NULL );
745 ECP_VALIDATE_RET( format == MBEDTLS_ECP_PF_UNCOMPRESSED ||
746 format == MBEDTLS_ECP_PF_COMPRESSED );
Manuel Pégourié-Gonnard37d218a2012-11-24 15:19:55 +0100747
Manuel Pégourié-Gonnarde19feb52012-11-24 14:10:14 +0100748 /*
Manuel Pégourié-Gonnard37d218a2012-11-24 15:19:55 +0100749 * Common case: P == 0
Manuel Pégourié-Gonnarde19feb52012-11-24 14:10:14 +0100750 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200751 if( mbedtls_mpi_cmp_int( &P->Z, 0 ) == 0 )
Manuel Pégourié-Gonnarde19feb52012-11-24 14:10:14 +0100752 {
753 if( buflen < 1 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200754 return( MBEDTLS_ERR_ECP_BUFFER_TOO_SMALL );
Manuel Pégourié-Gonnarde19feb52012-11-24 14:10:14 +0100755
756 buf[0] = 0x00;
757 *olen = 1;
758
759 return( 0 );
760 }
761
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200762 plen = mbedtls_mpi_size( &grp->P );
Manuel Pégourié-Gonnarde19feb52012-11-24 14:10:14 +0100763
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200764 if( format == MBEDTLS_ECP_PF_UNCOMPRESSED )
Manuel Pégourié-Gonnard37d218a2012-11-24 15:19:55 +0100765 {
766 *olen = 2 * plen + 1;
Manuel Pégourié-Gonnarde19feb52012-11-24 14:10:14 +0100767
Manuel Pégourié-Gonnard37d218a2012-11-24 15:19:55 +0100768 if( buflen < *olen )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200769 return( MBEDTLS_ERR_ECP_BUFFER_TOO_SMALL );
Manuel Pégourié-Gonnard37d218a2012-11-24 15:19:55 +0100770
771 buf[0] = 0x04;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200772 MBEDTLS_MPI_CHK( mbedtls_mpi_write_binary( &P->X, buf + 1, plen ) );
773 MBEDTLS_MPI_CHK( mbedtls_mpi_write_binary( &P->Y, buf + 1 + plen, plen ) );
Manuel Pégourié-Gonnard37d218a2012-11-24 15:19:55 +0100774 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200775 else if( format == MBEDTLS_ECP_PF_COMPRESSED )
Manuel Pégourié-Gonnard37d218a2012-11-24 15:19:55 +0100776 {
777 *olen = plen + 1;
778
779 if( buflen < *olen )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200780 return( MBEDTLS_ERR_ECP_BUFFER_TOO_SMALL );
Manuel Pégourié-Gonnard37d218a2012-11-24 15:19:55 +0100781
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200782 buf[0] = 0x02 + mbedtls_mpi_get_bit( &P->Y, 0 );
783 MBEDTLS_MPI_CHK( mbedtls_mpi_write_binary( &P->X, buf + 1, plen ) );
Manuel Pégourié-Gonnard37d218a2012-11-24 15:19:55 +0100784 }
Manuel Pégourié-Gonnarde19feb52012-11-24 14:10:14 +0100785
786cleanup:
787 return( ret );
788}
789
790/*
Manuel Pégourié-Gonnard5e402d82012-11-24 16:19:42 +0100791 * Import a point from unsigned binary data (SEC1 2.3.4)
792 */
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000793int mbedtls_ecp_point_read_binary( const mbedtls_ecp_group *grp,
794 mbedtls_ecp_point *pt,
795 const unsigned char *buf, size_t ilen )
Manuel Pégourié-Gonnard5246ee52014-03-19 16:18:38 +0100796{
Manuel Pégourié-Gonnard5e402d82012-11-24 16:19:42 +0100797 int ret;
798 size_t plen;
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000799 ECP_VALIDATE_RET( grp != NULL );
800 ECP_VALIDATE_RET( pt != NULL );
801 ECP_VALIDATE_RET( buf != NULL );
Manuel Pégourié-Gonnard5e402d82012-11-24 16:19:42 +0100802
Paul Bakker82788fb2014-10-20 13:59:19 +0200803 if( ilen < 1 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200804 return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
Manuel Pégourié-Gonnard67dbe1e2014-07-08 13:09:24 +0200805
Manuel Pégourié-Gonnardc042cf02014-03-26 14:12:20 +0100806 if( buf[0] == 0x00 )
807 {
808 if( ilen == 1 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200809 return( mbedtls_ecp_set_zero( pt ) );
Manuel Pégourié-Gonnardc042cf02014-03-26 14:12:20 +0100810 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200811 return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
Manuel Pégourié-Gonnardc042cf02014-03-26 14:12:20 +0100812 }
Manuel Pégourié-Gonnard5e402d82012-11-24 16:19:42 +0100813
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200814 plen = mbedtls_mpi_size( &grp->P );
Manuel Pégourié-Gonnard5e402d82012-11-24 16:19:42 +0100815
Manuel Pégourié-Gonnard5246ee52014-03-19 16:18:38 +0100816 if( buf[0] != 0x04 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200817 return( MBEDTLS_ERR_ECP_FEATURE_UNAVAILABLE );
Manuel Pégourié-Gonnard5246ee52014-03-19 16:18:38 +0100818
819 if( ilen != 2 * plen + 1 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200820 return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
Manuel Pégourié-Gonnard5e402d82012-11-24 16:19:42 +0100821
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200822 MBEDTLS_MPI_CHK( mbedtls_mpi_read_binary( &pt->X, buf + 1, plen ) );
823 MBEDTLS_MPI_CHK( mbedtls_mpi_read_binary( &pt->Y, buf + 1 + plen, plen ) );
824 MBEDTLS_MPI_CHK( mbedtls_mpi_lset( &pt->Z, 1 ) );
Manuel Pégourié-Gonnard5e402d82012-11-24 16:19:42 +0100825
826cleanup:
827 return( ret );
828}
829
830/*
Manuel Pégourié-Gonnard00794052013-02-09 19:00:07 +0100831 * Import a point from a TLS ECPoint record (RFC 4492)
832 * struct {
833 * opaque point <1..2^8-1>;
834 * } ECPoint;
835 */
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000836int mbedtls_ecp_tls_read_point( const mbedtls_ecp_group *grp,
837 mbedtls_ecp_point *pt,
838 const unsigned char **buf, size_t buf_len )
Manuel Pégourié-Gonnard00794052013-02-09 19:00:07 +0100839{
840 unsigned char data_len;
Manuel Pégourié-Gonnard98f51812013-02-10 13:38:29 +0100841 const unsigned char *buf_start;
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000842 ECP_VALIDATE_RET( grp != NULL );
843 ECP_VALIDATE_RET( pt != NULL );
844 ECP_VALIDATE_RET( buf != NULL );
845 ECP_VALIDATE_RET( *buf != NULL );
Manuel Pégourié-Gonnard00794052013-02-09 19:00:07 +0100846
847 /*
Manuel Pégourié-Gonnard67dbe1e2014-07-08 13:09:24 +0200848 * We must have at least two bytes (1 for length, at least one for data)
Manuel Pégourié-Gonnard00794052013-02-09 19:00:07 +0100849 */
850 if( buf_len < 2 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200851 return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
Manuel Pégourié-Gonnard00794052013-02-09 19:00:07 +0100852
Manuel Pégourié-Gonnard98f51812013-02-10 13:38:29 +0100853 data_len = *(*buf)++;
Manuel Pégourié-Gonnard00794052013-02-09 19:00:07 +0100854 if( data_len < 1 || data_len > buf_len - 1 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200855 return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
Manuel Pégourié-Gonnard00794052013-02-09 19:00:07 +0100856
Manuel Pégourié-Gonnard98f51812013-02-10 13:38:29 +0100857 /*
858 * Save buffer start for read_binary and update buf
859 */
860 buf_start = *buf;
861 *buf += data_len;
862
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000863 return( mbedtls_ecp_point_read_binary( grp, pt, buf_start, data_len ) );
Manuel Pégourié-Gonnard00794052013-02-09 19:00:07 +0100864}
865
866/*
867 * Export a point as a TLS ECPoint record (RFC 4492)
868 * struct {
869 * opaque point <1..2^8-1>;
870 * } ECPoint;
871 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200872int mbedtls_ecp_tls_write_point( const mbedtls_ecp_group *grp, const mbedtls_ecp_point *pt,
Manuel Pégourié-Gonnard420f1eb2013-02-10 12:22:46 +0100873 int format, size_t *olen,
874 unsigned char *buf, size_t blen )
Manuel Pégourié-Gonnard00794052013-02-09 19:00:07 +0100875{
Manuel Pégourié-Gonnard420f1eb2013-02-10 12:22:46 +0100876 int ret;
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000877 ECP_VALIDATE_RET( grp != NULL );
878 ECP_VALIDATE_RET( pt != NULL );
879 ECP_VALIDATE_RET( olen != NULL );
880 ECP_VALIDATE_RET( buf != NULL );
881 ECP_VALIDATE_RET( format == MBEDTLS_ECP_PF_UNCOMPRESSED ||
882 format == MBEDTLS_ECP_PF_COMPRESSED );
Manuel Pégourié-Gonnard420f1eb2013-02-10 12:22:46 +0100883
Manuel Pégourié-Gonnard00794052013-02-09 19:00:07 +0100884 /*
Manuel Pégourié-Gonnard420f1eb2013-02-10 12:22:46 +0100885 * buffer length must be at least one, for our length byte
Manuel Pégourié-Gonnard00794052013-02-09 19:00:07 +0100886 */
Manuel Pégourié-Gonnard420f1eb2013-02-10 12:22:46 +0100887 if( blen < 1 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200888 return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
Manuel Pégourié-Gonnard00794052013-02-09 19:00:07 +0100889
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200890 if( ( ret = mbedtls_ecp_point_write_binary( grp, pt, format,
Manuel Pégourié-Gonnard420f1eb2013-02-10 12:22:46 +0100891 olen, buf + 1, blen - 1) ) != 0 )
892 return( ret );
893
894 /*
895 * write length to the first byte and update total length
896 */
Paul Bakkerb9cfaa02013-10-11 18:58:55 +0200897 buf[0] = (unsigned char) *olen;
Manuel Pégourié-Gonnard420f1eb2013-02-10 12:22:46 +0100898 ++*olen;
899
Paul Bakkerd8bb8262014-06-17 14:06:49 +0200900 return( 0 );
Manuel Pégourié-Gonnard00794052013-02-09 19:00:07 +0100901}
902
903/*
Manuel Pégourié-Gonnard1a967282013-02-09 17:03:58 +0100904 * Set a group from an ECParameters record (RFC 4492)
905 */
Janos Follath89ac8c92018-10-30 11:24:05 +0000906int mbedtls_ecp_tls_read_group( mbedtls_ecp_group *grp,
907 const unsigned char **buf, size_t len )
908{
909 int ret;
910 mbedtls_ecp_group_id grp_id;
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000911 ECP_VALIDATE_RET( grp != NULL );
912 ECP_VALIDATE_RET( buf != NULL );
913 ECP_VALIDATE_RET( *buf != NULL );
Janos Follath89ac8c92018-10-30 11:24:05 +0000914
915 if( ( ret = mbedtls_ecp_tls_read_group_id( &grp_id, buf, len ) ) != 0 )
916 return( ret );
917
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000918 return( mbedtls_ecp_group_load( grp, grp_id ) );
Janos Follath89ac8c92018-10-30 11:24:05 +0000919}
920
921/*
922 * Read a group id from an ECParameters record (RFC 4492) and convert it to
923 * mbedtls_ecp_group_id.
924 */
925int mbedtls_ecp_tls_read_group_id( mbedtls_ecp_group_id *grp,
926 const unsigned char **buf, size_t len )
Manuel Pégourié-Gonnard1a967282013-02-09 17:03:58 +0100927{
Manuel Pégourié-Gonnardf24b4a72013-09-23 18:14:50 +0200928 uint16_t tls_id;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200929 const mbedtls_ecp_curve_info *curve_info;
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000930 ECP_VALIDATE_RET( grp != NULL );
931 ECP_VALIDATE_RET( buf != NULL );
932 ECP_VALIDATE_RET( *buf != NULL );
Manuel Pégourié-Gonnard1a967282013-02-09 17:03:58 +0100933
934 /*
935 * We expect at least three bytes (see below)
936 */
937 if( len < 3 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200938 return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
Manuel Pégourié-Gonnard1a967282013-02-09 17:03:58 +0100939
940 /*
941 * First byte is curve_type; only named_curve is handled
942 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200943 if( *(*buf)++ != MBEDTLS_ECP_TLS_NAMED_CURVE )
944 return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
Manuel Pégourié-Gonnard1a967282013-02-09 17:03:58 +0100945
946 /*
Manuel Pégourié-Gonnardb3258872013-02-10 12:06:19 +0100947 * Next two bytes are the namedcurve value
Manuel Pégourié-Gonnard1a967282013-02-09 17:03:58 +0100948 */
Manuel Pégourié-Gonnardf24b4a72013-09-23 18:14:50 +0200949 tls_id = *(*buf)++;
950 tls_id <<= 8;
951 tls_id |= *(*buf)++;
952
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200953 if( ( curve_info = mbedtls_ecp_curve_info_from_tls_id( tls_id ) ) == NULL )
954 return( MBEDTLS_ERR_ECP_FEATURE_UNAVAILABLE );
Manuel Pégourié-Gonnardf24b4a72013-09-23 18:14:50 +0200955
Janos Follath89ac8c92018-10-30 11:24:05 +0000956 *grp = curve_info->grp_id;
957
958 return( 0 );
Manuel Pégourié-Gonnardb3258872013-02-10 12:06:19 +0100959}
960
961/*
962 * Write the ECParameters record corresponding to a group (RFC 4492)
963 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200964int mbedtls_ecp_tls_write_group( const mbedtls_ecp_group *grp, size_t *olen,
Manuel Pégourié-Gonnardb3258872013-02-10 12:06:19 +0100965 unsigned char *buf, size_t blen )
966{
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200967 const mbedtls_ecp_curve_info *curve_info;
Hanno Becker4f8e8e52018-12-14 15:08:03 +0000968 ECP_VALIDATE_RET( grp != NULL );
969 ECP_VALIDATE_RET( buf != NULL );
970 ECP_VALIDATE_RET( olen != NULL );
Manuel Pégourié-Gonnardf24b4a72013-09-23 18:14:50 +0200971
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200972 if( ( curve_info = mbedtls_ecp_curve_info_from_grp_id( grp->id ) ) == NULL )
973 return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
Manuel Pégourié-Gonnard70380392013-09-16 16:19:53 +0200974
Manuel Pégourié-Gonnardb3258872013-02-10 12:06:19 +0100975 /*
976 * We are going to write 3 bytes (see below)
977 */
978 *olen = 3;
979 if( blen < *olen )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200980 return( MBEDTLS_ERR_ECP_BUFFER_TOO_SMALL );
Manuel Pégourié-Gonnardb3258872013-02-10 12:06:19 +0100981
982 /*
983 * First byte is curve_type, always named_curve
984 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200985 *buf++ = MBEDTLS_ECP_TLS_NAMED_CURVE;
Manuel Pégourié-Gonnardb3258872013-02-10 12:06:19 +0100986
987 /*
988 * Next two bytes are the namedcurve value
989 */
Manuel Pégourié-Gonnardf24b4a72013-09-23 18:14:50 +0200990 buf[0] = curve_info->tls_id >> 8;
991 buf[1] = curve_info->tls_id & 0xFF;
Manuel Pégourié-Gonnardb3258872013-02-10 12:06:19 +0100992
Paul Bakkerd8bb8262014-06-17 14:06:49 +0200993 return( 0 );
Manuel Pégourié-Gonnarda5402fe2012-11-07 20:24:05 +0100994}
Manuel Pégourié-Gonnardab38b702012-11-05 17:34:55 +0100995
Manuel Pégourié-Gonnard568c9cf2013-09-16 17:30:04 +0200996/*
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200997 * Wrapper around fast quasi-modp functions, with fall-back to mbedtls_mpi_mod_mpi.
998 * See the documentation of struct mbedtls_ecp_group.
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +0200999 *
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001000 * This function is in the critial loop for mbedtls_ecp_mul, so pay attention to perf.
Manuel Pégourié-Gonnard568c9cf2013-09-16 17:30:04 +02001001 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001002static int ecp_modp( mbedtls_mpi *N, const mbedtls_ecp_group *grp )
Manuel Pégourié-Gonnard70380392013-09-16 16:19:53 +02001003{
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +02001004 int ret;
Manuel Pégourié-Gonnard568c9cf2013-09-16 17:30:04 +02001005
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +02001006 if( grp->modp == NULL )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001007 return( mbedtls_mpi_mod_mpi( N, N, &grp->P ) );
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +02001008
1009 /* N->s < 0 is a much faster test, which fails only if N is 0 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001010 if( ( N->s < 0 && mbedtls_mpi_cmp_int( N, 0 ) != 0 ) ||
Manuel Pégourié-Gonnardc0696c22015-06-18 16:47:17 +02001011 mbedtls_mpi_bitlen( N ) > 2 * grp->pbits )
Manuel Pégourié-Gonnard70380392013-09-16 16:19:53 +02001012 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001013 return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
Manuel Pégourié-Gonnard70380392013-09-16 16:19:53 +02001014 }
Manuel Pégourié-Gonnard568c9cf2013-09-16 17:30:04 +02001015
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001016 MBEDTLS_MPI_CHK( grp->modp( N ) );
Manuel Pégourié-Gonnard70380392013-09-16 16:19:53 +02001017
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +02001018 /* N->s < 0 is a much faster test, which fails only if N is 0 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001019 while( N->s < 0 && mbedtls_mpi_cmp_int( N, 0 ) != 0 )
1020 MBEDTLS_MPI_CHK( mbedtls_mpi_add_mpi( N, N, &grp->P ) );
Manuel Pégourié-Gonnard568c9cf2013-09-16 17:30:04 +02001021
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001022 while( mbedtls_mpi_cmp_mpi( N, &grp->P ) >= 0 )
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +02001023 /* we known P, N and the result are positive */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001024 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_abs( N, N, &grp->P ) );
Manuel Pégourié-Gonnard568c9cf2013-09-16 17:30:04 +02001025
Manuel Pégourié-Gonnardcae6f3e2013-10-23 20:19:57 +02001026cleanup:
1027 return( ret );
Manuel Pégourié-Gonnard70380392013-09-16 16:19:53 +02001028}
Manuel Pégourié-Gonnard568c9cf2013-09-16 17:30:04 +02001029
Manuel Pégourié-Gonnard847395a2012-11-05 13:13:44 +01001030/*
Manuel Pégourié-Gonnard47123252012-11-10 14:44:24 +01001031 * Fast mod-p functions expect their argument to be in the 0..p^2 range.
Manuel Pégourié-Gonnarddada4da2012-11-10 14:23:17 +01001032 *
Manuel Pégourié-Gonnard47123252012-11-10 14:44:24 +01001033 * In order to guarantee that, we need to ensure that operands of
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001034 * mbedtls_mpi_mul_mpi are in the 0..p range. So, after each operation we will
Manuel Pégourié-Gonnarddada4da2012-11-10 14:23:17 +01001035 * bring the result back to this range.
1036 *
Manuel Pégourié-Gonnard47123252012-11-10 14:44:24 +01001037 * The following macros are shortcuts for doing that.
Manuel Pégourié-Gonnarddada4da2012-11-10 14:23:17 +01001038 */
1039
1040/*
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001041 * Reduce a mbedtls_mpi mod p in-place, general case, to use after mbedtls_mpi_mul_mpi
Manuel Pégourié-Gonnard84d1aea2012-11-09 02:09:38 +01001042 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001043#if defined(MBEDTLS_SELF_TEST)
Manuel Pégourié-Gonnard91814812013-11-21 20:23:55 +01001044#define INC_MUL_COUNT mul_count++;
1045#else
1046#define INC_MUL_COUNT
1047#endif
1048
Hanno Beckerd6028a12018-10-15 12:01:35 +01001049#define MOD_MUL( N ) \
1050 do \
1051 { \
1052 MBEDTLS_MPI_CHK( ecp_modp( &(N), grp ) ); \
1053 INC_MUL_COUNT \
1054 } while( 0 )
Manuel Pégourié-Gonnard84d1aea2012-11-09 02:09:38 +01001055
1056/*
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001057 * Reduce a mbedtls_mpi mod p in-place, to use after mbedtls_mpi_sub_mpi
Manuel Pégourié-Gonnardc9e387c2013-10-17 17:15:35 +02001058 * N->s < 0 is a very fast test, which fails only if N is 0
Manuel Pégourié-Gonnard84d1aea2012-11-09 02:09:38 +01001059 */
Hanno Beckerd6028a12018-10-15 12:01:35 +01001060#define MOD_SUB( N ) \
1061 while( (N).s < 0 && mbedtls_mpi_cmp_int( &(N), 0 ) != 0 ) \
1062 MBEDTLS_MPI_CHK( mbedtls_mpi_add_mpi( &(N), &(N), &grp->P ) )
Manuel Pégourié-Gonnard84d1aea2012-11-09 02:09:38 +01001063
1064/*
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001065 * Reduce a mbedtls_mpi mod p in-place, to use after mbedtls_mpi_add_mpi and mbedtls_mpi_mul_int.
Manuel Pégourié-Gonnardc9e387c2013-10-17 17:15:35 +02001066 * We known P, N and the result are positive, so sub_abs is correct, and
1067 * a bit faster.
Manuel Pégourié-Gonnard84d1aea2012-11-09 02:09:38 +01001068 */
Hanno Beckerd6028a12018-10-15 12:01:35 +01001069#define MOD_ADD( N ) \
1070 while( mbedtls_mpi_cmp_mpi( &(N), &grp->P ) >= 0 ) \
1071 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_abs( &(N), &(N), &grp->P ) )
Manuel Pégourié-Gonnard84d1aea2012-11-09 02:09:38 +01001072
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +02001073#if defined(ECP_SHORTWEIERSTRASS)
Manuel Pégourié-Gonnard7c94d8b2013-12-04 23:15:46 +01001074/*
1075 * For curves in short Weierstrass form, we do all the internal operations in
1076 * Jacobian coordinates.
1077 *
1078 * For multiplication, we'll use a comb method with coutermeasueres against
1079 * SPA, hence timing attacks.
1080 */
1081
Manuel Pégourié-Gonnard84d1aea2012-11-09 02:09:38 +01001082/*
Manuel Pégourié-Gonnard1c2782c2012-11-19 20:16:28 +01001083 * Normalize jacobian coordinates so that Z == 0 || Z == 1 (GECC 3.2.1)
Manuel Pégourié-Gonnard04a02252013-11-20 22:57:38 +01001084 * Cost: 1N := 1I + 3M + 1S
Manuel Pégourié-Gonnardd070f512012-11-08 17:40:51 +01001085 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001086static int ecp_normalize_jac( const mbedtls_ecp_group *grp, mbedtls_ecp_point *pt )
Manuel Pégourié-Gonnardd070f512012-11-08 17:40:51 +01001087{
Manuel Pégourié-Gonnard47123252012-11-10 14:44:24 +01001088 int ret;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001089 mbedtls_mpi Zi, ZZi;
Manuel Pégourié-Gonnardd070f512012-11-08 17:40:51 +01001090
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001091 if( mbedtls_mpi_cmp_int( &pt->Z, 0 ) == 0 )
Manuel Pégourié-Gonnardd070f512012-11-08 17:40:51 +01001092 return( 0 );
Manuel Pégourié-Gonnardd070f512012-11-08 17:40:51 +01001093
Janos Follathb0697532016-08-18 12:38:46 +01001094#if defined(MBEDTLS_ECP_NORMALIZE_JAC_ALT)
Manuel Pégourié-Gonnardebac5d32017-08-23 16:23:36 +02001095 if( mbedtls_internal_ecp_grp_capable( grp ) )
1096 return( mbedtls_internal_ecp_normalize_jac( grp, pt ) );
Janos Follath372697b2016-10-28 16:53:11 +01001097#endif /* MBEDTLS_ECP_NORMALIZE_JAC_ALT */
Manuel Pégourié-Gonnardebac5d32017-08-23 16:23:36 +02001098
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001099 mbedtls_mpi_init( &Zi ); mbedtls_mpi_init( &ZZi );
Manuel Pégourié-Gonnardd070f512012-11-08 17:40:51 +01001100
Manuel Pégourié-Gonnard1c2782c2012-11-19 20:16:28 +01001101 /*
1102 * X = X / Z^2 mod p
1103 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001104 MBEDTLS_MPI_CHK( mbedtls_mpi_inv_mod( &Zi, &pt->Z, &grp->P ) );
1105 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &ZZi, &Zi, &Zi ) ); MOD_MUL( ZZi );
1106 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &pt->X, &pt->X, &ZZi ) ); MOD_MUL( pt->X );
Manuel Pégourié-Gonnardd070f512012-11-08 17:40:51 +01001107
1108 /*
Manuel Pégourié-Gonnard1c2782c2012-11-19 20:16:28 +01001109 * Y = Y / Z^3 mod p
Manuel Pégourié-Gonnardd070f512012-11-08 17:40:51 +01001110 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001111 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &pt->Y, &pt->Y, &ZZi ) ); MOD_MUL( pt->Y );
1112 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &pt->Y, &pt->Y, &Zi ) ); MOD_MUL( pt->Y );
Manuel Pégourié-Gonnardd070f512012-11-08 17:40:51 +01001113
1114 /*
Manuel Pégourié-Gonnard1c2782c2012-11-19 20:16:28 +01001115 * Z = 1
Manuel Pégourié-Gonnardd070f512012-11-08 17:40:51 +01001116 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001117 MBEDTLS_MPI_CHK( mbedtls_mpi_lset( &pt->Z, 1 ) );
Manuel Pégourié-Gonnardd070f512012-11-08 17:40:51 +01001118
1119cleanup:
1120
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001121 mbedtls_mpi_free( &Zi ); mbedtls_mpi_free( &ZZi );
Manuel Pégourié-Gonnardd070f512012-11-08 17:40:51 +01001122
1123 return( ret );
1124}
1125
1126/*
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001127 * Normalize jacobian coordinates of an array of (pointers to) points,
Manuel Pégourié-Gonnard3680c822012-11-21 18:49:45 +01001128 * using Montgomery's trick to perform only one inversion mod P.
Manuel Pégourié-Gonnardcdd44322012-11-21 16:00:55 +01001129 * (See for example Cohen's "A Course in Computational Algebraic Number
1130 * Theory", Algorithm 10.3.4.)
1131 *
Manuel Pégourié-Gonnard07de4b12013-09-02 16:26:04 +02001132 * Warning: fails (returning an error) if one of the points is zero!
Manuel Pégourié-Gonnard7a949d32013-12-05 10:26:01 +01001133 * This should never happen, see choice of w in ecp_mul_comb().
Manuel Pégourié-Gonnard04a02252013-11-20 22:57:38 +01001134 *
1135 * Cost: 1N(t) := 1I + (6t - 3)M + 1S
Manuel Pégourié-Gonnardcdd44322012-11-21 16:00:55 +01001136 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001137static int ecp_normalize_jac_many( const mbedtls_ecp_group *grp,
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02001138 mbedtls_ecp_point *T[], size_t T_size )
Manuel Pégourié-Gonnardcdd44322012-11-21 16:00:55 +01001139{
1140 int ret;
1141 size_t i;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001142 mbedtls_mpi *c, u, Zi, ZZi;
Manuel Pégourié-Gonnardcdd44322012-11-21 16:00:55 +01001143
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02001144 if( T_size < 2 )
Manuel Pégourié-Gonnard3c0b4ea2013-12-02 19:44:41 +01001145 return( ecp_normalize_jac( grp, *T ) );
Manuel Pégourié-Gonnardcdd44322012-11-21 16:00:55 +01001146
Janos Follathb0697532016-08-18 12:38:46 +01001147#if defined(MBEDTLS_ECP_NORMALIZE_JAC_MANY_ALT)
Manuel Pégourié-Gonnardebac5d32017-08-23 16:23:36 +02001148 if( mbedtls_internal_ecp_grp_capable( grp ) )
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02001149 return( mbedtls_internal_ecp_normalize_jac_many( grp, T, T_size ) );
Janos Follathb0697532016-08-18 12:38:46 +01001150#endif
1151
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02001152 if( ( c = mbedtls_calloc( T_size, sizeof( mbedtls_mpi ) ) ) == NULL )
Manuel Pégourié-Gonnard6a8ca332015-05-28 09:33:39 +02001153 return( MBEDTLS_ERR_ECP_ALLOC_FAILED );
Manuel Pégourié-Gonnardcdd44322012-11-21 16:00:55 +01001154
Manuel Pégourié-Gonnard5bd38b12017-08-23 16:55:59 +02001155 for( i = 0; i < T_size; i++ )
1156 mbedtls_mpi_init( &c[i] );
1157
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001158 mbedtls_mpi_init( &u ); mbedtls_mpi_init( &Zi ); mbedtls_mpi_init( &ZZi );
Manuel Pégourié-Gonnardcdd44322012-11-21 16:00:55 +01001159
1160 /*
1161 * c[i] = Z_0 * ... * Z_i
1162 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001163 MBEDTLS_MPI_CHK( mbedtls_mpi_copy( &c[0], &T[0]->Z ) );
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02001164 for( i = 1; i < T_size; i++ )
Manuel Pégourié-Gonnardcdd44322012-11-21 16:00:55 +01001165 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001166 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &c[i], &c[i-1], &T[i]->Z ) );
Manuel Pégourié-Gonnardcdd44322012-11-21 16:00:55 +01001167 MOD_MUL( c[i] );
1168 }
1169
1170 /*
1171 * u = 1 / (Z_0 * ... * Z_n) mod P
1172 */
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02001173 MBEDTLS_MPI_CHK( mbedtls_mpi_inv_mod( &u, &c[T_size-1], &grp->P ) );
Manuel Pégourié-Gonnardcdd44322012-11-21 16:00:55 +01001174
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02001175 for( i = T_size - 1; ; i-- )
Manuel Pégourié-Gonnardcdd44322012-11-21 16:00:55 +01001176 {
1177 /*
1178 * Zi = 1 / Z_i mod p
1179 * u = 1 / (Z_0 * ... * Z_i) mod P
1180 */
1181 if( i == 0 ) {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001182 MBEDTLS_MPI_CHK( mbedtls_mpi_copy( &Zi, &u ) );
Manuel Pégourié-Gonnardcdd44322012-11-21 16:00:55 +01001183 }
1184 else
1185 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001186 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &Zi, &u, &c[i-1] ) ); MOD_MUL( Zi );
1187 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &u, &u, &T[i]->Z ) ); MOD_MUL( u );
Manuel Pégourié-Gonnardcdd44322012-11-21 16:00:55 +01001188 }
1189
1190 /*
1191 * proceed as in normalize()
1192 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001193 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &ZZi, &Zi, &Zi ) ); MOD_MUL( ZZi );
1194 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &T[i]->X, &T[i]->X, &ZZi ) ); MOD_MUL( T[i]->X );
1195 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &T[i]->Y, &T[i]->Y, &ZZi ) ); MOD_MUL( T[i]->Y );
1196 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &T[i]->Y, &T[i]->Y, &Zi ) ); MOD_MUL( T[i]->Y );
Manuel Pégourié-Gonnard1f789b82013-12-30 17:31:56 +01001197
1198 /*
1199 * Post-precessing: reclaim some memory by shrinking coordinates
1200 * - not storing Z (always 1)
1201 * - shrinking other coordinates, but still keeping the same number of
1202 * limbs as P, as otherwise it will too likely be regrown too fast.
1203 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001204 MBEDTLS_MPI_CHK( mbedtls_mpi_shrink( &T[i]->X, grp->P.n ) );
1205 MBEDTLS_MPI_CHK( mbedtls_mpi_shrink( &T[i]->Y, grp->P.n ) );
1206 mbedtls_mpi_free( &T[i]->Z );
Manuel Pégourié-Gonnardcdd44322012-11-21 16:00:55 +01001207
1208 if( i == 0 )
1209 break;
1210 }
1211
1212cleanup:
1213
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001214 mbedtls_mpi_free( &u ); mbedtls_mpi_free( &Zi ); mbedtls_mpi_free( &ZZi );
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02001215 for( i = 0; i < T_size; i++ )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001216 mbedtls_mpi_free( &c[i] );
1217 mbedtls_free( c );
Manuel Pégourié-Gonnardcdd44322012-11-21 16:00:55 +01001218
1219 return( ret );
1220}
1221
Manuel Pégourié-Gonnardcdd44322012-11-21 16:00:55 +01001222/*
Manuel Pégourié-Gonnard01fca5e2013-11-21 17:47:12 +01001223 * Conditional point inversion: Q -> -Q = (Q.X, -Q.Y, Q.Z) without leak.
1224 * "inv" must be 0 (don't invert) or 1 (invert) or the result will be invalid
1225 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001226static int ecp_safe_invert_jac( const mbedtls_ecp_group *grp,
1227 mbedtls_ecp_point *Q,
Manuel Pégourié-Gonnard01fca5e2013-11-21 17:47:12 +01001228 unsigned char inv )
1229{
1230 int ret;
1231 unsigned char nonzero;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001232 mbedtls_mpi mQY;
Manuel Pégourié-Gonnard01fca5e2013-11-21 17:47:12 +01001233
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001234 mbedtls_mpi_init( &mQY );
Manuel Pégourié-Gonnard01fca5e2013-11-21 17:47:12 +01001235
1236 /* Use the fact that -Q.Y mod P = P - Q.Y unless Q.Y == 0 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001237 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_mpi( &mQY, &grp->P, &Q->Y ) );
1238 nonzero = mbedtls_mpi_cmp_int( &Q->Y, 0 ) != 0;
1239 MBEDTLS_MPI_CHK( mbedtls_mpi_safe_cond_assign( &Q->Y, &mQY, inv & nonzero ) );
Manuel Pégourié-Gonnard01fca5e2013-11-21 17:47:12 +01001240
1241cleanup:
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001242 mbedtls_mpi_free( &mQY );
Manuel Pégourié-Gonnard01fca5e2013-11-21 17:47:12 +01001243
1244 return( ret );
1245}
1246
1247/*
Manuel Pégourié-Gonnard0cd6f982013-10-10 15:55:39 +02001248 * Point doubling R = 2 P, Jacobian coordinates
Manuel Pégourié-Gonnard0ace4b32013-10-10 12:44:27 +02001249 *
Peter Dettmance661b22015-02-07 14:43:51 +07001250 * Based on http://www.hyperelliptic.org/EFD/g1p/auto-shortw-jacobian.html#doubling-dbl-1998-cmo-2 .
Manuel Pégourié-Gonnard04a02252013-11-20 22:57:38 +01001251 *
Peter Dettmance661b22015-02-07 14:43:51 +07001252 * We follow the variable naming fairly closely. The formula variations that trade a MUL for a SQR
1253 * (plus a few ADDs) aren't useful as our bignum implementation doesn't distinguish squaring.
1254 *
1255 * Standard optimizations are applied when curve parameter A is one of { 0, -3 }.
1256 *
1257 * Cost: 1D := 3M + 4S (A == 0)
1258 * 4M + 4S (A == -3)
1259 * 3M + 6S + 1a otherwise
Manuel Pégourié-Gonnard1c4aa242013-10-09 16:09:46 +02001260 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001261static int ecp_double_jac( const mbedtls_ecp_group *grp, mbedtls_ecp_point *R,
1262 const mbedtls_ecp_point *P )
Manuel Pégourié-Gonnard1c4aa242013-10-09 16:09:46 +02001263{
1264 int ret;
Manuel Pégourié-Gonnard2088ba62015-05-12 10:36:26 +02001265 mbedtls_mpi M, S, T, U;
Manuel Pégourié-Gonnard1c4aa242013-10-09 16:09:46 +02001266
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001267#if defined(MBEDTLS_SELF_TEST)
Manuel Pégourié-Gonnard0cd6f982013-10-10 15:55:39 +02001268 dbl_count++;
1269#endif
1270
Janos Follathb0697532016-08-18 12:38:46 +01001271#if defined(MBEDTLS_ECP_DOUBLE_JAC_ALT)
Manuel Pégourié-Gonnardebac5d32017-08-23 16:23:36 +02001272 if( mbedtls_internal_ecp_grp_capable( grp ) )
1273 return( mbedtls_internal_ecp_double_jac( grp, R, P ) );
Janos Follath372697b2016-10-28 16:53:11 +01001274#endif /* MBEDTLS_ECP_DOUBLE_JAC_ALT */
Janos Follathb0697532016-08-18 12:38:46 +01001275
Manuel Pégourié-Gonnard2088ba62015-05-12 10:36:26 +02001276 mbedtls_mpi_init( &M ); mbedtls_mpi_init( &S ); mbedtls_mpi_init( &T ); mbedtls_mpi_init( &U );
Manuel Pégourié-Gonnard73cc01d2013-12-06 12:41:30 +01001277
1278 /* Special case for A = -3 */
1279 if( grp->A.p == NULL )
1280 {
Peter Dettmance661b22015-02-07 14:43:51 +07001281 /* M = 3(X + Z^2)(X - Z^2) */
Manuel Pégourié-Gonnard2088ba62015-05-12 10:36:26 +02001282 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &S, &P->Z, &P->Z ) ); MOD_MUL( S );
1283 MBEDTLS_MPI_CHK( mbedtls_mpi_add_mpi( &T, &P->X, &S ) ); MOD_ADD( T );
1284 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_mpi( &U, &P->X, &S ) ); MOD_SUB( U );
1285 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &S, &T, &U ) ); MOD_MUL( S );
1286 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_int( &M, &S, 3 ) ); MOD_ADD( M );
Manuel Pégourié-Gonnard73cc01d2013-12-06 12:41:30 +01001287 }
1288 else
Peter Vaskovica676acf2014-08-06 00:48:39 +02001289 {
Peter Dettmance661b22015-02-07 14:43:51 +07001290 /* M = 3.X^2 */
Manuel Pégourié-Gonnard2088ba62015-05-12 10:36:26 +02001291 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &S, &P->X, &P->X ) ); MOD_MUL( S );
1292 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_int( &M, &S, 3 ) ); MOD_ADD( M );
Peter Dettmance661b22015-02-07 14:43:51 +07001293
1294 /* Optimize away for "koblitz" curves with A = 0 */
Manuel Pégourié-Gonnard2088ba62015-05-12 10:36:26 +02001295 if( mbedtls_mpi_cmp_int( &grp->A, 0 ) != 0 )
Peter Dettmance661b22015-02-07 14:43:51 +07001296 {
1297 /* M += A.Z^4 */
Manuel Pégourié-Gonnard2088ba62015-05-12 10:36:26 +02001298 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &S, &P->Z, &P->Z ) ); MOD_MUL( S );
1299 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &T, &S, &S ) ); MOD_MUL( T );
1300 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &S, &T, &grp->A ) ); MOD_MUL( S );
1301 MBEDTLS_MPI_CHK( mbedtls_mpi_add_mpi( &M, &M, &S ) ); MOD_ADD( M );
Peter Dettmance661b22015-02-07 14:43:51 +07001302 }
Peter Vaskovica676acf2014-08-06 00:48:39 +02001303 }
Manuel Pégourié-Gonnard73cc01d2013-12-06 12:41:30 +01001304
Peter Dettmance661b22015-02-07 14:43:51 +07001305 /* S = 4.X.Y^2 */
Manuel Pégourié-Gonnard2088ba62015-05-12 10:36:26 +02001306 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &T, &P->Y, &P->Y ) ); MOD_MUL( T );
1307 MBEDTLS_MPI_CHK( mbedtls_mpi_shift_l( &T, 1 ) ); MOD_ADD( T );
1308 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &S, &P->X, &T ) ); MOD_MUL( S );
1309 MBEDTLS_MPI_CHK( mbedtls_mpi_shift_l( &S, 1 ) ); MOD_ADD( S );
Manuel Pégourié-Gonnard1c4aa242013-10-09 16:09:46 +02001310
Peter Dettmance661b22015-02-07 14:43:51 +07001311 /* U = 8.Y^4 */
Manuel Pégourié-Gonnard2088ba62015-05-12 10:36:26 +02001312 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &U, &T, &T ) ); MOD_MUL( U );
1313 MBEDTLS_MPI_CHK( mbedtls_mpi_shift_l( &U, 1 ) ); MOD_ADD( U );
Peter Dettmance661b22015-02-07 14:43:51 +07001314
1315 /* T = M^2 - 2.S */
Manuel Pégourié-Gonnard2088ba62015-05-12 10:36:26 +02001316 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &T, &M, &M ) ); MOD_MUL( T );
1317 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_mpi( &T, &T, &S ) ); MOD_SUB( T );
1318 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_mpi( &T, &T, &S ) ); MOD_SUB( T );
Peter Dettmance661b22015-02-07 14:43:51 +07001319
1320 /* S = M(S - T) - U */
Manuel Pégourié-Gonnard2088ba62015-05-12 10:36:26 +02001321 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_mpi( &S, &S, &T ) ); MOD_SUB( S );
1322 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &S, &S, &M ) ); MOD_MUL( S );
1323 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_mpi( &S, &S, &U ) ); MOD_SUB( S );
Peter Dettmance661b22015-02-07 14:43:51 +07001324
1325 /* U = 2.Y.Z */
Manuel Pégourié-Gonnard2088ba62015-05-12 10:36:26 +02001326 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &U, &P->Y, &P->Z ) ); MOD_MUL( U );
1327 MBEDTLS_MPI_CHK( mbedtls_mpi_shift_l( &U, 1 ) ); MOD_ADD( U );
Peter Dettmance661b22015-02-07 14:43:51 +07001328
Manuel Pégourié-Gonnard2088ba62015-05-12 10:36:26 +02001329 MBEDTLS_MPI_CHK( mbedtls_mpi_copy( &R->X, &T ) );
1330 MBEDTLS_MPI_CHK( mbedtls_mpi_copy( &R->Y, &S ) );
1331 MBEDTLS_MPI_CHK( mbedtls_mpi_copy( &R->Z, &U ) );
Manuel Pégourié-Gonnard1c4aa242013-10-09 16:09:46 +02001332
1333cleanup:
Manuel Pégourié-Gonnard2088ba62015-05-12 10:36:26 +02001334 mbedtls_mpi_free( &M ); mbedtls_mpi_free( &S ); mbedtls_mpi_free( &T ); mbedtls_mpi_free( &U );
Manuel Pégourié-Gonnard1c4aa242013-10-09 16:09:46 +02001335
1336 return( ret );
1337}
1338
1339/*
Manuel Pégourié-Gonnard469a2092013-11-21 18:20:43 +01001340 * Addition: R = P + Q, mixed affine-Jacobian coordinates (GECC 3.22)
Manuel Pégourié-Gonnard9674fd02012-11-19 21:23:27 +01001341 *
1342 * The coordinates of Q must be normalized (= affine),
1343 * but those of P don't need to. R is not normalized.
1344 *
Manuel Pégourié-Gonnardaade42f2013-11-21 19:19:54 +01001345 * Special cases: (1) P or Q is zero, (2) R is zero, (3) P == Q.
Manuel Pégourié-Gonnard7a949d32013-12-05 10:26:01 +01001346 * None of these cases can happen as intermediate step in ecp_mul_comb():
Manuel Pégourié-Gonnardaade42f2013-11-21 19:19:54 +01001347 * - at each step, P, Q and R are multiples of the base point, the factor
1348 * being less than its order, so none of them is zero;
1349 * - Q is an odd multiple of the base point, P an even multiple,
1350 * due to the choice of precomputed points in the modified comb method.
1351 * So branches for these cases do not leak secret information.
1352 *
Manuel Pégourié-Gonnard72c172a2013-12-30 16:04:55 +01001353 * We accept Q->Z being unset (saving memory in tables) as meaning 1.
1354 *
Manuel Pégourié-Gonnard04a02252013-11-20 22:57:38 +01001355 * Cost: 1A := 8M + 3S
Manuel Pégourié-Gonnardae180d02012-11-02 18:14:40 +01001356 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001357static int ecp_add_mixed( const mbedtls_ecp_group *grp, mbedtls_ecp_point *R,
1358 const mbedtls_ecp_point *P, const mbedtls_ecp_point *Q )
Manuel Pégourié-Gonnardae180d02012-11-02 18:14:40 +01001359{
Manuel Pégourié-Gonnard47123252012-11-10 14:44:24 +01001360 int ret;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001361 mbedtls_mpi T1, T2, T3, T4, X, Y, Z;
Manuel Pégourié-Gonnardae180d02012-11-02 18:14:40 +01001362
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001363#if defined(MBEDTLS_SELF_TEST)
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +01001364 add_count++;
1365#endif
1366
Janos Follathb0697532016-08-18 12:38:46 +01001367#if defined(MBEDTLS_ECP_ADD_MIXED_ALT)
Manuel Pégourié-Gonnardebac5d32017-08-23 16:23:36 +02001368 if( mbedtls_internal_ecp_grp_capable( grp ) )
1369 return( mbedtls_internal_ecp_add_mixed( grp, R, P, Q ) );
Janos Follath372697b2016-10-28 16:53:11 +01001370#endif /* MBEDTLS_ECP_ADD_MIXED_ALT */
Janos Follathb0697532016-08-18 12:38:46 +01001371
Manuel Pégourié-Gonnardae180d02012-11-02 18:14:40 +01001372 /*
Manuel Pégourié-Gonnardaade42f2013-11-21 19:19:54 +01001373 * Trivial cases: P == 0 or Q == 0 (case 1)
Manuel Pégourié-Gonnardae180d02012-11-02 18:14:40 +01001374 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001375 if( mbedtls_mpi_cmp_int( &P->Z, 0 ) == 0 )
1376 return( mbedtls_ecp_copy( R, Q ) );
Manuel Pégourié-Gonnard469a2092013-11-21 18:20:43 +01001377
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001378 if( Q->Z.p != NULL && mbedtls_mpi_cmp_int( &Q->Z, 0 ) == 0 )
1379 return( mbedtls_ecp_copy( R, P ) );
Manuel Pégourié-Gonnard1c2782c2012-11-19 20:16:28 +01001380
1381 /*
1382 * Make sure Q coordinates are normalized
1383 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001384 if( Q->Z.p != NULL && mbedtls_mpi_cmp_int( &Q->Z, 1 ) != 0 )
1385 return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
Manuel Pégourié-Gonnardae180d02012-11-02 18:14:40 +01001386
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001387 mbedtls_mpi_init( &T1 ); mbedtls_mpi_init( &T2 ); mbedtls_mpi_init( &T3 ); mbedtls_mpi_init( &T4 );
1388 mbedtls_mpi_init( &X ); mbedtls_mpi_init( &Y ); mbedtls_mpi_init( &Z );
Manuel Pégourié-Gonnardab38b702012-11-05 17:34:55 +01001389
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001390 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &T1, &P->Z, &P->Z ) ); MOD_MUL( T1 );
1391 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &T2, &T1, &P->Z ) ); MOD_MUL( T2 );
1392 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &T1, &T1, &Q->X ) ); MOD_MUL( T1 );
1393 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &T2, &T2, &Q->Y ) ); MOD_MUL( T2 );
1394 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_mpi( &T1, &T1, &P->X ) ); MOD_SUB( T1 );
1395 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_mpi( &T2, &T2, &P->Y ) ); MOD_SUB( T2 );
Manuel Pégourié-Gonnardae180d02012-11-02 18:14:40 +01001396
Manuel Pégourié-Gonnardaade42f2013-11-21 19:19:54 +01001397 /* Special cases (2) and (3) */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001398 if( mbedtls_mpi_cmp_int( &T1, 0 ) == 0 )
Manuel Pégourié-Gonnard7e0adfb2012-11-08 23:21:46 +01001399 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001400 if( mbedtls_mpi_cmp_int( &T2, 0 ) == 0 )
Manuel Pégourié-Gonnard7e0adfb2012-11-08 23:21:46 +01001401 {
1402 ret = ecp_double_jac( grp, R, P );
1403 goto cleanup;
1404 }
1405 else
1406 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001407 ret = mbedtls_ecp_set_zero( R );
Manuel Pégourié-Gonnard7e0adfb2012-11-08 23:21:46 +01001408 goto cleanup;
1409 }
1410 }
1411
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001412 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &Z, &P->Z, &T1 ) ); MOD_MUL( Z );
1413 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &T3, &T1, &T1 ) ); MOD_MUL( T3 );
1414 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &T4, &T3, &T1 ) ); MOD_MUL( T4 );
1415 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &T3, &T3, &P->X ) ); MOD_MUL( T3 );
1416 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_int( &T1, &T3, 2 ) ); MOD_ADD( T1 );
1417 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &X, &T2, &T2 ) ); MOD_MUL( X );
1418 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_mpi( &X, &X, &T1 ) ); MOD_SUB( X );
1419 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_mpi( &X, &X, &T4 ) ); MOD_SUB( X );
1420 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_mpi( &T3, &T3, &X ) ); MOD_SUB( T3 );
1421 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &T3, &T3, &T2 ) ); MOD_MUL( T3 );
1422 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &T4, &T4, &P->Y ) ); MOD_MUL( T4 );
1423 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_mpi( &Y, &T3, &T4 ) ); MOD_SUB( Y );
Manuel Pégourié-Gonnard7e0adfb2012-11-08 23:21:46 +01001424
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001425 MBEDTLS_MPI_CHK( mbedtls_mpi_copy( &R->X, &X ) );
1426 MBEDTLS_MPI_CHK( mbedtls_mpi_copy( &R->Y, &Y ) );
1427 MBEDTLS_MPI_CHK( mbedtls_mpi_copy( &R->Z, &Z ) );
Manuel Pégourié-Gonnardae180d02012-11-02 18:14:40 +01001428
1429cleanup:
1430
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001431 mbedtls_mpi_free( &T1 ); mbedtls_mpi_free( &T2 ); mbedtls_mpi_free( &T3 ); mbedtls_mpi_free( &T4 );
1432 mbedtls_mpi_free( &X ); mbedtls_mpi_free( &Y ); mbedtls_mpi_free( &Z );
Manuel Pégourié-Gonnardae180d02012-11-02 18:14:40 +01001433
1434 return( ret );
1435}
1436
1437/*
Manuel Pégourié-Gonnard07de4b12013-09-02 16:26:04 +02001438 * Randomize jacobian coordinates:
1439 * (X, Y, Z) -> (l^2 X, l^3 Y, l Z) for random l
Manuel Pégourié-Gonnard3c0b4ea2013-12-02 19:44:41 +01001440 * This is sort of the reverse operation of ecp_normalize_jac().
Manuel Pégourié-Gonnard44aab792013-11-21 10:53:59 +01001441 *
1442 * This countermeasure was first suggested in [2].
Manuel Pégourié-Gonnard07de4b12013-09-02 16:26:04 +02001443 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001444static int ecp_randomize_jac( const mbedtls_ecp_group *grp, mbedtls_ecp_point *pt,
Manuel Pégourié-Gonnard07de4b12013-09-02 16:26:04 +02001445 int (*f_rng)(void *, unsigned char *, size_t), void *p_rng )
1446{
1447 int ret;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001448 mbedtls_mpi l, ll;
Janos Follathb0697532016-08-18 12:38:46 +01001449 size_t p_size;
Manuel Pégourié-Gonnard07de4b12013-09-02 16:26:04 +02001450 int count = 0;
1451
Janos Follathb0697532016-08-18 12:38:46 +01001452#if defined(MBEDTLS_ECP_RANDOMIZE_JAC_ALT)
Manuel Pégourié-Gonnardebac5d32017-08-23 16:23:36 +02001453 if( mbedtls_internal_ecp_grp_capable( grp ) )
1454 return( mbedtls_internal_ecp_randomize_jac( grp, pt, f_rng, p_rng ) );
Janos Follath372697b2016-10-28 16:53:11 +01001455#endif /* MBEDTLS_ECP_RANDOMIZE_JAC_ALT */
Janos Follathb0697532016-08-18 12:38:46 +01001456
1457 p_size = ( grp->pbits + 7 ) / 8;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001458 mbedtls_mpi_init( &l ); mbedtls_mpi_init( &ll );
Manuel Pégourié-Gonnard07de4b12013-09-02 16:26:04 +02001459
1460 /* Generate l such that 1 < l < p */
1461 do
1462 {
Ron Eldorca6ff582017-01-12 14:50:50 +02001463 MBEDTLS_MPI_CHK( mbedtls_mpi_fill_random( &l, p_size, f_rng, p_rng ) );
Manuel Pégourié-Gonnard07de4b12013-09-02 16:26:04 +02001464
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001465 while( mbedtls_mpi_cmp_mpi( &l, &grp->P ) >= 0 )
1466 MBEDTLS_MPI_CHK( mbedtls_mpi_shift_r( &l, 1 ) );
Manuel Pégourié-Gonnard07de4b12013-09-02 16:26:04 +02001467
1468 if( count++ > 10 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001469 return( MBEDTLS_ERR_ECP_RANDOM_FAILED );
Manuel Pégourié-Gonnard07de4b12013-09-02 16:26:04 +02001470 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001471 while( mbedtls_mpi_cmp_int( &l, 1 ) <= 0 );
Manuel Pégourié-Gonnard07de4b12013-09-02 16:26:04 +02001472
1473 /* Z = l * Z */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001474 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &pt->Z, &pt->Z, &l ) ); MOD_MUL( pt->Z );
Manuel Pégourié-Gonnard07de4b12013-09-02 16:26:04 +02001475
1476 /* X = l^2 * X */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001477 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &ll, &l, &l ) ); MOD_MUL( ll );
1478 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &pt->X, &pt->X, &ll ) ); MOD_MUL( pt->X );
Manuel Pégourié-Gonnard07de4b12013-09-02 16:26:04 +02001479
1480 /* Y = l^3 * Y */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001481 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &ll, &ll, &l ) ); MOD_MUL( ll );
1482 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &pt->Y, &pt->Y, &ll ) ); MOD_MUL( pt->Y );
Manuel Pégourié-Gonnard07de4b12013-09-02 16:26:04 +02001483
1484cleanup:
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001485 mbedtls_mpi_free( &l ); mbedtls_mpi_free( &ll );
Manuel Pégourié-Gonnard07de4b12013-09-02 16:26:04 +02001486
1487 return( ret );
1488}
1489
1490/*
Manuel Pégourié-Gonnardc30200e2013-11-20 18:39:55 +01001491 * Check and define parameters used by the comb method (see below for details)
1492 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001493#if MBEDTLS_ECP_WINDOW_SIZE < 2 || MBEDTLS_ECP_WINDOW_SIZE > 7
1494#error "MBEDTLS_ECP_WINDOW_SIZE out of bounds"
Manuel Pégourié-Gonnardc30200e2013-11-20 18:39:55 +01001495#endif
1496
1497/* d = ceil( n / w ) */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001498#define COMB_MAX_D ( MBEDTLS_ECP_MAX_BITS + 1 ) / 2
Manuel Pégourié-Gonnardc30200e2013-11-20 18:39:55 +01001499
1500/* number of precomputed points */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001501#define COMB_MAX_PRE ( 1 << ( MBEDTLS_ECP_WINDOW_SIZE - 1 ) )
Manuel Pégourié-Gonnardc30200e2013-11-20 18:39:55 +01001502
1503/*
1504 * Compute the representation of m that will be used with our comb method.
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001505 *
1506 * The basic comb method is described in GECC 3.44 for example. We use a
Manuel Pégourié-Gonnard101a39f2013-11-20 14:47:19 +01001507 * modified version that provides resistance to SPA by avoiding zero
1508 * digits in the representation as in [3]. We modify the method further by
1509 * requiring that all K_i be odd, which has the small cost that our
Manuel Pégourié-Gonnard7037e222017-08-23 14:30:36 +02001510 * representation uses one more K_i, due to carries, but saves on the size of
1511 * the precomputed table.
Manuel Pégourié-Gonnard101a39f2013-11-20 14:47:19 +01001512 *
Manuel Pégourié-Gonnard7037e222017-08-23 14:30:36 +02001513 * Summary of the comb method and its modifications:
1514 *
1515 * - The goal is to compute m*P for some w*d-bit integer m.
1516 *
1517 * - The basic comb method splits m into the w-bit integers
1518 * x[0] .. x[d-1] where x[i] consists of the bits in m whose
1519 * index has residue i modulo d, and computes m * P as
1520 * S[x[0]] + 2 * S[x[1]] + .. + 2^(d-1) S[x[d-1]], where
1521 * S[i_{w-1} .. i_0] := i_{w-1} 2^{(w-1)d} P + ... + i_1 2^d P + i_0 P.
1522 *
1523 * - If it happens that, say, x[i+1]=0 (=> S[x[i+1]]=0), one can replace the sum by
1524 * .. + 2^{i-1} S[x[i-1]] - 2^i S[x[i]] + 2^{i+1} S[x[i]] + 2^{i+2} S[x[i+2]] ..,
1525 * thereby successively converting it into a form where all summands
1526 * are nonzero, at the cost of negative summands. This is the basic idea of [3].
1527 *
1528 * - More generally, even if x[i+1] != 0, we can first transform the sum as
1529 * .. - 2^i S[x[i]] + 2^{i+1} ( S[x[i]] + S[x[i+1]] ) + 2^{i+2} S[x[i+2]] ..,
1530 * and then replace S[x[i]] + S[x[i+1]] = S[x[i] ^ x[i+1]] + 2 S[x[i] & x[i+1]].
1531 * Performing and iterating this procedure for those x[i] that are even
1532 * (keeping track of carry), we can transform the original sum into one of the form
1533 * S[x'[0]] +- 2 S[x'[1]] +- .. +- 2^{d-1} S[x'[d-1]] + 2^d S[x'[d]]
1534 * with all x'[i] odd. It is therefore only necessary to know S at odd indices,
1535 * which is why we are only computing half of it in the first place in
1536 * ecp_precompute_comb and accessing it with index abs(i) / 2 in ecp_select_comb.
1537 *
1538 * - For the sake of compactness, only the seven low-order bits of x[i]
1539 * are used to represent its absolute value (K_i in the paper), and the msb
Manuel Pégourié-Gonnardee68cff2018-10-15 15:27:49 +02001540 * of x[i] encodes the sign (s_i in the paper): it is set if and only if
Manuel Pégourié-Gonnard7037e222017-08-23 14:30:36 +02001541 * if s_i == -1;
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001542 *
1543 * Calling conventions:
Manuel Pégourié-Gonnard101a39f2013-11-20 14:47:19 +01001544 * - x is an array of size d + 1
Manuel Pégourié-Gonnardc30200e2013-11-20 18:39:55 +01001545 * - w is the size, ie number of teeth, of the comb, and must be between
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001546 * 2 and 7 (in practice, between 2 and MBEDTLS_ECP_WINDOW_SIZE)
Manuel Pégourié-Gonnard101a39f2013-11-20 14:47:19 +01001547 * - m is the MPI, expected to be odd and such that bitlength(m) <= w * d
1548 * (the result will be incorrect if these assumptions are not satisfied)
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001549 */
Manuel Pégourié-Gonnard62738e92017-03-14 10:00:21 +01001550static void ecp_comb_recode_core( unsigned char x[], size_t d,
1551 unsigned char w, const mbedtls_mpi *m )
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001552{
1553 size_t i, j;
Manuel Pégourié-Gonnard101a39f2013-11-20 14:47:19 +01001554 unsigned char c, cc, adjust;
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001555
Manuel Pégourié-Gonnard101a39f2013-11-20 14:47:19 +01001556 memset( x, 0, d+1 );
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001557
Manuel Pégourié-Gonnardedc1a1f2013-11-21 09:50:00 +01001558 /* First get the classical comb values (except for x_d = 0) */
1559 for( i = 0; i < d; i++ )
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001560 for( j = 0; j < w; j++ )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001561 x[i] |= mbedtls_mpi_get_bit( m, i + d * j ) << j;
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001562
Manuel Pégourié-Gonnardedc1a1f2013-11-21 09:50:00 +01001563 /* Now make sure x_1 .. x_d are odd */
1564 c = 0;
1565 for( i = 1; i <= d; i++ )
1566 {
Manuel Pégourié-Gonnard101a39f2013-11-20 14:47:19 +01001567 /* Add carry and update it */
1568 cc = x[i] & c;
1569 x[i] = x[i] ^ c;
1570 c = cc;
1571
Manuel Pégourié-Gonnardedc1a1f2013-11-21 09:50:00 +01001572 /* Adjust if needed, avoiding branches */
Manuel Pégourié-Gonnard101a39f2013-11-20 14:47:19 +01001573 adjust = 1 - ( x[i] & 0x01 );
1574 c |= x[i] & ( x[i-1] * adjust );
1575 x[i] = x[i] ^ ( x[i-1] * adjust );
1576 x[i-1] |= adjust << 7;
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001577 }
1578}
1579
1580/*
Manuel Pégourié-Gonnard7037e222017-08-23 14:30:36 +02001581 * Precompute points for the adapted comb method
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001582 *
Manuel Pégourié-Gonnard7037e222017-08-23 14:30:36 +02001583 * Assumption: T must be able to hold 2^{w - 1} elements.
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001584 *
Manuel Pégourié-Gonnard7037e222017-08-23 14:30:36 +02001585 * Operation: If i = i_{w-1} ... i_1 is the binary representation of i,
1586 * sets T[i] = i_{w-1} 2^{(w-1)d} P + ... + i_1 2^d P + P.
Manuel Pégourié-Gonnard04a02252013-11-20 22:57:38 +01001587 *
1588 * Cost: d(w-1) D + (2^{w-1} - 1) A + 1 N(w-1) + 1 N(2^{w-1} - 1)
Manuel Pégourié-Gonnard7037e222017-08-23 14:30:36 +02001589 *
1590 * Note: Even comb values (those where P would be omitted from the
1591 * sum defining T[i] above) are not needed in our adaption
Manuel Pégourié-Gonnardee68cff2018-10-15 15:27:49 +02001592 * the comb method. See ecp_comb_recode_core().
Manuel Pégourié-Gonnard7037e222017-08-23 14:30:36 +02001593 *
1594 * This function currently works in four steps:
Manuel Pégourié-Gonnardee68cff2018-10-15 15:27:49 +02001595 * (1) [dbl] Computation of intermediate T[i] for 2-power values of i
Manuel Pégourié-Gonnard4ed1dab2017-08-24 11:02:04 +02001596 * (2) [norm_dbl] Normalization of coordinates of these T[i]
1597 * (3) [add] Computation of all T[i]
1598 * (4) [norm_add] Normalization of all T[i]
Manuel Pégourié-Gonnard7037e222017-08-23 14:30:36 +02001599 *
1600 * Step 1 can be interrupted but not the others; together with the final
1601 * coordinate normalization they are the largest steps done at once, depending
1602 * on the window size. Here are operation counts for P-256:
1603 *
1604 * step (2) (3) (4)
1605 * w = 5 142 165 208
1606 * w = 4 136 77 160
1607 * w = 3 130 33 136
1608 * w = 2 124 11 124
1609 *
1610 * So if ECC operations are blocking for too long even with a low max_ops
1611 * value, it's useful to set MBEDTLS_ECP_WINDOW_SIZE to a lower value in order
1612 * to minimize maximum blocking time.
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001613 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001614static int ecp_precompute_comb( const mbedtls_ecp_group *grp,
1615 mbedtls_ecp_point T[], const mbedtls_ecp_point *P,
Manuel Pégourié-Gonnard3cade222017-04-20 09:31:00 +02001616 unsigned char w, size_t d,
1617 mbedtls_ecp_restart_ctx *rs_ctx )
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001618{
1619 int ret;
Manuel Pégourié-Gonnardfc3e0be2017-03-20 09:29:31 +01001620 unsigned char i;
Manuel Pégourié-Gonnard213541a2017-03-20 12:50:41 +01001621 size_t j = 0;
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02001622 const unsigned char T_size = 1U << ( w - 1 );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001623 mbedtls_ecp_point *cur, *TT[COMB_MAX_PRE - 1];
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001624
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02001625#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard3cade222017-04-20 09:31:00 +02001626 if( rs_ctx != NULL && rs_ctx->rsm != NULL )
Manuel Pégourié-Gonnard085b1df2017-03-16 16:56:04 +01001627 {
Manuel Pégourié-Gonnard4ed1dab2017-08-24 11:02:04 +02001628 if( rs_ctx->rsm->state == ecp_rsm_pre_dbl )
1629 goto dbl;
Manuel Pégourié-Gonnard3cade222017-04-20 09:31:00 +02001630 if( rs_ctx->rsm->state == ecp_rsm_pre_norm_dbl )
Manuel Pégourié-Gonnarde2d7cb32017-03-20 10:24:17 +01001631 goto norm_dbl;
Manuel Pégourié-Gonnard4ed1dab2017-08-24 11:02:04 +02001632 if( rs_ctx->rsm->state == ecp_rsm_pre_add )
1633 goto add;
1634 if( rs_ctx->rsm->state == ecp_rsm_pre_norm_add )
1635 goto norm_add;
Manuel Pégourié-Gonnard085b1df2017-03-16 16:56:04 +01001636 }
Manuel Pégourié-Gonnardee68cff2018-10-15 15:27:49 +02001637#else
1638 (void) rs_ctx;
Manuel Pégourié-Gonnard085b1df2017-03-16 16:56:04 +01001639#endif
1640
Manuel Pégourié-Gonnard4ed1dab2017-08-24 11:02:04 +02001641#if defined(MBEDTLS_ECP_RESTARTABLE)
1642 if( rs_ctx != NULL && rs_ctx->rsm != NULL )
1643 {
1644 rs_ctx->rsm->state = ecp_rsm_pre_dbl;
1645
1646 /* initial state for the loop */
1647 rs_ctx->rsm->i = 0;
1648 }
1649
1650dbl:
1651#endif
Manuel Pégourié-Gonnardee68cff2018-10-15 15:27:49 +02001652 /*
1653 * Set T[0] = P and
1654 * T[2^{l-1}] = 2^{dl} P for l = 1 .. w-1 (this is not the final value)
1655 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001656 MBEDTLS_MPI_CHK( mbedtls_ecp_copy( &T[0], P ) );
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001657
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02001658#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard3cade222017-04-20 09:31:00 +02001659 if( rs_ctx != NULL && rs_ctx->rsm != NULL && rs_ctx->rsm->i != 0 )
1660 j = rs_ctx->rsm->i;
Manuel Pégourié-Gonnard213541a2017-03-20 12:50:41 +01001661 else
1662#endif
1663 j = 0;
1664
1665 for( ; j < d * ( w - 1 ); j++ )
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001666 {
Manuel Pégourié-Gonnardc7511482017-04-20 16:31:00 +02001667 MBEDTLS_ECP_BUDGET( MBEDTLS_ECP_OPS_DBL );
Manuel Pégourié-Gonnard213541a2017-03-20 12:50:41 +01001668
Manuel Pégourié-Gonnardae557072017-03-20 12:21:24 +01001669 i = 1U << ( j / d );
Manuel Pégourié-Gonnard101a39f2013-11-20 14:47:19 +01001670 cur = T + i;
Manuel Pégourié-Gonnardae557072017-03-20 12:21:24 +01001671
1672 if( j % d == 0 )
1673 MBEDTLS_MPI_CHK( mbedtls_ecp_copy( cur, T + ( i >> 1 ) ) );
1674
1675 MBEDTLS_MPI_CHK( ecp_double_jac( grp, cur, cur ) );
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001676 }
1677
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02001678#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard4ed1dab2017-08-24 11:02:04 +02001679 if( rs_ctx != NULL && rs_ctx->rsm != NULL )
1680 rs_ctx->rsm->state = ecp_rsm_pre_norm_dbl;
1681
Manuel Pégourié-Gonnarde2d7cb32017-03-20 10:24:17 +01001682norm_dbl:
1683#endif
Manuel Pégourié-Gonnardee68cff2018-10-15 15:27:49 +02001684 /*
1685 * Normalize current elements in T. As T has holes,
1686 * use an auxiliary array of pointers to elements in T.
1687 */
Manuel Pégourié-Gonnardfc3e0be2017-03-20 09:29:31 +01001688 j = 0;
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02001689 for( i = 1; i < T_size; i <<= 1 )
Manuel Pégourié-Gonnardfc3e0be2017-03-20 09:29:31 +01001690 TT[j++] = T + i;
1691
Manuel Pégourié-Gonnardc7511482017-04-20 16:31:00 +02001692 MBEDTLS_ECP_BUDGET( MBEDTLS_ECP_OPS_INV + 6 * j - 2 );
Manuel Pégourié-Gonnarde2d7cb32017-03-20 10:24:17 +01001693
Manuel Pégourié-Gonnardfc3e0be2017-03-20 09:29:31 +01001694 MBEDTLS_MPI_CHK( ecp_normalize_jac_many( grp, TT, j ) );
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001695
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02001696#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard4ed1dab2017-08-24 11:02:04 +02001697 if( rs_ctx != NULL && rs_ctx->rsm != NULL )
1698 rs_ctx->rsm->state = ecp_rsm_pre_add;
1699
Manuel Pégourié-Gonnarde2d7cb32017-03-20 10:24:17 +01001700add:
1701#endif
Manuel Pégourié-Gonnardee68cff2018-10-15 15:27:49 +02001702 /*
1703 * Compute the remaining ones using the minimal number of additions
1704 * Be careful to update T[2^l] only after using it!
1705 */
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02001706 MBEDTLS_ECP_BUDGET( ( T_size - 1 ) * MBEDTLS_ECP_OPS_ADD );
Manuel Pégourié-Gonnarde2d7cb32017-03-20 10:24:17 +01001707
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02001708 for( i = 1; i < T_size; i <<= 1 )
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001709 {
Manuel Pégourié-Gonnard101a39f2013-11-20 14:47:19 +01001710 j = i;
1711 while( j-- )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001712 MBEDTLS_MPI_CHK( ecp_add_mixed( grp, &T[i + j], &T[j], &T[i] ) );
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001713 }
1714
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02001715#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard4ed1dab2017-08-24 11:02:04 +02001716 if( rs_ctx != NULL && rs_ctx->rsm != NULL )
1717 rs_ctx->rsm->state = ecp_rsm_pre_norm_add;
1718
Manuel Pégourié-Gonnarde2d7cb32017-03-20 10:24:17 +01001719norm_add:
1720#endif
Manuel Pégourié-Gonnardee68cff2018-10-15 15:27:49 +02001721 /*
Manuel Pégourié-Gonnarda966fde2018-10-23 10:41:11 +02001722 * Normalize final elements in T. Even though there are no holes now, we
1723 * still need the auxiliary array for homogeneity with the previous
1724 * call. Also, skip T[0] which is already normalised, being a copy of P.
Manuel Pégourié-Gonnardee68cff2018-10-15 15:27:49 +02001725 */
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02001726 for( j = 0; j + 1 < T_size; j++ )
Manuel Pégourié-Gonnardfc3e0be2017-03-20 09:29:31 +01001727 TT[j] = T + j + 1;
1728
Manuel Pégourié-Gonnardc7511482017-04-20 16:31:00 +02001729 MBEDTLS_ECP_BUDGET( MBEDTLS_ECP_OPS_INV + 6 * j - 2 );
Manuel Pégourié-Gonnarde2d7cb32017-03-20 10:24:17 +01001730
Manuel Pégourié-Gonnardfc3e0be2017-03-20 09:29:31 +01001731 MBEDTLS_MPI_CHK( ecp_normalize_jac_many( grp, TT, j ) );
Manuel Pégourié-Gonnarde2820122013-11-21 10:08:50 +01001732
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001733cleanup:
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02001734#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard3cade222017-04-20 09:31:00 +02001735 if( rs_ctx != NULL && rs_ctx->rsm != NULL &&
1736 ret == MBEDTLS_ERR_ECP_IN_PROGRESS )
Manuel Pégourié-Gonnard213541a2017-03-20 12:50:41 +01001737 {
Manuel Pégourié-Gonnard4ed1dab2017-08-24 11:02:04 +02001738 if( rs_ctx->rsm->state == ecp_rsm_pre_dbl )
Manuel Pégourié-Gonnard3cade222017-04-20 09:31:00 +02001739 rs_ctx->rsm->i = j;
Manuel Pégourié-Gonnard213541a2017-03-20 12:50:41 +01001740 }
1741#endif
Janos Follathb0697532016-08-18 12:38:46 +01001742
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001743 return( ret );
1744}
1745
1746/*
Manuel Pégourié-Gonnard101a39f2013-11-20 14:47:19 +01001747 * Select precomputed point: R = sign(i) * T[ abs(i) / 2 ]
Manuel Pégourié-Gonnard7037e222017-08-23 14:30:36 +02001748 *
1749 * See ecp_comb_recode_core() for background
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001750 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001751static int ecp_select_comb( const mbedtls_ecp_group *grp, mbedtls_ecp_point *R,
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02001752 const mbedtls_ecp_point T[], unsigned char T_size,
Manuel Pégourié-Gonnardd7283502013-11-21 20:00:38 +01001753 unsigned char i )
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001754{
1755 int ret;
Manuel Pégourié-Gonnardd7283502013-11-21 20:00:38 +01001756 unsigned char ii, j;
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001757
Manuel Pégourié-Gonnardd7283502013-11-21 20:00:38 +01001758 /* Ignore the "sign" bit and scale down */
1759 ii = ( i & 0x7Fu ) >> 1;
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001760
Manuel Pégourié-Gonnardd7283502013-11-21 20:00:38 +01001761 /* Read the whole table to thwart cache-based timing attacks */
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02001762 for( j = 0; j < T_size; j++ )
Manuel Pégourié-Gonnardd7283502013-11-21 20:00:38 +01001763 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001764 MBEDTLS_MPI_CHK( mbedtls_mpi_safe_cond_assign( &R->X, &T[j].X, j == ii ) );
1765 MBEDTLS_MPI_CHK( mbedtls_mpi_safe_cond_assign( &R->Y, &T[j].Y, j == ii ) );
Manuel Pégourié-Gonnardd7283502013-11-21 20:00:38 +01001766 }
1767
Manuel Pégourié-Gonnard01fca5e2013-11-21 17:47:12 +01001768 /* Safely invert result if i is "negative" */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001769 MBEDTLS_MPI_CHK( ecp_safe_invert_jac( grp, R, i >> 7 ) );
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001770
1771cleanup:
1772 return( ret );
1773}
1774
1775/*
1776 * Core multiplication algorithm for the (modified) comb method.
1777 * This part is actually common with the basic comb method (GECC 3.44)
Manuel Pégourié-Gonnard04a02252013-11-20 22:57:38 +01001778 *
1779 * Cost: d A + d D + 1 R
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001780 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001781static int ecp_mul_comb_core( const mbedtls_ecp_group *grp, mbedtls_ecp_point *R,
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02001782 const mbedtls_ecp_point T[], unsigned char T_size,
Manuel Pégourié-Gonnard70c14372013-11-20 20:07:26 +01001783 const unsigned char x[], size_t d,
1784 int (*f_rng)(void *, unsigned char *, size_t),
Manuel Pégourié-Gonnard3cade222017-04-20 09:31:00 +02001785 void *p_rng,
1786 mbedtls_ecp_restart_ctx *rs_ctx )
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001787{
1788 int ret;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001789 mbedtls_ecp_point Txi;
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001790 size_t i;
1791
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001792 mbedtls_ecp_point_init( &Txi );
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001793
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02001794#if !defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard3cade222017-04-20 09:31:00 +02001795 (void) rs_ctx;
1796#endif
1797
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02001798#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard4ed1dab2017-08-24 11:02:04 +02001799 if( rs_ctx != NULL && rs_ctx->rsm != NULL &&
1800 rs_ctx->rsm->state != ecp_rsm_comb_core )
1801 {
1802 rs_ctx->rsm->i = 0;
1803 rs_ctx->rsm->state = ecp_rsm_comb_core;
1804 }
1805
1806 /* new 'if' instead of nested for the sake of the 'else' branch */
Manuel Pégourié-Gonnard3cade222017-04-20 09:31:00 +02001807 if( rs_ctx != NULL && rs_ctx->rsm != NULL && rs_ctx->rsm->i != 0 )
Manuel Pégourié-Gonnardc5d844b2017-03-15 13:06:28 +01001808 {
Manuel Pégourié-Gonnard3cade222017-04-20 09:31:00 +02001809 /* restore current index (R already pointing to rs_ctx->rsm->R) */
1810 i = rs_ctx->rsm->i;
Manuel Pégourié-Gonnardc5d844b2017-03-15 13:06:28 +01001811 }
1812 else
1813#endif
1814 {
1815 /* Start with a non-zero point and randomize its coordinates */
1816 i = d;
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02001817 MBEDTLS_MPI_CHK( ecp_select_comb( grp, R, T, T_size, x[i] ) );
Manuel Pégourié-Gonnardc5d844b2017-03-15 13:06:28 +01001818 MBEDTLS_MPI_CHK( mbedtls_mpi_lset( &R->Z, 1 ) );
1819 if( f_rng != 0 )
1820 MBEDTLS_MPI_CHK( ecp_randomize_jac( grp, R, f_rng, p_rng ) );
1821 }
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001822
Manuel Pégourié-Gonnard90f31b72018-10-16 10:45:24 +02001823 while( i != 0 )
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001824 {
Manuel Pégourié-Gonnardc7511482017-04-20 16:31:00 +02001825 MBEDTLS_ECP_BUDGET( MBEDTLS_ECP_OPS_DBL + MBEDTLS_ECP_OPS_ADD );
Manuel Pégourié-Gonnard90f31b72018-10-16 10:45:24 +02001826 --i;
1827
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001828 MBEDTLS_MPI_CHK( ecp_double_jac( grp, R, R ) );
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02001829 MBEDTLS_MPI_CHK( ecp_select_comb( grp, &Txi, T, T_size, x[i] ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001830 MBEDTLS_MPI_CHK( ecp_add_mixed( grp, R, R, &Txi ) );
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001831 }
1832
1833cleanup:
Janos Follathb0697532016-08-18 12:38:46 +01001834
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001835 mbedtls_ecp_point_free( &Txi );
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001836
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02001837#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard4ed1dab2017-08-24 11:02:04 +02001838 if( rs_ctx != NULL && rs_ctx->rsm != NULL &&
1839 ret == MBEDTLS_ERR_ECP_IN_PROGRESS )
Manuel Pégourié-Gonnardc5d844b2017-03-15 13:06:28 +01001840 {
Manuel Pégourié-Gonnard90f31b72018-10-16 10:45:24 +02001841 rs_ctx->rsm->i = i;
Manuel Pégourié-Gonnard4ed1dab2017-08-24 11:02:04 +02001842 /* no need to save R, already pointing to rs_ctx->rsm->R */
Manuel Pégourié-Gonnardc5d844b2017-03-15 13:06:28 +01001843 }
1844#endif
1845
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01001846 return( ret );
1847}
1848
1849/*
Manuel Pégourié-Gonnard62738e92017-03-14 10:00:21 +01001850 * Recode the scalar to get constant-time comb multiplication
1851 *
1852 * As the actual scalar recoding needs an odd scalar as a starting point,
1853 * this wrapper ensures that by replacing m by N - m if necessary, and
1854 * informs the caller that the result of multiplication will be negated.
Manuel Pégourié-Gonnard7037e222017-08-23 14:30:36 +02001855 *
Manuel Pégourié-Gonnardfd87e352017-08-24 14:21:05 +02001856 * This works because we only support large prime order for Short Weierstrass
1857 * curves, so N is always odd hence either m or N - m is.
1858 *
Manuel Pégourié-Gonnard7037e222017-08-23 14:30:36 +02001859 * See ecp_comb_recode_core() for background.
Manuel Pégourié-Gonnardec5606a2017-03-09 12:46:45 +01001860 */
Manuel Pégourié-Gonnard62738e92017-03-14 10:00:21 +01001861static int ecp_comb_recode_scalar( const mbedtls_ecp_group *grp,
1862 const mbedtls_mpi *m,
1863 unsigned char k[COMB_MAX_D + 1],
1864 size_t d,
1865 unsigned char w,
1866 unsigned char *parity_trick )
Manuel Pégourié-Gonnardec5606a2017-03-09 12:46:45 +01001867{
1868 int ret;
Manuel Pégourié-Gonnard62738e92017-03-14 10:00:21 +01001869 mbedtls_mpi M, mm;
Manuel Pégourié-Gonnardec5606a2017-03-09 12:46:45 +01001870
Manuel Pégourié-Gonnard62738e92017-03-14 10:00:21 +01001871 mbedtls_mpi_init( &M );
Manuel Pégourié-Gonnardec5606a2017-03-09 12:46:45 +01001872 mbedtls_mpi_init( &mm );
1873
Manuel Pégourié-Gonnardfd87e352017-08-24 14:21:05 +02001874 /* N is always odd (see above), just make extra sure */
Manuel Pégourié-Gonnardec5606a2017-03-09 12:46:45 +01001875 if( mbedtls_mpi_get_bit( &grp->N, 0 ) != 1 )
1876 return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
1877
Manuel Pégourié-Gonnard62738e92017-03-14 10:00:21 +01001878 /* do we need the parity trick? */
1879 *parity_trick = ( mbedtls_mpi_get_bit( m, 0 ) == 0 );
1880
1881 /* execute parity fix in constant time */
1882 MBEDTLS_MPI_CHK( mbedtls_mpi_copy( &M, m ) );
Manuel Pégourié-Gonnardec5606a2017-03-09 12:46:45 +01001883 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_mpi( &mm, &grp->N, m ) );
Manuel Pégourié-Gonnard62738e92017-03-14 10:00:21 +01001884 MBEDTLS_MPI_CHK( mbedtls_mpi_safe_cond_assign( &M, &mm, *parity_trick ) );
1885
1886 /* actual scalar recoding */
1887 ecp_comb_recode_core( k, d, w, &M );
Manuel Pégourié-Gonnardec5606a2017-03-09 12:46:45 +01001888
1889cleanup:
1890 mbedtls_mpi_free( &mm );
Manuel Pégourié-Gonnard62738e92017-03-14 10:00:21 +01001891 mbedtls_mpi_free( &M );
Manuel Pégourié-Gonnardec5606a2017-03-09 12:46:45 +01001892
1893 return( ret );
1894}
1895
1896/*
Manuel Pégourié-Gonnard391f4412017-03-13 12:26:21 +01001897 * Perform comb multiplication (for short Weierstrass curves)
1898 * once the auxiliary table has been pre-computed.
Manuel Pégourié-Gonnard62738e92017-03-14 10:00:21 +01001899 *
1900 * Scalar recoding may use a parity trick that makes us compute -m * P,
1901 * if that is the case we'll need to recover m * P at the end.
Manuel Pégourié-Gonnard391f4412017-03-13 12:26:21 +01001902 */
1903static int ecp_mul_comb_after_precomp( const mbedtls_ecp_group *grp,
1904 mbedtls_ecp_point *R,
1905 const mbedtls_mpi *m,
1906 const mbedtls_ecp_point *T,
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02001907 unsigned char T_size,
Manuel Pégourié-Gonnard391f4412017-03-13 12:26:21 +01001908 unsigned char w,
1909 size_t d,
1910 int (*f_rng)(void *, unsigned char *, size_t),
Manuel Pégourié-Gonnard3cade222017-04-20 09:31:00 +02001911 void *p_rng,
1912 mbedtls_ecp_restart_ctx *rs_ctx )
Manuel Pégourié-Gonnard391f4412017-03-13 12:26:21 +01001913{
1914 int ret;
Manuel Pégourié-Gonnard62738e92017-03-14 10:00:21 +01001915 unsigned char parity_trick;
Manuel Pégourié-Gonnard391f4412017-03-13 12:26:21 +01001916 unsigned char k[COMB_MAX_D + 1];
Manuel Pégourié-Gonnard8962ddb2017-03-14 12:11:21 +01001917 mbedtls_ecp_point *RR = R;
1918
Manuel Pégourié-Gonnard4ed1dab2017-08-24 11:02:04 +02001919#if defined(MBEDTLS_ECP_RESTARTABLE)
1920 if( rs_ctx != NULL && rs_ctx->rsm != NULL )
1921 {
1922 RR = &rs_ctx->rsm->R;
1923
1924 if( rs_ctx->rsm->state == ecp_rsm_final_norm )
1925 goto final_norm;
1926 }
Manuel Pégourié-Gonnard8962ddb2017-03-14 12:11:21 +01001927#endif
Manuel Pégourié-Gonnard391f4412017-03-13 12:26:21 +01001928
Manuel Pégourié-Gonnard4ed1dab2017-08-24 11:02:04 +02001929 MBEDTLS_MPI_CHK( ecp_comb_recode_scalar( grp, m, k, d, w,
1930 &parity_trick ) );
1931 MBEDTLS_MPI_CHK( ecp_mul_comb_core( grp, RR, T, T_size, k, d,
1932 f_rng, p_rng, rs_ctx ) );
1933 MBEDTLS_MPI_CHK( ecp_safe_invert_jac( grp, RR, parity_trick ) );
1934
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02001935#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard3cade222017-04-20 09:31:00 +02001936 if( rs_ctx != NULL && rs_ctx->rsm != NULL )
Manuel Pégourié-Gonnard4ed1dab2017-08-24 11:02:04 +02001937 rs_ctx->rsm->state = ecp_rsm_final_norm;
Manuel Pégourié-Gonnard3cade222017-04-20 09:31:00 +02001938
Manuel Pégourié-Gonnard4ed1dab2017-08-24 11:02:04 +02001939final_norm:
Manuel Pégourié-Gonnard2fad7ae2017-03-14 13:13:13 +01001940#endif
Manuel Pégourié-Gonnardf6004162020-03-25 12:41:29 +01001941 /*
1942 * Knowledge of the jacobian coordinates may leak the last few bits of the
1943 * scalar [1], and since our MPI implementation isn't constant-flow,
1944 * inversion (used for coordinate normalization) may leak the full value
1945 * of its input via side-channels [2].
1946 *
1947 * [1] https://eprint.iacr.org/2003/191
1948 * [2] https://eprint.iacr.org/2020/055
1949 *
1950 * Avoid the leak by randomizing coordinates before we normalize them.
1951 */
1952 if( f_rng != 0 )
1953 MBEDTLS_MPI_CHK( ecp_randomize_jac( grp, RR, f_rng, p_rng ) );
1954
Manuel Pégourié-Gonnardc7511482017-04-20 16:31:00 +02001955 MBEDTLS_ECP_BUDGET( MBEDTLS_ECP_OPS_INV );
Manuel Pégourié-Gonnard8962ddb2017-03-14 12:11:21 +01001956 MBEDTLS_MPI_CHK( ecp_normalize_jac( grp, RR ) );
1957
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02001958#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard28d16282017-08-23 17:33:27 +02001959 if( rs_ctx != NULL && rs_ctx->rsm != NULL )
1960 MBEDTLS_MPI_CHK( mbedtls_ecp_copy( R, RR ) );
Manuel Pégourié-Gonnard8962ddb2017-03-14 12:11:21 +01001961#endif
Manuel Pégourié-Gonnard391f4412017-03-13 12:26:21 +01001962
1963cleanup:
Manuel Pégourié-Gonnard391f4412017-03-13 12:26:21 +01001964 return( ret );
1965}
1966
Manuel Pégourié-Gonnard391f4412017-03-13 12:26:21 +01001967/*
Manuel Pégourié-Gonnard4b2336d2017-03-09 13:23:50 +01001968 * Pick window size based on curve size and whether we optimize for base point
1969 */
1970static unsigned char ecp_pick_window_size( const mbedtls_ecp_group *grp,
1971 unsigned char p_eq_g )
1972{
1973 unsigned char w;
1974
1975 /*
1976 * Minimize the number of multiplications, that is minimize
1977 * 10 * d * w + 18 * 2^(w-1) + 11 * d + 7 * w, with d = ceil( nbits / w )
1978 * (see costs of the various parts, with 1S = 1M)
1979 */
1980 w = grp->nbits >= 384 ? 5 : 4;
1981
1982 /*
1983 * If P == G, pre-compute a bit more, since this may be re-used later.
1984 * Just adding one avoids upping the cost of the first mul too much,
1985 * and the memory cost too.
1986 */
1987 if( p_eq_g )
1988 w++;
1989
1990 /*
1991 * Make sure w is within bounds.
1992 * (The last test is useful only for very small curves in the test suite.)
1993 */
1994 if( w > MBEDTLS_ECP_WINDOW_SIZE )
1995 w = MBEDTLS_ECP_WINDOW_SIZE;
1996 if( w >= grp->nbits )
1997 w = 2;
1998
1999 return( w );
2000}
2001
2002/*
Manuel Pégourié-Gonnard07bf6f52017-03-16 17:21:38 +01002003 * Multiplication using the comb method - for curves in short Weierstrass form
2004 *
2005 * This function is mainly responsible for administrative work:
2006 * - managing the restart context if enabled
Manuel Pégourié-Gonnard11556e22017-08-24 13:41:19 +02002007 * - managing the table of precomputed points (passed between the below two
Manuel Pégourié-Gonnard07bf6f52017-03-16 17:21:38 +01002008 * functions): allocation, computation, ownership tranfer, freeing.
2009 *
2010 * It delegates the actual arithmetic work to:
2011 * ecp_precompute_comb() and ecp_mul_comb_with_precomp()
2012 *
2013 * See comments on ecp_comb_recode_core() regarding the computation strategy.
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01002014 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002015static int ecp_mul_comb( mbedtls_ecp_group *grp, mbedtls_ecp_point *R,
2016 const mbedtls_mpi *m, const mbedtls_ecp_point *P,
Manuel Pégourié-Gonnarda0179b82013-12-04 11:49:20 +01002017 int (*f_rng)(void *, unsigned char *, size_t),
Manuel Pégourié-Gonnard3cade222017-04-20 09:31:00 +02002018 void *p_rng,
2019 mbedtls_ecp_restart_ctx *rs_ctx )
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01002020{
2021 int ret;
Manuel Pégourié-Gonnard11556e22017-08-24 13:41:19 +02002022 unsigned char w, p_eq_g, i;
Manuel Pégourié-Gonnardd7283502013-11-21 20:00:38 +01002023 size_t d;
Manuel Pégourié-Gonnard11556e22017-08-24 13:41:19 +02002024 unsigned char T_size, T_ok;
2025 mbedtls_ecp_point *T;
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01002026
Manuel Pégourié-Gonnarddb4a8eb2017-08-23 18:18:22 +02002027 ECP_RS_ENTER( rsm );
Manuel Pégourié-Gonnard510d5ca2017-03-08 11:41:47 +01002028
Manuel Pégourié-Gonnard22be6352017-03-09 13:02:35 +01002029 /* Is P the base point ? */
2030#if MBEDTLS_ECP_FIXED_POINT_OPTIM == 1
2031 p_eq_g = ( mbedtls_mpi_cmp_mpi( &P->Y, &grp->G.Y ) == 0 &&
2032 mbedtls_mpi_cmp_mpi( &P->X, &grp->G.X ) == 0 );
Manuel Pégourié-Gonnard196d1332017-08-28 13:14:27 +02002033#else
2034 p_eq_g = 0;
Manuel Pégourié-Gonnard22be6352017-03-09 13:02:35 +01002035#endif
2036
Manuel Pégourié-Gonnard391f4412017-03-13 12:26:21 +01002037 /* Pick window size and deduce related sizes */
Manuel Pégourié-Gonnard4b2336d2017-03-09 13:23:50 +01002038 w = ecp_pick_window_size( grp, p_eq_g );
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02002039 T_size = 1U << ( w - 1 );
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01002040 d = ( grp->nbits + w - 1 ) / w;
2041
Manuel Pégourié-Gonnard085b1df2017-03-16 16:56:04 +01002042 /* Pre-computed table: do we have it already for the base point? */
2043 if( p_eq_g && grp->T != NULL )
2044 {
Manuel Pégourié-Gonnard7037e222017-08-23 14:30:36 +02002045 /* second pointer to the same table, will be deleted on exit */
Manuel Pégourié-Gonnard085b1df2017-03-16 16:56:04 +01002046 T = grp->T;
2047 T_ok = 1;
2048 }
Manuel Pégourié-Gonnard11556e22017-08-24 13:41:19 +02002049 else
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02002050#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard085b1df2017-03-16 16:56:04 +01002051 /* Pre-computed table: do we have one in progress? complete? */
Manuel Pégourié-Gonnard11556e22017-08-24 13:41:19 +02002052 if( rs_ctx != NULL && rs_ctx->rsm != NULL && rs_ctx->rsm->T != NULL )
Manuel Pégourié-Gonnardc9c0aa62017-03-16 14:53:26 +01002053 {
Manuel Pégourié-Gonnard45fd0162017-03-22 08:24:42 +01002054 /* transfer ownership of T from rsm to local function */
Manuel Pégourié-Gonnard3cade222017-04-20 09:31:00 +02002055 T = rs_ctx->rsm->T;
2056 rs_ctx->rsm->T = NULL;
2057 rs_ctx->rsm->T_size = 0;
Manuel Pégourié-Gonnard085b1df2017-03-16 16:56:04 +01002058
Manuel Pégourié-Gonnardb25cb602018-10-16 11:48:09 +02002059 /* This effectively jumps to the call to mul_comb_after_precomp() */
Manuel Pégourié-Gonnard11556e22017-08-24 13:41:19 +02002060 T_ok = rs_ctx->rsm->state >= ecp_rsm_comb_core;
Manuel Pégourié-Gonnardc9c0aa62017-03-16 14:53:26 +01002061 }
Manuel Pégourié-Gonnard11556e22017-08-24 13:41:19 +02002062 else
Manuel Pégourié-Gonnardc9c0aa62017-03-16 14:53:26 +01002063#endif
Manuel Pégourié-Gonnard085b1df2017-03-16 16:56:04 +01002064 /* Allocate table if we didn't have any */
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01002065 {
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02002066 T = mbedtls_calloc( T_size, sizeof( mbedtls_ecp_point ) );
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01002067 if( T == NULL )
2068 {
Manuel Pégourié-Gonnard6a8ca332015-05-28 09:33:39 +02002069 ret = MBEDTLS_ERR_ECP_ALLOC_FAILED;
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01002070 goto cleanup;
2071 }
Manuel Pégourié-Gonnard5bd38b12017-08-23 16:55:59 +02002072
2073 for( i = 0; i < T_size; i++ )
2074 mbedtls_ecp_point_init( &T[i] );
Manuel Pégourié-Gonnard11556e22017-08-24 13:41:19 +02002075
2076 T_ok = 0;
Manuel Pégourié-Gonnard085b1df2017-03-16 16:56:04 +01002077 }
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01002078
Manuel Pégourié-Gonnard085b1df2017-03-16 16:56:04 +01002079 /* Compute table (or finish computing it) if not done already */
2080 if( !T_ok )
2081 {
Manuel Pégourié-Gonnard3cade222017-04-20 09:31:00 +02002082 MBEDTLS_MPI_CHK( ecp_precompute_comb( grp, T, P, w, d, rs_ctx ) );
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01002083
2084 if( p_eq_g )
2085 {
Manuel Pégourié-Gonnard7037e222017-08-23 14:30:36 +02002086 /* almost transfer ownership of T to the group, but keep a copy of
Manuel Pégourié-Gonnardee68cff2018-10-15 15:27:49 +02002087 * the pointer to use for calling the next function more easily */
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01002088 grp->T = T;
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02002089 grp->T_size = T_size;
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01002090 }
2091 }
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01002092
Manuel Pégourié-Gonnard391f4412017-03-13 12:26:21 +01002093 /* Actual comb multiplication using precomputed points */
2094 MBEDTLS_MPI_CHK( ecp_mul_comb_after_precomp( grp, R, m,
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02002095 T, T_size, w, d,
Manuel Pégourié-Gonnard3cade222017-04-20 09:31:00 +02002096 f_rng, p_rng, rs_ctx ) );
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01002097
2098cleanup:
2099
Manuel Pégourié-Gonnard07bf6f52017-03-16 17:21:38 +01002100 /* does T belong to the group? */
2101 if( T == grp->T )
2102 T = NULL;
2103
2104 /* does T belong to the restart context? */
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02002105#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard3cade222017-04-20 09:31:00 +02002106 if( rs_ctx != NULL && rs_ctx->rsm != NULL && ret == MBEDTLS_ERR_ECP_IN_PROGRESS && T != NULL )
Manuel Pégourié-Gonnardc9c0aa62017-03-16 14:53:26 +01002107 {
Manuel Pégourié-Gonnard45fd0162017-03-22 08:24:42 +01002108 /* transfer ownership of T from local function to rsm */
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02002109 rs_ctx->rsm->T_size = T_size;
Manuel Pégourié-Gonnard3cade222017-04-20 09:31:00 +02002110 rs_ctx->rsm->T = T;
Manuel Pégourié-Gonnardc9c0aa62017-03-16 14:53:26 +01002111 T = NULL;
2112 }
2113#endif
2114
Manuel Pégourié-Gonnard07bf6f52017-03-16 17:21:38 +01002115 /* did T belong to us? then let's destroy it! */
2116 if( T != NULL )
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01002117 {
Manuel Pégourié-Gonnard92cceb22017-08-23 16:27:29 +02002118 for( i = 0; i < T_size; i++ )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002119 mbedtls_ecp_point_free( &T[i] );
2120 mbedtls_free( T );
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01002121 }
2122
Manuel Pégourié-Gonnard2fad7ae2017-03-14 13:13:13 +01002123 /* don't free R while in progress in case R == P */
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02002124#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard2fad7ae2017-03-14 13:13:13 +01002125 if( ret != MBEDTLS_ERR_ECP_IN_PROGRESS )
2126#endif
Manuel Pégourié-Gonnard07bf6f52017-03-16 17:21:38 +01002127 /* prevent caller from using invalid value */
Manuel Pégourié-Gonnardaade42f2013-11-21 19:19:54 +01002128 if( ret != 0 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002129 mbedtls_ecp_point_free( R );
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01002130
Manuel Pégourié-Gonnarddb4a8eb2017-08-23 18:18:22 +02002131 ECP_RS_LEAVE( rsm );
Manuel Pégourié-Gonnard77af79a2017-03-14 10:58:00 +01002132
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01002133 return( ret );
2134}
2135
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +02002136#endif /* ECP_SHORTWEIERSTRASS */
Manuel Pégourié-Gonnard7c94d8b2013-12-04 23:15:46 +01002137
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +02002138#if defined(ECP_MONTGOMERY)
Manuel Pégourié-Gonnard7c94d8b2013-12-04 23:15:46 +01002139/*
2140 * For Montgomery curves, we do all the internal arithmetic in projective
2141 * coordinates. Import/export of points uses only the x coordinates, which is
2142 * internaly represented as X / Z.
2143 *
2144 * For scalar multiplication, we'll use a Montgomery ladder.
2145 */
2146
Manuel Pégourié-Gonnardd1c1ba92013-11-16 15:50:12 +01002147/*
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002148 * Normalize Montgomery x/z coordinates: X = X/Z, Z = 1
2149 * Cost: 1M + 1I
2150 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002151static int ecp_normalize_mxz( const mbedtls_ecp_group *grp, mbedtls_ecp_point *P )
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002152{
2153 int ret;
2154
Janos Follathb0697532016-08-18 12:38:46 +01002155#if defined(MBEDTLS_ECP_NORMALIZE_MXZ_ALT)
Manuel Pégourié-Gonnardebac5d32017-08-23 16:23:36 +02002156 if( mbedtls_internal_ecp_grp_capable( grp ) )
2157 return( mbedtls_internal_ecp_normalize_mxz( grp, P ) );
Janos Follath372697b2016-10-28 16:53:11 +01002158#endif /* MBEDTLS_ECP_NORMALIZE_MXZ_ALT */
Janos Follathb0697532016-08-18 12:38:46 +01002159
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002160 MBEDTLS_MPI_CHK( mbedtls_mpi_inv_mod( &P->Z, &P->Z, &grp->P ) );
2161 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &P->X, &P->X, &P->Z ) ); MOD_MUL( P->X );
2162 MBEDTLS_MPI_CHK( mbedtls_mpi_lset( &P->Z, 1 ) );
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002163
2164cleanup:
2165 return( ret );
2166}
2167
2168/*
Manuel Pégourié-Gonnard3afa07f2013-12-03 13:28:21 +01002169 * Randomize projective x/z coordinates:
2170 * (X, Z) -> (l X, l Z) for random l
2171 * This is sort of the reverse operation of ecp_normalize_mxz().
2172 *
2173 * This countermeasure was first suggested in [2].
2174 * Cost: 2M
2175 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002176static int ecp_randomize_mxz( const mbedtls_ecp_group *grp, mbedtls_ecp_point *P,
Manuel Pégourié-Gonnard3afa07f2013-12-03 13:28:21 +01002177 int (*f_rng)(void *, unsigned char *, size_t), void *p_rng )
2178{
2179 int ret;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002180 mbedtls_mpi l;
Janos Follathb0697532016-08-18 12:38:46 +01002181 size_t p_size;
Manuel Pégourié-Gonnard3afa07f2013-12-03 13:28:21 +01002182 int count = 0;
2183
Janos Follathb0697532016-08-18 12:38:46 +01002184#if defined(MBEDTLS_ECP_RANDOMIZE_MXZ_ALT)
Manuel Pégourié-Gonnardebac5d32017-08-23 16:23:36 +02002185 if( mbedtls_internal_ecp_grp_capable( grp ) )
2186 return( mbedtls_internal_ecp_randomize_mxz( grp, P, f_rng, p_rng );
Janos Follath372697b2016-10-28 16:53:11 +01002187#endif /* MBEDTLS_ECP_RANDOMIZE_MXZ_ALT */
Janos Follathb0697532016-08-18 12:38:46 +01002188
2189 p_size = ( grp->pbits + 7 ) / 8;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002190 mbedtls_mpi_init( &l );
Manuel Pégourié-Gonnard3afa07f2013-12-03 13:28:21 +01002191
2192 /* Generate l such that 1 < l < p */
2193 do
2194 {
Ron Eldorca6ff582017-01-12 14:50:50 +02002195 MBEDTLS_MPI_CHK( mbedtls_mpi_fill_random( &l, p_size, f_rng, p_rng ) );
Manuel Pégourié-Gonnard3afa07f2013-12-03 13:28:21 +01002196
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002197 while( mbedtls_mpi_cmp_mpi( &l, &grp->P ) >= 0 )
2198 MBEDTLS_MPI_CHK( mbedtls_mpi_shift_r( &l, 1 ) );
Manuel Pégourié-Gonnard3afa07f2013-12-03 13:28:21 +01002199
2200 if( count++ > 10 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002201 return( MBEDTLS_ERR_ECP_RANDOM_FAILED );
Manuel Pégourié-Gonnard3afa07f2013-12-03 13:28:21 +01002202 }
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002203 while( mbedtls_mpi_cmp_int( &l, 1 ) <= 0 );
Manuel Pégourié-Gonnard3afa07f2013-12-03 13:28:21 +01002204
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002205 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &P->X, &P->X, &l ) ); MOD_MUL( P->X );
2206 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &P->Z, &P->Z, &l ) ); MOD_MUL( P->Z );
Manuel Pégourié-Gonnard3afa07f2013-12-03 13:28:21 +01002207
2208cleanup:
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002209 mbedtls_mpi_free( &l );
Manuel Pégourié-Gonnard3afa07f2013-12-03 13:28:21 +01002210
2211 return( ret );
2212}
2213
2214/*
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002215 * Double-and-add: R = 2P, S = P + Q, with d = X(P - Q),
2216 * for Montgomery curves in x/z coordinates.
2217 *
2218 * http://www.hyperelliptic.org/EFD/g1p/auto-code/montgom/xz/ladder/mladd-1987-m.op3
2219 * with
2220 * d = X1
2221 * P = (X2, Z2)
2222 * Q = (X3, Z3)
2223 * R = (X4, Z4)
2224 * S = (X5, Z5)
2225 * and eliminating temporary variables tO, ..., t4.
2226 *
2227 * Cost: 5M + 4S
2228 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002229static int ecp_double_add_mxz( const mbedtls_ecp_group *grp,
2230 mbedtls_ecp_point *R, mbedtls_ecp_point *S,
2231 const mbedtls_ecp_point *P, const mbedtls_ecp_point *Q,
2232 const mbedtls_mpi *d )
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002233{
2234 int ret;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002235 mbedtls_mpi A, AA, B, BB, E, C, D, DA, CB;
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002236
Janos Follathb0697532016-08-18 12:38:46 +01002237#if defined(MBEDTLS_ECP_DOUBLE_ADD_MXZ_ALT)
Manuel Pégourié-Gonnardebac5d32017-08-23 16:23:36 +02002238 if( mbedtls_internal_ecp_grp_capable( grp ) )
2239 return( mbedtls_internal_ecp_double_add_mxz( grp, R, S, P, Q, d ) );
Janos Follath372697b2016-10-28 16:53:11 +01002240#endif /* MBEDTLS_ECP_DOUBLE_ADD_MXZ_ALT */
Janos Follathb0697532016-08-18 12:38:46 +01002241
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002242 mbedtls_mpi_init( &A ); mbedtls_mpi_init( &AA ); mbedtls_mpi_init( &B );
2243 mbedtls_mpi_init( &BB ); mbedtls_mpi_init( &E ); mbedtls_mpi_init( &C );
2244 mbedtls_mpi_init( &D ); mbedtls_mpi_init( &DA ); mbedtls_mpi_init( &CB );
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002245
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002246 MBEDTLS_MPI_CHK( mbedtls_mpi_add_mpi( &A, &P->X, &P->Z ) ); MOD_ADD( A );
2247 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &AA, &A, &A ) ); MOD_MUL( AA );
2248 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_mpi( &B, &P->X, &P->Z ) ); MOD_SUB( B );
2249 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &BB, &B, &B ) ); MOD_MUL( BB );
2250 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_mpi( &E, &AA, &BB ) ); MOD_SUB( E );
2251 MBEDTLS_MPI_CHK( mbedtls_mpi_add_mpi( &C, &Q->X, &Q->Z ) ); MOD_ADD( C );
2252 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_mpi( &D, &Q->X, &Q->Z ) ); MOD_SUB( D );
2253 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &DA, &D, &A ) ); MOD_MUL( DA );
2254 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &CB, &C, &B ) ); MOD_MUL( CB );
2255 MBEDTLS_MPI_CHK( mbedtls_mpi_add_mpi( &S->X, &DA, &CB ) ); MOD_MUL( S->X );
2256 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &S->X, &S->X, &S->X ) ); MOD_MUL( S->X );
2257 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_mpi( &S->Z, &DA, &CB ) ); MOD_SUB( S->Z );
2258 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &S->Z, &S->Z, &S->Z ) ); MOD_MUL( S->Z );
2259 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &S->Z, d, &S->Z ) ); MOD_MUL( S->Z );
2260 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &R->X, &AA, &BB ) ); MOD_MUL( R->X );
2261 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &R->Z, &grp->A, &E ) ); MOD_MUL( R->Z );
2262 MBEDTLS_MPI_CHK( mbedtls_mpi_add_mpi( &R->Z, &BB, &R->Z ) ); MOD_ADD( R->Z );
2263 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &R->Z, &E, &R->Z ) ); MOD_MUL( R->Z );
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002264
2265cleanup:
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002266 mbedtls_mpi_free( &A ); mbedtls_mpi_free( &AA ); mbedtls_mpi_free( &B );
2267 mbedtls_mpi_free( &BB ); mbedtls_mpi_free( &E ); mbedtls_mpi_free( &C );
2268 mbedtls_mpi_free( &D ); mbedtls_mpi_free( &DA ); mbedtls_mpi_free( &CB );
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002269
2270 return( ret );
2271}
2272
2273/*
Manuel Pégourié-Gonnarda0179b82013-12-04 11:49:20 +01002274 * Multiplication with Montgomery ladder in x/z coordinates,
2275 * for curves in Montgomery form
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002276 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002277static int ecp_mul_mxz( mbedtls_ecp_group *grp, mbedtls_ecp_point *R,
2278 const mbedtls_mpi *m, const mbedtls_ecp_point *P,
Manuel Pégourié-Gonnarda0179b82013-12-04 11:49:20 +01002279 int (*f_rng)(void *, unsigned char *, size_t),
2280 void *p_rng )
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002281{
2282 int ret;
2283 size_t i;
Manuel Pégourié-Gonnardb6f45a62013-12-04 21:54:36 +01002284 unsigned char b;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002285 mbedtls_ecp_point RP;
2286 mbedtls_mpi PX;
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002287
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002288 mbedtls_ecp_point_init( &RP ); mbedtls_mpi_init( &PX );
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002289
Manuel Pégourié-Gonnard3afa07f2013-12-03 13:28:21 +01002290 /* Save PX and read from P before writing to R, in case P == R */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002291 MBEDTLS_MPI_CHK( mbedtls_mpi_copy( &PX, &P->X ) );
2292 MBEDTLS_MPI_CHK( mbedtls_ecp_copy( &RP, P ) );
Manuel Pégourié-Gonnard357ff652013-12-04 18:39:17 +01002293
2294 /* Set R to zero in modified x/z coordinates */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002295 MBEDTLS_MPI_CHK( mbedtls_mpi_lset( &R->X, 1 ) );
2296 MBEDTLS_MPI_CHK( mbedtls_mpi_lset( &R->Z, 0 ) );
2297 mbedtls_mpi_free( &R->Y );
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002298
Manuel Pégourié-Gonnard93f41db2013-12-05 10:48:42 +01002299 /* RP.X might be sligtly larger than P, so reduce it */
2300 MOD_ADD( RP.X );
2301
Manuel Pégourié-Gonnard3afa07f2013-12-03 13:28:21 +01002302 /* Randomize coordinates of the starting point */
Manuel Pégourié-Gonnard357ff652013-12-04 18:39:17 +01002303 if( f_rng != NULL )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002304 MBEDTLS_MPI_CHK( ecp_randomize_mxz( grp, &RP, f_rng, p_rng ) );
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002305
Manuel Pégourié-Gonnardb6f45a62013-12-04 21:54:36 +01002306 /* Loop invariant: R = result so far, RP = R + P */
Manuel Pégourié-Gonnardc0696c22015-06-18 16:47:17 +02002307 i = mbedtls_mpi_bitlen( m ); /* one past the (zero-based) most significant bit */
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002308 while( i-- > 0 )
2309 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002310 b = mbedtls_mpi_get_bit( m, i );
Manuel Pégourié-Gonnardb6f45a62013-12-04 21:54:36 +01002311 /*
2312 * if (b) R = 2R + P else R = 2R,
2313 * which is:
2314 * if (b) double_add( RP, R, RP, R )
2315 * else double_add( R, RP, R, RP )
2316 * but using safe conditional swaps to avoid leaks
2317 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002318 MBEDTLS_MPI_CHK( mbedtls_mpi_safe_cond_swap( &R->X, &RP.X, b ) );
2319 MBEDTLS_MPI_CHK( mbedtls_mpi_safe_cond_swap( &R->Z, &RP.Z, b ) );
2320 MBEDTLS_MPI_CHK( ecp_double_add_mxz( grp, R, &RP, R, &RP, &PX ) );
2321 MBEDTLS_MPI_CHK( mbedtls_mpi_safe_cond_swap( &R->X, &RP.X, b ) );
2322 MBEDTLS_MPI_CHK( mbedtls_mpi_safe_cond_swap( &R->Z, &RP.Z, b ) );
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002323 }
2324
Manuel Pégourié-Gonnardf6004162020-03-25 12:41:29 +01002325 /*
2326 * Knowledge of the projective coordinates may leak the last few bits of the
2327 * scalar [1], and since our MPI implementation isn't constant-flow,
2328 * inversion (used for coordinate normalization) may leak the full value
2329 * of its input via side-channels [2].
2330 *
2331 * [1] https://eprint.iacr.org/2003/191
2332 * [2] https://eprint.iacr.org/2020/055
2333 *
2334 * Avoid the leak by randomizing coordinates before we normalize them.
2335 */
2336 if( f_rng != NULL )
2337 MBEDTLS_MPI_CHK( ecp_randomize_mxz( grp, R, f_rng, p_rng ) );
2338
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002339 MBEDTLS_MPI_CHK( ecp_normalize_mxz( grp, R ) );
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002340
2341cleanup:
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002342 mbedtls_ecp_point_free( &RP ); mbedtls_mpi_free( &PX );
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002343
2344 return( ret );
2345}
2346
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +02002347#endif /* ECP_MONTGOMERY */
Manuel Pégourié-Gonnard7c94d8b2013-12-04 23:15:46 +01002348
Manuel Pégourié-Gonnardd9ea82e72013-12-03 12:02:28 +01002349/*
Manuel Pégourié-Gonnard884569c2017-04-20 10:10:59 +02002350 * Restartable multiplication R = m * P
Manuel Pégourié-Gonnarda0179b82013-12-04 11:49:20 +01002351 */
Manuel Pégourié-Gonnard884569c2017-04-20 10:10:59 +02002352int mbedtls_ecp_mul_restartable( mbedtls_ecp_group *grp, mbedtls_ecp_point *R,
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002353 const mbedtls_mpi *m, const mbedtls_ecp_point *P,
Manuel Pégourié-Gonnard884569c2017-04-20 10:10:59 +02002354 int (*f_rng)(void *, unsigned char *, size_t), void *p_rng,
2355 mbedtls_ecp_restart_ctx *rs_ctx )
Manuel Pégourié-Gonnarda0179b82013-12-04 11:49:20 +01002356{
Janos Follathb0697532016-08-18 12:38:46 +01002357 int ret = MBEDTLS_ERR_ECP_BAD_INPUT_DATA;
Janos Follathc44ab972016-11-18 16:38:23 +00002358#if defined(MBEDTLS_ECP_INTERNAL_ALT)
2359 char is_grp_capable = 0;
2360#endif
Hanno Becker4f8e8e52018-12-14 15:08:03 +00002361 ECP_VALIDATE_RET( grp != NULL );
2362 ECP_VALIDATE_RET( R != NULL );
2363 ECP_VALIDATE_RET( m != NULL );
2364 ECP_VALIDATE_RET( P != NULL );
Manuel Pégourié-Gonnarda0179b82013-12-04 11:49:20 +01002365
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02002366#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard3a256122017-04-20 11:20:26 +02002367 /* reset ops count for this call if top-level */
2368 if( rs_ctx != NULL && rs_ctx->depth++ == 0 )
2369 rs_ctx->ops_done = 0;
2370#endif
Manuel Pégourié-Gonnarda0179b82013-12-04 11:49:20 +01002371
Janos Follathc44ab972016-11-18 16:38:23 +00002372#if defined(MBEDTLS_ECP_INTERNAL_ALT)
Manuel Pégourié-Gonnardebac5d32017-08-23 16:23:36 +02002373 if( ( is_grp_capable = mbedtls_internal_ecp_grp_capable( grp ) ) )
Janos Follathc44ab972016-11-18 16:38:23 +00002374 MBEDTLS_MPI_CHK( mbedtls_internal_ecp_init( grp ) );
Janos Follathc44ab972016-11-18 16:38:23 +00002375#endif /* MBEDTLS_ECP_INTERNAL_ALT */
Manuel Pégourié-Gonnard3a256122017-04-20 11:20:26 +02002376
Manuel Pégourié-Gonnard95aedfe2017-08-24 13:47:04 +02002377#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnarda08cd1a2017-04-20 11:29:43 +02002378 /* skip argument check when restarting */
Manuel Pégourié-Gonnard95aedfe2017-08-24 13:47:04 +02002379 if( rs_ctx == NULL || rs_ctx->rsm == NULL )
Manuel Pégourié-Gonnarda08cd1a2017-04-20 11:29:43 +02002380#endif
2381 {
Manuel Pégourié-Gonnard5314f232017-04-21 12:36:59 +02002382 /* check_privkey is free */
2383 MBEDTLS_ECP_BUDGET( MBEDTLS_ECP_OPS_CHK );
2384
Manuel Pégourié-Gonnarda08cd1a2017-04-20 11:29:43 +02002385 /* Common sanity checks */
2386 MBEDTLS_MPI_CHK( mbedtls_ecp_check_privkey( grp, m ) );
2387 MBEDTLS_MPI_CHK( mbedtls_ecp_check_pubkey( grp, P ) );
Manuel Pégourié-Gonnarda08cd1a2017-04-20 11:29:43 +02002388 }
Manuel Pégourié-Gonnard3a256122017-04-20 11:20:26 +02002389
2390 ret = MBEDTLS_ERR_ECP_BAD_INPUT_DATA;
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +02002391#if defined(ECP_MONTGOMERY)
2392 if( ecp_get_type( grp ) == ECP_TYPE_MONTGOMERY )
Manuel Pégourié-Gonnard3a256122017-04-20 11:20:26 +02002393 MBEDTLS_MPI_CHK( ecp_mul_mxz( grp, R, m, P, f_rng, p_rng ) );
Janos Follath430d3372016-11-03 14:25:37 +00002394#endif
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +02002395#if defined(ECP_SHORTWEIERSTRASS)
2396 if( ecp_get_type( grp ) == ECP_TYPE_SHORT_WEIERSTRASS )
Manuel Pégourié-Gonnard3a256122017-04-20 11:20:26 +02002397 MBEDTLS_MPI_CHK( ecp_mul_comb( grp, R, m, P, f_rng, p_rng, rs_ctx ) );
Janos Follath430d3372016-11-03 14:25:37 +00002398#endif
Manuel Pégourié-Gonnard3a256122017-04-20 11:20:26 +02002399
Janos Follath6c8ccd52016-11-29 15:37:09 +00002400cleanup:
Janos Follathb0697532016-08-18 12:38:46 +01002401
Manuel Pégourié-Gonnard3a256122017-04-20 11:20:26 +02002402#if defined(MBEDTLS_ECP_INTERNAL_ALT)
Manuel Pégourié-Gonnardebac5d32017-08-23 16:23:36 +02002403 if( is_grp_capable )
Janos Follathc44ab972016-11-18 16:38:23 +00002404 mbedtls_internal_ecp_free( grp );
Janos Follathc44ab972016-11-18 16:38:23 +00002405#endif /* MBEDTLS_ECP_INTERNAL_ALT */
Manuel Pégourié-Gonnard3a256122017-04-20 11:20:26 +02002406
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02002407#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard3a256122017-04-20 11:20:26 +02002408 if( rs_ctx != NULL )
2409 rs_ctx->depth--;
2410#endif
2411
Janos Follathb0697532016-08-18 12:38:46 +01002412 return( ret );
Manuel Pégourié-Gonnarda0179b82013-12-04 11:49:20 +01002413}
2414
Manuel Pégourié-Gonnardb739a712017-04-19 10:11:56 +02002415/*
Manuel Pégourié-Gonnard884569c2017-04-20 10:10:59 +02002416 * Multiplication R = m * P
Manuel Pégourié-Gonnardb739a712017-04-19 10:11:56 +02002417 */
Manuel Pégourié-Gonnard884569c2017-04-20 10:10:59 +02002418int mbedtls_ecp_mul( mbedtls_ecp_group *grp, mbedtls_ecp_point *R,
Manuel Pégourié-Gonnardb739a712017-04-19 10:11:56 +02002419 const mbedtls_mpi *m, const mbedtls_ecp_point *P,
Manuel Pégourié-Gonnard884569c2017-04-20 10:10:59 +02002420 int (*f_rng)(void *, unsigned char *, size_t), void *p_rng )
Manuel Pégourié-Gonnardb739a712017-04-19 10:11:56 +02002421{
Hanno Becker4f8e8e52018-12-14 15:08:03 +00002422 ECP_VALIDATE_RET( grp != NULL );
2423 ECP_VALIDATE_RET( R != NULL );
2424 ECP_VALIDATE_RET( m != NULL );
2425 ECP_VALIDATE_RET( P != NULL );
Manuel Pégourié-Gonnard884569c2017-04-20 10:10:59 +02002426 return( mbedtls_ecp_mul_restartable( grp, R, m, P, f_rng, p_rng, NULL ) );
Manuel Pégourié-Gonnardb739a712017-04-19 10:11:56 +02002427}
Manuel Pégourié-Gonnardb739a712017-04-19 10:11:56 +02002428
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +02002429#if defined(ECP_SHORTWEIERSTRASS)
Manuel Pégourié-Gonnarda0179b82013-12-04 11:49:20 +01002430/*
Manuel Pégourié-Gonnardd9622732013-12-05 10:06:06 +01002431 * Check that an affine point is valid as a public key,
2432 * short weierstrass curves (SEC1 3.2.3.1)
Manuel Pégourié-Gonnardc8dc2952013-07-01 14:06:13 +02002433 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002434static int ecp_check_pubkey_sw( const mbedtls_ecp_group *grp, const mbedtls_ecp_point *pt )
Manuel Pégourié-Gonnardc8dc2952013-07-01 14:06:13 +02002435{
2436 int ret;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002437 mbedtls_mpi YY, RHS;
Manuel Pégourié-Gonnardc8dc2952013-07-01 14:06:13 +02002438
Manuel Pégourié-Gonnard312d2e82013-12-04 11:08:01 +01002439 /* pt coordinates must be normalized for our checks */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002440 if( mbedtls_mpi_cmp_int( &pt->X, 0 ) < 0 ||
2441 mbedtls_mpi_cmp_int( &pt->Y, 0 ) < 0 ||
2442 mbedtls_mpi_cmp_mpi( &pt->X, &grp->P ) >= 0 ||
2443 mbedtls_mpi_cmp_mpi( &pt->Y, &grp->P ) >= 0 )
2444 return( MBEDTLS_ERR_ECP_INVALID_KEY );
Manuel Pégourié-Gonnardc8dc2952013-07-01 14:06:13 +02002445
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002446 mbedtls_mpi_init( &YY ); mbedtls_mpi_init( &RHS );
Manuel Pégourié-Gonnardc8dc2952013-07-01 14:06:13 +02002447
2448 /*
2449 * YY = Y^2
Manuel Pégourié-Gonnardcd7458a2013-10-08 13:11:30 +02002450 * RHS = X (X^2 + A) + B = X^3 + A X + B
Manuel Pégourié-Gonnardc8dc2952013-07-01 14:06:13 +02002451 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002452 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &YY, &pt->Y, &pt->Y ) ); MOD_MUL( YY );
2453 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &RHS, &pt->X, &pt->X ) ); MOD_MUL( RHS );
Manuel Pégourié-Gonnard73cc01d2013-12-06 12:41:30 +01002454
2455 /* Special case for A = -3 */
2456 if( grp->A.p == NULL )
2457 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002458 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_int( &RHS, &RHS, 3 ) ); MOD_SUB( RHS );
Manuel Pégourié-Gonnard73cc01d2013-12-06 12:41:30 +01002459 }
2460 else
2461 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002462 MBEDTLS_MPI_CHK( mbedtls_mpi_add_mpi( &RHS, &RHS, &grp->A ) ); MOD_ADD( RHS );
Manuel Pégourié-Gonnard73cc01d2013-12-06 12:41:30 +01002463 }
2464
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002465 MBEDTLS_MPI_CHK( mbedtls_mpi_mul_mpi( &RHS, &RHS, &pt->X ) ); MOD_MUL( RHS );
2466 MBEDTLS_MPI_CHK( mbedtls_mpi_add_mpi( &RHS, &RHS, &grp->B ) ); MOD_ADD( RHS );
Manuel Pégourié-Gonnardc8dc2952013-07-01 14:06:13 +02002467
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002468 if( mbedtls_mpi_cmp_mpi( &YY, &RHS ) != 0 )
2469 ret = MBEDTLS_ERR_ECP_INVALID_KEY;
Manuel Pégourié-Gonnardc8dc2952013-07-01 14:06:13 +02002470
2471cleanup:
2472
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002473 mbedtls_mpi_free( &YY ); mbedtls_mpi_free( &RHS );
Manuel Pégourié-Gonnardc8dc2952013-07-01 14:06:13 +02002474
2475 return( ret );
2476}
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +02002477#endif /* ECP_SHORTWEIERSTRASS */
Manuel Pégourié-Gonnardd9622732013-12-05 10:06:06 +01002478
Manuel Pégourié-Gonnard56cc88a2015-05-11 18:40:45 +02002479/*
Manuel Pégourié-Gonnardde9f9532015-10-23 15:50:37 +02002480 * R = m * P with shortcuts for m == 1 and m == -1
2481 * NOT constant-time - ONLY for short Weierstrass!
2482 */
2483static int mbedtls_ecp_mul_shortcuts( mbedtls_ecp_group *grp,
2484 mbedtls_ecp_point *R,
2485 const mbedtls_mpi *m,
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +02002486 const mbedtls_ecp_point *P,
2487 mbedtls_ecp_restart_ctx *rs_ctx )
Manuel Pégourié-Gonnardde9f9532015-10-23 15:50:37 +02002488{
2489 int ret;
2490
2491 if( mbedtls_mpi_cmp_int( m, 1 ) == 0 )
2492 {
2493 MBEDTLS_MPI_CHK( mbedtls_ecp_copy( R, P ) );
2494 }
2495 else if( mbedtls_mpi_cmp_int( m, -1 ) == 0 )
2496 {
2497 MBEDTLS_MPI_CHK( mbedtls_ecp_copy( R, P ) );
2498 if( mbedtls_mpi_cmp_int( &R->Y, 0 ) != 0 )
2499 MBEDTLS_MPI_CHK( mbedtls_mpi_sub_mpi( &R->Y, &grp->P, &R->Y ) );
2500 }
2501 else
2502 {
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +02002503 MBEDTLS_MPI_CHK( mbedtls_ecp_mul_restartable( grp, R, m, P,
2504 NULL, NULL, rs_ctx ) );
Manuel Pégourié-Gonnardde9f9532015-10-23 15:50:37 +02002505 }
2506
2507cleanup:
2508 return( ret );
2509}
2510
2511/*
Manuel Pégourié-Gonnard54dd6522017-04-20 13:36:18 +02002512 * Restartable linear combination
Manuel Pégourié-Gonnardde9f9532015-10-23 15:50:37 +02002513 * NOT constant-time
Manuel Pégourié-Gonnard56cc88a2015-05-11 18:40:45 +02002514 */
Manuel Pégourié-Gonnard54dd6522017-04-20 13:36:18 +02002515int mbedtls_ecp_muladd_restartable(
2516 mbedtls_ecp_group *grp, mbedtls_ecp_point *R,
Manuel Pégourié-Gonnard56cc88a2015-05-11 18:40:45 +02002517 const mbedtls_mpi *m, const mbedtls_ecp_point *P,
Manuel Pégourié-Gonnard54dd6522017-04-20 13:36:18 +02002518 const mbedtls_mpi *n, const mbedtls_ecp_point *Q,
2519 mbedtls_ecp_restart_ctx *rs_ctx )
Manuel Pégourié-Gonnard56cc88a2015-05-11 18:40:45 +02002520{
2521 int ret;
2522 mbedtls_ecp_point mP;
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +02002523 mbedtls_ecp_point *pmP = &mP;
2524 mbedtls_ecp_point *pR = R;
Janos Follathc44ab972016-11-18 16:38:23 +00002525#if defined(MBEDTLS_ECP_INTERNAL_ALT)
2526 char is_grp_capable = 0;
2527#endif
Hanno Becker4f8e8e52018-12-14 15:08:03 +00002528 ECP_VALIDATE_RET( grp != NULL );
2529 ECP_VALIDATE_RET( R != NULL );
2530 ECP_VALIDATE_RET( m != NULL );
2531 ECP_VALIDATE_RET( P != NULL );
2532 ECP_VALIDATE_RET( n != NULL );
2533 ECP_VALIDATE_RET( Q != NULL );
Manuel Pégourié-Gonnard56cc88a2015-05-11 18:40:45 +02002534
2535 if( ecp_get_type( grp ) != ECP_TYPE_SHORT_WEIERSTRASS )
2536 return( MBEDTLS_ERR_ECP_FEATURE_UNAVAILABLE );
2537
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +02002538 mbedtls_ecp_point_init( &mP );
2539
Manuel Pégourié-Gonnarddb4a8eb2017-08-23 18:18:22 +02002540 ECP_RS_ENTER( ma );
2541
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02002542#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +02002543 if( rs_ctx != NULL && rs_ctx->ma != NULL )
2544 {
2545 /* redirect intermediate results to restart context */
2546 pmP = &rs_ctx->ma->mP;
2547 pR = &rs_ctx->ma->R;
2548
2549 /* jump to next operation */
2550 if( rs_ctx->ma->state == ecp_rsma_mul2 )
2551 goto mul2;
2552 if( rs_ctx->ma->state == ecp_rsma_add )
2553 goto add;
2554 if( rs_ctx->ma->state == ecp_rsma_norm )
2555 goto norm;
2556 }
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02002557#endif /* MBEDTLS_ECP_RESTARTABLE */
Manuel Pégourié-Gonnard54dd6522017-04-20 13:36:18 +02002558
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +02002559 MBEDTLS_MPI_CHK( mbedtls_ecp_mul_shortcuts( grp, pmP, m, P, rs_ctx ) );
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02002560#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +02002561 if( rs_ctx != NULL && rs_ctx->ma != NULL )
Manuel Pégourié-Gonnardc9efa002017-08-24 10:25:06 +02002562 rs_ctx->ma->state = ecp_rsma_mul2;
Manuel Pégourié-Gonnard56cc88a2015-05-11 18:40:45 +02002563
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +02002564mul2:
2565#endif
2566 MBEDTLS_MPI_CHK( mbedtls_ecp_mul_shortcuts( grp, pR, n, Q, rs_ctx ) );
Janos Follathaf6f2692018-12-07 09:55:24 +00002567
2568#if defined(MBEDTLS_ECP_INTERNAL_ALT)
2569 if( ( is_grp_capable = mbedtls_internal_ecp_grp_capable( grp ) ) )
2570 MBEDTLS_MPI_CHK( mbedtls_internal_ecp_init( grp ) );
2571#endif /* MBEDTLS_ECP_INTERNAL_ALT */
2572
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02002573#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +02002574 if( rs_ctx != NULL && rs_ctx->ma != NULL )
Manuel Pégourié-Gonnardc9efa002017-08-24 10:25:06 +02002575 rs_ctx->ma->state = ecp_rsma_add;
Manuel Pégourié-Gonnard1a7c5ef2015-08-13 10:19:09 +02002576
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +02002577add:
2578#endif
Manuel Pégourié-Gonnardc7511482017-04-20 16:31:00 +02002579 MBEDTLS_ECP_BUDGET( MBEDTLS_ECP_OPS_ADD );
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +02002580 MBEDTLS_MPI_CHK( ecp_add_mixed( grp, pR, pmP, pR ) );
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02002581#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +02002582 if( rs_ctx != NULL && rs_ctx->ma != NULL )
Manuel Pégourié-Gonnardc9efa002017-08-24 10:25:06 +02002583 rs_ctx->ma->state = ecp_rsma_norm;
Janos Follath430d3372016-11-03 14:25:37 +00002584
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +02002585norm:
2586#endif
Manuel Pégourié-Gonnardc7511482017-04-20 16:31:00 +02002587 MBEDTLS_ECP_BUDGET( MBEDTLS_ECP_OPS_INV );
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +02002588 MBEDTLS_MPI_CHK( ecp_normalize_jac( grp, pR ) );
2589
Manuel Pégourié-Gonnard4b9c51e2017-04-20 15:50:26 +02002590#if defined(MBEDTLS_ECP_RESTARTABLE)
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +02002591 if( rs_ctx != NULL && rs_ctx->ma != NULL )
2592 MBEDTLS_MPI_CHK( mbedtls_ecp_copy( R, pR ) );
2593#endif
Manuel Pégourié-Gonnard56cc88a2015-05-11 18:40:45 +02002594
2595cleanup:
Janos Follathc44ab972016-11-18 16:38:23 +00002596#if defined(MBEDTLS_ECP_INTERNAL_ALT)
Manuel Pégourié-Gonnardebac5d32017-08-23 16:23:36 +02002597 if( is_grp_capable )
Janos Follathc44ab972016-11-18 16:38:23 +00002598 mbedtls_internal_ecp_free( grp );
Janos Follathc44ab972016-11-18 16:38:23 +00002599#endif /* MBEDTLS_ECP_INTERNAL_ALT */
Manuel Pégourié-Gonnard1631d632017-04-20 14:48:56 +02002600
Manuel Pégourié-Gonnard56cc88a2015-05-11 18:40:45 +02002601 mbedtls_ecp_point_free( &mP );
2602
Manuel Pégourié-Gonnarddb4a8eb2017-08-23 18:18:22 +02002603 ECP_RS_LEAVE( ma );
Manuel Pégourié-Gonnard54dd6522017-04-20 13:36:18 +02002604
Manuel Pégourié-Gonnard56cc88a2015-05-11 18:40:45 +02002605 return( ret );
2606}
2607
Manuel Pégourié-Gonnard54dd6522017-04-20 13:36:18 +02002608/*
2609 * Linear combination
2610 * NOT constant-time
2611 */
2612int mbedtls_ecp_muladd( mbedtls_ecp_group *grp, mbedtls_ecp_point *R,
2613 const mbedtls_mpi *m, const mbedtls_ecp_point *P,
2614 const mbedtls_mpi *n, const mbedtls_ecp_point *Q )
2615{
Hanno Becker4f8e8e52018-12-14 15:08:03 +00002616 ECP_VALIDATE_RET( grp != NULL );
2617 ECP_VALIDATE_RET( R != NULL );
2618 ECP_VALIDATE_RET( m != NULL );
2619 ECP_VALIDATE_RET( P != NULL );
2620 ECP_VALIDATE_RET( n != NULL );
2621 ECP_VALIDATE_RET( Q != NULL );
Manuel Pégourié-Gonnard54dd6522017-04-20 13:36:18 +02002622 return( mbedtls_ecp_muladd_restartable( grp, R, m, P, n, Q, NULL ) );
2623}
Manuel Pégourié-Gonnardd9622732013-12-05 10:06:06 +01002624
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +02002625#if defined(ECP_MONTGOMERY)
Manuel Pégourié-Gonnardd9622732013-12-05 10:06:06 +01002626/*
2627 * Check validity of a public key for Montgomery curves with x-only schemes
2628 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002629static int ecp_check_pubkey_mx( const mbedtls_ecp_group *grp, const mbedtls_ecp_point *pt )
Manuel Pégourié-Gonnardd9622732013-12-05 10:06:06 +01002630{
Manuel Pégourié-Gonnard07894332015-06-23 00:18:41 +02002631 /* [Curve25519 p. 5] Just check X is the correct number of bytes */
Nicholas Wilson08f3ef12015-11-10 13:10:01 +00002632 /* Allow any public value, if it's too big then we'll just reduce it mod p
2633 * (RFC 7748 sec. 5 para. 3). */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002634 if( mbedtls_mpi_size( &pt->X ) > ( grp->nbits + 7 ) / 8 )
2635 return( MBEDTLS_ERR_ECP_INVALID_KEY );
Manuel Pégourié-Gonnardd9622732013-12-05 10:06:06 +01002636
2637 return( 0 );
2638}
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +02002639#endif /* ECP_MONTGOMERY */
Manuel Pégourié-Gonnardd9622732013-12-05 10:06:06 +01002640
2641/*
2642 * Check that a point is valid as a public key
2643 */
Hanno Becker4f8e8e52018-12-14 15:08:03 +00002644int mbedtls_ecp_check_pubkey( const mbedtls_ecp_group *grp,
2645 const mbedtls_ecp_point *pt )
Manuel Pégourié-Gonnardd9622732013-12-05 10:06:06 +01002646{
Hanno Becker4f8e8e52018-12-14 15:08:03 +00002647 ECP_VALIDATE_RET( grp != NULL );
2648 ECP_VALIDATE_RET( pt != NULL );
2649
Manuel Pégourié-Gonnardd9622732013-12-05 10:06:06 +01002650 /* Must use affine coordinates */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002651 if( mbedtls_mpi_cmp_int( &pt->Z, 1 ) != 0 )
2652 return( MBEDTLS_ERR_ECP_INVALID_KEY );
Manuel Pégourié-Gonnardd9622732013-12-05 10:06:06 +01002653
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +02002654#if defined(ECP_MONTGOMERY)
2655 if( ecp_get_type( grp ) == ECP_TYPE_MONTGOMERY )
Manuel Pégourié-Gonnardd9622732013-12-05 10:06:06 +01002656 return( ecp_check_pubkey_mx( grp, pt ) );
2657#endif
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +02002658#if defined(ECP_SHORTWEIERSTRASS)
2659 if( ecp_get_type( grp ) == ECP_TYPE_SHORT_WEIERSTRASS )
Manuel Pégourié-Gonnardd9622732013-12-05 10:06:06 +01002660 return( ecp_check_pubkey_sw( grp, pt ) );
2661#endif
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002662 return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
Manuel Pégourié-Gonnardd9622732013-12-05 10:06:06 +01002663}
Manuel Pégourié-Gonnardc8dc2952013-07-01 14:06:13 +02002664
2665/*
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002666 * Check that an mbedtls_mpi is valid as a private key
Manuel Pégourié-Gonnardc8dc2952013-07-01 14:06:13 +02002667 */
Hanno Becker4f8e8e52018-12-14 15:08:03 +00002668int mbedtls_ecp_check_privkey( const mbedtls_ecp_group *grp,
2669 const mbedtls_mpi *d )
Manuel Pégourié-Gonnardc8dc2952013-07-01 14:06:13 +02002670{
Hanno Becker4f8e8e52018-12-14 15:08:03 +00002671 ECP_VALIDATE_RET( grp != NULL );
2672 ECP_VALIDATE_RET( d != NULL );
2673
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +02002674#if defined(ECP_MONTGOMERY)
2675 if( ecp_get_type( grp ) == ECP_TYPE_MONTGOMERY )
Manuel Pégourié-Gonnard312d2e82013-12-04 11:08:01 +01002676 {
Nicholas Wilson08f3ef12015-11-10 13:10:01 +00002677 /* see RFC 7748 sec. 5 para. 5 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002678 if( mbedtls_mpi_get_bit( d, 0 ) != 0 ||
2679 mbedtls_mpi_get_bit( d, 1 ) != 0 ||
Manuel Pégourié-Gonnardc0696c22015-06-18 16:47:17 +02002680 mbedtls_mpi_bitlen( d ) - 1 != grp->nbits ) /* mbedtls_mpi_bitlen is one-based! */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002681 return( MBEDTLS_ERR_ECP_INVALID_KEY );
Nicholas Wilson08f3ef12015-11-10 13:10:01 +00002682
2683 /* see [Curve25519] page 5 */
2684 if( grp->nbits == 254 && mbedtls_mpi_get_bit( d, 2 ) != 0 )
2685 return( MBEDTLS_ERR_ECP_INVALID_KEY );
2686
2687 return( 0 );
Manuel Pégourié-Gonnard312d2e82013-12-04 11:08:01 +01002688 }
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +02002689#endif /* ECP_MONTGOMERY */
2690#if defined(ECP_SHORTWEIERSTRASS)
2691 if( ecp_get_type( grp ) == ECP_TYPE_SHORT_WEIERSTRASS )
Manuel Pégourié-Gonnard312d2e82013-12-04 11:08:01 +01002692 {
2693 /* see SEC1 3.2 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002694 if( mbedtls_mpi_cmp_int( d, 1 ) < 0 ||
2695 mbedtls_mpi_cmp_mpi( d, &grp->N ) >= 0 )
2696 return( MBEDTLS_ERR_ECP_INVALID_KEY );
Manuel Pégourié-Gonnardd9622732013-12-05 10:06:06 +01002697 else
2698 return( 0 );
Manuel Pégourié-Gonnard312d2e82013-12-04 11:08:01 +01002699 }
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +02002700#endif /* ECP_SHORTWEIERSTRASS */
Manuel Pégourié-Gonnardc8dc2952013-07-01 14:06:13 +02002701
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002702 return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
Manuel Pégourié-Gonnardc8dc2952013-07-01 14:06:13 +02002703}
2704
2705/*
Manuel Pégourié-Gonnarda7937f92017-04-20 15:37:46 +02002706 * Generate a private key
Manuel Pégourié-Gonnard45a035a2013-01-26 14:42:45 +01002707 */
Manuel Pégourié-Gonnarda7937f92017-04-20 15:37:46 +02002708int mbedtls_ecp_gen_privkey( const mbedtls_ecp_group *grp,
2709 mbedtls_mpi *d,
Manuel Pégourié-Gonnard45a035a2013-01-26 14:42:45 +01002710 int (*f_rng)(void *, unsigned char *, size_t),
2711 void *p_rng )
2712{
Manuel Pégourié-Gonnarda7937f92017-04-20 15:37:46 +02002713 int ret = MBEDTLS_ERR_ECP_BAD_INPUT_DATA;
Hanno Becker4f8e8e52018-12-14 15:08:03 +00002714 size_t n_size;
2715
2716 ECP_VALIDATE_RET( grp != NULL );
2717 ECP_VALIDATE_RET( d != NULL );
2718 ECP_VALIDATE_RET( f_rng != NULL );
2719
2720 n_size = ( grp->nbits + 7 ) / 8;
Manuel Pégourié-Gonnard45a035a2013-01-26 14:42:45 +01002721
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +02002722#if defined(ECP_MONTGOMERY)
2723 if( ecp_get_type( grp ) == ECP_TYPE_MONTGOMERY )
Manuel Pégourié-Gonnard45a035a2013-01-26 14:42:45 +01002724 {
Manuel Pégourié-Gonnardfe0af402013-12-04 18:14:55 +01002725 /* [M225] page 5 */
2726 size_t b;
2727
Janos Follath98e28a72016-05-31 14:03:54 +01002728 do {
2729 MBEDTLS_MPI_CHK( mbedtls_mpi_fill_random( d, n_size, f_rng, p_rng ) );
2730 } while( mbedtls_mpi_bitlen( d ) == 0);
Manuel Pégourié-Gonnard45a035a2013-01-26 14:42:45 +01002731
Manuel Pégourié-Gonnardfe0af402013-12-04 18:14:55 +01002732 /* Make sure the most significant bit is nbits */
Manuel Pégourié-Gonnardc0696c22015-06-18 16:47:17 +02002733 b = mbedtls_mpi_bitlen( d ) - 1; /* mbedtls_mpi_bitlen is one-based */
Manuel Pégourié-Gonnardfe0af402013-12-04 18:14:55 +01002734 if( b > grp->nbits )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002735 MBEDTLS_MPI_CHK( mbedtls_mpi_shift_r( d, b - grp->nbits ) );
Manuel Pégourié-Gonnardfe0af402013-12-04 18:14:55 +01002736 else
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002737 MBEDTLS_MPI_CHK( mbedtls_mpi_set_bit( d, grp->nbits, 1 ) );
Manuel Pégourié-Gonnard45a035a2013-01-26 14:42:45 +01002738
Nicholas Wilson08f3ef12015-11-10 13:10:01 +00002739 /* Make sure the last two bits are unset for Curve448, three bits for
2740 Curve25519 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002741 MBEDTLS_MPI_CHK( mbedtls_mpi_set_bit( d, 0, 0 ) );
2742 MBEDTLS_MPI_CHK( mbedtls_mpi_set_bit( d, 1, 0 ) );
Nicholas Wilson08f3ef12015-11-10 13:10:01 +00002743 if( grp->nbits == 254 )
2744 {
2745 MBEDTLS_MPI_CHK( mbedtls_mpi_set_bit( d, 2, 0 ) );
2746 }
Manuel Pégourié-Gonnard45a035a2013-01-26 14:42:45 +01002747 }
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +02002748#endif /* ECP_MONTGOMERY */
Manuel Pégourié-Gonnarda7937f92017-04-20 15:37:46 +02002749
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +02002750#if defined(ECP_SHORTWEIERSTRASS)
2751 if( ecp_get_type( grp ) == ECP_TYPE_SHORT_WEIERSTRASS )
Manuel Pégourié-Gonnardfe0af402013-12-04 18:14:55 +01002752 {
2753 /* SEC1 3.2.1: Generate d such that 1 <= n < N */
Manuel Pégourié-Gonnardd9622732013-12-05 10:06:06 +01002754 int count = 0;
Janos Follath867a3ab2019-10-11 14:21:53 +01002755 unsigned cmp = 0;
Manuel Pégourié-Gonnard79f73b92014-01-03 12:35:05 +01002756
2757 /*
2758 * Match the procedure given in RFC 6979 (deterministic ECDSA):
2759 * - use the same byte ordering;
2760 * - keep the leftmost nbits bits of the generated octet string;
2761 * - try until result is in the desired range.
2762 * This also avoids any biais, which is especially important for ECDSA.
2763 */
Manuel Pégourié-Gonnardfe0af402013-12-04 18:14:55 +01002764 do
2765 {
Hanno Becker7c8cb9c2017-10-17 15:19:38 +01002766 MBEDTLS_MPI_CHK( mbedtls_mpi_fill_random( d, n_size, f_rng, p_rng ) );
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002767 MBEDTLS_MPI_CHK( mbedtls_mpi_shift_r( d, 8 * n_size - grp->nbits ) );
Manuel Pégourié-Gonnardfe0af402013-12-04 18:14:55 +01002768
Manuel Pégourié-Gonnard6e8e34d2014-01-28 19:30:56 +01002769 /*
2770 * Each try has at worst a probability 1/2 of failing (the msb has
2771 * a probability 1/2 of being 0, and then the result will be < N),
2772 * so after 30 tries failure probability is a most 2**(-30).
2773 *
2774 * For most curves, 1 try is enough with overwhelming probability,
2775 * since N starts with a lot of 1s in binary, but some curves
2776 * such as secp224k1 are actually very close to the worst case.
2777 */
Manuel Pégourié-Gonnard67543962017-04-21 13:19:43 +02002778 if( ++count > 30 )
2779 return( MBEDTLS_ERR_ECP_RANDOM_FAILED );
Janos Follath4c3408b2019-09-16 14:27:39 +01002780
Janos Follath867a3ab2019-10-11 14:21:53 +01002781 ret = mbedtls_mpi_lt_mpi_ct( d, &grp->N, &cmp );
Janos Follath4c3408b2019-09-16 14:27:39 +01002782 if( ret != 0 )
2783 {
2784 goto cleanup;
2785 }
Manuel Pégourié-Gonnardfe0af402013-12-04 18:14:55 +01002786 }
Janos Follath867a3ab2019-10-11 14:21:53 +01002787 while( mbedtls_mpi_cmp_int( d, 1 ) < 0 || cmp != 1 );
Manuel Pégourié-Gonnardfe0af402013-12-04 18:14:55 +01002788 }
Manuel Pégourié-Gonnard8408a942015-04-09 12:14:31 +02002789#endif /* ECP_SHORTWEIERSTRASS */
Manuel Pégourié-Gonnard45a035a2013-01-26 14:42:45 +01002790
Manuel Pégourié-Gonnardc9573992014-01-03 12:54:00 +01002791cleanup:
Manuel Pégourié-Gonnarda7937f92017-04-20 15:37:46 +02002792 return( ret );
2793}
Manuel Pégourié-Gonnardc9573992014-01-03 12:54:00 +01002794
Manuel Pégourié-Gonnarda7937f92017-04-20 15:37:46 +02002795/*
2796 * Generate a keypair with configurable base point
2797 */
2798int mbedtls_ecp_gen_keypair_base( mbedtls_ecp_group *grp,
2799 const mbedtls_ecp_point *G,
2800 mbedtls_mpi *d, mbedtls_ecp_point *Q,
2801 int (*f_rng)(void *, unsigned char *, size_t),
2802 void *p_rng )
2803{
2804 int ret;
Hanno Becker4f8e8e52018-12-14 15:08:03 +00002805 ECP_VALIDATE_RET( grp != NULL );
2806 ECP_VALIDATE_RET( d != NULL );
2807 ECP_VALIDATE_RET( G != NULL );
2808 ECP_VALIDATE_RET( Q != NULL );
2809 ECP_VALIDATE_RET( f_rng != NULL );
Manuel Pégourié-Gonnarda7937f92017-04-20 15:37:46 +02002810
2811 MBEDTLS_MPI_CHK( mbedtls_ecp_gen_privkey( grp, d, f_rng, p_rng ) );
2812 MBEDTLS_MPI_CHK( mbedtls_ecp_mul( grp, Q, d, G, f_rng, p_rng ) );
2813
2814cleanup:
2815 return( ret );
Manuel Pégourié-Gonnardd9a3f472015-08-11 14:31:03 +02002816}
2817
2818/*
2819 * Generate key pair, wrapper for conventional base point
2820 */
2821int mbedtls_ecp_gen_keypair( mbedtls_ecp_group *grp,
2822 mbedtls_mpi *d, mbedtls_ecp_point *Q,
2823 int (*f_rng)(void *, unsigned char *, size_t),
2824 void *p_rng )
2825{
Hanno Becker4f8e8e52018-12-14 15:08:03 +00002826 ECP_VALIDATE_RET( grp != NULL );
2827 ECP_VALIDATE_RET( d != NULL );
2828 ECP_VALIDATE_RET( Q != NULL );
2829 ECP_VALIDATE_RET( f_rng != NULL );
2830
Manuel Pégourié-Gonnardd9a3f472015-08-11 14:31:03 +02002831 return( mbedtls_ecp_gen_keypair_base( grp, &grp->G, d, Q, f_rng, p_rng ) );
Manuel Pégourié-Gonnard45a035a2013-01-26 14:42:45 +01002832}
Manuel Pégourié-Gonnardefaa31e2012-11-06 21:34:35 +01002833
Manuel Pégourié-Gonnard104ee1d2013-11-30 14:13:16 +01002834/*
2835 * Generate a keypair, prettier wrapper
2836 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002837int mbedtls_ecp_gen_key( mbedtls_ecp_group_id grp_id, mbedtls_ecp_keypair *key,
Manuel Pégourié-Gonnard104ee1d2013-11-30 14:13:16 +01002838 int (*f_rng)(void *, unsigned char *, size_t), void *p_rng )
2839{
2840 int ret;
Hanno Becker4f8e8e52018-12-14 15:08:03 +00002841 ECP_VALIDATE_RET( key != NULL );
2842 ECP_VALIDATE_RET( f_rng != NULL );
Manuel Pégourié-Gonnard104ee1d2013-11-30 14:13:16 +01002843
Manuel Pégourié-Gonnarde3a062b2015-05-11 18:46:47 +02002844 if( ( ret = mbedtls_ecp_group_load( &key->grp, grp_id ) ) != 0 )
Manuel Pégourié-Gonnard104ee1d2013-11-30 14:13:16 +01002845 return( ret );
2846
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002847 return( mbedtls_ecp_gen_keypair( &key->grp, &key->d, &key->Q, f_rng, p_rng ) );
Manuel Pégourié-Gonnard104ee1d2013-11-30 14:13:16 +01002848}
2849
Manuel Pégourié-Gonnard30668d62014-11-06 15:25:32 +01002850/*
2851 * Check a public-private key pair
2852 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002853int mbedtls_ecp_check_pub_priv( const mbedtls_ecp_keypair *pub, const mbedtls_ecp_keypair *prv )
Manuel Pégourié-Gonnard30668d62014-11-06 15:25:32 +01002854{
2855 int ret;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002856 mbedtls_ecp_point Q;
2857 mbedtls_ecp_group grp;
Hanno Becker4f8e8e52018-12-14 15:08:03 +00002858 ECP_VALIDATE_RET( pub != NULL );
2859 ECP_VALIDATE_RET( prv != NULL );
Manuel Pégourié-Gonnard30668d62014-11-06 15:25:32 +01002860
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002861 if( pub->grp.id == MBEDTLS_ECP_DP_NONE ||
Manuel Pégourié-Gonnard30668d62014-11-06 15:25:32 +01002862 pub->grp.id != prv->grp.id ||
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002863 mbedtls_mpi_cmp_mpi( &pub->Q.X, &prv->Q.X ) ||
2864 mbedtls_mpi_cmp_mpi( &pub->Q.Y, &prv->Q.Y ) ||
2865 mbedtls_mpi_cmp_mpi( &pub->Q.Z, &prv->Q.Z ) )
Manuel Pégourié-Gonnard30668d62014-11-06 15:25:32 +01002866 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002867 return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
Manuel Pégourié-Gonnard30668d62014-11-06 15:25:32 +01002868 }
2869
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002870 mbedtls_ecp_point_init( &Q );
2871 mbedtls_ecp_group_init( &grp );
Manuel Pégourié-Gonnard30668d62014-11-06 15:25:32 +01002872
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002873 /* mbedtls_ecp_mul() needs a non-const group... */
2874 mbedtls_ecp_group_copy( &grp, &prv->grp );
Manuel Pégourié-Gonnard30668d62014-11-06 15:25:32 +01002875
2876 /* Also checks d is valid */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002877 MBEDTLS_MPI_CHK( mbedtls_ecp_mul( &grp, &Q, &prv->d, &prv->grp.G, NULL, NULL ) );
Manuel Pégourié-Gonnard30668d62014-11-06 15:25:32 +01002878
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002879 if( mbedtls_mpi_cmp_mpi( &Q.X, &prv->Q.X ) ||
2880 mbedtls_mpi_cmp_mpi( &Q.Y, &prv->Q.Y ) ||
2881 mbedtls_mpi_cmp_mpi( &Q.Z, &prv->Q.Z ) )
Manuel Pégourié-Gonnard30668d62014-11-06 15:25:32 +01002882 {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002883 ret = MBEDTLS_ERR_ECP_BAD_INPUT_DATA;
Manuel Pégourié-Gonnard30668d62014-11-06 15:25:32 +01002884 goto cleanup;
2885 }
2886
2887cleanup:
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002888 mbedtls_ecp_point_free( &Q );
2889 mbedtls_ecp_group_free( &grp );
Manuel Pégourié-Gonnard30668d62014-11-06 15:25:32 +01002890
2891 return( ret );
2892}
2893
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002894#if defined(MBEDTLS_SELF_TEST)
Manuel Pégourié-Gonnard39d2adb2012-10-31 09:26:55 +01002895
Manuel Pégourié-Gonnardb505c272012-11-05 17:27:54 +01002896/*
Manuel Pégourié-Gonnard39d2adb2012-10-31 09:26:55 +01002897 * Checkup routine
2898 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002899int mbedtls_ecp_self_test( int verbose )
Manuel Pégourié-Gonnard39d2adb2012-10-31 09:26:55 +01002900{
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +01002901 int ret;
2902 size_t i;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002903 mbedtls_ecp_group grp;
2904 mbedtls_ecp_point R, P;
2905 mbedtls_mpi m;
Manuel Pégourié-Gonnard91814812013-11-21 20:23:55 +01002906 unsigned long add_c_prev, dbl_c_prev, mul_c_prev;
Manuel Pégourié-Gonnardb8012fc2013-10-10 15:40:49 +02002907 /* exponents especially adapted for secp192r1 */
Paul Bakkerb6c5d2e2013-06-25 16:25:17 +02002908 const char *exponents[] =
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +01002909 {
Manuel Pégourié-Gonnardb63f9e92012-11-21 13:00:58 +01002910 "000000000000000000000000000000000000000000000001", /* one */
Manuel Pégourié-Gonnardff27b7c2013-11-21 09:28:03 +01002911 "FFFFFFFFFFFFFFFFFFFFFFFF99DEF836146BC9B1B4D22830", /* N - 1 */
Manuel Pégourié-Gonnardb63f9e92012-11-21 13:00:58 +01002912 "5EA6F389A38B8BC81E767753B15AA5569E1782E30ABE7D25", /* random */
Manuel Pégourié-Gonnardff27b7c2013-11-21 09:28:03 +01002913 "400000000000000000000000000000000000000000000000", /* one and zeros */
2914 "7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF", /* all ones */
2915 "555555555555555555555555555555555555555555555555", /* 101010... */
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +01002916 };
2917
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002918 mbedtls_ecp_group_init( &grp );
2919 mbedtls_ecp_point_init( &R );
2920 mbedtls_ecp_point_init( &P );
2921 mbedtls_mpi_init( &m );
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +01002922
Manuel Pégourié-Gonnardb8012fc2013-10-10 15:40:49 +02002923 /* Use secp192r1 if available, or any available curve */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002924#if defined(MBEDTLS_ECP_DP_SECP192R1_ENABLED)
Manuel Pégourié-Gonnarde3a062b2015-05-11 18:46:47 +02002925 MBEDTLS_MPI_CHK( mbedtls_ecp_group_load( &grp, MBEDTLS_ECP_DP_SECP192R1 ) );
Paul Bakker5dc6b5f2013-06-29 23:26:34 +02002926#else
Manuel Pégourié-Gonnarde3a062b2015-05-11 18:46:47 +02002927 MBEDTLS_MPI_CHK( mbedtls_ecp_group_load( &grp, mbedtls_ecp_curve_list()->grp_id ) );
Manuel Pégourié-Gonnardb8012fc2013-10-10 15:40:49 +02002928#endif
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +01002929
2930 if( verbose != 0 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002931 mbedtls_printf( " ECP test #1 (constant op_count, base point G): " );
Manuel Pégourié-Gonnard161ef962013-09-17 19:13:10 +02002932
2933 /* Do a dummy multiplication first to trigger precomputation */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002934 MBEDTLS_MPI_CHK( mbedtls_mpi_lset( &m, 2 ) );
2935 MBEDTLS_MPI_CHK( mbedtls_ecp_mul( &grp, &P, &m, &grp.G, NULL, NULL ) );
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +01002936
2937 add_count = 0;
2938 dbl_count = 0;
Manuel Pégourié-Gonnard91814812013-11-21 20:23:55 +01002939 mul_count = 0;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002940 MBEDTLS_MPI_CHK( mbedtls_mpi_read_string( &m, 16, exponents[0] ) );
2941 MBEDTLS_MPI_CHK( mbedtls_ecp_mul( &grp, &R, &m, &grp.G, NULL, NULL ) );
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +01002942
2943 for( i = 1; i < sizeof( exponents ) / sizeof( exponents[0] ); i++ )
2944 {
2945 add_c_prev = add_count;
2946 dbl_c_prev = dbl_count;
Manuel Pégourié-Gonnard91814812013-11-21 20:23:55 +01002947 mul_c_prev = mul_count;
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +01002948 add_count = 0;
2949 dbl_count = 0;
Manuel Pégourié-Gonnard91814812013-11-21 20:23:55 +01002950 mul_count = 0;
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +01002951
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002952 MBEDTLS_MPI_CHK( mbedtls_mpi_read_string( &m, 16, exponents[i] ) );
2953 MBEDTLS_MPI_CHK( mbedtls_ecp_mul( &grp, &R, &m, &grp.G, NULL, NULL ) );
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +01002954
Manuel Pégourié-Gonnard91814812013-11-21 20:23:55 +01002955 if( add_count != add_c_prev ||
2956 dbl_count != dbl_c_prev ||
2957 mul_count != mul_c_prev )
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +01002958 {
2959 if( verbose != 0 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002960 mbedtls_printf( "failed (%u)\n", (unsigned int) i );
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +01002961
2962 ret = 1;
2963 goto cleanup;
2964 }
2965 }
2966
2967 if( verbose != 0 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002968 mbedtls_printf( "passed\n" );
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +01002969
Manuel Pégourié-Gonnard161ef962013-09-17 19:13:10 +02002970 if( verbose != 0 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002971 mbedtls_printf( " ECP test #2 (constant op_count, other point): " );
Manuel Pégourié-Gonnard161ef962013-09-17 19:13:10 +02002972 /* We computed P = 2G last time, use it */
2973
2974 add_count = 0;
2975 dbl_count = 0;
Manuel Pégourié-Gonnard91814812013-11-21 20:23:55 +01002976 mul_count = 0;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002977 MBEDTLS_MPI_CHK( mbedtls_mpi_read_string( &m, 16, exponents[0] ) );
2978 MBEDTLS_MPI_CHK( mbedtls_ecp_mul( &grp, &R, &m, &P, NULL, NULL ) );
Manuel Pégourié-Gonnard161ef962013-09-17 19:13:10 +02002979
2980 for( i = 1; i < sizeof( exponents ) / sizeof( exponents[0] ); i++ )
2981 {
2982 add_c_prev = add_count;
2983 dbl_c_prev = dbl_count;
Manuel Pégourié-Gonnard91814812013-11-21 20:23:55 +01002984 mul_c_prev = mul_count;
Manuel Pégourié-Gonnard161ef962013-09-17 19:13:10 +02002985 add_count = 0;
2986 dbl_count = 0;
Manuel Pégourié-Gonnard91814812013-11-21 20:23:55 +01002987 mul_count = 0;
Manuel Pégourié-Gonnard161ef962013-09-17 19:13:10 +02002988
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002989 MBEDTLS_MPI_CHK( mbedtls_mpi_read_string( &m, 16, exponents[i] ) );
2990 MBEDTLS_MPI_CHK( mbedtls_ecp_mul( &grp, &R, &m, &P, NULL, NULL ) );
Manuel Pégourié-Gonnard161ef962013-09-17 19:13:10 +02002991
Manuel Pégourié-Gonnard91814812013-11-21 20:23:55 +01002992 if( add_count != add_c_prev ||
2993 dbl_count != dbl_c_prev ||
2994 mul_count != mul_c_prev )
Manuel Pégourié-Gonnard161ef962013-09-17 19:13:10 +02002995 {
2996 if( verbose != 0 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002997 mbedtls_printf( "failed (%u)\n", (unsigned int) i );
Manuel Pégourié-Gonnard161ef962013-09-17 19:13:10 +02002998
2999 ret = 1;
3000 goto cleanup;
3001 }
3002 }
3003
3004 if( verbose != 0 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003005 mbedtls_printf( "passed\n" );
Manuel Pégourié-Gonnard161ef962013-09-17 19:13:10 +02003006
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +01003007cleanup:
3008
3009 if( ret < 0 && verbose != 0 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003010 mbedtls_printf( "Unexpected error, return code = %08X\n", ret );
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +01003011
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003012 mbedtls_ecp_group_free( &grp );
3013 mbedtls_ecp_point_free( &R );
3014 mbedtls_ecp_point_free( &P );
3015 mbedtls_mpi_free( &m );
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +01003016
3017 if( verbose != 0 )
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003018 mbedtls_printf( "\n" );
Manuel Pégourié-Gonnardb4a310b2012-11-13 20:57:00 +01003019
3020 return( ret );
Manuel Pégourié-Gonnard39d2adb2012-10-31 09:26:55 +01003021}
3022
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003023#endif /* MBEDTLS_SELF_TEST */
Manuel Pégourié-Gonnard39d2adb2012-10-31 09:26:55 +01003024
Janos Follathb0697532016-08-18 12:38:46 +01003025#endif /* !MBEDTLS_ECP_ALT */
3026
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003027#endif /* MBEDTLS_ECP_C */