xref: /aosp_15_r20/external/mbedtls/3rdparty/everest/library/x25519.c (revision 62c56f9862f102b96d72393aff6076c951fb8148)
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