blob: 83064dc61945b3dd7c342874bcd0f91402e9d72d [file] [log] [blame]
Christoph M. Wintersteigerde4fcf22018-10-25 12:41:04 +01001/*
2 * ECDH with curve-optimized implementation multiplexing
3 *
4 * Copyright 2016-2018 INRIA and Microsoft Corporation
5 * 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.
18 *
Gilles Peskinee820c0a2023-08-03 17:45:20 +020019 * This file is part of Mbed TLS (https://tls.mbed.org)
Christoph M. Wintersteigerde4fcf22018-10-25 12:41:04 +010020 */
21
Gilles Peskinedb09ef62020-06-03 01:43:33 +020022#include "common.h"
Christoph M. Wintersteigerde4fcf22018-10-25 12:41:04 +010023
Christoph M. Wintersteiger6e0cac12019-02-22 17:02:12 +000024#if defined(MBEDTLS_ECDH_C) && defined(MBEDTLS_ECDH_VARIANT_EVEREST_ENABLED)
Christoph M. Wintersteigerde4fcf22018-10-25 12:41:04 +010025
Christoph M. Wintersteiger4936beb2018-12-12 17:26:41 +000026#include <mbedtls/ecdh.h>
27
Christoph M. Wintersteiger6e0cac12019-02-22 17:02:12 +000028#if !(defined(__SIZEOF_INT128__) && (__SIZEOF_INT128__ == 16))
29#define KRML_VERIFIED_UINT128
30#endif
31
Christoph M. Wintersteigerde4fcf22018-10-25 12:41:04 +010032#include <Hacl_Curve25519.h>
33#include <mbedtls/platform_util.h>
34
35#include "x25519.h"
36
37#include <string.h>
38
39/*
40 * Initialize context
41 */
42void mbedtls_x25519_init( mbedtls_x25519_context *ctx )
43{
Christoph M. Wintersteiger088ef492019-02-15 16:25:48 +000044 mbedtls_platform_zeroize( ctx, sizeof( mbedtls_x25519_context ) );
Christoph M. Wintersteigerde4fcf22018-10-25 12:41:04 +010045}
46
47/*
48 * Free context
49 */
50void mbedtls_x25519_free( mbedtls_x25519_context *ctx )
51{
52 if( ctx == NULL )
53 return;
54
Christoph M. Wintersteigerfb779f12019-02-15 16:20:54 +000055 mbedtls_platform_zeroize( ctx->our_secret, MBEDTLS_X25519_KEY_SIZE_BYTES );
56 mbedtls_platform_zeroize( ctx->peer_point, MBEDTLS_X25519_KEY_SIZE_BYTES );
Christoph M. Wintersteigerde4fcf22018-10-25 12:41:04 +010057}
58
59int mbedtls_x25519_make_params( mbedtls_x25519_context *ctx, size_t *olen,
60 unsigned char *buf, size_t blen,
61 int( *f_rng )(void *, unsigned char *, size_t),
62 void *p_rng )
63{
64 int ret = 0;
65
Christoph M. Wintersteigerfb779f12019-02-15 16:20:54 +000066 uint8_t base[MBEDTLS_X25519_KEY_SIZE_BYTES] = {0};
Christoph M. Wintersteigerde4fcf22018-10-25 12:41:04 +010067
Christoph M. Wintersteigerfb779f12019-02-15 16:20:54 +000068 if( ( ret = f_rng( p_rng, ctx->our_secret, MBEDTLS_X25519_KEY_SIZE_BYTES ) ) != 0 )
Christoph M. Wintersteigerde4fcf22018-10-25 12:41:04 +010069 return ret;
70
Christoph M. Wintersteiger85929582019-02-18 13:20:33 +000071 *olen = MBEDTLS_X25519_KEY_SIZE_BYTES + 4;
Christoph M. Wintersteigerde4fcf22018-10-25 12:41:04 +010072 if( blen < *olen )
73 return( MBEDTLS_ERR_ECP_BUFFER_TOO_SMALL );
74
75 *buf++ = MBEDTLS_ECP_TLS_NAMED_CURVE;
76 *buf++ = MBEDTLS_ECP_TLS_CURVE25519 >> 8;
77 *buf++ = MBEDTLS_ECP_TLS_CURVE25519 & 0xFF;
Christoph M. Wintersteigerfb779f12019-02-15 16:20:54 +000078 *buf++ = MBEDTLS_X25519_KEY_SIZE_BYTES;
Christoph M. Wintersteigerde4fcf22018-10-25 12:41:04 +010079
80 base[0] = 9;
81 Hacl_Curve25519_crypto_scalarmult( buf, ctx->our_secret, base );
82
83 base[0] = 0;
Christoph M. Wintersteigerfb779f12019-02-15 16:20:54 +000084 if( memcmp( buf, base, MBEDTLS_X25519_KEY_SIZE_BYTES) == 0 )
Christoph M. Wintersteigerde4fcf22018-10-25 12:41:04 +010085 return MBEDTLS_ERR_ECP_RANDOM_FAILED;
86
87 return( 0 );
88}
89
90int mbedtls_x25519_read_params( mbedtls_x25519_context *ctx,
91 const unsigned char **buf, const unsigned char *end )
92{
Christoph M. Wintersteiger85929582019-02-18 13:20:33 +000093 if( end - *buf < MBEDTLS_X25519_KEY_SIZE_BYTES + 1 )
Christoph M. Wintersteigerde4fcf22018-10-25 12:41:04 +010094 return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
95
Christoph M. Wintersteigerfb779f12019-02-15 16:20:54 +000096 if( ( *(*buf)++ != MBEDTLS_X25519_KEY_SIZE_BYTES ) )
Christoph M. Wintersteigerde4fcf22018-10-25 12:41:04 +010097 return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
98
Christoph M. Wintersteigerfb779f12019-02-15 16:20:54 +000099 memcpy( ctx->peer_point, *buf, MBEDTLS_X25519_KEY_SIZE_BYTES );
100 *buf += MBEDTLS_X25519_KEY_SIZE_BYTES;
Christoph M. Wintersteigerde4fcf22018-10-25 12:41:04 +0100101 return( 0 );
102}
103
104int mbedtls_x25519_get_params( mbedtls_x25519_context *ctx, const mbedtls_ecp_keypair *key,
Christoph M. Wintersteiger4936beb2018-12-12 17:26:41 +0000105 mbedtls_x25519_ecdh_side side )
Christoph M. Wintersteigerde4fcf22018-10-25 12:41:04 +0100106{
107 size_t olen = 0;
108
109 switch( side ) {
Christoph M. Wintersteiger4936beb2018-12-12 17:26:41 +0000110 case MBEDTLS_X25519_ECDH_THEIRS:
Christoph M. Wintersteiger0969eee2019-04-15 12:00:16 +0100111 return mbedtls_ecp_point_write_binary( &key->grp, &key->Q, MBEDTLS_ECP_PF_COMPRESSED, &olen, ctx->peer_point, MBEDTLS_X25519_KEY_SIZE_BYTES );
Christoph M. Wintersteiger4936beb2018-12-12 17:26:41 +0000112 case MBEDTLS_X25519_ECDH_OURS:
Christoph M. Wintersteiger0969eee2019-04-15 12:00:16 +0100113 return mbedtls_mpi_write_binary_le( &key->d, ctx->our_secret, MBEDTLS_X25519_KEY_SIZE_BYTES );
Christoph M. Wintersteigerde4fcf22018-10-25 12:41:04 +0100114 default:
115 return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
116 }
117}
118
119int mbedtls_x25519_calc_secret( mbedtls_x25519_context *ctx, size_t *olen,
120 unsigned char *buf, size_t blen,
121 int( *f_rng )(void *, unsigned char *, size_t),
122 void *p_rng )
123{
Christoph M. Wintersteiger537f41e2019-02-15 16:50:54 +0000124 /* f_rng and p_rng are not used here because this implementation does not
125 need blinding since it has constant trace. */
Christoph M. Wintersteigerde4fcf22018-10-25 12:41:04 +0100126 (( void )f_rng);
127 (( void )p_rng);
128
Christoph M. Wintersteigerfb779f12019-02-15 16:20:54 +0000129 *olen = MBEDTLS_X25519_KEY_SIZE_BYTES;
Christoph M. Wintersteigerde4fcf22018-10-25 12:41:04 +0100130
131 if( blen < *olen )
132 return( MBEDTLS_ERR_ECP_BUFFER_TOO_SMALL );
133
134 Hacl_Curve25519_crypto_scalarmult( buf, ctx->our_secret, ctx->peer_point);
135
136 /* Wipe the DH secret and don't let the peer chose a small subgroup point */
Christoph M. Wintersteiger088ef492019-02-15 16:25:48 +0000137 mbedtls_platform_zeroize( ctx->our_secret, MBEDTLS_X25519_KEY_SIZE_BYTES );
138
Christoph M. Wintersteigerfb779f12019-02-15 16:20:54 +0000139 if( memcmp( buf, ctx->our_secret, MBEDTLS_X25519_KEY_SIZE_BYTES) == 0 )
Christoph M. Wintersteigerde4fcf22018-10-25 12:41:04 +0100140 return MBEDTLS_ERR_ECP_RANDOM_FAILED;
141
142 return( 0 );
143}
144
145int mbedtls_x25519_make_public( mbedtls_x25519_context *ctx, size_t *olen,
146 unsigned char *buf, size_t blen,
147 int( *f_rng )(void *, unsigned char *, size_t),
148 void *p_rng )
149{
Christoph M. Wintersteigerefdf4d72019-02-15 17:21:04 +0000150 int ret = 0;
Christoph M. Wintersteigerfb779f12019-02-15 16:20:54 +0000151 unsigned char base[MBEDTLS_X25519_KEY_SIZE_BYTES] = { 0 };
Christoph M. Wintersteigerde4fcf22018-10-25 12:41:04 +0100152
Christoph M. Wintersteigerde4fcf22018-10-25 12:41:04 +0100153 if( ctx == NULL )
Christoph M. Wintersteigerefdf4d72019-02-15 17:21:04 +0000154 return( MBEDTLS_ERR_ECP_BAD_INPUT_DATA );
155
156 if( ( ret = f_rng( p_rng, ctx->our_secret, MBEDTLS_X25519_KEY_SIZE_BYTES ) ) != 0 )
157 return ret;
Christoph M. Wintersteigerde4fcf22018-10-25 12:41:04 +0100158
Christoph M. Wintersteiger85929582019-02-18 13:20:33 +0000159 *olen = MBEDTLS_X25519_KEY_SIZE_BYTES + 1;
Christoph M. Wintersteigerde4fcf22018-10-25 12:41:04 +0100160 if( blen < *olen )
161 return(MBEDTLS_ERR_ECP_BUFFER_TOO_SMALL);
Christoph M. Wintersteigerfb779f12019-02-15 16:20:54 +0000162 *buf++ = MBEDTLS_X25519_KEY_SIZE_BYTES;
Christoph M. Wintersteigerde4fcf22018-10-25 12:41:04 +0100163
164 base[0] = 9;
165 Hacl_Curve25519_crypto_scalarmult( buf, ctx->our_secret, base );
166
167 base[0] = 0;
Christoph M. Wintersteigerfb779f12019-02-15 16:20:54 +0000168 if( memcmp( buf, base, MBEDTLS_X25519_KEY_SIZE_BYTES ) == 0 )
Christoph M. Wintersteigerde4fcf22018-10-25 12:41:04 +0100169 return MBEDTLS_ERR_ECP_RANDOM_FAILED;
170
Christoph M. Wintersteigerefdf4d72019-02-15 17:21:04 +0000171 return( ret );
Christoph M. Wintersteigerde4fcf22018-10-25 12:41:04 +0100172}
173
174int mbedtls_x25519_read_public( mbedtls_x25519_context *ctx,
175 const unsigned char *buf, size_t blen )
176{
Christoph M. Wintersteiger85929582019-02-18 13:20:33 +0000177 if( blen < MBEDTLS_X25519_KEY_SIZE_BYTES + 1 )
Christoph M. Wintersteigerde4fcf22018-10-25 12:41:04 +0100178 return(MBEDTLS_ERR_ECP_BUFFER_TOO_SMALL);
Christoph M. Wintersteigerfb779f12019-02-15 16:20:54 +0000179 if( (*buf++ != MBEDTLS_X25519_KEY_SIZE_BYTES) )
Christoph M. Wintersteigerde4fcf22018-10-25 12:41:04 +0100180 return(MBEDTLS_ERR_ECP_BAD_INPUT_DATA);
Christoph M. Wintersteigerfb779f12019-02-15 16:20:54 +0000181 memcpy( ctx->peer_point, buf, MBEDTLS_X25519_KEY_SIZE_BYTES );
Christoph M. Wintersteigerefdf4d72019-02-15 17:21:04 +0000182 return( 0 );
Christoph M. Wintersteigerde4fcf22018-10-25 12:41:04 +0100183}
184
185
Christoph M. Wintersteiger6e0cac12019-02-22 17:02:12 +0000186#endif /* MBEDTLS_ECDH_C && MBEDTLS_ECDH_VARIANT_EVEREST_ENABLED */