1*62c56f98SSadaf Ebrahimi /*
2*62c56f98SSadaf Ebrahimi * ECDH with curve-optimized implementation multiplexing
3*62c56f98SSadaf Ebrahimi *
4*62c56f98SSadaf Ebrahimi * Copyright 2016-2018 INRIA and Microsoft Corporation
5*62c56f98SSadaf Ebrahimi * SPDX-License-Identifier: Apache-2.0
6*62c56f98SSadaf Ebrahimi *
7*62c56f98SSadaf Ebrahimi * Licensed under the Apache License, Version 2.0 (the "License"); you may
8*62c56f98SSadaf Ebrahimi * not use this file except in compliance with the License.
9*62c56f98SSadaf Ebrahimi * You may obtain a copy of the License at
10*62c56f98SSadaf Ebrahimi *
11*62c56f98SSadaf Ebrahimi * http://www.apache.org/licenses/LICENSE-2.0
12*62c56f98SSadaf Ebrahimi *
13*62c56f98SSadaf Ebrahimi * Unless required by applicable law or agreed to in writing, software
14*62c56f98SSadaf Ebrahimi * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
15*62c56f98SSadaf Ebrahimi * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16*62c56f98SSadaf Ebrahimi * See the License for the specific language governing permissions and
17*62c56f98SSadaf Ebrahimi * limitations under the License.
18*62c56f98SSadaf Ebrahimi *
19*62c56f98SSadaf Ebrahimi * This file is part of Mbed TLS (https://tls.mbed.org)
20*62c56f98SSadaf Ebrahimi */
21*62c56f98SSadaf Ebrahimi
22*62c56f98SSadaf Ebrahimi #include "common.h"
23*62c56f98SSadaf Ebrahimi
24*62c56f98SSadaf Ebrahimi #if defined(MBEDTLS_ECDH_C) && defined(MBEDTLS_ECDH_VARIANT_EVEREST_ENABLED)
25*62c56f98SSadaf Ebrahimi
26*62c56f98SSadaf Ebrahimi #include <mbedtls/ecdh.h>
27*62c56f98SSadaf Ebrahimi
28*62c56f98SSadaf Ebrahimi #if !(defined(__SIZEOF_INT128__) && (__SIZEOF_INT128__ == 16))
29*62c56f98SSadaf Ebrahimi #define KRML_VERIFIED_UINT128
30*62c56f98SSadaf Ebrahimi #endif
31*62c56f98SSadaf Ebrahimi
32*62c56f98SSadaf Ebrahimi #include <Hacl_Curve25519.h>
33*62c56f98SSadaf Ebrahimi #include <mbedtls/platform_util.h>
34*62c56f98SSadaf Ebrahimi
35*62c56f98SSadaf Ebrahimi #include "x25519.h"
36*62c56f98SSadaf Ebrahimi
37*62c56f98SSadaf Ebrahimi #include <string.h>
38*62c56f98SSadaf Ebrahimi
39*62c56f98SSadaf Ebrahimi /*
40*62c56f98SSadaf Ebrahimi * Initialize context
41*62c56f98SSadaf Ebrahimi */
mbedtls_x25519_init(mbedtls_x25519_context * ctx)42*62c56f98SSadaf Ebrahimi void mbedtls_x25519_init( mbedtls_x25519_context *ctx )
43*62c56f98SSadaf Ebrahimi {
44*62c56f98SSadaf Ebrahimi mbedtls_platform_zeroize( ctx, sizeof( mbedtls_x25519_context ) );
45*62c56f98SSadaf Ebrahimi }
46*62c56f98SSadaf Ebrahimi
47*62c56f98SSadaf Ebrahimi /*
48*62c56f98SSadaf Ebrahimi * Free context
49*62c56f98SSadaf Ebrahimi */
mbedtls_x25519_free(mbedtls_x25519_context * ctx)50*62c56f98SSadaf Ebrahimi void mbedtls_x25519_free( mbedtls_x25519_context *ctx )
51*62c56f98SSadaf Ebrahimi {
52*62c56f98SSadaf Ebrahimi if( ctx == NULL )
53*62c56f98SSadaf Ebrahimi return;
54*62c56f98SSadaf Ebrahimi
55*62c56f98SSadaf Ebrahimi mbedtls_platform_zeroize( ctx->our_secret, MBEDTLS_X25519_KEY_SIZE_BYTES );
56*62c56f98SSadaf Ebrahimi mbedtls_platform_zeroize( ctx->peer_point, MBEDTLS_X25519_KEY_SIZE_BYTES );
57*62c56f98SSadaf Ebrahimi }
58*62c56f98SSadaf Ebrahimi
mbedtls_x25519_make_params(mbedtls_x25519_context * ctx,size_t * olen,unsigned char * buf,size_t blen,int (* f_rng)(void *,unsigned char *,size_t),void * p_rng)59*62c56f98SSadaf Ebrahimi int mbedtls_x25519_make_params( mbedtls_x25519_context *ctx, size_t *olen,
60*62c56f98SSadaf Ebrahimi unsigned char *buf, size_t blen,
61*62c56f98SSadaf Ebrahimi int( *f_rng )(void *, unsigned char *, size_t),
62*62c56f98SSadaf Ebrahimi void *p_rng )
63*62c56f98SSadaf Ebrahimi {
64*62c56f98SSadaf Ebrahimi int ret = 0;
65*62c56f98SSadaf Ebrahimi
66*62c56f98SSadaf Ebrahimi uint8_t base[MBEDTLS_X25519_KEY_SIZE_BYTES] = {0};
67*62c56f98SSadaf Ebrahimi
68*62c56f98SSadaf Ebrahimi if( ( ret = f_rng( p_rng, ctx->our_secret, MBEDTLS_X25519_KEY_SIZE_BYTES ) ) != 0 )
69*62c56f98SSadaf Ebrahimi return ret;
70*62c56f98SSadaf Ebrahimi
71*62c56f98SSadaf Ebrahimi *olen = MBEDTLS_X25519_KEY_SIZE_BYTES + 4;
72*62c56f98SSadaf Ebrahimi if( blen < *olen )
73*62c56f98SSadaf Ebrahimi return( MBEDTLS_ERR_ECP_BUFFER_TOO_SMALL );
74*62c56f98SSadaf Ebrahimi
75*62c56f98SSadaf Ebrahimi *buf++ = MBEDTLS_ECP_TLS_NAMED_CURVE;
76*62c56f98SSadaf Ebrahimi *buf++ = MBEDTLS_ECP_TLS_CURVE25519 >> 8;
77*62c56f98SSadaf Ebrahimi *buf++ = MBEDTLS_ECP_TLS_CURVE25519 & 0xFF;
78*62c56f98SSadaf Ebrahimi *buf++ = MBEDTLS_X25519_KEY_SIZE_BYTES;
79*62c56f98SSadaf Ebrahimi
80*62c56f98SSadaf Ebrahimi base[0] = 9;
81*62c56f98SSadaf Ebrahimi Hacl_Curve25519_crypto_scalarmult( buf, ctx->our_secret, base );
82*62c56f98SSadaf Ebrahimi
83*62c56f98SSadaf Ebrahimi base[0] = 0;
84*62c56f98SSadaf Ebrahimi if( memcmp( buf, base, MBEDTLS_X25519_KEY_SIZE_BYTES) == 0 )
85*62c56f98SSadaf Ebrahimi return MBEDTLS_ERR_ECP_RANDOM_FAILED;
86*62c56f98SSadaf Ebrahimi
87*62c56f98SSadaf Ebrahimi return( 0 );
88*62c56f98SSadaf Ebrahimi }
89*62c56f98SSadaf Ebrahimi
mbedtls_x25519_read_params(mbedtls_x25519_context * ctx,const unsigned char ** buf,const unsigned char * end)90*62c56f98SSadaf Ebrahimi int mbedtls_x25519_read_params( mbedtls_x25519_context *ctx,
91*62c56f98SSadaf Ebrahimi const unsigned char **buf, const unsigned char *end )
92*62c56f98SSadaf Ebrahimi {
93*62c56f98SSadaf Ebrahimi if( end - *buf < MBEDTLS_X25519_KEY_SIZE_BYTES + 1 )
94*62c56f98SSadaf Ebrahimi return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
95*62c56f98SSadaf Ebrahimi
96*62c56f98SSadaf Ebrahimi if( ( *(*buf)++ != MBEDTLS_X25519_KEY_SIZE_BYTES ) )
97*62c56f98SSadaf Ebrahimi return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
98*62c56f98SSadaf Ebrahimi
99*62c56f98SSadaf Ebrahimi memcpy( ctx->peer_point, *buf, MBEDTLS_X25519_KEY_SIZE_BYTES );
100*62c56f98SSadaf Ebrahimi *buf += MBEDTLS_X25519_KEY_SIZE_BYTES;
101*62c56f98SSadaf Ebrahimi return( 0 );
102*62c56f98SSadaf Ebrahimi }
103*62c56f98SSadaf Ebrahimi
mbedtls_x25519_get_params(mbedtls_x25519_context * ctx,const mbedtls_ecp_keypair * key,mbedtls_x25519_ecdh_side side)104*62c56f98SSadaf Ebrahimi int mbedtls_x25519_get_params( mbedtls_x25519_context *ctx, const mbedtls_ecp_keypair *key,
105*62c56f98SSadaf Ebrahimi mbedtls_x25519_ecdh_side side )
106*62c56f98SSadaf Ebrahimi {
107*62c56f98SSadaf Ebrahimi size_t olen = 0;
108*62c56f98SSadaf Ebrahimi
109*62c56f98SSadaf Ebrahimi switch( side ) {
110*62c56f98SSadaf Ebrahimi case MBEDTLS_X25519_ECDH_THEIRS:
111*62c56f98SSadaf Ebrahimi return mbedtls_ecp_point_write_binary( &key->grp, &key->Q, MBEDTLS_ECP_PF_COMPRESSED, &olen, ctx->peer_point, MBEDTLS_X25519_KEY_SIZE_BYTES );
112*62c56f98SSadaf Ebrahimi case MBEDTLS_X25519_ECDH_OURS:
113*62c56f98SSadaf Ebrahimi return mbedtls_mpi_write_binary_le( &key->d, ctx->our_secret, MBEDTLS_X25519_KEY_SIZE_BYTES );
114*62c56f98SSadaf Ebrahimi default:
115*62c56f98SSadaf Ebrahimi return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
116*62c56f98SSadaf Ebrahimi }
117*62c56f98SSadaf Ebrahimi }
118*62c56f98SSadaf Ebrahimi
mbedtls_x25519_calc_secret(mbedtls_x25519_context * ctx,size_t * olen,unsigned char * buf,size_t blen,int (* f_rng)(void *,unsigned char *,size_t),void * p_rng)119*62c56f98SSadaf Ebrahimi int mbedtls_x25519_calc_secret( mbedtls_x25519_context *ctx, size_t *olen,
120*62c56f98SSadaf Ebrahimi unsigned char *buf, size_t blen,
121*62c56f98SSadaf Ebrahimi int( *f_rng )(void *, unsigned char *, size_t),
122*62c56f98SSadaf Ebrahimi void *p_rng )
123*62c56f98SSadaf Ebrahimi {
124*62c56f98SSadaf Ebrahimi /* f_rng and p_rng are not used here because this implementation does not
125*62c56f98SSadaf Ebrahimi need blinding since it has constant trace. */
126*62c56f98SSadaf Ebrahimi (( void )f_rng);
127*62c56f98SSadaf Ebrahimi (( void )p_rng);
128*62c56f98SSadaf Ebrahimi
129*62c56f98SSadaf Ebrahimi *olen = MBEDTLS_X25519_KEY_SIZE_BYTES;
130*62c56f98SSadaf Ebrahimi
131*62c56f98SSadaf Ebrahimi if( blen < *olen )
132*62c56f98SSadaf Ebrahimi return( MBEDTLS_ERR_ECP_BUFFER_TOO_SMALL );
133*62c56f98SSadaf Ebrahimi
134*62c56f98SSadaf Ebrahimi Hacl_Curve25519_crypto_scalarmult( buf, ctx->our_secret, ctx->peer_point);
135*62c56f98SSadaf Ebrahimi
136*62c56f98SSadaf Ebrahimi /* Wipe the DH secret and don't let the peer chose a small subgroup point */
137*62c56f98SSadaf Ebrahimi mbedtls_platform_zeroize( ctx->our_secret, MBEDTLS_X25519_KEY_SIZE_BYTES );
138*62c56f98SSadaf Ebrahimi
139*62c56f98SSadaf Ebrahimi if( memcmp( buf, ctx->our_secret, MBEDTLS_X25519_KEY_SIZE_BYTES) == 0 )
140*62c56f98SSadaf Ebrahimi return MBEDTLS_ERR_ECP_RANDOM_FAILED;
141*62c56f98SSadaf Ebrahimi
142*62c56f98SSadaf Ebrahimi return( 0 );
143*62c56f98SSadaf Ebrahimi }
144*62c56f98SSadaf Ebrahimi
mbedtls_x25519_make_public(mbedtls_x25519_context * ctx,size_t * olen,unsigned char * buf,size_t blen,int (* f_rng)(void *,unsigned char *,size_t),void * p_rng)145*62c56f98SSadaf Ebrahimi int mbedtls_x25519_make_public( mbedtls_x25519_context *ctx, size_t *olen,
146*62c56f98SSadaf Ebrahimi unsigned char *buf, size_t blen,
147*62c56f98SSadaf Ebrahimi int( *f_rng )(void *, unsigned char *, size_t),
148*62c56f98SSadaf Ebrahimi void *p_rng )
149*62c56f98SSadaf Ebrahimi {
150*62c56f98SSadaf Ebrahimi int ret = 0;
151*62c56f98SSadaf Ebrahimi unsigned char base[MBEDTLS_X25519_KEY_SIZE_BYTES] = { 0 };
152*62c56f98SSadaf Ebrahimi
153*62c56f98SSadaf Ebrahimi if( ctx == NULL )
154*62c56f98SSadaf Ebrahimi return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
155*62c56f98SSadaf Ebrahimi
156*62c56f98SSadaf Ebrahimi if( ( ret = f_rng( p_rng, ctx->our_secret, MBEDTLS_X25519_KEY_SIZE_BYTES ) ) != 0 )
157*62c56f98SSadaf Ebrahimi return ret;
158*62c56f98SSadaf Ebrahimi
159*62c56f98SSadaf Ebrahimi *olen = MBEDTLS_X25519_KEY_SIZE_BYTES + 1;
160*62c56f98SSadaf Ebrahimi if( blen < *olen )
161*62c56f98SSadaf Ebrahimi return(MBEDTLS_ERR_ECP_BUFFER_TOO_SMALL);
162*62c56f98SSadaf Ebrahimi *buf++ = MBEDTLS_X25519_KEY_SIZE_BYTES;
163*62c56f98SSadaf Ebrahimi
164*62c56f98SSadaf Ebrahimi base[0] = 9;
165*62c56f98SSadaf Ebrahimi Hacl_Curve25519_crypto_scalarmult( buf, ctx->our_secret, base );
166*62c56f98SSadaf Ebrahimi
167*62c56f98SSadaf Ebrahimi base[0] = 0;
168*62c56f98SSadaf Ebrahimi if( memcmp( buf, base, MBEDTLS_X25519_KEY_SIZE_BYTES ) == 0 )
169*62c56f98SSadaf Ebrahimi return MBEDTLS_ERR_ECP_RANDOM_FAILED;
170*62c56f98SSadaf Ebrahimi
171*62c56f98SSadaf Ebrahimi return( ret );
172*62c56f98SSadaf Ebrahimi }
173*62c56f98SSadaf Ebrahimi
mbedtls_x25519_read_public(mbedtls_x25519_context * ctx,const unsigned char * buf,size_t blen)174*62c56f98SSadaf Ebrahimi int mbedtls_x25519_read_public( mbedtls_x25519_context *ctx,
175*62c56f98SSadaf Ebrahimi const unsigned char *buf, size_t blen )
176*62c56f98SSadaf Ebrahimi {
177*62c56f98SSadaf Ebrahimi if( blen < MBEDTLS_X25519_KEY_SIZE_BYTES + 1 )
178*62c56f98SSadaf Ebrahimi return(MBEDTLS_ERR_ECP_BUFFER_TOO_SMALL);
179*62c56f98SSadaf Ebrahimi if( (*buf++ != MBEDTLS_X25519_KEY_SIZE_BYTES) )
180*62c56f98SSadaf Ebrahimi return(MBEDTLS_ERR_ECP_BAD_INPUT_DATA);
181*62c56f98SSadaf Ebrahimi memcpy( ctx->peer_point, buf, MBEDTLS_X25519_KEY_SIZE_BYTES );
182*62c56f98SSadaf Ebrahimi return( 0 );
183*62c56f98SSadaf Ebrahimi }
184*62c56f98SSadaf Ebrahimi
185*62c56f98SSadaf Ebrahimi
186*62c56f98SSadaf Ebrahimi #endif /* MBEDTLS_ECDH_C && MBEDTLS_ECDH_VARIANT_EVEREST_ENABLED */
187