blob: 2a9f674261bc1aedf81c85e0f2f90b3b9d49ff6c [file] [log] [blame]
gabor-mezei-arm90559722021-07-12 16:31:22 +02001/**
2 * Constant-time functions
3 *
4 * Copyright The Mbed TLS Contributors
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 */
19
Gilles Peskine1b6c09a2023-01-11 14:52:35 +010020/*
Gabor Mezeidbe0f892021-11-03 16:13:32 +010021 * The following functions are implemented without using comparison operators, as those
Gabor Mezei3c38b6e2021-10-18 16:09:41 +020022 * might be translated to branches by some compilers on some platforms.
23 */
24
gabor-mezei-arm90559722021-07-12 16:31:22 +020025#include "common.h"
Gabor Mezeic0ae1cf2021-10-20 12:09:35 +020026#include "constant_time_internal.h"
Gabor Mezeie24dea82021-10-19 12:22:25 +020027#include "mbedtls/constant_time.h"
gabor-mezei-armcb4317b2021-09-27 14:28:31 +020028#include "mbedtls/error.h"
gabor-mezei-armd5a392a2021-09-29 10:50:31 +020029#include "mbedtls/platform_util.h"
gabor-mezei-arm944c1072021-09-27 11:28:54 +020030
gabor-mezei-arm097d4f52021-09-27 12:55:33 +020031#if defined(MBEDTLS_BIGNUM_C)
32#include "mbedtls/bignum.h"
33#endif
34
gabor-mezei-armcb4317b2021-09-27 14:28:31 +020035#if defined(MBEDTLS_SSL_TLS_C)
36#include "mbedtls/ssl_internal.h"
37#endif
38
gabor-mezei-armd5a392a2021-09-29 10:50:31 +020039#if defined(MBEDTLS_RSA_C)
40#include "mbedtls/rsa.h"
41#endif
42
Gabor Mezei46f79c32021-11-15 16:13:01 +010043#if defined(MBEDTLS_BASE64_C)
44#include "constant_time_invasive.h"
45#endif
46
gabor-mezei-armf52941e2021-09-27 16:11:12 +020047#include <string.h>
gabor-mezei-arm097d4f52021-09-27 12:55:33 +020048
Gilles Peskine1b6c09a2023-01-11 14:52:35 +010049int mbedtls_ct_memcmp(const void *a,
50 const void *b,
51 size_t n)
gabor-mezei-arm944c1072021-09-27 11:28:54 +020052{
53 size_t i;
54 volatile const unsigned char *A = (volatile const unsigned char *) a;
55 volatile const unsigned char *B = (volatile const unsigned char *) b;
56 volatile unsigned char diff = 0;
57
Gilles Peskine1b6c09a2023-01-11 14:52:35 +010058 for (i = 0; i < n; i++) {
gabor-mezei-arm944c1072021-09-27 11:28:54 +020059 /* Read volatile data in order before computing diff.
60 * This avoids IAR compiler warning:
61 * 'the order of volatile accesses is undefined ..' */
62 unsigned char x = A[i], y = B[i];
63 diff |= x ^ y;
64 }
65
Gilles Peskine1b6c09a2023-01-11 14:52:35 +010066 return (int) diff;
gabor-mezei-arm944c1072021-09-27 11:28:54 +020067}
68
Gilles Peskine1b6c09a2023-01-11 14:52:35 +010069unsigned mbedtls_ct_uint_mask(unsigned value)
gabor-mezei-armc11cac92021-09-27 11:40:03 +020070{
71 /* MSVC has a warning about unary minus on unsigned, but this is
72 * well-defined and precisely what we want to do here */
73#if defined(_MSC_VER)
74#pragma warning( push )
75#pragma warning( disable : 4146 )
76#endif
Gilles Peskine1b6c09a2023-01-11 14:52:35 +010077 return -((value | -value) >> (sizeof(value) * 8 - 1));
gabor-mezei-armc11cac92021-09-27 11:40:03 +020078#if defined(_MSC_VER)
79#pragma warning( pop )
80#endif
81}
gabor-mezei-armd361ccd2021-09-27 11:49:42 +020082
Przemek Stekiel169554c2022-10-06 10:53:20 +020083#if defined(MBEDTLS_SSL_SOME_MODES_USE_MAC)
Gabor Mezei61bf64f2021-10-20 11:17:43 +020084
Gilles Peskine1b6c09a2023-01-11 14:52:35 +010085size_t mbedtls_ct_size_mask(size_t value)
gabor-mezei-armd361ccd2021-09-27 11:49:42 +020086{
87 /* MSVC has a warning about unary minus on unsigned integer types,
88 * but this is well-defined and precisely what we want to do here. */
89#if defined(_MSC_VER)
90#pragma warning( push )
91#pragma warning( disable : 4146 )
92#endif
Gilles Peskine1b6c09a2023-01-11 14:52:35 +010093 return -((value | -value) >> (sizeof(value) * 8 - 1));
gabor-mezei-armd361ccd2021-09-27 11:49:42 +020094#if defined(_MSC_VER)
95#pragma warning( pop )
96#endif
97}
gabor-mezei-arm4d6b1462021-09-27 11:53:54 +020098
Przemek Stekiel169554c2022-10-06 10:53:20 +020099#endif /* MBEDTLS_SSL_SOME_MODES_USE_MAC */
Gabor Mezei61bf64f2021-10-20 11:17:43 +0200100
gabor-mezei-arm60febd52021-08-11 15:07:02 +0200101#if defined(MBEDTLS_BIGNUM_C)
102
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100103mbedtls_mpi_uint mbedtls_ct_mpi_uint_mask(mbedtls_mpi_uint value)
gabor-mezei-arm60febd52021-08-11 15:07:02 +0200104{
105 /* MSVC has a warning about unary minus on unsigned, but this is
106 * well-defined and precisely what we want to do here */
107#if defined(_MSC_VER)
108#pragma warning( push )
109#pragma warning( disable : 4146 )
110#endif
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100111 return -((value | -value) >> (sizeof(value) * 8 - 1));
gabor-mezei-arm60febd52021-08-11 15:07:02 +0200112#if defined(_MSC_VER)
113#pragma warning( pop )
114#endif
115}
116
117#endif /* MBEDTLS_BIGNUM_C */
118
Dave Rodgman1d523682023-09-20 16:26:49 +0100119#if defined(MBEDTLS_SSL_SOME_SUITES_USE_TLS_CBC) || defined(MBEDTLS_NIST_KW_C) || \
120 defined(MBEDTLS_CIPHER_MODE_WITH_PADDING)
Gabor Mezei2b358802021-10-18 17:05:06 +0200121
Gabor Mezei2c5ed222021-10-18 16:05:50 +0200122/** Constant-flow mask generation for "less than" comparison:
123 * - if \p x < \p y, return all-bits 1, that is (size_t) -1
124 * - otherwise, return all bits 0, that is 0
125 *
126 * This function can be used to write constant-time code by replacing branches
127 * with bit operations using masks.
128 *
129 * \param x The first value to analyze.
130 * \param y The second value to analyze.
131 *
132 * \return All-bits-one if \p x is less than \p y, otherwise zero.
133 */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100134static size_t mbedtls_ct_size_mask_lt(size_t x,
135 size_t y)
gabor-mezei-arm4d6b1462021-09-27 11:53:54 +0200136{
137 /* This has the most significant bit set if and only if x < y */
138 const size_t sub = x - y;
139
140 /* sub1 = (x < y) ? 1 : 0 */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100141 const size_t sub1 = sub >> (sizeof(sub) * 8 - 1);
gabor-mezei-arm4d6b1462021-09-27 11:53:54 +0200142
143 /* mask = (x < y) ? 0xff... : 0x00... */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100144 const size_t mask = mbedtls_ct_size_mask(sub1);
gabor-mezei-arm4d6b1462021-09-27 11:53:54 +0200145
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100146 return mask;
gabor-mezei-arm4d6b1462021-09-27 11:53:54 +0200147}
gabor-mezei-arma2bcabc2021-09-27 11:58:31 +0200148
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100149size_t mbedtls_ct_size_mask_ge(size_t x,
150 size_t y)
gabor-mezei-arma2bcabc2021-09-27 11:58:31 +0200151{
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100152 return ~mbedtls_ct_size_mask_lt(x, y);
gabor-mezei-arma2bcabc2021-09-27 11:58:31 +0200153}
gabor-mezei-arm96584dd2021-09-27 12:15:19 +0200154
Dave Rodgman1d523682023-09-20 16:26:49 +0100155#endif /* defined(MBEDTLS_SSL_SOME_SUITES_USE_TLS_CBC) || defined(MBEDTLS_NIST_KW_C) ||
156 defined(MBEDTLS_CIPHER_MODE_WITH_PADDING) */
Gabor Mezei2b358802021-10-18 17:05:06 +0200157
Gabor Mezei46f79c32021-11-15 16:13:01 +0100158#if defined(MBEDTLS_BASE64_C)
159
160/* Return 0xff if low <= c <= high, 0 otherwise.
161 *
162 * Constant flow with respect to c.
163 */
Gabor Mezeidf293322021-11-26 17:20:36 +0100164MBEDTLS_STATIC_TESTABLE
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100165unsigned char mbedtls_ct_uchar_mask_of_range(unsigned char low,
166 unsigned char high,
167 unsigned char c)
Gabor Mezei46f79c32021-11-15 16:13:01 +0100168{
169 /* low_mask is: 0 if low <= c, 0x...ff if low > c */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100170 unsigned low_mask = ((unsigned) c - low) >> 8;
Gabor Mezei46f79c32021-11-15 16:13:01 +0100171 /* high_mask is: 0 if c <= high, 0x...ff if c > high */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100172 unsigned high_mask = ((unsigned) high - c) >> 8;
173 return ~(low_mask | high_mask) & 0xff;
Gabor Mezei46f79c32021-11-15 16:13:01 +0100174}
175
176#endif /* MBEDTLS_BASE64_C */
177
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100178unsigned mbedtls_ct_size_bool_eq(size_t x,
179 size_t y)
gabor-mezei-arm96584dd2021-09-27 12:15:19 +0200180{
181 /* diff = 0 if x == y, non-zero otherwise */
182 const size_t diff = x ^ y;
183
184 /* MSVC has a warning about unary minus on unsigned integer types,
185 * but this is well-defined and precisely what we want to do here. */
186#if defined(_MSC_VER)
187#pragma warning( push )
188#pragma warning( disable : 4146 )
189#endif
190
191 /* diff_msb's most significant bit is equal to x != y */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100192 const size_t diff_msb = (diff | (size_t) -diff);
gabor-mezei-arm96584dd2021-09-27 12:15:19 +0200193
194#if defined(_MSC_VER)
195#pragma warning( pop )
196#endif
197
198 /* diff1 = (x != y) ? 1 : 0 */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100199 const unsigned diff1 = diff_msb >> (sizeof(diff_msb) * 8 - 1);
gabor-mezei-arm96584dd2021-09-27 12:15:19 +0200200
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100201 return 1 ^ diff1;
gabor-mezei-arm96584dd2021-09-27 12:15:19 +0200202}
gabor-mezei-arm9d7bf092021-09-27 12:25:07 +0200203
Gabor Mezei2b358802021-10-18 17:05:06 +0200204#if defined(MBEDTLS_PKCS1_V15) && defined(MBEDTLS_RSA_C) && !defined(MBEDTLS_RSA_ALT)
205
Gabor Mezeifd8a42d2021-10-18 16:35:23 +0200206/** Constant-flow "greater than" comparison:
207 * return x > y
208 *
209 * This is equivalent to \p x > \p y, but is likely to be compiled
210 * to code using bitwise operation rather than a branch.
211 *
212 * \param x The first value to analyze.
213 * \param y The second value to analyze.
214 *
215 * \return 1 if \p x greater than \p y, otherwise 0.
216 */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100217static unsigned mbedtls_ct_size_gt(size_t x,
218 size_t y)
gabor-mezei-arm9d7bf092021-09-27 12:25:07 +0200219{
gabor-mezei-arm5e488242021-08-10 20:36:09 +0200220 /* Return the sign bit (1 for negative) of (y - x). */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100221 return (y - x) >> (sizeof(size_t) * 8 - 1);
gabor-mezei-arm9d7bf092021-09-27 12:25:07 +0200222}
gabor-mezei-arm097d4f52021-09-27 12:55:33 +0200223
Gabor Mezei2b358802021-10-18 17:05:06 +0200224#endif /* MBEDTLS_PKCS1_V15 && MBEDTLS_RSA_C && ! MBEDTLS_RSA_ALT */
225
gabor-mezei-arm097d4f52021-09-27 12:55:33 +0200226#if defined(MBEDTLS_BIGNUM_C)
227
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100228unsigned mbedtls_ct_mpi_uint_lt(const mbedtls_mpi_uint x,
229 const mbedtls_mpi_uint y)
gabor-mezei-arm097d4f52021-09-27 12:55:33 +0200230{
231 mbedtls_mpi_uint ret;
232 mbedtls_mpi_uint cond;
233
234 /*
235 * Check if the most significant bits (MSB) of the operands are different.
236 */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100237 cond = (x ^ y);
gabor-mezei-arm097d4f52021-09-27 12:55:33 +0200238 /*
239 * If the MSB are the same then the difference x-y will be negative (and
240 * have its MSB set to 1 during conversion to unsigned) if and only if x<y.
241 */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100242 ret = (x - y) & ~cond;
gabor-mezei-arm097d4f52021-09-27 12:55:33 +0200243 /*
244 * If the MSB are different, then the operand with the MSB of 1 is the
245 * bigger. (That is if y has MSB of 1, then x<y is true and it is false if
246 * the MSB of y is 0.)
247 */
248 ret |= y & cond;
249
250
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100251 ret = ret >> (sizeof(mbedtls_mpi_uint) * 8 - 1);
gabor-mezei-arm097d4f52021-09-27 12:55:33 +0200252
253 return (unsigned) ret;
254}
255
256#endif /* MBEDTLS_BIGNUM_C */
gabor-mezei-arm75332532021-09-27 12:59:30 +0200257
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100258unsigned mbedtls_ct_uint_if(unsigned condition,
259 unsigned if1,
260 unsigned if0)
gabor-mezei-arm75332532021-09-27 12:59:30 +0200261{
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100262 unsigned mask = mbedtls_ct_uint_mask(condition);
263 return (mask & if1) | (~mask & if0);
gabor-mezei-arm75332532021-09-27 12:59:30 +0200264}
gabor-mezei-arm5cec8b42021-09-27 13:03:57 +0200265
Gabor Mezei2b358802021-10-18 17:05:06 +0200266#if defined(MBEDTLS_BIGNUM_C)
gabor-mezei-armbc3a2882021-09-27 15:47:00 +0200267
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100268void mbedtls_ct_mpi_uint_cond_assign(size_t n,
269 mbedtls_mpi_uint *dest,
270 const mbedtls_mpi_uint *src,
271 unsigned char condition)
gabor-mezei-arm043192d2021-09-27 13:17:15 +0200272{
273 size_t i;
274
275 /* MSVC has a warning about unary minus on unsigned integer types,
276 * but this is well-defined and precisely what we want to do here. */
277#if defined(_MSC_VER)
278#pragma warning( push )
279#pragma warning( disable : 4146 )
280#endif
281
gabor-mezei-arm5e488242021-08-10 20:36:09 +0200282 /* all-bits 1 if condition is 1, all-bits 0 if condition is 0 */
283 const mbedtls_mpi_uint mask = -condition;
gabor-mezei-arm043192d2021-09-27 13:17:15 +0200284
285#if defined(_MSC_VER)
286#pragma warning( pop )
287#endif
288
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100289 for (i = 0; i < n; i++) {
290 dest[i] = (src[i] & mask) | (dest[i] & ~mask);
291 }
gabor-mezei-arm043192d2021-09-27 13:17:15 +0200292}
293
294#endif /* MBEDTLS_BIGNUM_C */
gabor-mezei-arm7b23c0b2021-09-27 13:31:06 +0200295
Gabor Mezei200708d2021-11-15 16:18:54 +0100296#if defined(MBEDTLS_BASE64_C)
297
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100298unsigned char mbedtls_ct_base64_enc_char(unsigned char value)
Gabor Mezei200708d2021-11-15 16:18:54 +0100299{
300 unsigned char digit = 0;
Gabor Mezei46ca2f72021-11-24 15:51:39 +0100301 /* For each range of values, if value is in that range, mask digit with
302 * the corresponding value. Since value can only be in a single range,
Gabor Mezei200708d2021-11-15 16:18:54 +0100303 * only at most one masking will change digit. */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100304 digit |= mbedtls_ct_uchar_mask_of_range(0, 25, value) & ('A' + value);
305 digit |= mbedtls_ct_uchar_mask_of_range(26, 51, value) & ('a' + value - 26);
306 digit |= mbedtls_ct_uchar_mask_of_range(52, 61, value) & ('0' + value - 52);
307 digit |= mbedtls_ct_uchar_mask_of_range(62, 62, value) & '+';
308 digit |= mbedtls_ct_uchar_mask_of_range(63, 63, value) & '/';
309 return digit;
Gabor Mezei200708d2021-11-15 16:18:54 +0100310}
311
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100312signed char mbedtls_ct_base64_dec_value(unsigned char c)
Gabor Mezei3d4dba82021-11-15 16:22:37 +0100313{
314 unsigned char val = 0;
315 /* For each range of digits, if c is in that range, mask val with
316 * the corresponding value. Since c can only be in a single range,
317 * only at most one masking will change val. Set val to one plus
318 * the desired value so that it stays 0 if c is in none of the ranges. */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100319 val |= mbedtls_ct_uchar_mask_of_range('A', 'Z', c) & (c - 'A' + 0 + 1);
320 val |= mbedtls_ct_uchar_mask_of_range('a', 'z', c) & (c - 'a' + 26 + 1);
321 val |= mbedtls_ct_uchar_mask_of_range('0', '9', c) & (c - '0' + 52 + 1);
322 val |= mbedtls_ct_uchar_mask_of_range('+', '+', c) & (c - '+' + 62 + 1);
323 val |= mbedtls_ct_uchar_mask_of_range('/', '/', c) & (c - '/' + 63 + 1);
Gabor Mezei3d4dba82021-11-15 16:22:37 +0100324 /* At this point, val is 0 if c is an invalid digit and v+1 if c is
325 * a digit with the value v. */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100326 return val - 1;
Gabor Mezei3d4dba82021-11-15 16:22:37 +0100327}
328
Gabor Mezei200708d2021-11-15 16:18:54 +0100329#endif /* MBEDTLS_BASE64_C */
330
Gabor Mezei2b358802021-10-18 17:05:06 +0200331#if defined(MBEDTLS_PKCS1_V15) && defined(MBEDTLS_RSA_C) && !defined(MBEDTLS_RSA_ALT)
332
Gabor Mezeifd8a42d2021-10-18 16:35:23 +0200333/** Shift some data towards the left inside a buffer.
334 *
Gabor Mezei18a44942021-10-20 11:59:27 +0200335 * `mbedtls_ct_mem_move_to_left(start, total, offset)` is functionally
Gabor Mezeifd8a42d2021-10-18 16:35:23 +0200336 * equivalent to
337 * ```
338 * memmove(start, start + offset, total - offset);
339 * memset(start + offset, 0, total - offset);
340 * ```
341 * but it strives to use a memory access pattern (and thus total timing)
342 * that does not depend on \p offset. This timing independence comes at
343 * the expense of performance.
344 *
345 * \param start Pointer to the start of the buffer.
346 * \param total Total size of the buffer.
347 * \param offset Offset from which to copy \p total - \p offset bytes.
348 */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100349static void mbedtls_ct_mem_move_to_left(void *start,
350 size_t total,
351 size_t offset)
gabor-mezei-arm7b23c0b2021-09-27 13:31:06 +0200352{
353 volatile unsigned char *buf = start;
354 size_t i, n;
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100355 if (total == 0) {
gabor-mezei-arm7b23c0b2021-09-27 13:31:06 +0200356 return;
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100357 }
358 for (i = 0; i < total; i++) {
359 unsigned no_op = mbedtls_ct_size_gt(total - offset, i);
gabor-mezei-arm7b23c0b2021-09-27 13:31:06 +0200360 /* The first `total - offset` passes are a no-op. The last
361 * `offset` passes shift the data one byte to the left and
362 * zero out the last byte. */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100363 for (n = 0; n < total - 1; n++) {
gabor-mezei-arm7b23c0b2021-09-27 13:31:06 +0200364 unsigned char current = buf[n];
365 unsigned char next = buf[n+1];
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100366 buf[n] = mbedtls_ct_uint_if(no_op, current, next);
gabor-mezei-arm7b23c0b2021-09-27 13:31:06 +0200367 }
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100368 buf[total-1] = mbedtls_ct_uint_if(no_op, buf[total-1], 0);
gabor-mezei-arm7b23c0b2021-09-27 13:31:06 +0200369 }
370}
gabor-mezei-armee06feb2021-09-27 13:34:25 +0200371
Gabor Mezei2b358802021-10-18 17:05:06 +0200372#endif /* MBEDTLS_PKCS1_V15 && MBEDTLS_RSA_C && ! MBEDTLS_RSA_ALT */
373
Przemek Stekiel169554c2022-10-06 10:53:20 +0200374#if defined(MBEDTLS_SSL_SOME_MODES_USE_MAC)
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100375void mbedtls_ct_memcpy_if_eq(unsigned char *dest,
376 const unsigned char *src,
377 size_t len,
378 size_t c1,
379 size_t c2)
gabor-mezei-armee06feb2021-09-27 13:34:25 +0200380{
381 /* mask = c1 == c2 ? 0xff : 0x00 */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100382 const size_t equal = mbedtls_ct_size_bool_eq(c1, c2);
383 const unsigned char mask = (unsigned char) mbedtls_ct_size_mask(equal);
gabor-mezei-armee06feb2021-09-27 13:34:25 +0200384
gabor-mezei-arm5e488242021-08-10 20:36:09 +0200385 /* dest[i] = c1 == c2 ? src[i] : dest[i] */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100386 for (size_t i = 0; i < len; i++) {
387 dest[i] = (src[i] & mask) | (dest[i] & ~mask);
gabor-mezei-arm0f7b9e42021-09-27 13:57:45 +0200388 }
389}
gabor-mezei-armcb4317b2021-09-27 14:28:31 +0200390
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100391void mbedtls_ct_memcpy_offset(unsigned char *dest,
392 const unsigned char *src,
393 size_t offset,
394 size_t offset_min,
395 size_t offset_max,
396 size_t len)
397{
398 size_t offsetval;
399
400 for (offsetval = offset_min; offsetval <= offset_max; offsetval++) {
401 mbedtls_ct_memcpy_if_eq(dest, src + offsetval, len,
402 offsetval, offset);
403 }
404}
405
406int mbedtls_ct_hmac(mbedtls_md_context_t *ctx,
407 const unsigned char *add_data,
408 size_t add_data_len,
409 const unsigned char *data,
410 size_t data_len_secret,
411 size_t min_data_len,
412 size_t max_data_len,
413 unsigned char *output)
gabor-mezei-armcb4317b2021-09-27 14:28:31 +0200414{
415 /*
416 * This function breaks the HMAC abstraction and uses the md_clone()
417 * extension to the MD API in order to get constant-flow behaviour.
418 *
419 * HMAC(msg) is defined as HASH(okey + HASH(ikey + msg)) where + means
420 * concatenation, and okey/ikey are the XOR of the key with some fixed bit
421 * patterns (see RFC 2104, sec. 2), which are stored in ctx->hmac_ctx.
422 *
423 * We'll first compute inner_hash = HASH(ikey + msg) by hashing up to
424 * minlen, then cloning the context, and for each byte up to maxlen
425 * finishing up the hash computation, keeping only the correct result.
426 *
427 * Then we only need to compute HASH(okey + inner_hash) and we're done.
428 */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100429 const mbedtls_md_type_t md_alg = mbedtls_md_get_type(ctx->md_info);
gabor-mezei-armcb4317b2021-09-27 14:28:31 +0200430 /* TLS 1.0-1.2 only support SHA-384, SHA-256, SHA-1, MD-5,
431 * all of which have the same block size except SHA-384. */
432 const size_t block_size = md_alg == MBEDTLS_MD_SHA384 ? 128 : 64;
433 const unsigned char * const ikey = ctx->hmac_ctx;
434 const unsigned char * const okey = ikey + block_size;
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100435 const size_t hash_size = mbedtls_md_get_size(ctx->md_info);
gabor-mezei-armcb4317b2021-09-27 14:28:31 +0200436
437 unsigned char aux_out[MBEDTLS_MD_MAX_SIZE];
438 mbedtls_md_context_t aux;
439 size_t offset;
440 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
441
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100442 mbedtls_md_init(&aux);
gabor-mezei-armcb4317b2021-09-27 14:28:31 +0200443
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100444#define MD_CHK(func_call) \
gabor-mezei-armcb4317b2021-09-27 14:28:31 +0200445 do { \
446 ret = (func_call); \
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100447 if (ret != 0) \
448 goto cleanup; \
449 } while (0)
gabor-mezei-armcb4317b2021-09-27 14:28:31 +0200450
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100451 MD_CHK(mbedtls_md_setup(&aux, ctx->md_info, 0));
gabor-mezei-armcb4317b2021-09-27 14:28:31 +0200452
453 /* After hmac_start() of hmac_reset(), ikey has already been hashed,
454 * so we can start directly with the message */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100455 MD_CHK(mbedtls_md_update(ctx, add_data, add_data_len));
456 MD_CHK(mbedtls_md_update(ctx, data, min_data_len));
gabor-mezei-armcb4317b2021-09-27 14:28:31 +0200457
Paul Elliottb8300282022-05-19 18:31:35 +0100458 /* Fill the hash buffer in advance with something that is
459 * not a valid hash (barring an attack on the hash and
460 * deliberately-crafted input), in case the caller doesn't
461 * check the return status properly. */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100462 memset(output, '!', hash_size);
Paul Elliottb8300282022-05-19 18:31:35 +0100463
gabor-mezei-armcb4317b2021-09-27 14:28:31 +0200464 /* For each possible length, compute the hash up to that point */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100465 for (offset = min_data_len; offset <= max_data_len; offset++) {
466 MD_CHK(mbedtls_md_clone(&aux, ctx));
467 MD_CHK(mbedtls_md_finish(&aux, aux_out));
gabor-mezei-armcb4317b2021-09-27 14:28:31 +0200468 /* Keep only the correct inner_hash in the output buffer */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100469 mbedtls_ct_memcpy_if_eq(output, aux_out, hash_size,
470 offset, data_len_secret);
gabor-mezei-armcb4317b2021-09-27 14:28:31 +0200471
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100472 if (offset < max_data_len) {
473 MD_CHK(mbedtls_md_update(ctx, data + offset, 1));
474 }
gabor-mezei-armcb4317b2021-09-27 14:28:31 +0200475 }
476
477 /* The context needs to finish() before it starts() again */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100478 MD_CHK(mbedtls_md_finish(ctx, aux_out));
gabor-mezei-armcb4317b2021-09-27 14:28:31 +0200479
480 /* Now compute HASH(okey + inner_hash) */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100481 MD_CHK(mbedtls_md_starts(ctx));
482 MD_CHK(mbedtls_md_update(ctx, okey, block_size));
483 MD_CHK(mbedtls_md_update(ctx, output, hash_size));
484 MD_CHK(mbedtls_md_finish(ctx, output));
gabor-mezei-armcb4317b2021-09-27 14:28:31 +0200485
486 /* Done, get ready for next time */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100487 MD_CHK(mbedtls_md_hmac_reset(ctx));
gabor-mezei-armcb4317b2021-09-27 14:28:31 +0200488
489#undef MD_CHK
490
491cleanup:
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100492 mbedtls_md_free(&aux);
493 return ret;
gabor-mezei-armcb4317b2021-09-27 14:28:31 +0200494}
495
Przemek Stekiel169554c2022-10-06 10:53:20 +0200496#endif /* MBEDTLS_SSL_SOME_MODES_USE_MAC */
gabor-mezei-armb8caeee2021-09-27 15:33:35 +0200497
498#if defined(MBEDTLS_BIGNUM_C)
499
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100500#define MPI_VALIDATE_RET(cond) \
501 MBEDTLS_INTERNAL_VALIDATE_RET(cond, MBEDTLS_ERR_MPI_BAD_INPUT_DATA)
gabor-mezei-armb8caeee2021-09-27 15:33:35 +0200502
503/*
504 * Conditionally assign X = Y, without leaking information
505 * about whether the assignment was made or not.
506 * (Leaking information about the respective sizes of X and Y is ok however.)
507 */
Tautvydas Žilys61156f82022-01-31 13:34:01 -0800508#if defined(_MSC_VER) && defined(_M_ARM64) && (_MSC_FULL_VER < 193131103)
Tautvydas Žilysea4af4d2022-01-26 15:33:27 -0800509/*
Tautvydas Žilys61156f82022-01-31 13:34:01 -0800510 * MSVC miscompiles this function if it's inlined prior to Visual Studio 2022 version 17.1. See:
Tautvydas Žilysea4af4d2022-01-26 15:33:27 -0800511 * https://developercommunity.visualstudio.com/t/c-compiler-miscompiles-part-of-mbedtls-library-on/1646989
512 */
513__declspec(noinline)
514#endif
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100515int mbedtls_mpi_safe_cond_assign(mbedtls_mpi *X,
516 const mbedtls_mpi *Y,
517 unsigned char assign)
gabor-mezei-armb8caeee2021-09-27 15:33:35 +0200518{
519 int ret = 0;
520 size_t i;
521 mbedtls_mpi_uint limb_mask;
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100522 MPI_VALIDATE_RET(X != NULL);
523 MPI_VALIDATE_RET(Y != NULL);
gabor-mezei-armb8caeee2021-09-27 15:33:35 +0200524
gabor-mezei-armb8caeee2021-09-27 15:33:35 +0200525 /* all-bits 1 if assign is 1, all-bits 0 if assign is 0 */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100526 limb_mask = mbedtls_ct_mpi_uint_mask(assign);;
gabor-mezei-armb8caeee2021-09-27 15:33:35 +0200527
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100528 MBEDTLS_MPI_CHK(mbedtls_mpi_grow(X, Y->n));
gabor-mezei-armb8caeee2021-09-27 15:33:35 +0200529
Tom Cosgrove735d2c92023-05-03 09:50:10 +0100530 X->s = (int) mbedtls_ct_uint_if(assign, Y->s, X->s);
gabor-mezei-armb8caeee2021-09-27 15:33:35 +0200531
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100532 mbedtls_ct_mpi_uint_cond_assign(Y->n, X->p, Y->p, assign);
gabor-mezei-armb8caeee2021-09-27 15:33:35 +0200533
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100534 for (i = Y->n; i < X->n; i++) {
gabor-mezei-armb8caeee2021-09-27 15:33:35 +0200535 X->p[i] &= ~limb_mask;
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100536 }
gabor-mezei-armb8caeee2021-09-27 15:33:35 +0200537
538cleanup:
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100539 return ret;
gabor-mezei-armb8caeee2021-09-27 15:33:35 +0200540}
541
gabor-mezei-arm58fc8a62021-09-27 15:37:50 +0200542/*
543 * Conditionally swap X and Y, without leaking information
544 * about whether the swap was made or not.
Shaun Case0e7791f2021-12-20 21:14:10 -0800545 * Here it is not ok to simply swap the pointers, which would lead to
gabor-mezei-arm58fc8a62021-09-27 15:37:50 +0200546 * different memory access patterns when X and Y are used afterwards.
547 */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100548int mbedtls_mpi_safe_cond_swap(mbedtls_mpi *X,
549 mbedtls_mpi *Y,
550 unsigned char swap)
gabor-mezei-arm58fc8a62021-09-27 15:37:50 +0200551{
552 int ret, s;
553 size_t i;
554 mbedtls_mpi_uint limb_mask;
555 mbedtls_mpi_uint tmp;
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100556 MPI_VALIDATE_RET(X != NULL);
557 MPI_VALIDATE_RET(Y != NULL);
gabor-mezei-arm58fc8a62021-09-27 15:37:50 +0200558
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100559 if (X == Y) {
560 return 0;
561 }
gabor-mezei-arm58fc8a62021-09-27 15:37:50 +0200562
gabor-mezei-arm58fc8a62021-09-27 15:37:50 +0200563 /* all-bits 1 if swap is 1, all-bits 0 if swap is 0 */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100564 limb_mask = mbedtls_ct_mpi_uint_mask(swap);
gabor-mezei-arm58fc8a62021-09-27 15:37:50 +0200565
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100566 MBEDTLS_MPI_CHK(mbedtls_mpi_grow(X, Y->n));
567 MBEDTLS_MPI_CHK(mbedtls_mpi_grow(Y, X->n));
gabor-mezei-arm58fc8a62021-09-27 15:37:50 +0200568
569 s = X->s;
Tom Cosgrove735d2c92023-05-03 09:50:10 +0100570 X->s = (int) mbedtls_ct_uint_if(swap, Y->s, X->s);
571 Y->s = (int) mbedtls_ct_uint_if(swap, s, Y->s);
gabor-mezei-arm58fc8a62021-09-27 15:37:50 +0200572
573
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100574 for (i = 0; i < X->n; i++) {
gabor-mezei-arm58fc8a62021-09-27 15:37:50 +0200575 tmp = X->p[i];
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100576 X->p[i] = (X->p[i] & ~limb_mask) | (Y->p[i] & limb_mask);
577 Y->p[i] = (Y->p[i] & ~limb_mask) | (tmp & limb_mask);
gabor-mezei-arm58fc8a62021-09-27 15:37:50 +0200578 }
579
580cleanup:
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100581 return ret;
gabor-mezei-arm58fc8a62021-09-27 15:37:50 +0200582}
583
gabor-mezei-armb10301d2021-09-27 15:41:30 +0200584/*
585 * Compare signed values in constant time
586 */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100587int mbedtls_mpi_lt_mpi_ct(const mbedtls_mpi *X,
588 const mbedtls_mpi *Y,
589 unsigned *ret)
gabor-mezei-armb10301d2021-09-27 15:41:30 +0200590{
591 size_t i;
592 /* The value of any of these variables is either 0 or 1 at all times. */
593 unsigned cond, done, X_is_negative, Y_is_negative;
594
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100595 MPI_VALIDATE_RET(X != NULL);
596 MPI_VALIDATE_RET(Y != NULL);
597 MPI_VALIDATE_RET(ret != NULL);
gabor-mezei-armb10301d2021-09-27 15:41:30 +0200598
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100599 if (X->n != Y->n) {
gabor-mezei-armb10301d2021-09-27 15:41:30 +0200600 return MBEDTLS_ERR_MPI_BAD_INPUT_DATA;
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100601 }
gabor-mezei-armb10301d2021-09-27 15:41:30 +0200602
603 /*
604 * Set sign_N to 1 if N >= 0, 0 if N < 0.
605 * We know that N->s == 1 if N >= 0 and N->s == -1 if N < 0.
606 */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100607 X_is_negative = (X->s & 2) >> 1;
608 Y_is_negative = (Y->s & 2) >> 1;
gabor-mezei-armb10301d2021-09-27 15:41:30 +0200609
610 /*
611 * If the signs are different, then the positive operand is the bigger.
612 * That is if X is negative (X_is_negative == 1), then X < Y is true and it
613 * is false if X is positive (X_is_negative == 0).
614 */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100615 cond = (X_is_negative ^ Y_is_negative);
gabor-mezei-armb10301d2021-09-27 15:41:30 +0200616 *ret = cond & X_is_negative;
617
618 /*
619 * This is a constant-time function. We might have the result, but we still
620 * need to go through the loop. Record if we have the result already.
621 */
622 done = cond;
623
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100624 for (i = X->n; i > 0; i--) {
gabor-mezei-armb10301d2021-09-27 15:41:30 +0200625 /*
626 * If Y->p[i - 1] < X->p[i - 1] then X < Y is true if and only if both
627 * X and Y are negative.
628 *
629 * Again even if we can make a decision, we just mark the result and
630 * the fact that we are done and continue looping.
631 */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100632 cond = mbedtls_ct_mpi_uint_lt(Y->p[i - 1], X->p[i - 1]);
633 *ret |= cond & (1 - done) & X_is_negative;
gabor-mezei-armb10301d2021-09-27 15:41:30 +0200634 done |= cond;
635
636 /*
637 * If X->p[i - 1] < Y->p[i - 1] then X < Y is true if and only if both
638 * X and Y are positive.
639 *
640 * Again even if we can make a decision, we just mark the result and
641 * the fact that we are done and continue looping.
642 */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100643 cond = mbedtls_ct_mpi_uint_lt(X->p[i - 1], Y->p[i - 1]);
644 *ret |= cond & (1 - done) & (1 - X_is_negative);
gabor-mezei-armb10301d2021-09-27 15:41:30 +0200645 done |= cond;
646 }
647
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100648 return 0;
gabor-mezei-armb10301d2021-09-27 15:41:30 +0200649}
650
gabor-mezei-armb8caeee2021-09-27 15:33:35 +0200651#endif /* MBEDTLS_BIGNUM_C */
gabor-mezei-armf52941e2021-09-27 16:11:12 +0200652
653#if defined(MBEDTLS_PKCS1_V15) && defined(MBEDTLS_RSA_C) && !defined(MBEDTLS_RSA_ALT)
654
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100655int mbedtls_ct_rsaes_pkcs1_v15_unpadding(int mode,
656 unsigned char *input,
657 size_t ilen,
658 unsigned char *output,
659 size_t output_max_len,
660 size_t *olen)
gabor-mezei-armf52941e2021-09-27 16:11:12 +0200661{
662 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
663 size_t i, plaintext_max_size;
664
665 /* The following variables take sensitive values: their value must
666 * not leak into the observable behavior of the function other than
667 * the designated outputs (output, olen, return value). Otherwise
668 * this would open the execution of the function to
669 * side-channel-based variants of the Bleichenbacher padding oracle
670 * attack. Potential side channels include overall timing, memory
671 * access patterns (especially visible to an adversary who has access
672 * to a shared memory cache), and branches (especially visible to
673 * an adversary who has access to a shared code cache or to a shared
674 * branch predictor). */
675 size_t pad_count = 0;
676 unsigned bad = 0;
677 unsigned char pad_done = 0;
678 size_t plaintext_size = 0;
679 unsigned output_too_large;
680
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100681 plaintext_max_size = (output_max_len > ilen - 11) ? ilen - 11
Gabor Mezei150bdee2021-10-18 16:12:45 +0200682 : output_max_len;
gabor-mezei-armf52941e2021-09-27 16:11:12 +0200683
684 /* Check and get padding length in constant time and constant
685 * memory trace. The first byte must be 0. */
Gabor Mezei91deea72021-10-18 16:17:57 +0200686 bad |= input[0];
gabor-mezei-armf52941e2021-09-27 16:11:12 +0200687
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100688 if (mode == MBEDTLS_RSA_PRIVATE) {
gabor-mezei-armf52941e2021-09-27 16:11:12 +0200689 /* Decode EME-PKCS1-v1_5 padding: 0x00 || 0x02 || PS || 0x00
690 * where PS must be at least 8 nonzero bytes. */
Gabor Mezei91deea72021-10-18 16:17:57 +0200691 bad |= input[1] ^ MBEDTLS_RSA_CRYPT;
gabor-mezei-armf52941e2021-09-27 16:11:12 +0200692
693 /* Read the whole buffer. Set pad_done to nonzero if we find
694 * the 0x00 byte and remember the padding length in pad_count. */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100695 for (i = 2; i < ilen; i++) {
696 pad_done |= ((input[i] | (unsigned char) -input[i]) >> 7) ^ 1;
697 pad_count += ((pad_done | (unsigned char) -pad_done) >> 7) ^ 1;
gabor-mezei-armf52941e2021-09-27 16:11:12 +0200698 }
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100699 } else {
gabor-mezei-armf52941e2021-09-27 16:11:12 +0200700 /* Decode EMSA-PKCS1-v1_5 padding: 0x00 || 0x01 || PS || 0x00
701 * where PS must be at least 8 bytes with the value 0xFF. */
Gabor Mezei91deea72021-10-18 16:17:57 +0200702 bad |= input[1] ^ MBEDTLS_RSA_SIGN;
gabor-mezei-armf52941e2021-09-27 16:11:12 +0200703
704 /* Read the whole buffer. Set pad_done to nonzero if we find
705 * the 0x00 byte and remember the padding length in pad_count.
706 * If there's a non-0xff byte in the padding, the padding is bad. */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100707 for (i = 2; i < ilen; i++) {
708 pad_done |= mbedtls_ct_uint_if(input[i], 0, 1);
709 pad_count += mbedtls_ct_uint_if(pad_done, 0, 1);
710 bad |= mbedtls_ct_uint_if(pad_done, 0, input[i] ^ 0xFF);
gabor-mezei-armf52941e2021-09-27 16:11:12 +0200711 }
712 }
713
714 /* If pad_done is still zero, there's no data, only unfinished padding. */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100715 bad |= mbedtls_ct_uint_if(pad_done, 0, 1);
gabor-mezei-armf52941e2021-09-27 16:11:12 +0200716
717 /* There must be at least 8 bytes of padding. */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100718 bad |= mbedtls_ct_size_gt(8, pad_count);
gabor-mezei-armf52941e2021-09-27 16:11:12 +0200719
720 /* If the padding is valid, set plaintext_size to the number of
721 * remaining bytes after stripping the padding. If the padding
722 * is invalid, avoid leaking this fact through the size of the
723 * output: use the maximum message size that fits in the output
724 * buffer. Do it without branches to avoid leaking the padding
725 * validity through timing. RSA keys are small enough that all the
726 * size_t values involved fit in unsigned int. */
Gabor Mezei18a44942021-10-20 11:59:27 +0200727 plaintext_size = mbedtls_ct_uint_if(
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100728 bad, (unsigned) plaintext_max_size,
729 (unsigned) (ilen - pad_count - 3));
gabor-mezei-armf52941e2021-09-27 16:11:12 +0200730
731 /* Set output_too_large to 0 if the plaintext fits in the output
732 * buffer and to 1 otherwise. */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100733 output_too_large = mbedtls_ct_size_gt(plaintext_size,
734 plaintext_max_size);
gabor-mezei-armf52941e2021-09-27 16:11:12 +0200735
736 /* Set ret without branches to avoid timing attacks. Return:
737 * - INVALID_PADDING if the padding is bad (bad != 0).
738 * - OUTPUT_TOO_LARGE if the padding is good but the decrypted
739 * plaintext does not fit in the output buffer.
740 * - 0 if the padding is correct. */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100741 ret = -(int) mbedtls_ct_uint_if(
742 bad, -MBEDTLS_ERR_RSA_INVALID_PADDING,
743 mbedtls_ct_uint_if(output_too_large,
744 -MBEDTLS_ERR_RSA_OUTPUT_TOO_LARGE,
745 0));
gabor-mezei-armf52941e2021-09-27 16:11:12 +0200746
747 /* If the padding is bad or the plaintext is too large, zero the
748 * data that we're about to copy to the output buffer.
749 * We need to copy the same amount of data
750 * from the same buffer whether the padding is good or not to
751 * avoid leaking the padding validity through overall timing or
752 * through memory or cache access patterns. */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100753 bad = mbedtls_ct_uint_mask(bad | output_too_large);
754 for (i = 11; i < ilen; i++) {
Gabor Mezei91deea72021-10-18 16:17:57 +0200755 input[i] &= ~bad;
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100756 }
gabor-mezei-armf52941e2021-09-27 16:11:12 +0200757
758 /* If the plaintext is too large, truncate it to the buffer size.
759 * Copy anyway to avoid revealing the length through timing, because
760 * revealing the length is as bad as revealing the padding validity
761 * for a Bleichenbacher attack. */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100762 plaintext_size = mbedtls_ct_uint_if(output_too_large,
763 (unsigned) plaintext_max_size,
764 (unsigned) plaintext_size);
gabor-mezei-armf52941e2021-09-27 16:11:12 +0200765
766 /* Move the plaintext to the leftmost position where it can start in
767 * the working buffer, i.e. make it start plaintext_max_size from
768 * the end of the buffer. Do this with a memory access trace that
769 * does not depend on the plaintext size. After this move, the
770 * starting location of the plaintext is no longer sensitive
771 * information. */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100772 mbedtls_ct_mem_move_to_left(input + ilen - plaintext_max_size,
773 plaintext_max_size,
774 plaintext_max_size - plaintext_size);
gabor-mezei-armf52941e2021-09-27 16:11:12 +0200775
776 /* Finally copy the decrypted plaintext plus trailing zeros into the output
777 * buffer. If output_max_len is 0, then output may be an invalid pointer
778 * and the result of memcpy() would be undefined; prevent undefined
779 * behavior making sure to depend only on output_max_len (the size of the
780 * user-provided output buffer), which is independent from plaintext
781 * length, validity of padding, success of the decryption, and other
782 * secrets. */
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100783 if (output_max_len != 0) {
784 memcpy(output, input + ilen - plaintext_max_size, plaintext_max_size);
785 }
gabor-mezei-armf52941e2021-09-27 16:11:12 +0200786
787 /* Report the amount of data we copied to the output buffer. In case
788 * of errors (bad padding or output too large), the value of *olen
789 * when this function returns is not specified. Making it equivalent
790 * to the good case limits the risks of leaking the padding validity. */
791 *olen = plaintext_size;
792
Gilles Peskine1b6c09a2023-01-11 14:52:35 +0100793 return ret;
gabor-mezei-armf52941e2021-09-27 16:11:12 +0200794}
795
796#endif /* MBEDTLS_PKCS1_V15 && MBEDTLS_RSA_C && ! MBEDTLS_RSA_ALT */