blob: b7df690fb5c65131596c552e4141b6a7765f613e [file] [log] [blame]
Paul Bakker5121ce52009-01-03 21:22:43 +00001/*
2 * The RSA public-key cryptosystem
3 *
Bence Szépkúti1e148272020-08-07 13:07:28 +02004 * Copyright The Mbed TLS Contributors
Dave Rodgmane3c05852023-11-03 12:21:36 +00005 * SPDX-License-Identifier: Apache-2.0 OR GPL-2.0-or-later
Paul Bakker5121ce52009-01-03 21:22:43 +00006 */
Hanno Becker74716312017-10-02 10:00:37 +01007
Paul Bakker5121ce52009-01-03 21:22:43 +00008/*
Simon Butcherbdae02c2016-01-20 00:44:42 +00009 * The following sources were referenced in the design of this implementation
10 * of the RSA algorithm:
Paul Bakker5121ce52009-01-03 21:22:43 +000011 *
Simon Butcherbdae02c2016-01-20 00:44:42 +000012 * [1] A method for obtaining digital signatures and public-key cryptosystems
13 * R Rivest, A Shamir, and L Adleman
14 * http://people.csail.mit.edu/rivest/pubs.html#RSA78
15 *
16 * [2] Handbook of Applied Cryptography - 1997, Chapter 8
17 * Menezes, van Oorschot and Vanstone
18 *
Janos Follathe81102e2017-03-22 13:38:28 +000019 * [3] Malware Guard Extension: Using SGX to Conceal Cache Attacks
20 * Michael Schwarz, Samuel Weiser, Daniel Gruss, Clémentine Maurice and
21 * Stefan Mangard
22 * https://arxiv.org/abs/1702.08719v2
23 *
Paul Bakker5121ce52009-01-03 21:22:43 +000024 */
25
Gilles Peskinedb09ef62020-06-03 01:43:33 +020026#include "common.h"
Paul Bakker5121ce52009-01-03 21:22:43 +000027
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020028#if defined(MBEDTLS_RSA_C)
Paul Bakker5121ce52009-01-03 21:22:43 +000029
Manuel Pégourié-Gonnard7f809972015-03-09 17:05:11 +000030#include "mbedtls/rsa.h"
Janos Follathd6b09652023-11-21 09:33:54 +000031#include "bignum_core.h"
Janos Follath5f316972024-08-22 14:53:13 +010032#include "bignum_internal.h"
Chris Jones66a4cd42021-03-09 16:04:12 +000033#include "rsa_alt_helpers.h"
Tomi Fontanilles573dc232023-12-10 14:57:51 +020034#include "rsa_internal.h"
Manuel Pégourié-Gonnard7f809972015-03-09 17:05:11 +000035#include "mbedtls/oid.h"
Valerio Settib328c442024-01-23 10:48:45 +010036#include "mbedtls/asn1write.h"
Andres Amaya Garcia1f6301b2018-04-17 09:51:09 -050037#include "mbedtls/platform_util.h"
Janos Follath24eed8d2019-11-22 13:21:35 +000038#include "mbedtls/error.h"
Gabor Mezei22c9a6f2021-10-20 12:09:35 +020039#include "constant_time_internal.h"
Gabor Mezei765862c2021-10-19 12:22:25 +020040#include "mbedtls/constant_time.h"
Manuel Pégourié-Gonnard2d6d9932023-03-28 11:38:08 +020041#include "md_psa.h"
Paul Bakkerbb51f0c2012-08-23 07:46:58 +000042
Rich Evans00ab4702015-02-06 13:43:58 +000043#include <string.h>
44
gufe44c2620da2020-08-03 17:56:50 +020045#if defined(MBEDTLS_PKCS1_V15) && !defined(__OpenBSD__) && !defined(__NetBSD__)
Paul Bakker5121ce52009-01-03 21:22:43 +000046#include <stdlib.h>
Rich Evans00ab4702015-02-06 13:43:58 +000047#endif
Paul Bakker5121ce52009-01-03 21:22:43 +000048
Manuel Pégourié-Gonnard7f809972015-03-09 17:05:11 +000049#include "mbedtls/platform.h"
Paul Bakker7dc4c442014-02-01 22:50:26 +010050
Valerio Setti201e6432024-02-01 17:19:37 +010051/*
52 * Wrapper around mbedtls_asn1_get_mpi() that rejects zero.
53 *
54 * The value zero is:
55 * - never a valid value for an RSA parameter
56 * - interpreted as "omitted, please reconstruct" by mbedtls_rsa_complete().
57 *
58 * Since values can't be omitted in PKCS#1, passing a zero value to
59 * rsa_complete() would be incorrect, so reject zero values early.
60 */
61static int asn1_get_nonzero_mpi(unsigned char **p,
62 const unsigned char *end,
63 mbedtls_mpi *X)
64{
65 int ret;
66
67 ret = mbedtls_asn1_get_mpi(p, end, X);
68 if (ret != 0) {
69 return ret;
70 }
71
72 if (mbedtls_mpi_cmp_int(X, 0) == 0) {
73 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
74 }
75
76 return 0;
77}
78
Valerio Setti135ebde2024-02-01 17:00:29 +010079int mbedtls_rsa_parse_key(mbedtls_rsa_context *rsa, const unsigned char *key, size_t keylen)
Valerio Setti44ff9502024-02-01 16:51:05 +010080{
81 int ret, version;
82 size_t len;
83 unsigned char *p, *end;
84
85 mbedtls_mpi T;
86 mbedtls_mpi_init(&T);
87
88 p = (unsigned char *) key;
89 end = p + keylen;
90
91 /*
92 * This function parses the RSAPrivateKey (PKCS#1)
93 *
94 * RSAPrivateKey ::= SEQUENCE {
95 * version Version,
96 * modulus INTEGER, -- n
97 * publicExponent INTEGER, -- e
98 * privateExponent INTEGER, -- d
99 * prime1 INTEGER, -- p
100 * prime2 INTEGER, -- q
101 * exponent1 INTEGER, -- d mod (p-1)
102 * exponent2 INTEGER, -- d mod (q-1)
103 * coefficient INTEGER, -- (inverse of q) mod p
104 * otherPrimeInfos OtherPrimeInfos OPTIONAL
105 * }
106 */
107 if ((ret = mbedtls_asn1_get_tag(&p, end, &len,
108 MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE)) != 0) {
109 return ret;
110 }
111
Valerio Setti9de84bd2024-02-08 17:40:27 +0100112 if (end != p + len) {
113 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
114 }
Valerio Setti44ff9502024-02-01 16:51:05 +0100115
116 if ((ret = mbedtls_asn1_get_int(&p, end, &version)) != 0) {
117 return ret;
118 }
119
120 if (version != 0) {
121 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
122 }
123
124 /* Import N */
125 if ((ret = asn1_get_nonzero_mpi(&p, end, &T)) != 0 ||
126 (ret = mbedtls_rsa_import(rsa, &T, NULL, NULL,
127 NULL, NULL)) != 0) {
128 goto cleanup;
129 }
130
131 /* Import E */
132 if ((ret = asn1_get_nonzero_mpi(&p, end, &T)) != 0 ||
133 (ret = mbedtls_rsa_import(rsa, NULL, NULL, NULL,
134 NULL, &T)) != 0) {
135 goto cleanup;
136 }
137
138 /* Import D */
139 if ((ret = asn1_get_nonzero_mpi(&p, end, &T)) != 0 ||
140 (ret = mbedtls_rsa_import(rsa, NULL, NULL, NULL,
141 &T, NULL)) != 0) {
142 goto cleanup;
143 }
144
145 /* Import P */
146 if ((ret = asn1_get_nonzero_mpi(&p, end, &T)) != 0 ||
147 (ret = mbedtls_rsa_import(rsa, NULL, &T, NULL,
148 NULL, NULL)) != 0) {
149 goto cleanup;
150 }
151
152 /* Import Q */
153 if ((ret = asn1_get_nonzero_mpi(&p, end, &T)) != 0 ||
154 (ret = mbedtls_rsa_import(rsa, NULL, NULL, &T,
155 NULL, NULL)) != 0) {
156 goto cleanup;
157 }
158
159#if !defined(MBEDTLS_RSA_NO_CRT) && !defined(MBEDTLS_RSA_ALT)
160 /*
161 * The RSA CRT parameters DP, DQ and QP are nominally redundant, in
162 * that they can be easily recomputed from D, P and Q. However by
163 * parsing them from the PKCS1 structure it is possible to avoid
164 * recalculating them which both reduces the overhead of loading
165 * RSA private keys into memory and also avoids side channels which
166 * can arise when computing those values, since all of D, P, and Q
167 * are secret. See https://eprint.iacr.org/2020/055 for a
168 * description of one such attack.
169 */
170
171 /* Import DP */
172 if ((ret = asn1_get_nonzero_mpi(&p, end, &T)) != 0 ||
173 (ret = mbedtls_mpi_copy(&rsa->DP, &T)) != 0) {
174 goto cleanup;
175 }
176
177 /* Import DQ */
178 if ((ret = asn1_get_nonzero_mpi(&p, end, &T)) != 0 ||
179 (ret = mbedtls_mpi_copy(&rsa->DQ, &T)) != 0) {
180 goto cleanup;
181 }
182
183 /* Import QP */
184 if ((ret = asn1_get_nonzero_mpi(&p, end, &T)) != 0 ||
185 (ret = mbedtls_mpi_copy(&rsa->QP, &T)) != 0) {
186 goto cleanup;
187 }
188
189#else
190 /* Verify existence of the CRT params */
191 if ((ret = asn1_get_nonzero_mpi(&p, end, &T)) != 0 ||
192 (ret = asn1_get_nonzero_mpi(&p, end, &T)) != 0 ||
193 (ret = asn1_get_nonzero_mpi(&p, end, &T)) != 0) {
194 goto cleanup;
195 }
196#endif
197
198 /* rsa_complete() doesn't complete anything with the default
199 * implementation but is still called:
200 * - for the benefit of alternative implementation that may want to
201 * pre-compute stuff beyond what's provided (eg Montgomery factors)
202 * - as is also sanity-checks the key
203 *
204 * Furthermore, we also check the public part for consistency with
205 * mbedtls_pk_parse_pubkey(), as it includes size minima for example.
206 */
207 if ((ret = mbedtls_rsa_complete(rsa)) != 0 ||
208 (ret = mbedtls_rsa_check_pubkey(rsa)) != 0) {
209 goto cleanup;
210 }
211
212 if (p != end) {
213 ret = MBEDTLS_ERR_ASN1_LENGTH_MISMATCH;
214 }
215
216cleanup:
217
218 mbedtls_mpi_free(&T);
219
220 if (ret != 0) {
221 mbedtls_rsa_free(rsa);
222 }
223
224 return ret;
225}
226
Valerio Setti201e6432024-02-01 17:19:37 +0100227int mbedtls_rsa_parse_pubkey(mbedtls_rsa_context *rsa, const unsigned char *key, size_t keylen)
Valerio Setti44ff9502024-02-01 16:51:05 +0100228{
Valerio Setti201e6432024-02-01 17:19:37 +0100229 unsigned char *p = (unsigned char *) key;
230 unsigned char *end = (unsigned char *) (key + keylen);
Valerio Setti44ff9502024-02-01 16:51:05 +0100231 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
232 size_t len;
233
234 /*
235 * RSAPublicKey ::= SEQUENCE {
236 * modulus INTEGER, -- n
237 * publicExponent INTEGER -- e
238 * }
239 */
240
Valerio Setti201e6432024-02-01 17:19:37 +0100241 if ((ret = mbedtls_asn1_get_tag(&p, end, &len,
Valerio Setti44ff9502024-02-01 16:51:05 +0100242 MBEDTLS_ASN1_CONSTRUCTED | MBEDTLS_ASN1_SEQUENCE)) != 0) {
243 return ret;
244 }
245
Valerio Setti9de84bd2024-02-08 17:40:27 +0100246 if (end != p + len) {
247 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
248 }
Valerio Settife329ce2024-02-06 08:00:18 +0100249
Valerio Setti44ff9502024-02-01 16:51:05 +0100250 /* Import N */
Valerio Setti201e6432024-02-01 17:19:37 +0100251 if ((ret = mbedtls_asn1_get_tag(&p, end, &len, MBEDTLS_ASN1_INTEGER)) != 0) {
Valerio Setti44ff9502024-02-01 16:51:05 +0100252 return ret;
253 }
254
Valerio Setti201e6432024-02-01 17:19:37 +0100255 if ((ret = mbedtls_rsa_import_raw(rsa, p, len, NULL, 0, NULL, 0,
Valerio Setti44ff9502024-02-01 16:51:05 +0100256 NULL, 0, NULL, 0)) != 0) {
257 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
258 }
259
Valerio Setti201e6432024-02-01 17:19:37 +0100260 p += len;
Valerio Setti44ff9502024-02-01 16:51:05 +0100261
262 /* Import E */
Valerio Setti201e6432024-02-01 17:19:37 +0100263 if ((ret = mbedtls_asn1_get_tag(&p, end, &len, MBEDTLS_ASN1_INTEGER)) != 0) {
Valerio Setti44ff9502024-02-01 16:51:05 +0100264 return ret;
265 }
266
267 if ((ret = mbedtls_rsa_import_raw(rsa, NULL, 0, NULL, 0, NULL, 0,
Valerio Setti201e6432024-02-01 17:19:37 +0100268 NULL, 0, p, len)) != 0) {
Valerio Setti44ff9502024-02-01 16:51:05 +0100269 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
270 }
271
Valerio Setti201e6432024-02-01 17:19:37 +0100272 p += len;
Valerio Setti44ff9502024-02-01 16:51:05 +0100273
274 if (mbedtls_rsa_complete(rsa) != 0 ||
275 mbedtls_rsa_check_pubkey(rsa) != 0) {
276 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
277 }
278
Valerio Setti201e6432024-02-01 17:19:37 +0100279 if (p != end) {
Valerio Setti44ff9502024-02-01 16:51:05 +0100280 return MBEDTLS_ERR_ASN1_LENGTH_MISMATCH;
281 }
282
283 return 0;
284}
285
Valerio Setti135ebde2024-02-01 17:00:29 +0100286int mbedtls_rsa_write_key(const mbedtls_rsa_context *rsa, unsigned char *start,
Valerio Setti44ff9502024-02-01 16:51:05 +0100287 unsigned char **p)
288{
289 size_t len = 0;
290 int ret;
291
292 mbedtls_mpi T; /* Temporary holding the exported parameters */
293
294 /*
295 * Export the parameters one after another to avoid simultaneous copies.
296 */
297
298 mbedtls_mpi_init(&T);
299
300 /* Export QP */
301 if ((ret = mbedtls_rsa_export_crt(rsa, NULL, NULL, &T)) != 0 ||
302 (ret = mbedtls_asn1_write_mpi(p, start, &T)) < 0) {
303 goto end_of_export;
304 }
305 len += ret;
306
307 /* Export DQ */
308 if ((ret = mbedtls_rsa_export_crt(rsa, NULL, &T, NULL)) != 0 ||
309 (ret = mbedtls_asn1_write_mpi(p, start, &T)) < 0) {
310 goto end_of_export;
311 }
312 len += ret;
313
314 /* Export DP */
315 if ((ret = mbedtls_rsa_export_crt(rsa, &T, NULL, NULL)) != 0 ||
316 (ret = mbedtls_asn1_write_mpi(p, start, &T)) < 0) {
317 goto end_of_export;
318 }
319 len += ret;
320
321 /* Export Q */
322 if ((ret = mbedtls_rsa_export(rsa, NULL, NULL, &T, NULL, NULL)) != 0 ||
323 (ret = mbedtls_asn1_write_mpi(p, start, &T)) < 0) {
324 goto end_of_export;
325 }
326 len += ret;
327
328 /* Export P */
329 if ((ret = mbedtls_rsa_export(rsa, NULL, &T, NULL, NULL, NULL)) != 0 ||
330 (ret = mbedtls_asn1_write_mpi(p, start, &T)) < 0) {
331 goto end_of_export;
332 }
333 len += ret;
334
335 /* Export D */
336 if ((ret = mbedtls_rsa_export(rsa, NULL, NULL, NULL, &T, NULL)) != 0 ||
337 (ret = mbedtls_asn1_write_mpi(p, start, &T)) < 0) {
338 goto end_of_export;
339 }
340 len += ret;
341
342 /* Export E */
343 if ((ret = mbedtls_rsa_export(rsa, NULL, NULL, NULL, NULL, &T)) != 0 ||
344 (ret = mbedtls_asn1_write_mpi(p, start, &T)) < 0) {
345 goto end_of_export;
346 }
347 len += ret;
348
349 /* Export N */
350 if ((ret = mbedtls_rsa_export(rsa, &T, NULL, NULL, NULL, NULL)) != 0 ||
351 (ret = mbedtls_asn1_write_mpi(p, start, &T)) < 0) {
352 goto end_of_export;
353 }
354 len += ret;
355
356end_of_export:
357
358 mbedtls_mpi_free(&T);
359 if (ret < 0) {
360 return ret;
361 }
362
363 MBEDTLS_ASN1_CHK_ADD(len, mbedtls_asn1_write_int(p, start, 0));
364 MBEDTLS_ASN1_CHK_ADD(len, mbedtls_asn1_write_len(p, start, len));
365 MBEDTLS_ASN1_CHK_ADD(len, mbedtls_asn1_write_tag(p, start,
366 MBEDTLS_ASN1_CONSTRUCTED |
367 MBEDTLS_ASN1_SEQUENCE));
368
369 return (int) len;
370}
371
372/*
373 * RSAPublicKey ::= SEQUENCE {
374 * modulus INTEGER, -- n
375 * publicExponent INTEGER -- e
376 * }
377 */
Valerio Setti135ebde2024-02-01 17:00:29 +0100378int mbedtls_rsa_write_pubkey(const mbedtls_rsa_context *rsa, unsigned char *start,
Valerio Setti44ff9502024-02-01 16:51:05 +0100379 unsigned char **p)
380{
381 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
382 size_t len = 0;
383 mbedtls_mpi T;
384
385 mbedtls_mpi_init(&T);
386
387 /* Export E */
388 if ((ret = mbedtls_rsa_export(rsa, NULL, NULL, NULL, NULL, &T)) != 0 ||
389 (ret = mbedtls_asn1_write_mpi(p, start, &T)) < 0) {
390 goto end_of_export;
391 }
392 len += ret;
393
394 /* Export N */
395 if ((ret = mbedtls_rsa_export(rsa, &T, NULL, NULL, NULL, NULL)) != 0 ||
396 (ret = mbedtls_asn1_write_mpi(p, start, &T)) < 0) {
397 goto end_of_export;
398 }
399 len += ret;
400
401end_of_export:
402
403 mbedtls_mpi_free(&T);
404 if (ret < 0) {
405 return ret;
406 }
407
408 MBEDTLS_ASN1_CHK_ADD(len, mbedtls_asn1_write_len(p, start, len));
409 MBEDTLS_ASN1_CHK_ADD(len, mbedtls_asn1_write_tag(p, start, MBEDTLS_ASN1_CONSTRUCTED |
410 MBEDTLS_ASN1_SEQUENCE));
411
412 return (int) len;
413}
Dave Rodgman19e8cd02023-05-09 11:10:21 +0100414
415#if defined(MBEDTLS_PKCS1_V15) && defined(MBEDTLS_RSA_C) && !defined(MBEDTLS_RSA_ALT)
416
417/** This function performs the unpadding part of a PKCS#1 v1.5 decryption
418 * operation (EME-PKCS1-v1_5 decoding).
419 *
420 * \note The return value from this function is a sensitive value
421 * (this is unusual). #MBEDTLS_ERR_RSA_OUTPUT_TOO_LARGE shouldn't happen
422 * in a well-written application, but 0 vs #MBEDTLS_ERR_RSA_INVALID_PADDING
423 * is often a situation that an attacker can provoke and leaking which
424 * one is the result is precisely the information the attacker wants.
425 *
426 * \param input The input buffer which is the payload inside PKCS#1v1.5
427 * encryption padding, called the "encoded message EM"
428 * by the terminology.
429 * \param ilen The length of the payload in the \p input buffer.
430 * \param output The buffer for the payload, called "message M" by the
431 * PKCS#1 terminology. This must be a writable buffer of
432 * length \p output_max_len bytes.
433 * \param olen The address at which to store the length of
434 * the payload. This must not be \c NULL.
435 * \param output_max_len The length in bytes of the output buffer \p output.
436 *
437 * \return \c 0 on success.
438 * \return #MBEDTLS_ERR_RSA_OUTPUT_TOO_LARGE
439 * The output buffer is too small for the unpadded payload.
440 * \return #MBEDTLS_ERR_RSA_INVALID_PADDING
441 * The input doesn't contain properly formatted padding.
442 */
443static int mbedtls_ct_rsaes_pkcs1_v15_unpadding(unsigned char *input,
444 size_t ilen,
445 unsigned char *output,
446 size_t output_max_len,
447 size_t *olen)
448{
449 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
450 size_t i, plaintext_max_size;
451
452 /* The following variables take sensitive values: their value must
453 * not leak into the observable behavior of the function other than
454 * the designated outputs (output, olen, return value). Otherwise
455 * this would open the execution of the function to
456 * side-channel-based variants of the Bleichenbacher padding oracle
457 * attack. Potential side channels include overall timing, memory
458 * access patterns (especially visible to an adversary who has access
459 * to a shared memory cache), and branches (especially visible to
460 * an adversary who has access to a shared code cache or to a shared
461 * branch predictor). */
462 size_t pad_count = 0;
Dave Rodgman9f9c3b82023-05-17 12:28:51 +0100463 mbedtls_ct_condition_t bad;
464 mbedtls_ct_condition_t pad_done;
Dave Rodgman19e8cd02023-05-09 11:10:21 +0100465 size_t plaintext_size = 0;
Dave Rodgman9f9c3b82023-05-17 12:28:51 +0100466 mbedtls_ct_condition_t output_too_large;
Dave Rodgman19e8cd02023-05-09 11:10:21 +0100467
468 plaintext_max_size = (output_max_len > ilen - 11) ? ilen - 11
469 : output_max_len;
470
471 /* Check and get padding length in constant time and constant
472 * memory trace. The first byte must be 0. */
Dave Rodgman9f9c3b82023-05-17 12:28:51 +0100473 bad = mbedtls_ct_bool(input[0]);
Dave Rodgman19e8cd02023-05-09 11:10:21 +0100474
475
476 /* Decode EME-PKCS1-v1_5 padding: 0x00 || 0x02 || PS || 0x00
477 * where PS must be at least 8 nonzero bytes. */
Dave Rodgmanb7825ce2023-08-10 11:58:18 +0100478 bad = mbedtls_ct_bool_or(bad, mbedtls_ct_uint_ne(input[1], MBEDTLS_RSA_CRYPT));
Dave Rodgman19e8cd02023-05-09 11:10:21 +0100479
480 /* Read the whole buffer. Set pad_done to nonzero if we find
481 * the 0x00 byte and remember the padding length in pad_count. */
Dave Rodgman9f9c3b82023-05-17 12:28:51 +0100482 pad_done = MBEDTLS_CT_FALSE;
Dave Rodgman19e8cd02023-05-09 11:10:21 +0100483 for (i = 2; i < ilen; i++) {
Dave Rodgmanb7825ce2023-08-10 11:58:18 +0100484 mbedtls_ct_condition_t found = mbedtls_ct_uint_eq(input[i], 0);
Dave Rodgman9f9c3b82023-05-17 12:28:51 +0100485 pad_done = mbedtls_ct_bool_or(pad_done, found);
Dave Rodgman98ddc012023-08-10 12:11:31 +0100486 pad_count += mbedtls_ct_uint_if_else_0(mbedtls_ct_bool_not(pad_done), 1);
Dave Rodgman19e8cd02023-05-09 11:10:21 +0100487 }
488
Dave Rodgman19e8cd02023-05-09 11:10:21 +0100489 /* If pad_done is still zero, there's no data, only unfinished padding. */
Dave Rodgman9f9c3b82023-05-17 12:28:51 +0100490 bad = mbedtls_ct_bool_or(bad, mbedtls_ct_bool_not(pad_done));
Dave Rodgman19e8cd02023-05-09 11:10:21 +0100491
492 /* There must be at least 8 bytes of padding. */
Dave Rodgmanb7825ce2023-08-10 11:58:18 +0100493 bad = mbedtls_ct_bool_or(bad, mbedtls_ct_uint_gt(8, pad_count));
Dave Rodgman19e8cd02023-05-09 11:10:21 +0100494
495 /* If the padding is valid, set plaintext_size to the number of
496 * remaining bytes after stripping the padding. If the padding
497 * is invalid, avoid leaking this fact through the size of the
498 * output: use the maximum message size that fits in the output
499 * buffer. Do it without branches to avoid leaking the padding
500 * validity through timing. RSA keys are small enough that all the
501 * size_t values involved fit in unsigned int. */
Dave Rodgman2b4486a2023-05-17 15:51:59 +0100502 plaintext_size = mbedtls_ct_uint_if(
Dave Rodgman19e8cd02023-05-09 11:10:21 +0100503 bad, (unsigned) plaintext_max_size,
504 (unsigned) (ilen - pad_count - 3));
505
506 /* Set output_too_large to 0 if the plaintext fits in the output
507 * buffer and to 1 otherwise. */
Dave Rodgmanb7825ce2023-08-10 11:58:18 +0100508 output_too_large = mbedtls_ct_uint_gt(plaintext_size,
Dave Rodgman19e8cd02023-05-09 11:10:21 +0100509 plaintext_max_size);
510
511 /* Set ret without branches to avoid timing attacks. Return:
512 * - INVALID_PADDING if the padding is bad (bad != 0).
513 * - OUTPUT_TOO_LARGE if the padding is good but the decrypted
514 * plaintext does not fit in the output buffer.
515 * - 0 if the padding is correct. */
Dave Rodgmand03f4832023-09-22 09:52:15 +0100516 ret = mbedtls_ct_error_if(
Dave Rodgman9f9c3b82023-05-17 12:28:51 +0100517 bad,
Dave Rodgmand03f4832023-09-22 09:52:15 +0100518 MBEDTLS_ERR_RSA_INVALID_PADDING,
519 mbedtls_ct_error_if_else_0(output_too_large, MBEDTLS_ERR_RSA_OUTPUT_TOO_LARGE)
Dave Rodgman9f9c3b82023-05-17 12:28:51 +0100520 );
Dave Rodgman19e8cd02023-05-09 11:10:21 +0100521
522 /* If the padding is bad or the plaintext is too large, zero the
523 * data that we're about to copy to the output buffer.
524 * We need to copy the same amount of data
525 * from the same buffer whether the padding is good or not to
526 * avoid leaking the padding validity through overall timing or
527 * through memory or cache access patterns. */
Dave Rodgman9f9c3b82023-05-17 12:28:51 +0100528 mbedtls_ct_zeroize_if(mbedtls_ct_bool_or(bad, output_too_large), input + 11, ilen - 11);
Dave Rodgman19e8cd02023-05-09 11:10:21 +0100529
530 /* If the plaintext is too large, truncate it to the buffer size.
531 * Copy anyway to avoid revealing the length through timing, because
532 * revealing the length is as bad as revealing the padding validity
533 * for a Bleichenbacher attack. */
Dave Rodgman2b4486a2023-05-17 15:51:59 +0100534 plaintext_size = mbedtls_ct_uint_if(output_too_large,
Dave Rodgman19e8cd02023-05-09 11:10:21 +0100535 (unsigned) plaintext_max_size,
536 (unsigned) plaintext_size);
537
538 /* Move the plaintext to the leftmost position where it can start in
539 * the working buffer, i.e. make it start plaintext_max_size from
540 * the end of the buffer. Do this with a memory access trace that
541 * does not depend on the plaintext size. After this move, the
542 * starting location of the plaintext is no longer sensitive
543 * information. */
Dave Rodgman9f9c3b82023-05-17 12:28:51 +0100544 mbedtls_ct_memmove_left(input + ilen - plaintext_max_size,
545 plaintext_max_size,
546 plaintext_max_size - plaintext_size);
Dave Rodgman19e8cd02023-05-09 11:10:21 +0100547
548 /* Finally copy the decrypted plaintext plus trailing zeros into the output
549 * buffer. If output_max_len is 0, then output may be an invalid pointer
550 * and the result of memcpy() would be undefined; prevent undefined
551 * behavior making sure to depend only on output_max_len (the size of the
552 * user-provided output buffer), which is independent from plaintext
553 * length, validity of padding, success of the decryption, and other
554 * secrets. */
555 if (output_max_len != 0) {
556 memcpy(output, input + ilen - plaintext_max_size, plaintext_max_size);
557 }
558
559 /* Report the amount of data we copied to the output buffer. In case
560 * of errors (bad padding or output too large), the value of *olen
561 * when this function returns is not specified. Making it equivalent
562 * to the good case limits the risks of leaking the padding validity. */
563 *olen = plaintext_size;
564
565 return ret;
566}
567
568#endif /* MBEDTLS_PKCS1_V15 && MBEDTLS_RSA_C && ! MBEDTLS_RSA_ALT */
569
Hanno Beckera565f542017-10-11 11:00:19 +0100570#if !defined(MBEDTLS_RSA_ALT)
571
Gilles Peskine449bd832023-01-11 14:50:10 +0100572int mbedtls_rsa_import(mbedtls_rsa_context *ctx,
573 const mbedtls_mpi *N,
574 const mbedtls_mpi *P, const mbedtls_mpi *Q,
575 const mbedtls_mpi *D, const mbedtls_mpi *E)
Hanno Becker617c1ae2017-08-23 14:11:24 +0100576{
Janos Follath24eed8d2019-11-22 13:21:35 +0000577 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Hanno Becker617c1ae2017-08-23 14:11:24 +0100578
Gilles Peskine449bd832023-01-11 14:50:10 +0100579 if ((N != NULL && (ret = mbedtls_mpi_copy(&ctx->N, N)) != 0) ||
580 (P != NULL && (ret = mbedtls_mpi_copy(&ctx->P, P)) != 0) ||
581 (Q != NULL && (ret = mbedtls_mpi_copy(&ctx->Q, Q)) != 0) ||
582 (D != NULL && (ret = mbedtls_mpi_copy(&ctx->D, D)) != 0) ||
583 (E != NULL && (ret = mbedtls_mpi_copy(&ctx->E, E)) != 0)) {
584 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_RSA_BAD_INPUT_DATA, ret);
Hanno Becker617c1ae2017-08-23 14:11:24 +0100585 }
586
Gilles Peskine449bd832023-01-11 14:50:10 +0100587 if (N != NULL) {
588 ctx->len = mbedtls_mpi_size(&ctx->N);
589 }
Hanno Becker617c1ae2017-08-23 14:11:24 +0100590
Gilles Peskine449bd832023-01-11 14:50:10 +0100591 return 0;
Hanno Becker617c1ae2017-08-23 14:11:24 +0100592}
593
Gilles Peskine449bd832023-01-11 14:50:10 +0100594int mbedtls_rsa_import_raw(mbedtls_rsa_context *ctx,
595 unsigned char const *N, size_t N_len,
596 unsigned char const *P, size_t P_len,
597 unsigned char const *Q, size_t Q_len,
598 unsigned char const *D, size_t D_len,
599 unsigned char const *E, size_t E_len)
Hanno Becker617c1ae2017-08-23 14:11:24 +0100600{
Hanno Beckerd4d60572018-01-10 07:12:01 +0000601 int ret = 0;
Hanno Becker617c1ae2017-08-23 14:11:24 +0100602
Gilles Peskine449bd832023-01-11 14:50:10 +0100603 if (N != NULL) {
604 MBEDTLS_MPI_CHK(mbedtls_mpi_read_binary(&ctx->N, N, N_len));
605 ctx->len = mbedtls_mpi_size(&ctx->N);
Hanno Becker617c1ae2017-08-23 14:11:24 +0100606 }
607
Gilles Peskine449bd832023-01-11 14:50:10 +0100608 if (P != NULL) {
609 MBEDTLS_MPI_CHK(mbedtls_mpi_read_binary(&ctx->P, P, P_len));
610 }
Hanno Becker617c1ae2017-08-23 14:11:24 +0100611
Gilles Peskine449bd832023-01-11 14:50:10 +0100612 if (Q != NULL) {
613 MBEDTLS_MPI_CHK(mbedtls_mpi_read_binary(&ctx->Q, Q, Q_len));
614 }
Hanno Becker617c1ae2017-08-23 14:11:24 +0100615
Gilles Peskine449bd832023-01-11 14:50:10 +0100616 if (D != NULL) {
617 MBEDTLS_MPI_CHK(mbedtls_mpi_read_binary(&ctx->D, D, D_len));
618 }
Hanno Becker617c1ae2017-08-23 14:11:24 +0100619
Gilles Peskine449bd832023-01-11 14:50:10 +0100620 if (E != NULL) {
621 MBEDTLS_MPI_CHK(mbedtls_mpi_read_binary(&ctx->E, E, E_len));
622 }
Hanno Becker617c1ae2017-08-23 14:11:24 +0100623
624cleanup:
625
Gilles Peskine449bd832023-01-11 14:50:10 +0100626 if (ret != 0) {
627 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_RSA_BAD_INPUT_DATA, ret);
628 }
Hanno Becker617c1ae2017-08-23 14:11:24 +0100629
Gilles Peskine449bd832023-01-11 14:50:10 +0100630 return 0;
Hanno Becker617c1ae2017-08-23 14:11:24 +0100631}
632
Hanno Becker705fc682017-10-10 17:57:02 +0100633/*
634 * Checks whether the context fields are set in such a way
635 * that the RSA primitives will be able to execute without error.
636 * It does *not* make guarantees for consistency of the parameters.
637 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100638static int rsa_check_context(mbedtls_rsa_context const *ctx, int is_priv,
639 int blinding_needed)
Hanno Becker705fc682017-10-10 17:57:02 +0100640{
Hanno Beckerebd2c022017-10-12 10:54:53 +0100641#if !defined(MBEDTLS_RSA_NO_CRT)
642 /* blinding_needed is only used for NO_CRT to decide whether
643 * P,Q need to be present or not. */
644 ((void) blinding_needed);
645#endif
646
Gilles Peskine449bd832023-01-11 14:50:10 +0100647 if (ctx->len != mbedtls_mpi_size(&ctx->N) ||
648 ctx->len > MBEDTLS_MPI_MAX_SIZE) {
649 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
Hanno Becker3a760a12018-01-05 08:14:49 +0000650 }
Hanno Becker705fc682017-10-10 17:57:02 +0100651
652 /*
653 * 1. Modular exponentiation needs positive, odd moduli.
654 */
655
656 /* Modular exponentiation wrt. N is always used for
657 * RSA public key operations. */
Gilles Peskine449bd832023-01-11 14:50:10 +0100658 if (mbedtls_mpi_cmp_int(&ctx->N, 0) <= 0 ||
659 mbedtls_mpi_get_bit(&ctx->N, 0) == 0) {
660 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
Hanno Becker705fc682017-10-10 17:57:02 +0100661 }
662
663#if !defined(MBEDTLS_RSA_NO_CRT)
664 /* Modular exponentiation for P and Q is only
665 * used for private key operations and if CRT
666 * is used. */
Gilles Peskine449bd832023-01-11 14:50:10 +0100667 if (is_priv &&
668 (mbedtls_mpi_cmp_int(&ctx->P, 0) <= 0 ||
669 mbedtls_mpi_get_bit(&ctx->P, 0) == 0 ||
670 mbedtls_mpi_cmp_int(&ctx->Q, 0) <= 0 ||
671 mbedtls_mpi_get_bit(&ctx->Q, 0) == 0)) {
672 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
Hanno Becker705fc682017-10-10 17:57:02 +0100673 }
674#endif /* !MBEDTLS_RSA_NO_CRT */
675
676 /*
677 * 2. Exponents must be positive
678 */
679
680 /* Always need E for public key operations */
Gilles Peskine449bd832023-01-11 14:50:10 +0100681 if (mbedtls_mpi_cmp_int(&ctx->E, 0) <= 0) {
682 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
683 }
Hanno Becker705fc682017-10-10 17:57:02 +0100684
Hanno Beckerb82a5b52017-10-11 19:10:23 +0100685#if defined(MBEDTLS_RSA_NO_CRT)
Hanno Becker705fc682017-10-10 17:57:02 +0100686 /* For private key operations, use D or DP & DQ
687 * as (unblinded) exponents. */
Gilles Peskine449bd832023-01-11 14:50:10 +0100688 if (is_priv && mbedtls_mpi_cmp_int(&ctx->D, 0) <= 0) {
689 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
690 }
Hanno Becker705fc682017-10-10 17:57:02 +0100691#else
Gilles Peskine449bd832023-01-11 14:50:10 +0100692 if (is_priv &&
693 (mbedtls_mpi_cmp_int(&ctx->DP, 0) <= 0 ||
694 mbedtls_mpi_cmp_int(&ctx->DQ, 0) <= 0)) {
695 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
Hanno Becker705fc682017-10-10 17:57:02 +0100696 }
697#endif /* MBEDTLS_RSA_NO_CRT */
698
699 /* Blinding shouldn't make exponents negative either,
700 * so check that P, Q >= 1 if that hasn't yet been
701 * done as part of 1. */
Hanno Beckerb82a5b52017-10-11 19:10:23 +0100702#if defined(MBEDTLS_RSA_NO_CRT)
Gilles Peskine449bd832023-01-11 14:50:10 +0100703 if (is_priv && blinding_needed &&
704 (mbedtls_mpi_cmp_int(&ctx->P, 0) <= 0 ||
705 mbedtls_mpi_cmp_int(&ctx->Q, 0) <= 0)) {
706 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
Hanno Becker705fc682017-10-10 17:57:02 +0100707 }
708#endif
709
710 /* It wouldn't lead to an error if it wasn't satisfied,
Hanno Beckerf8c028a2017-10-17 09:20:57 +0100711 * but check for QP >= 1 nonetheless. */
Hanno Beckerb82a5b52017-10-11 19:10:23 +0100712#if !defined(MBEDTLS_RSA_NO_CRT)
Gilles Peskine449bd832023-01-11 14:50:10 +0100713 if (is_priv &&
714 mbedtls_mpi_cmp_int(&ctx->QP, 0) <= 0) {
715 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
Hanno Becker705fc682017-10-10 17:57:02 +0100716 }
717#endif
718
Gilles Peskine449bd832023-01-11 14:50:10 +0100719 return 0;
Hanno Becker705fc682017-10-10 17:57:02 +0100720}
721
Gilles Peskine449bd832023-01-11 14:50:10 +0100722int mbedtls_rsa_complete(mbedtls_rsa_context *ctx)
Hanno Beckere2e8b8d2017-08-23 14:06:45 +0100723{
724 int ret = 0;
Jack Lloyd8c2631b2020-01-23 17:23:52 -0500725 int have_N, have_P, have_Q, have_D, have_E;
726#if !defined(MBEDTLS_RSA_NO_CRT)
727 int have_DP, have_DQ, have_QP;
728#endif
Andrzej Kurekc470b6b2019-01-31 08:20:20 -0500729 int n_missing, pq_missing, d_missing, is_pub, is_priv;
Hanno Beckere2e8b8d2017-08-23 14:06:45 +0100730
Gilles Peskine449bd832023-01-11 14:50:10 +0100731 have_N = (mbedtls_mpi_cmp_int(&ctx->N, 0) != 0);
732 have_P = (mbedtls_mpi_cmp_int(&ctx->P, 0) != 0);
733 have_Q = (mbedtls_mpi_cmp_int(&ctx->Q, 0) != 0);
734 have_D = (mbedtls_mpi_cmp_int(&ctx->D, 0) != 0);
735 have_E = (mbedtls_mpi_cmp_int(&ctx->E, 0) != 0);
Jack Lloyd8c2631b2020-01-23 17:23:52 -0500736
737#if !defined(MBEDTLS_RSA_NO_CRT)
Gilles Peskine449bd832023-01-11 14:50:10 +0100738 have_DP = (mbedtls_mpi_cmp_int(&ctx->DP, 0) != 0);
739 have_DQ = (mbedtls_mpi_cmp_int(&ctx->DQ, 0) != 0);
740 have_QP = (mbedtls_mpi_cmp_int(&ctx->QP, 0) != 0);
Jack Lloyd8c2631b2020-01-23 17:23:52 -0500741#endif
Hanno Beckere2e8b8d2017-08-23 14:06:45 +0100742
Hanno Becker617c1ae2017-08-23 14:11:24 +0100743 /*
744 * Check whether provided parameters are enough
745 * to deduce all others. The following incomplete
746 * parameter sets for private keys are supported:
747 *
748 * (1) P, Q missing.
749 * (2) D and potentially N missing.
750 *
751 */
Hanno Beckere2e8b8d2017-08-23 14:06:45 +0100752
Andrzej Kurekc470b6b2019-01-31 08:20:20 -0500753 n_missing = have_P && have_Q && have_D && have_E;
754 pq_missing = have_N && !have_P && !have_Q && have_D && have_E;
755 d_missing = have_P && have_Q && !have_D && have_E;
756 is_pub = have_N && !have_P && !have_Q && !have_D && have_E;
Hanno Becker2cca6f32017-09-29 11:46:40 +0100757
758 /* These three alternatives are mutually exclusive */
Andrzej Kurekc470b6b2019-01-31 08:20:20 -0500759 is_priv = n_missing || pq_missing || d_missing;
Hanno Beckere2e8b8d2017-08-23 14:06:45 +0100760
Gilles Peskine449bd832023-01-11 14:50:10 +0100761 if (!is_priv && !is_pub) {
762 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
763 }
Hanno Becker617c1ae2017-08-23 14:11:24 +0100764
765 /*
Hanno Becker2cca6f32017-09-29 11:46:40 +0100766 * Step 1: Deduce N if P, Q are provided.
767 */
768
Gilles Peskine449bd832023-01-11 14:50:10 +0100769 if (!have_N && have_P && have_Q) {
770 if ((ret = mbedtls_mpi_mul_mpi(&ctx->N, &ctx->P,
771 &ctx->Q)) != 0) {
772 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_RSA_BAD_INPUT_DATA, ret);
Hanno Becker2cca6f32017-09-29 11:46:40 +0100773 }
774
Gilles Peskine449bd832023-01-11 14:50:10 +0100775 ctx->len = mbedtls_mpi_size(&ctx->N);
Hanno Becker2cca6f32017-09-29 11:46:40 +0100776 }
777
778 /*
779 * Step 2: Deduce and verify all remaining core parameters.
Hanno Becker617c1ae2017-08-23 14:11:24 +0100780 */
781
Gilles Peskine449bd832023-01-11 14:50:10 +0100782 if (pq_missing) {
783 ret = mbedtls_rsa_deduce_primes(&ctx->N, &ctx->E, &ctx->D,
784 &ctx->P, &ctx->Q);
785 if (ret != 0) {
786 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_RSA_BAD_INPUT_DATA, ret);
787 }
Hanno Becker617c1ae2017-08-23 14:11:24 +0100788
Gilles Peskine449bd832023-01-11 14:50:10 +0100789 } else if (d_missing) {
790 if ((ret = mbedtls_rsa_deduce_private_exponent(&ctx->P,
791 &ctx->Q,
792 &ctx->E,
793 &ctx->D)) != 0) {
794 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_RSA_BAD_INPUT_DATA, ret);
Hanno Becker617c1ae2017-08-23 14:11:24 +0100795 }
796 }
Hanno Becker617c1ae2017-08-23 14:11:24 +0100797
Hanno Becker617c1ae2017-08-23 14:11:24 +0100798 /*
Hanno Becker2cca6f32017-09-29 11:46:40 +0100799 * Step 3: Deduce all additional parameters specific
Hanno Beckere8674892017-10-10 17:56:14 +0100800 * to our current RSA implementation.
Hanno Becker617c1ae2017-08-23 14:11:24 +0100801 */
802
Hanno Becker23344b52017-08-23 07:43:27 +0100803#if !defined(MBEDTLS_RSA_NO_CRT)
Gilles Peskine449bd832023-01-11 14:50:10 +0100804 if (is_priv && !(have_DP && have_DQ && have_QP)) {
805 ret = mbedtls_rsa_deduce_crt(&ctx->P, &ctx->Q, &ctx->D,
806 &ctx->DP, &ctx->DQ, &ctx->QP);
807 if (ret != 0) {
808 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_RSA_BAD_INPUT_DATA, ret);
809 }
Hanno Becker617c1ae2017-08-23 14:11:24 +0100810 }
Hanno Becker23344b52017-08-23 07:43:27 +0100811#endif /* MBEDTLS_RSA_NO_CRT */
Hanno Becker617c1ae2017-08-23 14:11:24 +0100812
813 /*
Hanno Becker705fc682017-10-10 17:57:02 +0100814 * Step 3: Basic sanity checks
Hanno Becker617c1ae2017-08-23 14:11:24 +0100815 */
816
Gilles Peskine449bd832023-01-11 14:50:10 +0100817 return rsa_check_context(ctx, is_priv, 1);
Hanno Becker617c1ae2017-08-23 14:11:24 +0100818}
819
Gilles Peskine449bd832023-01-11 14:50:10 +0100820int mbedtls_rsa_export_raw(const mbedtls_rsa_context *ctx,
821 unsigned char *N, size_t N_len,
822 unsigned char *P, size_t P_len,
823 unsigned char *Q, size_t Q_len,
824 unsigned char *D, size_t D_len,
825 unsigned char *E, size_t E_len)
Hanno Becker617c1ae2017-08-23 14:11:24 +0100826{
827 int ret = 0;
Andrzej Kurekc470b6b2019-01-31 08:20:20 -0500828 int is_priv;
Hanno Becker617c1ae2017-08-23 14:11:24 +0100829
830 /* Check if key is private or public */
Andrzej Kurekc470b6b2019-01-31 08:20:20 -0500831 is_priv =
Gilles Peskine449bd832023-01-11 14:50:10 +0100832 mbedtls_mpi_cmp_int(&ctx->N, 0) != 0 &&
833 mbedtls_mpi_cmp_int(&ctx->P, 0) != 0 &&
834 mbedtls_mpi_cmp_int(&ctx->Q, 0) != 0 &&
835 mbedtls_mpi_cmp_int(&ctx->D, 0) != 0 &&
836 mbedtls_mpi_cmp_int(&ctx->E, 0) != 0;
Hanno Becker617c1ae2017-08-23 14:11:24 +0100837
Gilles Peskine449bd832023-01-11 14:50:10 +0100838 if (!is_priv) {
Hanno Becker617c1ae2017-08-23 14:11:24 +0100839 /* If we're trying to export private parameters for a public key,
840 * something must be wrong. */
Gilles Peskine449bd832023-01-11 14:50:10 +0100841 if (P != NULL || Q != NULL || D != NULL) {
842 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
843 }
Hanno Becker617c1ae2017-08-23 14:11:24 +0100844
845 }
846
Gilles Peskine449bd832023-01-11 14:50:10 +0100847 if (N != NULL) {
848 MBEDTLS_MPI_CHK(mbedtls_mpi_write_binary(&ctx->N, N, N_len));
849 }
Hanno Becker617c1ae2017-08-23 14:11:24 +0100850
Gilles Peskine449bd832023-01-11 14:50:10 +0100851 if (P != NULL) {
852 MBEDTLS_MPI_CHK(mbedtls_mpi_write_binary(&ctx->P, P, P_len));
853 }
Hanno Becker617c1ae2017-08-23 14:11:24 +0100854
Gilles Peskine449bd832023-01-11 14:50:10 +0100855 if (Q != NULL) {
856 MBEDTLS_MPI_CHK(mbedtls_mpi_write_binary(&ctx->Q, Q, Q_len));
857 }
Hanno Becker617c1ae2017-08-23 14:11:24 +0100858
Gilles Peskine449bd832023-01-11 14:50:10 +0100859 if (D != NULL) {
860 MBEDTLS_MPI_CHK(mbedtls_mpi_write_binary(&ctx->D, D, D_len));
861 }
Hanno Becker617c1ae2017-08-23 14:11:24 +0100862
Gilles Peskine449bd832023-01-11 14:50:10 +0100863 if (E != NULL) {
864 MBEDTLS_MPI_CHK(mbedtls_mpi_write_binary(&ctx->E, E, E_len));
865 }
Hanno Beckere2e8b8d2017-08-23 14:06:45 +0100866
867cleanup:
868
Gilles Peskine449bd832023-01-11 14:50:10 +0100869 return ret;
Hanno Beckere2e8b8d2017-08-23 14:06:45 +0100870}
871
Gilles Peskine449bd832023-01-11 14:50:10 +0100872int mbedtls_rsa_export(const mbedtls_rsa_context *ctx,
873 mbedtls_mpi *N, mbedtls_mpi *P, mbedtls_mpi *Q,
874 mbedtls_mpi *D, mbedtls_mpi *E)
Hanno Becker617c1ae2017-08-23 14:11:24 +0100875{
Janos Follath24eed8d2019-11-22 13:21:35 +0000876 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Andrzej Kurekc470b6b2019-01-31 08:20:20 -0500877 int is_priv;
Hanno Becker617c1ae2017-08-23 14:11:24 +0100878
879 /* Check if key is private or public */
Andrzej Kurekc470b6b2019-01-31 08:20:20 -0500880 is_priv =
Gilles Peskine449bd832023-01-11 14:50:10 +0100881 mbedtls_mpi_cmp_int(&ctx->N, 0) != 0 &&
882 mbedtls_mpi_cmp_int(&ctx->P, 0) != 0 &&
883 mbedtls_mpi_cmp_int(&ctx->Q, 0) != 0 &&
884 mbedtls_mpi_cmp_int(&ctx->D, 0) != 0 &&
885 mbedtls_mpi_cmp_int(&ctx->E, 0) != 0;
Hanno Becker617c1ae2017-08-23 14:11:24 +0100886
Gilles Peskine449bd832023-01-11 14:50:10 +0100887 if (!is_priv) {
Hanno Becker617c1ae2017-08-23 14:11:24 +0100888 /* If we're trying to export private parameters for a public key,
889 * something must be wrong. */
Gilles Peskine449bd832023-01-11 14:50:10 +0100890 if (P != NULL || Q != NULL || D != NULL) {
891 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
892 }
Hanno Becker617c1ae2017-08-23 14:11:24 +0100893
894 }
895
896 /* Export all requested core parameters. */
897
Gilles Peskine449bd832023-01-11 14:50:10 +0100898 if ((N != NULL && (ret = mbedtls_mpi_copy(N, &ctx->N)) != 0) ||
899 (P != NULL && (ret = mbedtls_mpi_copy(P, &ctx->P)) != 0) ||
900 (Q != NULL && (ret = mbedtls_mpi_copy(Q, &ctx->Q)) != 0) ||
901 (D != NULL && (ret = mbedtls_mpi_copy(D, &ctx->D)) != 0) ||
902 (E != NULL && (ret = mbedtls_mpi_copy(E, &ctx->E)) != 0)) {
903 return ret;
Hanno Becker617c1ae2017-08-23 14:11:24 +0100904 }
905
Gilles Peskine449bd832023-01-11 14:50:10 +0100906 return 0;
Hanno Becker617c1ae2017-08-23 14:11:24 +0100907}
908
909/*
910 * Export CRT parameters
911 * This must also be implemented if CRT is not used, for being able to
912 * write DER encoded RSA keys. The helper function mbedtls_rsa_deduce_crt
913 * can be used in this case.
914 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100915int mbedtls_rsa_export_crt(const mbedtls_rsa_context *ctx,
916 mbedtls_mpi *DP, mbedtls_mpi *DQ, mbedtls_mpi *QP)
Hanno Becker617c1ae2017-08-23 14:11:24 +0100917{
Janos Follath24eed8d2019-11-22 13:21:35 +0000918 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Andrzej Kurekc470b6b2019-01-31 08:20:20 -0500919 int is_priv;
Hanno Becker617c1ae2017-08-23 14:11:24 +0100920
921 /* Check if key is private or public */
Andrzej Kurekc470b6b2019-01-31 08:20:20 -0500922 is_priv =
Gilles Peskine449bd832023-01-11 14:50:10 +0100923 mbedtls_mpi_cmp_int(&ctx->N, 0) != 0 &&
924 mbedtls_mpi_cmp_int(&ctx->P, 0) != 0 &&
925 mbedtls_mpi_cmp_int(&ctx->Q, 0) != 0 &&
926 mbedtls_mpi_cmp_int(&ctx->D, 0) != 0 &&
927 mbedtls_mpi_cmp_int(&ctx->E, 0) != 0;
Hanno Becker617c1ae2017-08-23 14:11:24 +0100928
Gilles Peskine449bd832023-01-11 14:50:10 +0100929 if (!is_priv) {
930 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
931 }
Hanno Becker617c1ae2017-08-23 14:11:24 +0100932
Hanno Beckerdc95c892017-08-23 06:57:02 +0100933#if !defined(MBEDTLS_RSA_NO_CRT)
Hanno Becker617c1ae2017-08-23 14:11:24 +0100934 /* Export all requested blinding parameters. */
Gilles Peskine449bd832023-01-11 14:50:10 +0100935 if ((DP != NULL && (ret = mbedtls_mpi_copy(DP, &ctx->DP)) != 0) ||
936 (DQ != NULL && (ret = mbedtls_mpi_copy(DQ, &ctx->DQ)) != 0) ||
937 (QP != NULL && (ret = mbedtls_mpi_copy(QP, &ctx->QP)) != 0)) {
938 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_RSA_BAD_INPUT_DATA, ret);
Hanno Becker617c1ae2017-08-23 14:11:24 +0100939 }
Hanno Beckerdc95c892017-08-23 06:57:02 +0100940#else
Gilles Peskine449bd832023-01-11 14:50:10 +0100941 if ((ret = mbedtls_rsa_deduce_crt(&ctx->P, &ctx->Q, &ctx->D,
942 DP, DQ, QP)) != 0) {
943 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_RSA_BAD_INPUT_DATA, ret);
Hanno Beckerdc95c892017-08-23 06:57:02 +0100944 }
945#endif
Hanno Becker617c1ae2017-08-23 14:11:24 +0100946
Gilles Peskine449bd832023-01-11 14:50:10 +0100947 return 0;
Hanno Becker617c1ae2017-08-23 14:11:24 +0100948}
Hanno Beckere2e8b8d2017-08-23 14:06:45 +0100949
Paul Bakker5121ce52009-01-03 21:22:43 +0000950/*
951 * Initialize an RSA context
952 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100953void mbedtls_rsa_init(mbedtls_rsa_context *ctx)
Paul Bakker5121ce52009-01-03 21:22:43 +0000954{
Gilles Peskine449bd832023-01-11 14:50:10 +0100955 memset(ctx, 0, sizeof(mbedtls_rsa_context));
Paul Bakker5121ce52009-01-03 21:22:43 +0000956
Ronald Cronc1905a12021-06-05 11:11:14 +0200957 ctx->padding = MBEDTLS_RSA_PKCS_V15;
958 ctx->hash_id = MBEDTLS_MD_NONE;
Paul Bakkerc9965dc2013-09-29 14:58:17 +0200959
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200960#if defined(MBEDTLS_THREADING_C)
Gilles Peskineeb940592021-02-01 17:57:41 +0100961 /* Set ctx->ver to nonzero to indicate that the mutex has been
962 * initialized and will need to be freed. */
963 ctx->ver = 1;
Gilles Peskine449bd832023-01-11 14:50:10 +0100964 mbedtls_mutex_init(&ctx->mutex);
Paul Bakkerc9965dc2013-09-29 14:58:17 +0200965#endif
Paul Bakker5121ce52009-01-03 21:22:43 +0000966}
967
Manuel Pégourié-Gonnard844a4c02014-03-10 21:55:35 +0100968/*
969 * Set padding for an existing RSA context
970 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100971int mbedtls_rsa_set_padding(mbedtls_rsa_context *ctx, int padding,
972 mbedtls_md_type_t hash_id)
Manuel Pégourié-Gonnard844a4c02014-03-10 21:55:35 +0100973{
Gilles Peskine449bd832023-01-11 14:50:10 +0100974 switch (padding) {
Ronald Cron3a0375f2021-06-08 10:22:28 +0200975#if defined(MBEDTLS_PKCS1_V15)
976 case MBEDTLS_RSA_PKCS_V15:
977 break;
978#endif
979
980#if defined(MBEDTLS_PKCS1_V21)
981 case MBEDTLS_RSA_PKCS_V21:
982 break;
983#endif
984 default:
Gilles Peskine449bd832023-01-11 14:50:10 +0100985 return MBEDTLS_ERR_RSA_INVALID_PADDING;
Ronald Cron3a0375f2021-06-08 10:22:28 +0200986 }
Ronald Cronea7631b2021-06-03 18:51:59 +0200987
Manuel Pégourié-Gonnard3356b892022-07-05 10:25:06 +0200988#if defined(MBEDTLS_PKCS1_V21)
Gilles Peskine449bd832023-01-11 14:50:10 +0100989 if ((padding == MBEDTLS_RSA_PKCS_V21) &&
990 (hash_id != MBEDTLS_MD_NONE)) {
Manuel Pégourié-Gonnardfaa3b4e2022-07-15 13:18:15 +0200991 /* Just make sure this hash is supported in this build. */
Manuel Pégourié-Gonnard28f504e2023-03-30 09:42:10 +0200992 if (mbedtls_md_info_from_type(hash_id) == NULL) {
Gilles Peskine449bd832023-01-11 14:50:10 +0100993 return MBEDTLS_ERR_RSA_INVALID_PADDING;
994 }
Ronald Cronea7631b2021-06-03 18:51:59 +0200995 }
Manuel Pégourié-Gonnard3356b892022-07-05 10:25:06 +0200996#endif /* MBEDTLS_PKCS1_V21 */
Andrzej Kurekc470b6b2019-01-31 08:20:20 -0500997
Manuel Pégourié-Gonnard844a4c02014-03-10 21:55:35 +0100998 ctx->padding = padding;
999 ctx->hash_id = hash_id;
Ronald Cronea7631b2021-06-03 18:51:59 +02001000
Gilles Peskine449bd832023-01-11 14:50:10 +01001001 return 0;
Manuel Pégourié-Gonnard844a4c02014-03-10 21:55:35 +01001002}
1003
Hanno Becker617c1ae2017-08-23 14:11:24 +01001004/*
Yanray Wang83548b52023-03-15 16:46:34 +08001005 * Get padding mode of initialized RSA context
Yanray Wanga730df62023-03-01 10:18:19 +08001006 */
1007int mbedtls_rsa_get_padding_mode(const mbedtls_rsa_context *ctx)
1008{
Yanray Wang644b9012023-03-15 16:50:31 +08001009 return ctx->padding;
Yanray Wanga730df62023-03-01 10:18:19 +08001010}
1011
1012/*
Yanray Wang12cb3962023-03-01 10:20:02 +08001013 * Get hash identifier of mbedtls_md_type_t type
1014 */
Yanray Wangd41684e2023-03-17 18:54:22 +08001015int mbedtls_rsa_get_md_alg(const mbedtls_rsa_context *ctx)
Yanray Wang12cb3962023-03-01 10:20:02 +08001016{
Yanray Wang644b9012023-03-15 16:50:31 +08001017 return ctx->hash_id;
Yanray Wang12cb3962023-03-01 10:20:02 +08001018}
1019
1020/*
Gilles Peskine19f1adf2024-02-01 22:17:44 +01001021 * Get length in bits of RSA modulus
1022 */
1023size_t mbedtls_rsa_get_bitlen(const mbedtls_rsa_context *ctx)
1024{
1025 return mbedtls_mpi_bitlen(&ctx->N);
1026}
1027
1028/*
Hanno Becker617c1ae2017-08-23 14:11:24 +01001029 * Get length in bytes of RSA modulus
1030 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001031size_t mbedtls_rsa_get_len(const mbedtls_rsa_context *ctx)
Hanno Becker617c1ae2017-08-23 14:11:24 +01001032{
Gilles Peskine449bd832023-01-11 14:50:10 +01001033 return ctx->len;
Hanno Becker617c1ae2017-08-23 14:11:24 +01001034}
1035
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001036#if defined(MBEDTLS_GENPRIME)
Paul Bakker5121ce52009-01-03 21:22:43 +00001037
1038/*
1039 * Generate an RSA keypair
Jethro Beekmanc645bfe2018-02-14 19:27:13 -08001040 *
1041 * This generation method follows the RSA key pair generation procedure of
1042 * FIPS 186-4 if 2^16 < exponent < 2^256 and nbits = 2048 or nbits = 3072.
Paul Bakker5121ce52009-01-03 21:22:43 +00001043 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001044int mbedtls_rsa_gen_key(mbedtls_rsa_context *ctx,
1045 int (*f_rng)(void *, unsigned char *, size_t),
1046 void *p_rng,
1047 unsigned int nbits, int exponent)
Paul Bakker5121ce52009-01-03 21:22:43 +00001048{
Janos Follath24eed8d2019-11-22 13:21:35 +00001049 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Jethro Beekman97f95c92018-02-13 15:50:36 -08001050 mbedtls_mpi H, G, L;
Janos Follathb8fc1b02018-09-03 15:37:01 +01001051 int prime_quality = 0;
Paul Bakker5121ce52009-01-03 21:22:43 +00001052
Janos Follathb8fc1b02018-09-03 15:37:01 +01001053 /*
1054 * If the modulus is 1024 bit long or shorter, then the security strength of
1055 * the RSA algorithm is less than or equal to 80 bits and therefore an error
1056 * rate of 2^-80 is sufficient.
1057 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001058 if (nbits > 1024) {
Janos Follathb8fc1b02018-09-03 15:37:01 +01001059 prime_quality = MBEDTLS_MPI_GEN_PRIME_FLAG_LOW_ERR;
Gilles Peskine449bd832023-01-11 14:50:10 +01001060 }
Janos Follathb8fc1b02018-09-03 15:37:01 +01001061
Gilles Peskine449bd832023-01-11 14:50:10 +01001062 mbedtls_mpi_init(&H);
1063 mbedtls_mpi_init(&G);
1064 mbedtls_mpi_init(&L);
Paul Bakker5121ce52009-01-03 21:22:43 +00001065
Waleed Elmelegyd7bdbbe2023-07-20 16:26:58 +00001066 if (exponent < 3 || nbits % 2 != 0) {
Gilles Peskine5e40a7c2021-02-02 21:06:10 +01001067 ret = MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
1068 goto cleanup;
1069 }
1070
Waleed Elmelegyd7bdbbe2023-07-20 16:26:58 +00001071 if (nbits < MBEDTLS_RSA_GEN_KEY_MIN_BITS) {
Paul Bakker5121ce52009-01-03 21:22:43 +00001072 ret = MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
1073 goto cleanup;
1074 }
1075
1076 /*
1077 * find primes P and Q with Q < P so that:
Jethro Beekmanc645bfe2018-02-14 19:27:13 -08001078 * 1. |P-Q| > 2^( nbits / 2 - 100 )
1079 * 2. GCD( E, (P-1)*(Q-1) ) == 1
1080 * 3. E^-1 mod LCM(P-1, Q-1) > 2^( nbits / 2 )
Paul Bakker5121ce52009-01-03 21:22:43 +00001081 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001082 MBEDTLS_MPI_CHK(mbedtls_mpi_lset(&ctx->E, exponent));
Paul Bakker5121ce52009-01-03 21:22:43 +00001083
Gilles Peskine449bd832023-01-11 14:50:10 +01001084 do {
1085 MBEDTLS_MPI_CHK(mbedtls_mpi_gen_prime(&ctx->P, nbits >> 1,
1086 prime_quality, f_rng, p_rng));
Paul Bakker5121ce52009-01-03 21:22:43 +00001087
Gilles Peskine449bd832023-01-11 14:50:10 +01001088 MBEDTLS_MPI_CHK(mbedtls_mpi_gen_prime(&ctx->Q, nbits >> 1,
1089 prime_quality, f_rng, p_rng));
Paul Bakker5121ce52009-01-03 21:22:43 +00001090
Jethro Beekmanc645bfe2018-02-14 19:27:13 -08001091 /* make sure the difference between p and q is not too small (FIPS 186-4 §B.3.3 step 5.4) */
Gilles Peskine449bd832023-01-11 14:50:10 +01001092 MBEDTLS_MPI_CHK(mbedtls_mpi_sub_mpi(&H, &ctx->P, &ctx->Q));
1093 if (mbedtls_mpi_bitlen(&H) <= ((nbits >= 200) ? ((nbits >> 1) - 99) : 0)) {
Paul Bakker5121ce52009-01-03 21:22:43 +00001094 continue;
Gilles Peskine449bd832023-01-11 14:50:10 +01001095 }
Paul Bakker5121ce52009-01-03 21:22:43 +00001096
Jethro Beekmanc645bfe2018-02-14 19:27:13 -08001097 /* not required by any standards, but some users rely on the fact that P > Q */
Gilles Peskine449bd832023-01-11 14:50:10 +01001098 if (H.s < 0) {
1099 mbedtls_mpi_swap(&ctx->P, &ctx->Q);
1100 }
Janos Follathef441782016-09-21 13:18:12 +01001101
Hanno Beckerbee3aae2017-08-23 06:59:15 +01001102 /* Temporarily replace P,Q by P-1, Q-1 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001103 MBEDTLS_MPI_CHK(mbedtls_mpi_sub_int(&ctx->P, &ctx->P, 1));
1104 MBEDTLS_MPI_CHK(mbedtls_mpi_sub_int(&ctx->Q, &ctx->Q, 1));
1105 MBEDTLS_MPI_CHK(mbedtls_mpi_mul_mpi(&H, &ctx->P, &ctx->Q));
Jethro Beekman97f95c92018-02-13 15:50:36 -08001106
Jethro Beekmanc645bfe2018-02-14 19:27:13 -08001107 /* check GCD( E, (P-1)*(Q-1) ) == 1 (FIPS 186-4 §B.3.1 criterion 2(a)) */
Gilles Peskine449bd832023-01-11 14:50:10 +01001108 MBEDTLS_MPI_CHK(mbedtls_mpi_gcd(&G, &ctx->E, &H));
1109 if (mbedtls_mpi_cmp_int(&G, 1) != 0) {
Jethro Beekman97f95c92018-02-13 15:50:36 -08001110 continue;
Gilles Peskine449bd832023-01-11 14:50:10 +01001111 }
Jethro Beekman97f95c92018-02-13 15:50:36 -08001112
Jethro Beekmanc645bfe2018-02-14 19:27:13 -08001113 /* compute smallest possible D = E^-1 mod LCM(P-1, Q-1) (FIPS 186-4 §B.3.1 criterion 3(b)) */
Gilles Peskine449bd832023-01-11 14:50:10 +01001114 MBEDTLS_MPI_CHK(mbedtls_mpi_gcd(&G, &ctx->P, &ctx->Q));
1115 MBEDTLS_MPI_CHK(mbedtls_mpi_div_mpi(&L, NULL, &H, &G));
1116 MBEDTLS_MPI_CHK(mbedtls_mpi_inv_mod(&ctx->D, &ctx->E, &L));
Jethro Beekman97f95c92018-02-13 15:50:36 -08001117
Gilles Peskine449bd832023-01-11 14:50:10 +01001118 if (mbedtls_mpi_bitlen(&ctx->D) <= ((nbits + 1) / 2)) { // (FIPS 186-4 §B.3.1 criterion 3(a))
Jethro Beekman97f95c92018-02-13 15:50:36 -08001119 continue;
Gilles Peskine449bd832023-01-11 14:50:10 +01001120 }
Jethro Beekman97f95c92018-02-13 15:50:36 -08001121
1122 break;
Gilles Peskine449bd832023-01-11 14:50:10 +01001123 } while (1);
Paul Bakker5121ce52009-01-03 21:22:43 +00001124
Hanno Beckerbee3aae2017-08-23 06:59:15 +01001125 /* Restore P,Q */
Gilles Peskine449bd832023-01-11 14:50:10 +01001126 MBEDTLS_MPI_CHK(mbedtls_mpi_add_int(&ctx->P, &ctx->P, 1));
1127 MBEDTLS_MPI_CHK(mbedtls_mpi_add_int(&ctx->Q, &ctx->Q, 1));
Hanno Beckerbee3aae2017-08-23 06:59:15 +01001128
Gilles Peskine449bd832023-01-11 14:50:10 +01001129 MBEDTLS_MPI_CHK(mbedtls_mpi_mul_mpi(&ctx->N, &ctx->P, &ctx->Q));
Jethro Beekmanc645bfe2018-02-14 19:27:13 -08001130
Gilles Peskine449bd832023-01-11 14:50:10 +01001131 ctx->len = mbedtls_mpi_size(&ctx->N);
Hanno Beckerbee3aae2017-08-23 06:59:15 +01001132
Jethro Beekman97f95c92018-02-13 15:50:36 -08001133#if !defined(MBEDTLS_RSA_NO_CRT)
Paul Bakker5121ce52009-01-03 21:22:43 +00001134 /*
Paul Bakker5121ce52009-01-03 21:22:43 +00001135 * DP = D mod (P - 1)
1136 * DQ = D mod (Q - 1)
1137 * QP = Q^-1 mod P
1138 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001139 MBEDTLS_MPI_CHK(mbedtls_rsa_deduce_crt(&ctx->P, &ctx->Q, &ctx->D,
1140 &ctx->DP, &ctx->DQ, &ctx->QP));
Hanno Beckerbee3aae2017-08-23 06:59:15 +01001141#endif /* MBEDTLS_RSA_NO_CRT */
Paul Bakker5121ce52009-01-03 21:22:43 +00001142
Hanno Becker83aad1f2017-08-23 06:45:10 +01001143 /* Double-check */
Gilles Peskine449bd832023-01-11 14:50:10 +01001144 MBEDTLS_MPI_CHK(mbedtls_rsa_check_privkey(ctx));
Paul Bakker5121ce52009-01-03 21:22:43 +00001145
1146cleanup:
1147
Gilles Peskine449bd832023-01-11 14:50:10 +01001148 mbedtls_mpi_free(&H);
1149 mbedtls_mpi_free(&G);
1150 mbedtls_mpi_free(&L);
Paul Bakker5121ce52009-01-03 21:22:43 +00001151
Gilles Peskine449bd832023-01-11 14:50:10 +01001152 if (ret != 0) {
1153 mbedtls_rsa_free(ctx);
Chris Jones74392092021-04-01 16:00:01 +01001154
Gilles Peskine449bd832023-01-11 14:50:10 +01001155 if ((-ret & ~0x7f) == 0) {
1156 ret = MBEDTLS_ERROR_ADD(MBEDTLS_ERR_RSA_KEY_GEN_FAILED, ret);
1157 }
1158 return ret;
Paul Bakker5121ce52009-01-03 21:22:43 +00001159 }
1160
Gilles Peskine449bd832023-01-11 14:50:10 +01001161 return 0;
Paul Bakker5121ce52009-01-03 21:22:43 +00001162}
1163
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001164#endif /* MBEDTLS_GENPRIME */
Paul Bakker5121ce52009-01-03 21:22:43 +00001165
1166/*
1167 * Check a public RSA key
1168 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001169int mbedtls_rsa_check_pubkey(const mbedtls_rsa_context *ctx)
Paul Bakker5121ce52009-01-03 21:22:43 +00001170{
Gilles Peskine449bd832023-01-11 14:50:10 +01001171 if (rsa_check_context(ctx, 0 /* public */, 0 /* no blinding */) != 0) {
1172 return MBEDTLS_ERR_RSA_KEY_CHECK_FAILED;
Hanno Becker98838b02017-10-02 13:16:10 +01001173 }
Paul Bakker5121ce52009-01-03 21:22:43 +00001174
Gilles Peskine449bd832023-01-11 14:50:10 +01001175 if (mbedtls_mpi_bitlen(&ctx->N) < 128) {
1176 return MBEDTLS_ERR_RSA_KEY_CHECK_FAILED;
Hanno Becker98838b02017-10-02 13:16:10 +01001177 }
Paul Bakker5121ce52009-01-03 21:22:43 +00001178
Gilles Peskine449bd832023-01-11 14:50:10 +01001179 if (mbedtls_mpi_get_bit(&ctx->E, 0) == 0 ||
1180 mbedtls_mpi_bitlen(&ctx->E) < 2 ||
1181 mbedtls_mpi_cmp_mpi(&ctx->E, &ctx->N) >= 0) {
1182 return MBEDTLS_ERR_RSA_KEY_CHECK_FAILED;
1183 }
1184
1185 return 0;
Paul Bakker5121ce52009-01-03 21:22:43 +00001186}
1187
1188/*
Hanno Becker705fc682017-10-10 17:57:02 +01001189 * Check for the consistency of all fields in an RSA private key context
Paul Bakker5121ce52009-01-03 21:22:43 +00001190 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001191int mbedtls_rsa_check_privkey(const mbedtls_rsa_context *ctx)
Paul Bakker5121ce52009-01-03 21:22:43 +00001192{
Gilles Peskine449bd832023-01-11 14:50:10 +01001193 if (mbedtls_rsa_check_pubkey(ctx) != 0 ||
1194 rsa_check_context(ctx, 1 /* private */, 1 /* blinding */) != 0) {
1195 return MBEDTLS_ERR_RSA_KEY_CHECK_FAILED;
Paul Bakker5121ce52009-01-03 21:22:43 +00001196 }
Paul Bakker48377d92013-08-30 12:06:24 +02001197
Gilles Peskine449bd832023-01-11 14:50:10 +01001198 if (mbedtls_rsa_validate_params(&ctx->N, &ctx->P, &ctx->Q,
1199 &ctx->D, &ctx->E, NULL, NULL) != 0) {
1200 return MBEDTLS_ERR_RSA_KEY_CHECK_FAILED;
Paul Bakker5121ce52009-01-03 21:22:43 +00001201 }
Paul Bakker6c591fa2011-05-05 11:49:20 +00001202
Hanno Beckerb269a852017-08-25 08:03:21 +01001203#if !defined(MBEDTLS_RSA_NO_CRT)
Gilles Peskine449bd832023-01-11 14:50:10 +01001204 else if (mbedtls_rsa_validate_crt(&ctx->P, &ctx->Q, &ctx->D,
1205 &ctx->DP, &ctx->DQ, &ctx->QP) != 0) {
1206 return MBEDTLS_ERR_RSA_KEY_CHECK_FAILED;
Hanno Beckerb269a852017-08-25 08:03:21 +01001207 }
1208#endif
Paul Bakker6c591fa2011-05-05 11:49:20 +00001209
Gilles Peskine449bd832023-01-11 14:50:10 +01001210 return 0;
Paul Bakker5121ce52009-01-03 21:22:43 +00001211}
1212
1213/*
Manuel Pégourié-Gonnard2f8d1f92014-11-06 14:02:51 +01001214 * Check if contexts holding a public and private key match
1215 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001216int mbedtls_rsa_check_pub_priv(const mbedtls_rsa_context *pub,
1217 const mbedtls_rsa_context *prv)
Manuel Pégourié-Gonnard2f8d1f92014-11-06 14:02:51 +01001218{
Gilles Peskine449bd832023-01-11 14:50:10 +01001219 if (mbedtls_rsa_check_pubkey(pub) != 0 ||
1220 mbedtls_rsa_check_privkey(prv) != 0) {
1221 return MBEDTLS_ERR_RSA_KEY_CHECK_FAILED;
Manuel Pégourié-Gonnard2f8d1f92014-11-06 14:02:51 +01001222 }
1223
Gilles Peskine449bd832023-01-11 14:50:10 +01001224 if (mbedtls_mpi_cmp_mpi(&pub->N, &prv->N) != 0 ||
1225 mbedtls_mpi_cmp_mpi(&pub->E, &prv->E) != 0) {
1226 return MBEDTLS_ERR_RSA_KEY_CHECK_FAILED;
Manuel Pégourié-Gonnard2f8d1f92014-11-06 14:02:51 +01001227 }
1228
Gilles Peskine449bd832023-01-11 14:50:10 +01001229 return 0;
Manuel Pégourié-Gonnard2f8d1f92014-11-06 14:02:51 +01001230}
1231
1232/*
Paul Bakker5121ce52009-01-03 21:22:43 +00001233 * Do an RSA public key operation
1234 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001235int mbedtls_rsa_public(mbedtls_rsa_context *ctx,
1236 const unsigned char *input,
1237 unsigned char *output)
Paul Bakker5121ce52009-01-03 21:22:43 +00001238{
Janos Follath24eed8d2019-11-22 13:21:35 +00001239 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker23986e52011-04-24 08:57:21 +00001240 size_t olen;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001241 mbedtls_mpi T;
Paul Bakker5121ce52009-01-03 21:22:43 +00001242
Gilles Peskine449bd832023-01-11 14:50:10 +01001243 if (rsa_check_context(ctx, 0 /* public */, 0 /* no blinding */)) {
1244 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
1245 }
Hanno Becker705fc682017-10-10 17:57:02 +01001246
Gilles Peskine449bd832023-01-11 14:50:10 +01001247 mbedtls_mpi_init(&T);
Paul Bakker5121ce52009-01-03 21:22:43 +00001248
Manuel Pégourié-Gonnard1385a282015-08-27 11:30:58 +02001249#if defined(MBEDTLS_THREADING_C)
Gilles Peskine449bd832023-01-11 14:50:10 +01001250 if ((ret = mbedtls_mutex_lock(&ctx->mutex)) != 0) {
1251 return ret;
1252 }
Manuel Pégourié-Gonnard1385a282015-08-27 11:30:58 +02001253#endif
1254
Gilles Peskine449bd832023-01-11 14:50:10 +01001255 MBEDTLS_MPI_CHK(mbedtls_mpi_read_binary(&T, input, ctx->len));
Paul Bakker5121ce52009-01-03 21:22:43 +00001256
Gilles Peskine449bd832023-01-11 14:50:10 +01001257 if (mbedtls_mpi_cmp_mpi(&T, &ctx->N) >= 0) {
Manuel Pégourié-Gonnard4d04cdc2015-08-28 10:32:21 +02001258 ret = MBEDTLS_ERR_MPI_BAD_INPUT_DATA;
1259 goto cleanup;
Paul Bakker5121ce52009-01-03 21:22:43 +00001260 }
1261
1262 olen = ctx->len;
Janos Follath9d72df82024-08-15 16:06:19 +01001263 MBEDTLS_MPI_CHK(mbedtls_mpi_exp_mod_unsafe(&T, &T, &ctx->E, &ctx->N, &ctx->RN));
Gilles Peskine449bd832023-01-11 14:50:10 +01001264 MBEDTLS_MPI_CHK(mbedtls_mpi_write_binary(&T, output, olen));
Paul Bakker5121ce52009-01-03 21:22:43 +00001265
1266cleanup:
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001267#if defined(MBEDTLS_THREADING_C)
Gilles Peskine449bd832023-01-11 14:50:10 +01001268 if (mbedtls_mutex_unlock(&ctx->mutex) != 0) {
1269 return MBEDTLS_ERR_THREADING_MUTEX_ERROR;
1270 }
Manuel Pégourié-Gonnard88fca3e2015-03-27 15:06:07 +01001271#endif
Paul Bakker5121ce52009-01-03 21:22:43 +00001272
Gilles Peskine449bd832023-01-11 14:50:10 +01001273 mbedtls_mpi_free(&T);
Paul Bakker5121ce52009-01-03 21:22:43 +00001274
Gilles Peskine449bd832023-01-11 14:50:10 +01001275 if (ret != 0) {
1276 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_RSA_PUBLIC_FAILED, ret);
1277 }
Paul Bakker5121ce52009-01-03 21:22:43 +00001278
Gilles Peskine449bd832023-01-11 14:50:10 +01001279 return 0;
Paul Bakker5121ce52009-01-03 21:22:43 +00001280}
1281
Manuel Pégourié-Gonnardea53a552013-09-10 13:29:30 +02001282/*
Manuel Pégourié-Gonnard8a109f12013-09-10 13:37:26 +02001283 * Generate or update blinding values, see section 10 of:
1284 * KOCHER, Paul C. Timing attacks on implementations of Diffie-Hellman, RSA,
Manuel Pégourié-Gonnard998930a2015-04-03 13:48:06 +02001285 * DSS, and other systems. In : Advances in Cryptology-CRYPTO'96. Springer
Manuel Pégourié-Gonnard8a109f12013-09-10 13:37:26 +02001286 * Berlin Heidelberg, 1996. p. 104-113.
Manuel Pégourié-Gonnardea53a552013-09-10 13:29:30 +02001287 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001288static int rsa_prepare_blinding(mbedtls_rsa_context *ctx,
1289 int (*f_rng)(void *, unsigned char *, size_t), void *p_rng)
Manuel Pégourié-Gonnardea53a552013-09-10 13:29:30 +02001290{
Manuel Pégourié-Gonnard4d89c7e2013-10-04 15:18:38 +02001291 int ret, count = 0;
Manuel Pégourié-Gonnard750d3c72020-06-26 11:19:12 +02001292 mbedtls_mpi R;
1293
Gilles Peskine449bd832023-01-11 14:50:10 +01001294 mbedtls_mpi_init(&R);
Manuel Pégourié-Gonnardea53a552013-09-10 13:29:30 +02001295
Gilles Peskine449bd832023-01-11 14:50:10 +01001296 if (ctx->Vf.p != NULL) {
Manuel Pégourié-Gonnard8a109f12013-09-10 13:37:26 +02001297 /* We already have blinding values, just update them by squaring */
Gilles Peskine449bd832023-01-11 14:50:10 +01001298 MBEDTLS_MPI_CHK(mbedtls_mpi_mul_mpi(&ctx->Vi, &ctx->Vi, &ctx->Vi));
1299 MBEDTLS_MPI_CHK(mbedtls_mpi_mod_mpi(&ctx->Vi, &ctx->Vi, &ctx->N));
1300 MBEDTLS_MPI_CHK(mbedtls_mpi_mul_mpi(&ctx->Vf, &ctx->Vf, &ctx->Vf));
1301 MBEDTLS_MPI_CHK(mbedtls_mpi_mod_mpi(&ctx->Vf, &ctx->Vf, &ctx->N));
Manuel Pégourié-Gonnard8a109f12013-09-10 13:37:26 +02001302
Manuel Pégourié-Gonnard1385a282015-08-27 11:30:58 +02001303 goto cleanup;
Manuel Pégourié-Gonnard8a109f12013-09-10 13:37:26 +02001304 }
1305
Manuel Pégourié-Gonnard4d89c7e2013-10-04 15:18:38 +02001306 /* Unblinding value: Vf = random number, invertible mod N */
Manuel Pégourié-Gonnarda56a05b2025-07-10 21:40:15 +02001307 mbedtls_mpi_lset(&R, 0);
Manuel Pégourié-Gonnard4d89c7e2013-10-04 15:18:38 +02001308 do {
Gilles Peskine449bd832023-01-11 14:50:10 +01001309 if (count++ > 10) {
Manuel Pégourié-Gonnarde288ec02020-07-16 09:23:30 +02001310 ret = MBEDTLS_ERR_RSA_RNG_FAILED;
1311 goto cleanup;
1312 }
Manuel Pégourié-Gonnard4d89c7e2013-10-04 15:18:38 +02001313
Manuel Pégourié-Gonnarda56a05b2025-07-10 21:40:15 +02001314 MBEDTLS_MPI_CHK(mbedtls_mpi_random(&ctx->Vf, 1, &ctx->N, f_rng, p_rng));
1315 MBEDTLS_MPI_CHK(mbedtls_mpi_gcd_modinv_odd(&R, &ctx->Vi, &ctx->Vf, &ctx->N));
1316 } while (mbedtls_mpi_cmp_int(&R, 1) != 0);
Manuel Pégourié-Gonnardea53a552013-09-10 13:29:30 +02001317
Manuel Pégourié-Gonnard78683962020-07-16 09:48:54 +02001318 /* Blinding value: Vi = Vf^(-e) mod N
Manuel Pégourié-Gonnard750d3c72020-06-26 11:19:12 +02001319 * (Vi already contains Vf^-1 at this point) */
Gilles Peskine449bd832023-01-11 14:50:10 +01001320 MBEDTLS_MPI_CHK(mbedtls_mpi_exp_mod(&ctx->Vi, &ctx->Vi, &ctx->E, &ctx->N, &ctx->RN));
Manuel Pégourié-Gonnardea53a552013-09-10 13:29:30 +02001321
Manuel Pégourié-Gonnardae102992013-10-04 17:07:12 +02001322
Manuel Pégourié-Gonnardea53a552013-09-10 13:29:30 +02001323cleanup:
Gilles Peskine449bd832023-01-11 14:50:10 +01001324 mbedtls_mpi_free(&R);
Manuel Pégourié-Gonnard750d3c72020-06-26 11:19:12 +02001325
Gilles Peskine449bd832023-01-11 14:50:10 +01001326 return ret;
Manuel Pégourié-Gonnardea53a552013-09-10 13:29:30 +02001327}
Manuel Pégourié-Gonnardea53a552013-09-10 13:29:30 +02001328
Paul Bakker5121ce52009-01-03 21:22:43 +00001329/*
Janos Follathd6b09652023-11-21 09:33:54 +00001330 * Unblind
1331 * T = T * Vf mod N
1332 */
Janos Follathb4b8f3d2023-12-27 10:44:36 +00001333static int rsa_unblind(mbedtls_mpi *T, mbedtls_mpi *Vf, const mbedtls_mpi *N)
Janos Follathd6b09652023-11-21 09:33:54 +00001334{
1335 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
1336 const mbedtls_mpi_uint mm = mbedtls_mpi_core_montmul_init(N->p);
1337 const size_t nlimbs = N->n;
1338 const size_t tlimbs = mbedtls_mpi_core_montmul_working_limbs(nlimbs);
1339 mbedtls_mpi RR, M_T;
1340
1341 mbedtls_mpi_init(&RR);
1342 mbedtls_mpi_init(&M_T);
1343
1344 MBEDTLS_MPI_CHK(mbedtls_mpi_core_get_mont_r2_unsafe(&RR, N));
1345 MBEDTLS_MPI_CHK(mbedtls_mpi_grow(&M_T, tlimbs));
1346
1347 MBEDTLS_MPI_CHK(mbedtls_mpi_grow(T, nlimbs));
1348 MBEDTLS_MPI_CHK(mbedtls_mpi_grow(Vf, nlimbs));
1349
Janos Follathe6750b22023-12-27 10:22:59 +00001350 /* T = T * Vf mod N
1351 * Reminder: montmul(A, B, N) = A * B * R^-1 mod N
1352 * Usually both operands are multiplied by R mod N beforehand (by calling
1353 * `to_mont_rep()` on them), yielding a result that's also * R mod N (aka
1354 * "in the Montgomery domain"). Here we only multiply one operand by R mod
1355 * N, so the result is directly what we want - no need to call
1356 * `from_mont_rep()` on it. */
Janos Follathd6b09652023-11-21 09:33:54 +00001357 mbedtls_mpi_core_to_mont_rep(T->p, T->p, N->p, nlimbs, mm, RR.p, M_T.p);
Janos Follathd6b09652023-11-21 09:33:54 +00001358 mbedtls_mpi_core_montmul(T->p, T->p, Vf->p, nlimbs, N->p, nlimbs, mm, M_T.p);
1359
1360cleanup:
1361
1362 mbedtls_mpi_free(&RR);
1363 mbedtls_mpi_free(&M_T);
1364
1365 return ret;
1366}
1367
1368/*
Janos Follathe81102e2017-03-22 13:38:28 +00001369 * Exponent blinding supposed to prevent side-channel attacks using multiple
1370 * traces of measurements to recover the RSA key. The more collisions are there,
1371 * the more bits of the key can be recovered. See [3].
1372 *
1373 * Collecting n collisions with m bit long blinding value requires 2^(m-m/n)
Shaun Case8b0ecbc2021-12-20 21:14:10 -08001374 * observations on average.
Janos Follathe81102e2017-03-22 13:38:28 +00001375 *
1376 * For example with 28 byte blinding to achieve 2 collisions the adversary has
Shaun Case8b0ecbc2021-12-20 21:14:10 -08001377 * to make 2^112 observations on average.
Janos Follathe81102e2017-03-22 13:38:28 +00001378 *
1379 * (With the currently (as of 2017 April) known best algorithms breaking 2048
1380 * bit RSA requires approximately as much time as trying out 2^112 random keys.
1381 * Thus in this sense with 28 byte blinding the security is not reduced by
1382 * side-channel attacks like the one in [3])
1383 *
1384 * This countermeasure does not help if the key recovery is possible with a
1385 * single trace.
1386 */
1387#define RSA_EXPONENT_BLINDING 28
1388
1389/*
Paul Bakker5121ce52009-01-03 21:22:43 +00001390 * Do an RSA private key operation
1391 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001392int mbedtls_rsa_private(mbedtls_rsa_context *ctx,
1393 int (*f_rng)(void *, unsigned char *, size_t),
1394 void *p_rng,
1395 const unsigned char *input,
1396 unsigned char *output)
Paul Bakker5121ce52009-01-03 21:22:43 +00001397{
Janos Follath24eed8d2019-11-22 13:21:35 +00001398 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakker23986e52011-04-24 08:57:21 +00001399 size_t olen;
Hanno Becker06811ce2017-05-03 15:10:34 +01001400
1401 /* Temporary holding the result */
1402 mbedtls_mpi T;
1403
1404 /* Temporaries holding P-1, Q-1 and the
1405 * exponent blinding factor, respectively. */
Janos Follathf9203b42017-03-22 15:13:15 +00001406 mbedtls_mpi P1, Q1, R;
Hanno Becker06811ce2017-05-03 15:10:34 +01001407
1408#if !defined(MBEDTLS_RSA_NO_CRT)
1409 /* Temporaries holding the results mod p resp. mod q. */
1410 mbedtls_mpi TP, TQ;
1411
1412 /* Temporaries holding the blinded exponents for
1413 * the mod p resp. mod q computation (if used). */
Janos Follathf9203b42017-03-22 15:13:15 +00001414 mbedtls_mpi DP_blind, DQ_blind;
Hanno Becker06811ce2017-05-03 15:10:34 +01001415#else
1416 /* Temporary holding the blinded exponent (if used). */
1417 mbedtls_mpi D_blind;
Hanno Becker43f94722017-08-25 11:50:00 +01001418#endif /* MBEDTLS_RSA_NO_CRT */
Hanno Becker06811ce2017-05-03 15:10:34 +01001419
Hanno Beckerc6075cc2017-08-25 11:45:35 +01001420 /* Temporaries holding the initial input and the double
1421 * checked result; should be the same in the end. */
Janos Follathb4b8f3d2023-12-27 10:44:36 +00001422 mbedtls_mpi input_blinded, check_result_blinded;
Paul Bakker5121ce52009-01-03 21:22:43 +00001423
Gilles Peskine449bd832023-01-11 14:50:10 +01001424 if (f_rng == NULL) {
1425 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
1426 }
Manuel Pégourié-Gonnardf0359042021-06-15 11:29:26 +02001427
Gilles Peskine449bd832023-01-11 14:50:10 +01001428 if (rsa_check_context(ctx, 1 /* private key checks */,
1429 1 /* blinding on */) != 0) {
1430 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
Hanno Beckerebd2c022017-10-12 10:54:53 +01001431 }
Manuel Pégourié-Gonnardfb84d382015-10-30 10:56:25 +01001432
Hanno Becker06811ce2017-05-03 15:10:34 +01001433#if defined(MBEDTLS_THREADING_C)
Gilles Peskine449bd832023-01-11 14:50:10 +01001434 if ((ret = mbedtls_mutex_lock(&ctx->mutex)) != 0) {
1435 return ret;
1436 }
Hanno Becker06811ce2017-05-03 15:10:34 +01001437#endif
Janos Follathf9203b42017-03-22 15:13:15 +00001438
Hanno Becker06811ce2017-05-03 15:10:34 +01001439 /* MPI Initialization */
Gilles Peskine449bd832023-01-11 14:50:10 +01001440 mbedtls_mpi_init(&T);
Hanno Becker06811ce2017-05-03 15:10:34 +01001441
Gilles Peskine449bd832023-01-11 14:50:10 +01001442 mbedtls_mpi_init(&P1);
1443 mbedtls_mpi_init(&Q1);
1444 mbedtls_mpi_init(&R);
Janos Follathf9203b42017-03-22 15:13:15 +00001445
Janos Follathe81102e2017-03-22 13:38:28 +00001446#if defined(MBEDTLS_RSA_NO_CRT)
Gilles Peskine449bd832023-01-11 14:50:10 +01001447 mbedtls_mpi_init(&D_blind);
Janos Follathf9203b42017-03-22 15:13:15 +00001448#else
Gilles Peskine449bd832023-01-11 14:50:10 +01001449 mbedtls_mpi_init(&DP_blind);
1450 mbedtls_mpi_init(&DQ_blind);
Janos Follathe81102e2017-03-22 13:38:28 +00001451#endif
1452
Hanno Becker06811ce2017-05-03 15:10:34 +01001453#if !defined(MBEDTLS_RSA_NO_CRT)
Gilles Peskine449bd832023-01-11 14:50:10 +01001454 mbedtls_mpi_init(&TP); mbedtls_mpi_init(&TQ);
Manuel Pégourié-Gonnard1385a282015-08-27 11:30:58 +02001455#endif
1456
Janos Follathb4b8f3d2023-12-27 10:44:36 +00001457 mbedtls_mpi_init(&input_blinded);
1458 mbedtls_mpi_init(&check_result_blinded);
Hanno Becker06811ce2017-05-03 15:10:34 +01001459
1460 /* End of MPI initialization */
1461
Gilles Peskine449bd832023-01-11 14:50:10 +01001462 MBEDTLS_MPI_CHK(mbedtls_mpi_read_binary(&T, input, ctx->len));
1463 if (mbedtls_mpi_cmp_mpi(&T, &ctx->N) >= 0) {
Manuel Pégourié-Gonnard4d04cdc2015-08-28 10:32:21 +02001464 ret = MBEDTLS_ERR_MPI_BAD_INPUT_DATA;
1465 goto cleanup;
Paul Bakker5121ce52009-01-03 21:22:43 +00001466 }
1467
Manuel Pégourié-Gonnardf0359042021-06-15 11:29:26 +02001468 /*
1469 * Blinding
1470 * T = T * Vi mod N
1471 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001472 MBEDTLS_MPI_CHK(rsa_prepare_blinding(ctx, f_rng, p_rng));
1473 MBEDTLS_MPI_CHK(mbedtls_mpi_mul_mpi(&T, &T, &ctx->Vi));
1474 MBEDTLS_MPI_CHK(mbedtls_mpi_mod_mpi(&T, &T, &ctx->N));
Janos Follathe81102e2017-03-22 13:38:28 +00001475
Janos Follathb4b8f3d2023-12-27 10:44:36 +00001476 MBEDTLS_MPI_CHK(mbedtls_mpi_copy(&input_blinded, &T));
Janos Follath6bcbc922023-11-21 09:46:43 +00001477
Manuel Pégourié-Gonnardf0359042021-06-15 11:29:26 +02001478 /*
1479 * Exponent blinding
1480 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001481 MBEDTLS_MPI_CHK(mbedtls_mpi_sub_int(&P1, &ctx->P, 1));
1482 MBEDTLS_MPI_CHK(mbedtls_mpi_sub_int(&Q1, &ctx->Q, 1));
Janos Follathe81102e2017-03-22 13:38:28 +00001483
Janos Follathf9203b42017-03-22 15:13:15 +00001484#if defined(MBEDTLS_RSA_NO_CRT)
Manuel Pégourié-Gonnardf0359042021-06-15 11:29:26 +02001485 /*
1486 * D_blind = ( P - 1 ) * ( Q - 1 ) * R + D
1487 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001488 MBEDTLS_MPI_CHK(mbedtls_mpi_fill_random(&R, RSA_EXPONENT_BLINDING,
1489 f_rng, p_rng));
1490 MBEDTLS_MPI_CHK(mbedtls_mpi_mul_mpi(&D_blind, &P1, &Q1));
1491 MBEDTLS_MPI_CHK(mbedtls_mpi_mul_mpi(&D_blind, &D_blind, &R));
1492 MBEDTLS_MPI_CHK(mbedtls_mpi_add_mpi(&D_blind, &D_blind, &ctx->D));
Janos Follathf9203b42017-03-22 15:13:15 +00001493#else
Manuel Pégourié-Gonnardf0359042021-06-15 11:29:26 +02001494 /*
1495 * DP_blind = ( P - 1 ) * R + DP
1496 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001497 MBEDTLS_MPI_CHK(mbedtls_mpi_fill_random(&R, RSA_EXPONENT_BLINDING,
1498 f_rng, p_rng));
1499 MBEDTLS_MPI_CHK(mbedtls_mpi_mul_mpi(&DP_blind, &P1, &R));
1500 MBEDTLS_MPI_CHK(mbedtls_mpi_add_mpi(&DP_blind, &DP_blind,
1501 &ctx->DP));
Janos Follathf9203b42017-03-22 15:13:15 +00001502
Manuel Pégourié-Gonnardf0359042021-06-15 11:29:26 +02001503 /*
1504 * DQ_blind = ( Q - 1 ) * R + DQ
1505 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001506 MBEDTLS_MPI_CHK(mbedtls_mpi_fill_random(&R, RSA_EXPONENT_BLINDING,
1507 f_rng, p_rng));
1508 MBEDTLS_MPI_CHK(mbedtls_mpi_mul_mpi(&DQ_blind, &Q1, &R));
1509 MBEDTLS_MPI_CHK(mbedtls_mpi_add_mpi(&DQ_blind, &DQ_blind,
1510 &ctx->DQ));
Janos Follathe81102e2017-03-22 13:38:28 +00001511#endif /* MBEDTLS_RSA_NO_CRT */
Paul Bakkeraab30c12013-08-30 11:00:25 +02001512
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001513#if defined(MBEDTLS_RSA_NO_CRT)
Janos Follath47ee7702023-12-27 10:33:00 +00001514 MBEDTLS_MPI_CHK(mbedtls_mpi_exp_mod(&T, &T, &D_blind, &ctx->N, &ctx->RN));
Manuel Pégourié-Gonnarde10e06d2014-11-06 18:15:12 +01001515#else
Paul Bakkeraab30c12013-08-30 11:00:25 +02001516 /*
Janos Follathe81102e2017-03-22 13:38:28 +00001517 * Faster decryption using the CRT
Paul Bakker5121ce52009-01-03 21:22:43 +00001518 *
Hanno Becker06811ce2017-05-03 15:10:34 +01001519 * TP = input ^ dP mod P
1520 * TQ = input ^ dQ mod Q
Paul Bakker5121ce52009-01-03 21:22:43 +00001521 */
Hanno Becker06811ce2017-05-03 15:10:34 +01001522
Janos Follath47ee7702023-12-27 10:33:00 +00001523 MBEDTLS_MPI_CHK(mbedtls_mpi_exp_mod(&TP, &T, &DP_blind, &ctx->P, &ctx->RP));
1524 MBEDTLS_MPI_CHK(mbedtls_mpi_exp_mod(&TQ, &T, &DQ_blind, &ctx->Q, &ctx->RQ));
Paul Bakker5121ce52009-01-03 21:22:43 +00001525
1526 /*
Hanno Becker06811ce2017-05-03 15:10:34 +01001527 * T = (TP - TQ) * (Q^-1 mod P) mod P
Paul Bakker5121ce52009-01-03 21:22:43 +00001528 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001529 MBEDTLS_MPI_CHK(mbedtls_mpi_sub_mpi(&T, &TP, &TQ));
1530 MBEDTLS_MPI_CHK(mbedtls_mpi_mul_mpi(&TP, &T, &ctx->QP));
1531 MBEDTLS_MPI_CHK(mbedtls_mpi_mod_mpi(&T, &TP, &ctx->P));
Paul Bakker5121ce52009-01-03 21:22:43 +00001532
1533 /*
Hanno Becker06811ce2017-05-03 15:10:34 +01001534 * T = TQ + T * Q
Paul Bakker5121ce52009-01-03 21:22:43 +00001535 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001536 MBEDTLS_MPI_CHK(mbedtls_mpi_mul_mpi(&TP, &T, &ctx->Q));
1537 MBEDTLS_MPI_CHK(mbedtls_mpi_add_mpi(&T, &TQ, &TP));
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001538#endif /* MBEDTLS_RSA_NO_CRT */
Paul Bakkeraab30c12013-08-30 11:00:25 +02001539
Hanno Becker2dec5e82017-10-03 07:49:52 +01001540 /* Verify the result to prevent glitching attacks. */
Janos Follathb4b8f3d2023-12-27 10:44:36 +00001541 MBEDTLS_MPI_CHK(mbedtls_mpi_exp_mod(&check_result_blinded, &T, &ctx->E,
Gilles Peskine449bd832023-01-11 14:50:10 +01001542 &ctx->N, &ctx->RN));
Janos Follathb4b8f3d2023-12-27 10:44:36 +00001543 if (mbedtls_mpi_cmp_mpi(&check_result_blinded, &input_blinded) != 0) {
Hanno Becker06811ce2017-05-03 15:10:34 +01001544 ret = MBEDTLS_ERR_RSA_VERIFY_FAILED;
1545 goto cleanup;
1546 }
Hanno Becker06811ce2017-05-03 15:10:34 +01001547
Janos Follath6bcbc922023-11-21 09:46:43 +00001548 /*
1549 * Unblind
1550 * T = T * Vf mod N
1551 */
1552 MBEDTLS_MPI_CHK(rsa_unblind(&T, &ctx->Vf, &ctx->N));
1553
Paul Bakker5121ce52009-01-03 21:22:43 +00001554 olen = ctx->len;
Gilles Peskine449bd832023-01-11 14:50:10 +01001555 MBEDTLS_MPI_CHK(mbedtls_mpi_write_binary(&T, output, olen));
Paul Bakker5121ce52009-01-03 21:22:43 +00001556
1557cleanup:
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001558#if defined(MBEDTLS_THREADING_C)
Gilles Peskine449bd832023-01-11 14:50:10 +01001559 if (mbedtls_mutex_unlock(&ctx->mutex) != 0) {
1560 return MBEDTLS_ERR_THREADING_MUTEX_ERROR;
1561 }
Manuel Pégourié-Gonnardae102992013-10-04 17:07:12 +02001562#endif
Manuel Pégourié-Gonnard1385a282015-08-27 11:30:58 +02001563
Gilles Peskine449bd832023-01-11 14:50:10 +01001564 mbedtls_mpi_free(&P1);
1565 mbedtls_mpi_free(&Q1);
1566 mbedtls_mpi_free(&R);
Janos Follathf9203b42017-03-22 15:13:15 +00001567
Janos Follathe81102e2017-03-22 13:38:28 +00001568#if defined(MBEDTLS_RSA_NO_CRT)
Gilles Peskine449bd832023-01-11 14:50:10 +01001569 mbedtls_mpi_free(&D_blind);
Janos Follathf9203b42017-03-22 15:13:15 +00001570#else
Gilles Peskine449bd832023-01-11 14:50:10 +01001571 mbedtls_mpi_free(&DP_blind);
1572 mbedtls_mpi_free(&DQ_blind);
Janos Follathe81102e2017-03-22 13:38:28 +00001573#endif
Paul Bakker5121ce52009-01-03 21:22:43 +00001574
Gilles Peskine449bd832023-01-11 14:50:10 +01001575 mbedtls_mpi_free(&T);
Hanno Becker06811ce2017-05-03 15:10:34 +01001576
1577#if !defined(MBEDTLS_RSA_NO_CRT)
Gilles Peskine449bd832023-01-11 14:50:10 +01001578 mbedtls_mpi_free(&TP); mbedtls_mpi_free(&TQ);
Hanno Becker06811ce2017-05-03 15:10:34 +01001579#endif
1580
Janos Follathb4b8f3d2023-12-27 10:44:36 +00001581 mbedtls_mpi_free(&check_result_blinded);
1582 mbedtls_mpi_free(&input_blinded);
Hanno Becker06811ce2017-05-03 15:10:34 +01001583
Gilles Peskine449bd832023-01-11 14:50:10 +01001584 if (ret != 0 && ret >= -0x007f) {
1585 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_RSA_PRIVATE_FAILED, ret);
1586 }
Paul Bakker5121ce52009-01-03 21:22:43 +00001587
Gilles Peskine449bd832023-01-11 14:50:10 +01001588 return ret;
Paul Bakker5121ce52009-01-03 21:22:43 +00001589}
1590
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001591#if defined(MBEDTLS_PKCS1_V21)
Paul Bakker9dcc3222011-03-08 14:16:06 +00001592/**
1593 * Generate and apply the MGF1 operation (from PKCS#1 v2.1) to a buffer.
1594 *
Paul Bakkerb125ed82011-11-10 13:33:51 +00001595 * \param dst buffer to mask
1596 * \param dlen length of destination buffer
1597 * \param src source of the mask generation
1598 * \param slen length of the source buffer
Manuel Pégourié-Gonnard259c2132022-07-15 12:09:08 +02001599 * \param md_alg message digest to use
Paul Bakker9dcc3222011-03-08 14:16:06 +00001600 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001601static int mgf_mask(unsigned char *dst, size_t dlen, unsigned char *src,
1602 size_t slen, mbedtls_md_type_t md_alg)
Paul Bakker9dcc3222011-03-08 14:16:06 +00001603{
Paul Bakker9dcc3222011-03-08 14:16:06 +00001604 unsigned char counter[4];
1605 unsigned char *p;
Paul Bakker23986e52011-04-24 08:57:21 +00001606 unsigned int hlen;
1607 size_t i, use_len;
Manuel Pégourié-Gonnard88579842023-03-28 11:20:23 +02001608 unsigned char mask[MBEDTLS_MD_MAX_SIZE];
Andres Amaya Garcia94682d12017-07-20 14:26:37 +01001609 int ret = 0;
Manuel Pégourié-Gonnard077ba842022-07-27 10:42:31 +02001610 const mbedtls_md_info_t *md_info;
1611 mbedtls_md_context_t md_ctx;
Paul Bakker9dcc3222011-03-08 14:16:06 +00001612
Gilles Peskine449bd832023-01-11 14:50:10 +01001613 mbedtls_md_init(&md_ctx);
1614 md_info = mbedtls_md_info_from_type(md_alg);
1615 if (md_info == NULL) {
1616 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
1617 }
Manuel Pégourié-Gonnard259c2132022-07-15 12:09:08 +02001618
Gilles Peskine449bd832023-01-11 14:50:10 +01001619 mbedtls_md_init(&md_ctx);
1620 if ((ret = mbedtls_md_setup(&md_ctx, md_info, 0)) != 0) {
Manuel Pégourié-Gonnard259c2132022-07-15 12:09:08 +02001621 goto exit;
Gilles Peskine449bd832023-01-11 14:50:10 +01001622 }
Manuel Pégourié-Gonnard259c2132022-07-15 12:09:08 +02001623
Gilles Peskine449bd832023-01-11 14:50:10 +01001624 hlen = mbedtls_md_get_size(md_info);
Manuel Pégourié-Gonnard077ba842022-07-27 10:42:31 +02001625
Gilles Peskine449bd832023-01-11 14:50:10 +01001626 memset(mask, 0, sizeof(mask));
1627 memset(counter, 0, 4);
Paul Bakker9dcc3222011-03-08 14:16:06 +00001628
Simon Butcher02037452016-03-01 21:19:12 +00001629 /* Generate and apply dbMask */
Paul Bakker9dcc3222011-03-08 14:16:06 +00001630 p = dst;
1631
Gilles Peskine449bd832023-01-11 14:50:10 +01001632 while (dlen > 0) {
Paul Bakker9dcc3222011-03-08 14:16:06 +00001633 use_len = hlen;
Gilles Peskine449bd832023-01-11 14:50:10 +01001634 if (dlen < hlen) {
Paul Bakker9dcc3222011-03-08 14:16:06 +00001635 use_len = dlen;
Gilles Peskine449bd832023-01-11 14:50:10 +01001636 }
Paul Bakker9dcc3222011-03-08 14:16:06 +00001637
Gilles Peskine449bd832023-01-11 14:50:10 +01001638 if ((ret = mbedtls_md_starts(&md_ctx)) != 0) {
Andres Amaya Garcia698089e2017-06-28 11:46:46 +01001639 goto exit;
Gilles Peskine449bd832023-01-11 14:50:10 +01001640 }
1641 if ((ret = mbedtls_md_update(&md_ctx, src, slen)) != 0) {
Andres Amaya Garcia698089e2017-06-28 11:46:46 +01001642 goto exit;
Gilles Peskine449bd832023-01-11 14:50:10 +01001643 }
1644 if ((ret = mbedtls_md_update(&md_ctx, counter, 4)) != 0) {
Andres Amaya Garcia698089e2017-06-28 11:46:46 +01001645 goto exit;
Gilles Peskine449bd832023-01-11 14:50:10 +01001646 }
1647 if ((ret = mbedtls_md_finish(&md_ctx, mask)) != 0) {
Andres Amaya Garcia698089e2017-06-28 11:46:46 +01001648 goto exit;
Gilles Peskine449bd832023-01-11 14:50:10 +01001649 }
Paul Bakker9dcc3222011-03-08 14:16:06 +00001650
Gilles Peskine449bd832023-01-11 14:50:10 +01001651 for (i = 0; i < use_len; ++i) {
Paul Bakker9dcc3222011-03-08 14:16:06 +00001652 *p++ ^= mask[i];
Gilles Peskine449bd832023-01-11 14:50:10 +01001653 }
Paul Bakker9dcc3222011-03-08 14:16:06 +00001654
1655 counter[3]++;
1656
1657 dlen -= use_len;
1658 }
Gilles Peskine18ac7162017-05-05 19:24:06 +02001659
Andres Amaya Garcia698089e2017-06-28 11:46:46 +01001660exit:
Gilles Peskine449bd832023-01-11 14:50:10 +01001661 mbedtls_platform_zeroize(mask, sizeof(mask));
Gilles Peskine449bd832023-01-11 14:50:10 +01001662 mbedtls_md_free(&md_ctx);
Andres Amaya Garcia698089e2017-06-28 11:46:46 +01001663
Gilles Peskine449bd832023-01-11 14:50:10 +01001664 return ret;
Paul Bakker9dcc3222011-03-08 14:16:06 +00001665}
Manuel Pégourié-Gonnardf701acc2022-07-15 12:49:14 +02001666
1667/**
1668 * Generate Hash(M') as in RFC 8017 page 43 points 5 and 6.
1669 *
1670 * \param hash the input hash
1671 * \param hlen length of the input hash
1672 * \param salt the input salt
1673 * \param slen length of the input salt
Manuel Pégourié-Gonnard35c09e42022-07-15 13:10:54 +02001674 * \param out the output buffer - must be large enough for \p md_alg
Manuel Pégourié-Gonnardf701acc2022-07-15 12:49:14 +02001675 * \param md_alg message digest to use
1676 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001677static int hash_mprime(const unsigned char *hash, size_t hlen,
1678 const unsigned char *salt, size_t slen,
1679 unsigned char *out, mbedtls_md_type_t md_alg)
Manuel Pégourié-Gonnardf701acc2022-07-15 12:49:14 +02001680{
1681 const unsigned char zeros[8] = { 0, 0, 0, 0, 0, 0, 0, 0 };
Manuel Pégourié-Gonnard077ba842022-07-27 10:42:31 +02001682
Manuel Pégourié-Gonnardf701acc2022-07-15 12:49:14 +02001683 mbedtls_md_context_t md_ctx;
Przemek Stekielf98b57f2022-07-29 11:27:46 +02001684 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnardf701acc2022-07-15 12:49:14 +02001685
Gilles Peskine449bd832023-01-11 14:50:10 +01001686 const mbedtls_md_info_t *md_info = mbedtls_md_info_from_type(md_alg);
1687 if (md_info == NULL) {
1688 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
1689 }
Manuel Pégourié-Gonnardf701acc2022-07-15 12:49:14 +02001690
Gilles Peskine449bd832023-01-11 14:50:10 +01001691 mbedtls_md_init(&md_ctx);
1692 if ((ret = mbedtls_md_setup(&md_ctx, md_info, 0)) != 0) {
Manuel Pégourié-Gonnardf701acc2022-07-15 12:49:14 +02001693 goto exit;
Gilles Peskine449bd832023-01-11 14:50:10 +01001694 }
1695 if ((ret = mbedtls_md_starts(&md_ctx)) != 0) {
Manuel Pégourié-Gonnardf701acc2022-07-15 12:49:14 +02001696 goto exit;
Gilles Peskine449bd832023-01-11 14:50:10 +01001697 }
1698 if ((ret = mbedtls_md_update(&md_ctx, zeros, sizeof(zeros))) != 0) {
Manuel Pégourié-Gonnardf701acc2022-07-15 12:49:14 +02001699 goto exit;
Gilles Peskine449bd832023-01-11 14:50:10 +01001700 }
1701 if ((ret = mbedtls_md_update(&md_ctx, hash, hlen)) != 0) {
Manuel Pégourié-Gonnardf701acc2022-07-15 12:49:14 +02001702 goto exit;
Gilles Peskine449bd832023-01-11 14:50:10 +01001703 }
1704 if ((ret = mbedtls_md_update(&md_ctx, salt, slen)) != 0) {
Manuel Pégourié-Gonnardf701acc2022-07-15 12:49:14 +02001705 goto exit;
Gilles Peskine449bd832023-01-11 14:50:10 +01001706 }
1707 if ((ret = mbedtls_md_finish(&md_ctx, out)) != 0) {
Manuel Pégourié-Gonnardf701acc2022-07-15 12:49:14 +02001708 goto exit;
Gilles Peskine449bd832023-01-11 14:50:10 +01001709 }
Manuel Pégourié-Gonnardf701acc2022-07-15 12:49:14 +02001710
1711exit:
Gilles Peskine449bd832023-01-11 14:50:10 +01001712 mbedtls_md_free(&md_ctx);
Manuel Pégourié-Gonnardf701acc2022-07-15 12:49:14 +02001713
Gilles Peskine449bd832023-01-11 14:50:10 +01001714 return ret;
Manuel Pégourié-Gonnardf701acc2022-07-15 12:49:14 +02001715}
Manuel Pégourié-Gonnard35c09e42022-07-15 13:10:54 +02001716
1717/**
1718 * Compute a hash.
1719 *
1720 * \param md_alg algorithm to use
1721 * \param input input message to hash
1722 * \param ilen input length
1723 * \param output the output buffer - must be large enough for \p md_alg
1724 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001725static int compute_hash(mbedtls_md_type_t md_alg,
1726 const unsigned char *input, size_t ilen,
1727 unsigned char *output)
Manuel Pégourié-Gonnard35c09e42022-07-15 13:10:54 +02001728{
1729 const mbedtls_md_info_t *md_info;
1730
Gilles Peskine449bd832023-01-11 14:50:10 +01001731 md_info = mbedtls_md_info_from_type(md_alg);
1732 if (md_info == NULL) {
1733 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
1734 }
Manuel Pégourié-Gonnard35c09e42022-07-15 13:10:54 +02001735
Gilles Peskine449bd832023-01-11 14:50:10 +01001736 return mbedtls_md(md_info, input, ilen, output);
Manuel Pégourié-Gonnard35c09e42022-07-15 13:10:54 +02001737}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001738#endif /* MBEDTLS_PKCS1_V21 */
Paul Bakker9dcc3222011-03-08 14:16:06 +00001739
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001740#if defined(MBEDTLS_PKCS1_V21)
Paul Bakkerb3869132013-02-28 17:21:01 +01001741/*
1742 * Implementation of the PKCS#1 v2.1 RSAES-OAEP-ENCRYPT function
1743 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001744int mbedtls_rsa_rsaes_oaep_encrypt(mbedtls_rsa_context *ctx,
1745 int (*f_rng)(void *, unsigned char *, size_t),
1746 void *p_rng,
1747 const unsigned char *label, size_t label_len,
1748 size_t ilen,
1749 const unsigned char *input,
1750 unsigned char *output)
Paul Bakkerb3869132013-02-28 17:21:01 +01001751{
1752 size_t olen;
Janos Follath24eed8d2019-11-22 13:21:35 +00001753 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakkerb3869132013-02-28 17:21:01 +01001754 unsigned char *p = output;
1755 unsigned int hlen;
Paul Bakkerb3869132013-02-28 17:21:01 +01001756
Gilles Peskine449bd832023-01-11 14:50:10 +01001757 if (f_rng == NULL) {
1758 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
1759 }
Paul Bakkerb3869132013-02-28 17:21:01 +01001760
Manuel Pégourié-Gonnard9b41eb82023-03-28 11:14:24 +02001761 hlen = mbedtls_md_get_size_from_type((mbedtls_md_type_t) ctx->hash_id);
Gilles Peskine449bd832023-01-11 14:50:10 +01001762 if (hlen == 0) {
1763 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
1764 }
Paul Bakkerb3869132013-02-28 17:21:01 +01001765
1766 olen = ctx->len;
Paul Bakkerb3869132013-02-28 17:21:01 +01001767
Simon Butcher02037452016-03-01 21:19:12 +00001768 /* first comparison checks for overflow */
Gilles Peskine449bd832023-01-11 14:50:10 +01001769 if (ilen + 2 * hlen + 2 < ilen || olen < ilen + 2 * hlen + 2) {
1770 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
1771 }
Paul Bakkerb3869132013-02-28 17:21:01 +01001772
Gilles Peskine449bd832023-01-11 14:50:10 +01001773 memset(output, 0, olen);
Paul Bakkerb3869132013-02-28 17:21:01 +01001774
1775 *p++ = 0;
1776
Simon Butcher02037452016-03-01 21:19:12 +00001777 /* Generate a random octet string seed */
Gilles Peskine449bd832023-01-11 14:50:10 +01001778 if ((ret = f_rng(p_rng, p, hlen)) != 0) {
1779 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_RSA_RNG_FAILED, ret);
1780 }
Paul Bakkerb3869132013-02-28 17:21:01 +01001781
1782 p += hlen;
1783
Simon Butcher02037452016-03-01 21:19:12 +00001784 /* Construct DB */
Gilles Peskine449bd832023-01-11 14:50:10 +01001785 ret = compute_hash((mbedtls_md_type_t) ctx->hash_id, label, label_len, p);
1786 if (ret != 0) {
1787 return ret;
1788 }
Paul Bakkerb3869132013-02-28 17:21:01 +01001789 p += hlen;
1790 p += olen - 2 * hlen - 2 - ilen;
1791 *p++ = 1;
Gilles Peskine449bd832023-01-11 14:50:10 +01001792 if (ilen != 0) {
1793 memcpy(p, input, ilen);
1794 }
Paul Bakkerb3869132013-02-28 17:21:01 +01001795
Simon Butcher02037452016-03-01 21:19:12 +00001796 /* maskedDB: Apply dbMask to DB */
Gilles Peskine449bd832023-01-11 14:50:10 +01001797 if ((ret = mgf_mask(output + hlen + 1, olen - hlen - 1, output + 1, hlen,
Agathiyan Bragadeesh01ed84a2023-07-13 11:42:41 +01001798 (mbedtls_md_type_t) ctx->hash_id)) != 0) {
Gilles Peskine449bd832023-01-11 14:50:10 +01001799 return ret;
1800 }
Paul Bakkerb3869132013-02-28 17:21:01 +01001801
Simon Butcher02037452016-03-01 21:19:12 +00001802 /* maskedSeed: Apply seedMask to seed */
Gilles Peskine449bd832023-01-11 14:50:10 +01001803 if ((ret = mgf_mask(output + 1, hlen, output + hlen + 1, olen - hlen - 1,
Agathiyan Bragadeesh01ed84a2023-07-13 11:42:41 +01001804 (mbedtls_md_type_t) ctx->hash_id)) != 0) {
Gilles Peskine449bd832023-01-11 14:50:10 +01001805 return ret;
1806 }
Andres Amaya Garcia698089e2017-06-28 11:46:46 +01001807
Gilles Peskine449bd832023-01-11 14:50:10 +01001808 return mbedtls_rsa_public(ctx, output, output);
Paul Bakkerb3869132013-02-28 17:21:01 +01001809}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001810#endif /* MBEDTLS_PKCS1_V21 */
Paul Bakkerb3869132013-02-28 17:21:01 +01001811
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001812#if defined(MBEDTLS_PKCS1_V15)
Paul Bakkerb3869132013-02-28 17:21:01 +01001813/*
1814 * Implementation of the PKCS#1 v2.1 RSAES-PKCS1-V1_5-ENCRYPT function
1815 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001816int mbedtls_rsa_rsaes_pkcs1_v15_encrypt(mbedtls_rsa_context *ctx,
1817 int (*f_rng)(void *, unsigned char *, size_t),
1818 void *p_rng, size_t ilen,
1819 const unsigned char *input,
1820 unsigned char *output)
Paul Bakkerb3869132013-02-28 17:21:01 +01001821{
1822 size_t nb_pad, olen;
Janos Follath24eed8d2019-11-22 13:21:35 +00001823 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakkerb3869132013-02-28 17:21:01 +01001824 unsigned char *p = output;
1825
Paul Bakkerb3869132013-02-28 17:21:01 +01001826 olen = ctx->len;
Manuel Pégourié-Gonnard370717b2016-02-11 10:35:13 +01001827
Simon Butcher02037452016-03-01 21:19:12 +00001828 /* first comparison checks for overflow */
Gilles Peskine449bd832023-01-11 14:50:10 +01001829 if (ilen + 11 < ilen || olen < ilen + 11) {
1830 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
1831 }
Paul Bakkerb3869132013-02-28 17:21:01 +01001832
1833 nb_pad = olen - 3 - ilen;
1834
1835 *p++ = 0;
Thomas Daubney53e4ac62021-05-13 18:26:49 +01001836
Gilles Peskine449bd832023-01-11 14:50:10 +01001837 if (f_rng == NULL) {
1838 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
1839 }
Thomas Daubney53e4ac62021-05-13 18:26:49 +01001840
1841 *p++ = MBEDTLS_RSA_CRYPT;
1842
Gilles Peskine449bd832023-01-11 14:50:10 +01001843 while (nb_pad-- > 0) {
Thomas Daubney53e4ac62021-05-13 18:26:49 +01001844 int rng_dl = 100;
Andrzej Kurekc470b6b2019-01-31 08:20:20 -05001845
Thomas Daubney53e4ac62021-05-13 18:26:49 +01001846 do {
Gilles Peskine449bd832023-01-11 14:50:10 +01001847 ret = f_rng(p_rng, p, 1);
1848 } while (*p == 0 && --rng_dl && ret == 0);
Paul Bakkerb3869132013-02-28 17:21:01 +01001849
Thomas Daubney53e4ac62021-05-13 18:26:49 +01001850 /* Check if RNG failed to generate data */
Gilles Peskine449bd832023-01-11 14:50:10 +01001851 if (rng_dl == 0 || ret != 0) {
1852 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_RSA_RNG_FAILED, ret);
1853 }
Paul Bakkerb3869132013-02-28 17:21:01 +01001854
Thomas Daubney53e4ac62021-05-13 18:26:49 +01001855 p++;
Paul Bakkerb3869132013-02-28 17:21:01 +01001856 }
1857
1858 *p++ = 0;
Gilles Peskine449bd832023-01-11 14:50:10 +01001859 if (ilen != 0) {
1860 memcpy(p, input, ilen);
1861 }
Paul Bakkerb3869132013-02-28 17:21:01 +01001862
Gilles Peskine449bd832023-01-11 14:50:10 +01001863 return mbedtls_rsa_public(ctx, output, output);
Paul Bakkerb3869132013-02-28 17:21:01 +01001864}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001865#endif /* MBEDTLS_PKCS1_V15 */
Paul Bakkerb3869132013-02-28 17:21:01 +01001866
Paul Bakker5121ce52009-01-03 21:22:43 +00001867/*
1868 * Add the message padding, then do an RSA operation
1869 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001870int mbedtls_rsa_pkcs1_encrypt(mbedtls_rsa_context *ctx,
1871 int (*f_rng)(void *, unsigned char *, size_t),
1872 void *p_rng,
1873 size_t ilen,
1874 const unsigned char *input,
1875 unsigned char *output)
Paul Bakker5121ce52009-01-03 21:22:43 +00001876{
Gilles Peskine449bd832023-01-11 14:50:10 +01001877 switch (ctx->padding) {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001878#if defined(MBEDTLS_PKCS1_V15)
1879 case MBEDTLS_RSA_PKCS_V15:
Gilles Peskine449bd832023-01-11 14:50:10 +01001880 return mbedtls_rsa_rsaes_pkcs1_v15_encrypt(ctx, f_rng, p_rng,
1881 ilen, input, output);
Paul Bakker48377d92013-08-30 12:06:24 +02001882#endif
Paul Bakker5121ce52009-01-03 21:22:43 +00001883
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001884#if defined(MBEDTLS_PKCS1_V21)
1885 case MBEDTLS_RSA_PKCS_V21:
Gilles Peskine449bd832023-01-11 14:50:10 +01001886 return mbedtls_rsa_rsaes_oaep_encrypt(ctx, f_rng, p_rng, NULL, 0,
1887 ilen, input, output);
Paul Bakker9dcc3222011-03-08 14:16:06 +00001888#endif
Paul Bakker5121ce52009-01-03 21:22:43 +00001889
1890 default:
Gilles Peskine449bd832023-01-11 14:50:10 +01001891 return MBEDTLS_ERR_RSA_INVALID_PADDING;
Paul Bakker5121ce52009-01-03 21:22:43 +00001892 }
Paul Bakker5121ce52009-01-03 21:22:43 +00001893}
1894
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001895#if defined(MBEDTLS_PKCS1_V21)
Paul Bakker5121ce52009-01-03 21:22:43 +00001896/*
Paul Bakkerb3869132013-02-28 17:21:01 +01001897 * Implementation of the PKCS#1 v2.1 RSAES-OAEP-DECRYPT function
Paul Bakker5121ce52009-01-03 21:22:43 +00001898 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001899int mbedtls_rsa_rsaes_oaep_decrypt(mbedtls_rsa_context *ctx,
1900 int (*f_rng)(void *, unsigned char *, size_t),
1901 void *p_rng,
1902 const unsigned char *label, size_t label_len,
1903 size_t *olen,
1904 const unsigned char *input,
1905 unsigned char *output,
1906 size_t output_max_len)
Paul Bakker5121ce52009-01-03 21:22:43 +00001907{
Janos Follath24eed8d2019-11-22 13:21:35 +00001908 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnardab44d7e2013-11-29 12:49:44 +01001909 size_t ilen, i, pad_len;
Dave Rodgmanb4e6b412023-09-18 18:46:19 +01001910 unsigned char *p;
Dave Rodgmanc62f7fc2023-09-20 19:06:02 +01001911 mbedtls_ct_condition_t bad, in_padding;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02001912 unsigned char buf[MBEDTLS_MPI_MAX_SIZE];
Manuel Pégourié-Gonnard88579842023-03-28 11:20:23 +02001913 unsigned char lhash[MBEDTLS_MD_MAX_SIZE];
Paul Bakker23986e52011-04-24 08:57:21 +00001914 unsigned int hlen;
Paul Bakkerb3869132013-02-28 17:21:01 +01001915
Manuel Pégourié-Gonnarda5cfc352013-11-28 15:57:52 +01001916 /*
1917 * Parameters sanity checks
1918 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001919 if (ctx->padding != MBEDTLS_RSA_PKCS_V21) {
1920 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
1921 }
Paul Bakker5121ce52009-01-03 21:22:43 +00001922
1923 ilen = ctx->len;
1924
Gilles Peskine449bd832023-01-11 14:50:10 +01001925 if (ilen < 16 || ilen > sizeof(buf)) {
1926 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
1927 }
Paul Bakker5121ce52009-01-03 21:22:43 +00001928
Manuel Pégourié-Gonnard9b41eb82023-03-28 11:14:24 +02001929 hlen = mbedtls_md_get_size_from_type((mbedtls_md_type_t) ctx->hash_id);
Gilles Peskine449bd832023-01-11 14:50:10 +01001930 if (hlen == 0) {
1931 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
1932 }
Manuel Pégourié-Gonnarda5cfc352013-11-28 15:57:52 +01001933
Janos Follathc17cda12016-02-11 11:08:18 +00001934 // checking for integer underflow
Gilles Peskine449bd832023-01-11 14:50:10 +01001935 if (2 * hlen + 2 > ilen) {
1936 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
1937 }
Janos Follathc17cda12016-02-11 11:08:18 +00001938
Manuel Pégourié-Gonnarda5cfc352013-11-28 15:57:52 +01001939 /*
1940 * RSA operation
1941 */
Gilles Peskine449bd832023-01-11 14:50:10 +01001942 ret = mbedtls_rsa_private(ctx, f_rng, p_rng, input, buf);
Paul Bakker5121ce52009-01-03 21:22:43 +00001943
Gilles Peskine449bd832023-01-11 14:50:10 +01001944 if (ret != 0) {
Gilles Peskine4a7f6a02017-03-23 14:37:37 +01001945 goto cleanup;
Gilles Peskine449bd832023-01-11 14:50:10 +01001946 }
Paul Bakker5121ce52009-01-03 21:22:43 +00001947
Manuel Pégourié-Gonnarda5cfc352013-11-28 15:57:52 +01001948 /*
Manuel Pégourié-Gonnardab44d7e2013-11-29 12:49:44 +01001949 * Unmask data and generate lHash
Manuel Pégourié-Gonnarda5cfc352013-11-28 15:57:52 +01001950 */
Manuel Pégourié-Gonnarda5cfc352013-11-28 15:57:52 +01001951 /* seed: Apply seedMask to maskedSeed */
Gilles Peskine449bd832023-01-11 14:50:10 +01001952 if ((ret = mgf_mask(buf + 1, hlen, buf + hlen + 1, ilen - hlen - 1,
Agathiyan Bragadeesh01ed84a2023-07-13 11:42:41 +01001953 (mbedtls_md_type_t) ctx->hash_id)) != 0 ||
Gilles Peskine449bd832023-01-11 14:50:10 +01001954 /* DB: Apply dbMask to maskedDB */
1955 (ret = mgf_mask(buf + hlen + 1, ilen - hlen - 1, buf + 1, hlen,
Agathiyan Bragadeesh01ed84a2023-07-13 11:42:41 +01001956 (mbedtls_md_type_t) ctx->hash_id)) != 0) {
Andres Amaya Garcia698089e2017-06-28 11:46:46 +01001957 goto cleanup;
1958 }
Manuel Pégourié-Gonnarda5cfc352013-11-28 15:57:52 +01001959
Andres Amaya Garcia698089e2017-06-28 11:46:46 +01001960 /* Generate lHash */
Gilles Peskine449bd832023-01-11 14:50:10 +01001961 ret = compute_hash((mbedtls_md_type_t) ctx->hash_id,
1962 label, label_len, lhash);
1963 if (ret != 0) {
Andres Amaya Garcia698089e2017-06-28 11:46:46 +01001964 goto cleanup;
Gilles Peskine449bd832023-01-11 14:50:10 +01001965 }
Andres Amaya Garcia698089e2017-06-28 11:46:46 +01001966
Manuel Pégourié-Gonnarda5cfc352013-11-28 15:57:52 +01001967 /*
Manuel Pégourié-Gonnardab44d7e2013-11-29 12:49:44 +01001968 * Check contents, in "constant-time"
Manuel Pégourié-Gonnarda5cfc352013-11-28 15:57:52 +01001969 */
Paul Bakker5121ce52009-01-03 21:22:43 +00001970 p = buf;
1971
Dave Rodgmanb4e6b412023-09-18 18:46:19 +01001972 bad = mbedtls_ct_bool(*p++); /* First byte must be 0 */
Paul Bakkerb3869132013-02-28 17:21:01 +01001973
Manuel Pégourié-Gonnarda5cfc352013-11-28 15:57:52 +01001974 p += hlen; /* Skip seed */
Paul Bakkerb3869132013-02-28 17:21:01 +01001975
Manuel Pégourié-Gonnarda5cfc352013-11-28 15:57:52 +01001976 /* Check lHash */
Dave Rodgmanb4e6b412023-09-18 18:46:19 +01001977 bad = mbedtls_ct_bool_or(bad, mbedtls_ct_bool(mbedtls_ct_memcmp(lhash, p, hlen)));
Dave Rodgman66d6ac92023-09-18 18:35:03 +01001978 p += hlen;
Paul Bakkerb3869132013-02-28 17:21:01 +01001979
Manuel Pégourié-Gonnardab44d7e2013-11-29 12:49:44 +01001980 /* Get zero-padding len, but always read till end of buffer
1981 * (minus one, for the 01 byte) */
1982 pad_len = 0;
Dave Rodgmanc62f7fc2023-09-20 19:06:02 +01001983 in_padding = MBEDTLS_CT_TRUE;
Gilles Peskine449bd832023-01-11 14:50:10 +01001984 for (i = 0; i < ilen - 2 * hlen - 2; i++) {
Dave Rodgmanc62f7fc2023-09-20 19:06:02 +01001985 in_padding = mbedtls_ct_bool_and(in_padding, mbedtls_ct_uint_eq(p[i], 0));
1986 pad_len += mbedtls_ct_uint_if_else_0(in_padding, 1);
Manuel Pégourié-Gonnardab44d7e2013-11-29 12:49:44 +01001987 }
Paul Bakkerb3869132013-02-28 17:21:01 +01001988
Manuel Pégourié-Gonnardab44d7e2013-11-29 12:49:44 +01001989 p += pad_len;
Dave Rodgmanb4e6b412023-09-18 18:46:19 +01001990 bad = mbedtls_ct_bool_or(bad, mbedtls_ct_uint_ne(*p++, 0x01));
Paul Bakkerb3869132013-02-28 17:21:01 +01001991
Manuel Pégourié-Gonnardab44d7e2013-11-29 12:49:44 +01001992 /*
1993 * The only information "leaked" is whether the padding was correct or not
1994 * (eg, no data is copied if it was not correct). This meets the
1995 * recommendations in PKCS#1 v2.2: an opponent cannot distinguish between
1996 * the different error conditions.
1997 */
Dave Rodgmanb4e6b412023-09-18 18:46:19 +01001998 if (bad != MBEDTLS_CT_FALSE) {
Gilles Peskine4a7f6a02017-03-23 14:37:37 +01001999 ret = MBEDTLS_ERR_RSA_INVALID_PADDING;
2000 goto cleanup;
2001 }
Paul Bakkerb3869132013-02-28 17:21:01 +01002002
Dave Rodgmane4a6f5a2023-11-04 12:20:09 +00002003 if (ilen - ((size_t) (p - buf)) > output_max_len) {
Gilles Peskine4a7f6a02017-03-23 14:37:37 +01002004 ret = MBEDTLS_ERR_RSA_OUTPUT_TOO_LARGE;
2005 goto cleanup;
2006 }
Paul Bakkerb3869132013-02-28 17:21:01 +01002007
Dave Rodgmane4a6f5a2023-11-04 12:20:09 +00002008 *olen = ilen - ((size_t) (p - buf));
Gilles Peskine449bd832023-01-11 14:50:10 +01002009 if (*olen != 0) {
2010 memcpy(output, p, *olen);
2011 }
Gilles Peskine4a7f6a02017-03-23 14:37:37 +01002012 ret = 0;
Paul Bakkerb3869132013-02-28 17:21:01 +01002013
Gilles Peskine4a7f6a02017-03-23 14:37:37 +01002014cleanup:
Gilles Peskine449bd832023-01-11 14:50:10 +01002015 mbedtls_platform_zeroize(buf, sizeof(buf));
2016 mbedtls_platform_zeroize(lhash, sizeof(lhash));
Gilles Peskine4a7f6a02017-03-23 14:37:37 +01002017
Gilles Peskine449bd832023-01-11 14:50:10 +01002018 return ret;
Paul Bakkerb3869132013-02-28 17:21:01 +01002019}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002020#endif /* MBEDTLS_PKCS1_V21 */
Paul Bakkerb3869132013-02-28 17:21:01 +01002021
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002022#if defined(MBEDTLS_PKCS1_V15)
gabor-mezei-armbef600f2021-09-26 15:20:48 +02002023/*
2024 * Implementation of the PKCS#1 v2.1 RSAES-PKCS1-V1_5-DECRYPT function
2025 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002026int mbedtls_rsa_rsaes_pkcs1_v15_decrypt(mbedtls_rsa_context *ctx,
2027 int (*f_rng)(void *, unsigned char *, size_t),
2028 void *p_rng,
2029 size_t *olen,
2030 const unsigned char *input,
2031 unsigned char *output,
2032 size_t output_max_len)
gabor-mezei-armbef600f2021-09-26 15:20:48 +02002033{
2034 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
2035 size_t ilen;
2036 unsigned char buf[MBEDTLS_MPI_MAX_SIZE];
2037
gabor-mezei-armbef600f2021-09-26 15:20:48 +02002038 ilen = ctx->len;
2039
Gilles Peskine449bd832023-01-11 14:50:10 +01002040 if (ctx->padding != MBEDTLS_RSA_PKCS_V15) {
2041 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
2042 }
gabor-mezei-armbef600f2021-09-26 15:20:48 +02002043
Gilles Peskine449bd832023-01-11 14:50:10 +01002044 if (ilen < 16 || ilen > sizeof(buf)) {
2045 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
2046 }
gabor-mezei-armbef600f2021-09-26 15:20:48 +02002047
Gilles Peskine449bd832023-01-11 14:50:10 +01002048 ret = mbedtls_rsa_private(ctx, f_rng, p_rng, input, buf);
gabor-mezei-armbef600f2021-09-26 15:20:48 +02002049
Gilles Peskine449bd832023-01-11 14:50:10 +01002050 if (ret != 0) {
gabor-mezei-armbef600f2021-09-26 15:20:48 +02002051 goto cleanup;
Gilles Peskine449bd832023-01-11 14:50:10 +01002052 }
gabor-mezei-armbef600f2021-09-26 15:20:48 +02002053
Gilles Peskine449bd832023-01-11 14:50:10 +01002054 ret = mbedtls_ct_rsaes_pkcs1_v15_unpadding(buf, ilen,
2055 output, output_max_len, olen);
gabor-mezei-armbef600f2021-09-26 15:20:48 +02002056
Gilles Peskine4a7f6a02017-03-23 14:37:37 +01002057cleanup:
Gilles Peskine449bd832023-01-11 14:50:10 +01002058 mbedtls_platform_zeroize(buf, sizeof(buf));
Gilles Peskine4a7f6a02017-03-23 14:37:37 +01002059
Gilles Peskine449bd832023-01-11 14:50:10 +01002060 return ret;
Paul Bakker5121ce52009-01-03 21:22:43 +00002061}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002062#endif /* MBEDTLS_PKCS1_V15 */
Paul Bakker5121ce52009-01-03 21:22:43 +00002063
2064/*
Paul Bakkerb3869132013-02-28 17:21:01 +01002065 * Do an RSA operation, then remove the message padding
2066 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002067int mbedtls_rsa_pkcs1_decrypt(mbedtls_rsa_context *ctx,
2068 int (*f_rng)(void *, unsigned char *, size_t),
2069 void *p_rng,
2070 size_t *olen,
2071 const unsigned char *input,
2072 unsigned char *output,
2073 size_t output_max_len)
Paul Bakkerb3869132013-02-28 17:21:01 +01002074{
Gilles Peskine449bd832023-01-11 14:50:10 +01002075 switch (ctx->padding) {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002076#if defined(MBEDTLS_PKCS1_V15)
2077 case MBEDTLS_RSA_PKCS_V15:
Gilles Peskine449bd832023-01-11 14:50:10 +01002078 return mbedtls_rsa_rsaes_pkcs1_v15_decrypt(ctx, f_rng, p_rng, olen,
2079 input, output, output_max_len);
Paul Bakker48377d92013-08-30 12:06:24 +02002080#endif
Paul Bakkerb3869132013-02-28 17:21:01 +01002081
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002082#if defined(MBEDTLS_PKCS1_V21)
2083 case MBEDTLS_RSA_PKCS_V21:
Gilles Peskine449bd832023-01-11 14:50:10 +01002084 return mbedtls_rsa_rsaes_oaep_decrypt(ctx, f_rng, p_rng, NULL, 0,
2085 olen, input, output,
2086 output_max_len);
Paul Bakkerb3869132013-02-28 17:21:01 +01002087#endif
2088
2089 default:
Gilles Peskine449bd832023-01-11 14:50:10 +01002090 return MBEDTLS_ERR_RSA_INVALID_PADDING;
Paul Bakkerb3869132013-02-28 17:21:01 +01002091 }
2092}
2093
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002094#if defined(MBEDTLS_PKCS1_V21)
Tomi Fontanilles573dc232023-12-10 14:57:51 +02002095static int rsa_rsassa_pss_sign_no_mode_check(mbedtls_rsa_context *ctx,
2096 int (*f_rng)(void *, unsigned char *, size_t),
2097 void *p_rng,
2098 mbedtls_md_type_t md_alg,
2099 unsigned int hashlen,
2100 const unsigned char *hash,
2101 int saltlen,
2102 unsigned char *sig)
Paul Bakkerb3869132013-02-28 17:21:01 +01002103{
2104 size_t olen;
2105 unsigned char *p = sig;
Cédric Meuter668a78d2020-04-30 11:57:04 +02002106 unsigned char *salt = NULL;
Jaeden Amero3725bb22018-09-07 19:12:36 +01002107 size_t slen, min_slen, hlen, offset = 0;
Janos Follath24eed8d2019-11-22 13:21:35 +00002108 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakkerb3869132013-02-28 17:21:01 +01002109 size_t msb;
Tomi Fontanilles573dc232023-12-10 14:57:51 +02002110 mbedtls_md_type_t hash_id;
Manuel Pégourié-Gonnardf701acc2022-07-15 12:49:14 +02002111
Gilles Peskine449bd832023-01-11 14:50:10 +01002112 if ((md_alg != MBEDTLS_MD_NONE || hashlen != 0) && hash == NULL) {
Tuvshinzaya Erdenekhuu6a473b22022-08-05 15:49:56 +01002113 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
Gilles Peskine449bd832023-01-11 14:50:10 +01002114 }
Paul Bakkerb3869132013-02-28 17:21:01 +01002115
Gilles Peskine449bd832023-01-11 14:50:10 +01002116 if (f_rng == NULL) {
2117 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
2118 }
Paul Bakkerb3869132013-02-28 17:21:01 +01002119
2120 olen = ctx->len;
2121
Gilles Peskine449bd832023-01-11 14:50:10 +01002122 if (md_alg != MBEDTLS_MD_NONE) {
Simon Butcher02037452016-03-01 21:19:12 +00002123 /* Gather length of hash to sign */
Manuel Pégourié-Gonnard9b41eb82023-03-28 11:14:24 +02002124 size_t exp_hashlen = mbedtls_md_get_size_from_type(md_alg);
Gilles Peskine449bd832023-01-11 14:50:10 +01002125 if (exp_hashlen == 0) {
2126 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
2127 }
Paul Bakkerc70b9822013-04-07 22:00:46 +02002128
Gilles Peskine449bd832023-01-11 14:50:10 +01002129 if (hashlen != exp_hashlen) {
2130 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
2131 }
Paul Bakkerb3869132013-02-28 17:21:01 +01002132 }
2133
Tomi Fontanilles573dc232023-12-10 14:57:51 +02002134 hash_id = (mbedtls_md_type_t) ctx->hash_id;
2135 if (hash_id == MBEDTLS_MD_NONE) {
2136 hash_id = md_alg;
2137 }
2138 hlen = mbedtls_md_get_size_from_type(hash_id);
Gilles Peskine449bd832023-01-11 14:50:10 +01002139 if (hlen == 0) {
2140 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
2141 }
Paul Bakkerb3869132013-02-28 17:21:01 +01002142
Gilles Peskine449bd832023-01-11 14:50:10 +01002143 if (saltlen == MBEDTLS_RSA_SALT_LEN_ANY) {
2144 /* Calculate the largest possible salt length, up to the hash size.
2145 * Normally this is the hash length, which is the maximum salt length
2146 * according to FIPS 185-4 §5.5 (e) and common practice. If there is not
2147 * enough room, use the maximum salt length that fits. The constraint is
2148 * that the hash length plus the salt length plus 2 bytes must be at most
2149 * the key length. This complies with FIPS 186-4 §5.5 (e) and RFC 8017
2150 * (PKCS#1 v2.2) §9.1.1 step 3. */
Cedric Meuter8aa4d752020-04-21 12:49:11 +02002151 min_slen = hlen - 2;
Gilles Peskine449bd832023-01-11 14:50:10 +01002152 if (olen < hlen + min_slen + 2) {
2153 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
2154 } else if (olen >= hlen + hlen + 2) {
Cedric Meuter8aa4d752020-04-21 12:49:11 +02002155 slen = hlen;
Gilles Peskine449bd832023-01-11 14:50:10 +01002156 } else {
Cedric Meuter8aa4d752020-04-21 12:49:11 +02002157 slen = olen - hlen - 2;
Gilles Peskine449bd832023-01-11 14:50:10 +01002158 }
2159 } else if ((saltlen < 0) || (saltlen + hlen + 2 > olen)) {
2160 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
2161 } else {
Cédric Meuter010ddc22020-04-25 09:24:11 +02002162 slen = (size_t) saltlen;
Cedric Meuter8aa4d752020-04-21 12:49:11 +02002163 }
Paul Bakkerb3869132013-02-28 17:21:01 +01002164
Gilles Peskine449bd832023-01-11 14:50:10 +01002165 memset(sig, 0, olen);
Paul Bakkerb3869132013-02-28 17:21:01 +01002166
Simon Butcher02037452016-03-01 21:19:12 +00002167 /* Note: EMSA-PSS encoding is over the length of N - 1 bits */
Gilles Peskine449bd832023-01-11 14:50:10 +01002168 msb = mbedtls_mpi_bitlen(&ctx->N) - 1;
Jaeden Amero3725bb22018-09-07 19:12:36 +01002169 p += olen - hlen - slen - 2;
Paul Bakkerb3869132013-02-28 17:21:01 +01002170 *p++ = 0x01;
Cédric Meuter668a78d2020-04-30 11:57:04 +02002171
2172 /* Generate salt of length slen in place in the encoded message */
2173 salt = p;
Gilles Peskine449bd832023-01-11 14:50:10 +01002174 if ((ret = f_rng(p_rng, salt, slen)) != 0) {
2175 return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_RSA_RNG_FAILED, ret);
2176 }
Cédric Meuter668a78d2020-04-30 11:57:04 +02002177
Paul Bakkerb3869132013-02-28 17:21:01 +01002178 p += slen;
2179
Simon Butcher02037452016-03-01 21:19:12 +00002180 /* Generate H = Hash( M' ) */
Tomi Fontanilles573dc232023-12-10 14:57:51 +02002181 ret = hash_mprime(hash, hashlen, salt, slen, p, hash_id);
Gilles Peskine449bd832023-01-11 14:50:10 +01002182 if (ret != 0) {
2183 return ret;
2184 }
Paul Bakkerb3869132013-02-28 17:21:01 +01002185
Simon Butcher02037452016-03-01 21:19:12 +00002186 /* Compensate for boundary condition when applying mask */
Gilles Peskine449bd832023-01-11 14:50:10 +01002187 if (msb % 8 == 0) {
Paul Bakkerb3869132013-02-28 17:21:01 +01002188 offset = 1;
Gilles Peskine449bd832023-01-11 14:50:10 +01002189 }
Paul Bakkerb3869132013-02-28 17:21:01 +01002190
Simon Butcher02037452016-03-01 21:19:12 +00002191 /* maskedDB: Apply dbMask to DB */
Tomi Fontanilles573dc232023-12-10 14:57:51 +02002192 ret = mgf_mask(sig + offset, olen - hlen - 1 - offset, p, hlen, hash_id);
Gilles Peskine449bd832023-01-11 14:50:10 +01002193 if (ret != 0) {
2194 return ret;
2195 }
Paul Bakkerb3869132013-02-28 17:21:01 +01002196
Gilles Peskine449bd832023-01-11 14:50:10 +01002197 msb = mbedtls_mpi_bitlen(&ctx->N) - 1;
2198 sig[0] &= 0xFF >> (olen * 8 - msb);
Paul Bakkerb3869132013-02-28 17:21:01 +01002199
2200 p += hlen;
2201 *p++ = 0xBC;
2202
Gilles Peskine449bd832023-01-11 14:50:10 +01002203 return mbedtls_rsa_private(ctx, f_rng, p_rng, sig, sig);
Paul Bakkerb3869132013-02-28 17:21:01 +01002204}
Cedric Meuter8aa4d752020-04-21 12:49:11 +02002205
Tomi Fontanilles573dc232023-12-10 14:57:51 +02002206static int rsa_rsassa_pss_sign(mbedtls_rsa_context *ctx,
2207 int (*f_rng)(void *, unsigned char *, size_t),
2208 void *p_rng,
2209 mbedtls_md_type_t md_alg,
2210 unsigned int hashlen,
2211 const unsigned char *hash,
2212 int saltlen,
2213 unsigned char *sig)
2214{
2215 if (ctx->padding != MBEDTLS_RSA_PKCS_V21) {
2216 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
2217 }
Valerio Settie700d802024-02-26 13:52:34 +01002218 if ((ctx->hash_id == MBEDTLS_MD_NONE) && (md_alg == MBEDTLS_MD_NONE)) {
Tomi Fontanilles573dc232023-12-10 14:57:51 +02002219 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
2220 }
2221 return rsa_rsassa_pss_sign_no_mode_check(ctx, f_rng, p_rng, md_alg, hashlen, hash, saltlen,
2222 sig);
2223}
2224
2225int mbedtls_rsa_rsassa_pss_sign_no_mode_check(mbedtls_rsa_context *ctx,
2226 int (*f_rng)(void *, unsigned char *, size_t),
2227 void *p_rng,
2228 mbedtls_md_type_t md_alg,
2229 unsigned int hashlen,
2230 const unsigned char *hash,
2231 unsigned char *sig)
2232{
2233 return rsa_rsassa_pss_sign_no_mode_check(ctx, f_rng, p_rng, md_alg,
2234 hashlen, hash, MBEDTLS_RSA_SALT_LEN_ANY, sig);
2235}
2236
Cedric Meuter8aa4d752020-04-21 12:49:11 +02002237/*
Cédric Meuterf3fab332020-04-25 11:30:45 +02002238 * Implementation of the PKCS#1 v2.1 RSASSA-PSS-SIGN function with
2239 * the option to pass in the salt length.
2240 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002241int mbedtls_rsa_rsassa_pss_sign_ext(mbedtls_rsa_context *ctx,
2242 int (*f_rng)(void *, unsigned char *, size_t),
2243 void *p_rng,
2244 mbedtls_md_type_t md_alg,
2245 unsigned int hashlen,
2246 const unsigned char *hash,
2247 int saltlen,
2248 unsigned char *sig)
Cédric Meuterf3fab332020-04-25 11:30:45 +02002249{
Gilles Peskine449bd832023-01-11 14:50:10 +01002250 return rsa_rsassa_pss_sign(ctx, f_rng, p_rng, md_alg,
2251 hashlen, hash, saltlen, sig);
Cédric Meuterf3fab332020-04-25 11:30:45 +02002252}
2253
Cédric Meuterf3fab332020-04-25 11:30:45 +02002254/*
Cedric Meuter8aa4d752020-04-21 12:49:11 +02002255 * Implementation of the PKCS#1 v2.1 RSASSA-PSS-SIGN function
2256 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002257int mbedtls_rsa_rsassa_pss_sign(mbedtls_rsa_context *ctx,
2258 int (*f_rng)(void *, unsigned char *, size_t),
2259 void *p_rng,
2260 mbedtls_md_type_t md_alg,
2261 unsigned int hashlen,
2262 const unsigned char *hash,
2263 unsigned char *sig)
Cedric Meuter8aa4d752020-04-21 12:49:11 +02002264{
Gilles Peskine449bd832023-01-11 14:50:10 +01002265 return rsa_rsassa_pss_sign(ctx, f_rng, p_rng, md_alg,
2266 hashlen, hash, MBEDTLS_RSA_SALT_LEN_ANY, sig);
Cedric Meuter8aa4d752020-04-21 12:49:11 +02002267}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002268#endif /* MBEDTLS_PKCS1_V21 */
Paul Bakkerb3869132013-02-28 17:21:01 +01002269
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002270#if defined(MBEDTLS_PKCS1_V15)
Paul Bakkerb3869132013-02-28 17:21:01 +01002271/*
2272 * Implementation of the PKCS#1 v2.1 RSASSA-PKCS1-V1_5-SIGN function
2273 */
Hanno Beckerfdf38032017-09-06 12:35:55 +01002274
2275/* Construct a PKCS v1.5 encoding of a hashed message
2276 *
2277 * This is used both for signature generation and verification.
2278 *
2279 * Parameters:
2280 * - md_alg: Identifies the hash algorithm used to generate the given hash;
Hanno Beckere58d38c2017-09-27 17:09:00 +01002281 * MBEDTLS_MD_NONE if raw data is signed.
Gilles Peskine6e3187b2021-06-22 18:39:53 +02002282 * - hashlen: Length of hash. Must match md_alg if that's not NONE.
Hanno Beckere58d38c2017-09-27 17:09:00 +01002283 * - hash: Buffer containing the hashed message or the raw data.
2284 * - dst_len: Length of the encoded message.
Hanno Beckerfdf38032017-09-06 12:35:55 +01002285 * - dst: Buffer to hold the encoded message.
2286 *
2287 * Assumptions:
Gilles Peskine6e3187b2021-06-22 18:39:53 +02002288 * - hash has size hashlen.
Hanno Beckere58d38c2017-09-27 17:09:00 +01002289 * - dst points to a buffer of size at least dst_len.
Hanno Beckerfdf38032017-09-06 12:35:55 +01002290 *
2291 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002292static int rsa_rsassa_pkcs1_v15_encode(mbedtls_md_type_t md_alg,
2293 unsigned int hashlen,
2294 const unsigned char *hash,
2295 size_t dst_len,
2296 unsigned char *dst)
Hanno Beckerfdf38032017-09-06 12:35:55 +01002297{
2298 size_t oid_size = 0;
Hanno Beckere58d38c2017-09-27 17:09:00 +01002299 size_t nb_pad = dst_len;
Hanno Beckerfdf38032017-09-06 12:35:55 +01002300 unsigned char *p = dst;
2301 const char *oid = NULL;
2302
2303 /* Are we signing hashed or raw data? */
Gilles Peskine449bd832023-01-11 14:50:10 +01002304 if (md_alg != MBEDTLS_MD_NONE) {
Manuel Pégourié-Gonnard9b41eb82023-03-28 11:14:24 +02002305 unsigned char md_size = mbedtls_md_get_size_from_type(md_alg);
Gilles Peskine449bd832023-01-11 14:50:10 +01002306 if (md_size == 0) {
2307 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
2308 }
Hanno Beckerfdf38032017-09-06 12:35:55 +01002309
Gilles Peskine449bd832023-01-11 14:50:10 +01002310 if (mbedtls_oid_get_oid_by_md(md_alg, &oid, &oid_size) != 0) {
2311 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
2312 }
Hanno Beckerfdf38032017-09-06 12:35:55 +01002313
Gilles Peskine449bd832023-01-11 14:50:10 +01002314 if (hashlen != md_size) {
2315 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
2316 }
Hanno Beckerfdf38032017-09-06 12:35:55 +01002317
2318 /* Double-check that 8 + hashlen + oid_size can be used as a
2319 * 1-byte ASN.1 length encoding and that there's no overflow. */
Gilles Peskine449bd832023-01-11 14:50:10 +01002320 if (8 + hashlen + oid_size >= 0x80 ||
Hanno Beckerfdf38032017-09-06 12:35:55 +01002321 10 + hashlen < hashlen ||
Gilles Peskine449bd832023-01-11 14:50:10 +01002322 10 + hashlen + oid_size < 10 + hashlen) {
2323 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
2324 }
Hanno Beckerfdf38032017-09-06 12:35:55 +01002325
2326 /*
2327 * Static bounds check:
2328 * - Need 10 bytes for five tag-length pairs.
2329 * (Insist on 1-byte length encodings to protect against variants of
2330 * Bleichenbacher's forgery attack against lax PKCS#1v1.5 verification)
2331 * - Need hashlen bytes for hash
2332 * - Need oid_size bytes for hash alg OID.
2333 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002334 if (nb_pad < 10 + hashlen + oid_size) {
2335 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
2336 }
Hanno Beckerfdf38032017-09-06 12:35:55 +01002337 nb_pad -= 10 + hashlen + oid_size;
Gilles Peskine449bd832023-01-11 14:50:10 +01002338 } else {
2339 if (nb_pad < hashlen) {
2340 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
2341 }
Hanno Beckerfdf38032017-09-06 12:35:55 +01002342
2343 nb_pad -= hashlen;
2344 }
2345
Hanno Becker2b2f8982017-09-27 17:10:03 +01002346 /* Need space for signature header and padding delimiter (3 bytes),
2347 * and 8 bytes for the minimal padding */
Gilles Peskine449bd832023-01-11 14:50:10 +01002348 if (nb_pad < 3 + 8) {
2349 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
2350 }
Hanno Beckerfdf38032017-09-06 12:35:55 +01002351 nb_pad -= 3;
2352
2353 /* Now nb_pad is the amount of memory to be filled
Hanno Becker2b2f8982017-09-27 17:10:03 +01002354 * with padding, and at least 8 bytes long. */
Hanno Beckerfdf38032017-09-06 12:35:55 +01002355
2356 /* Write signature header and padding */
2357 *p++ = 0;
2358 *p++ = MBEDTLS_RSA_SIGN;
Gilles Peskine449bd832023-01-11 14:50:10 +01002359 memset(p, 0xFF, nb_pad);
Hanno Beckerfdf38032017-09-06 12:35:55 +01002360 p += nb_pad;
2361 *p++ = 0;
2362
2363 /* Are we signing raw data? */
Gilles Peskine449bd832023-01-11 14:50:10 +01002364 if (md_alg == MBEDTLS_MD_NONE) {
2365 memcpy(p, hash, hashlen);
2366 return 0;
Hanno Beckerfdf38032017-09-06 12:35:55 +01002367 }
2368
2369 /* Signing hashed data, add corresponding ASN.1 structure
2370 *
2371 * DigestInfo ::= SEQUENCE {
2372 * digestAlgorithm DigestAlgorithmIdentifier,
2373 * digest Digest }
2374 * DigestAlgorithmIdentifier ::= AlgorithmIdentifier
2375 * Digest ::= OCTET STRING
2376 *
2377 * Schematic:
2378 * TAG-SEQ + LEN [ TAG-SEQ + LEN [ TAG-OID + LEN [ OID ]
2379 * TAG-NULL + LEN [ NULL ] ]
2380 * TAG-OCTET + LEN [ HASH ] ]
2381 */
2382 *p++ = MBEDTLS_ASN1_SEQUENCE | MBEDTLS_ASN1_CONSTRUCTED;
Gilles Peskine449bd832023-01-11 14:50:10 +01002383 *p++ = (unsigned char) (0x08 + oid_size + hashlen);
Hanno Beckerfdf38032017-09-06 12:35:55 +01002384 *p++ = MBEDTLS_ASN1_SEQUENCE | MBEDTLS_ASN1_CONSTRUCTED;
Gilles Peskine449bd832023-01-11 14:50:10 +01002385 *p++ = (unsigned char) (0x04 + oid_size);
Hanno Beckerfdf38032017-09-06 12:35:55 +01002386 *p++ = MBEDTLS_ASN1_OID;
Hanno Becker87ae1972018-01-15 15:27:56 +00002387 *p++ = (unsigned char) oid_size;
Gilles Peskine449bd832023-01-11 14:50:10 +01002388 memcpy(p, oid, oid_size);
Hanno Beckerfdf38032017-09-06 12:35:55 +01002389 p += oid_size;
2390 *p++ = MBEDTLS_ASN1_NULL;
2391 *p++ = 0x00;
2392 *p++ = MBEDTLS_ASN1_OCTET_STRING;
Hanno Becker87ae1972018-01-15 15:27:56 +00002393 *p++ = (unsigned char) hashlen;
Gilles Peskine449bd832023-01-11 14:50:10 +01002394 memcpy(p, hash, hashlen);
Hanno Beckerfdf38032017-09-06 12:35:55 +01002395 p += hashlen;
2396
2397 /* Just a sanity-check, should be automatic
2398 * after the initial bounds check. */
Gilles Peskine449bd832023-01-11 14:50:10 +01002399 if (p != dst + dst_len) {
2400 mbedtls_platform_zeroize(dst, dst_len);
2401 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
Hanno Beckerfdf38032017-09-06 12:35:55 +01002402 }
2403
Gilles Peskine449bd832023-01-11 14:50:10 +01002404 return 0;
Hanno Beckerfdf38032017-09-06 12:35:55 +01002405}
2406
Paul Bakkerb3869132013-02-28 17:21:01 +01002407/*
2408 * Do an RSA operation to sign the message digest
2409 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002410int mbedtls_rsa_rsassa_pkcs1_v15_sign(mbedtls_rsa_context *ctx,
2411 int (*f_rng)(void *, unsigned char *, size_t),
2412 void *p_rng,
2413 mbedtls_md_type_t md_alg,
2414 unsigned int hashlen,
2415 const unsigned char *hash,
2416 unsigned char *sig)
Paul Bakkerb3869132013-02-28 17:21:01 +01002417{
Janos Follath24eed8d2019-11-22 13:21:35 +00002418 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Hanno Beckerfdf38032017-09-06 12:35:55 +01002419 unsigned char *sig_try = NULL, *verif = NULL;
Paul Bakkerb3869132013-02-28 17:21:01 +01002420
Gilles Peskine449bd832023-01-11 14:50:10 +01002421 if ((md_alg != MBEDTLS_MD_NONE || hashlen != 0) && hash == NULL) {
Tuvshinzaya Erdenekhuu6a473b22022-08-05 15:49:56 +01002422 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
Gilles Peskine449bd832023-01-11 14:50:10 +01002423 }
Andrzej Kurekc470b6b2019-01-31 08:20:20 -05002424
Gilles Peskine449bd832023-01-11 14:50:10 +01002425 if (ctx->padding != MBEDTLS_RSA_PKCS_V15) {
2426 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
2427 }
Thomas Daubneyd58ed582021-05-21 11:50:39 +01002428
Hanno Beckerfdf38032017-09-06 12:35:55 +01002429 /*
2430 * Prepare PKCS1-v1.5 encoding (padding and hash identifier)
2431 */
Paul Bakkerb3869132013-02-28 17:21:01 +01002432
Gilles Peskine449bd832023-01-11 14:50:10 +01002433 if ((ret = rsa_rsassa_pkcs1_v15_encode(md_alg, hashlen, hash,
2434 ctx->len, sig)) != 0) {
2435 return ret;
2436 }
Manuel Pégourié-Gonnard5f501042015-09-03 20:03:15 +02002437
Hanno Beckerfdf38032017-09-06 12:35:55 +01002438 /* Private key operation
2439 *
Manuel Pégourié-Gonnard5f501042015-09-03 20:03:15 +02002440 * In order to prevent Lenstra's attack, make the signature in a
2441 * temporary buffer and check it before returning it.
2442 */
Hanno Beckerfdf38032017-09-06 12:35:55 +01002443
Gilles Peskine449bd832023-01-11 14:50:10 +01002444 sig_try = mbedtls_calloc(1, ctx->len);
2445 if (sig_try == NULL) {
2446 return MBEDTLS_ERR_MPI_ALLOC_FAILED;
Simon Butcher1285ab52016-01-01 21:42:47 +00002447 }
2448
Gilles Peskine449bd832023-01-11 14:50:10 +01002449 verif = mbedtls_calloc(1, ctx->len);
2450 if (verif == NULL) {
2451 mbedtls_free(sig_try);
2452 return MBEDTLS_ERR_MPI_ALLOC_FAILED;
2453 }
Manuel Pégourié-Gonnard5f501042015-09-03 20:03:15 +02002454
Gilles Peskine449bd832023-01-11 14:50:10 +01002455 MBEDTLS_MPI_CHK(mbedtls_rsa_private(ctx, f_rng, p_rng, sig, sig_try));
2456 MBEDTLS_MPI_CHK(mbedtls_rsa_public(ctx, sig_try, verif));
2457
2458 if (mbedtls_ct_memcmp(verif, sig, ctx->len) != 0) {
Manuel Pégourié-Gonnard5f501042015-09-03 20:03:15 +02002459 ret = MBEDTLS_ERR_RSA_PRIVATE_FAILED;
2460 goto cleanup;
2461 }
2462
Gilles Peskine449bd832023-01-11 14:50:10 +01002463 memcpy(sig, sig_try, ctx->len);
Manuel Pégourié-Gonnard5f501042015-09-03 20:03:15 +02002464
2465cleanup:
Tom Cosgroveca8c61b2023-07-17 15:17:40 +01002466 mbedtls_zeroize_and_free(sig_try, ctx->len);
2467 mbedtls_zeroize_and_free(verif, ctx->len);
Manuel Pégourié-Gonnard5f501042015-09-03 20:03:15 +02002468
Gilles Peskine449bd832023-01-11 14:50:10 +01002469 if (ret != 0) {
2470 memset(sig, '!', ctx->len);
2471 }
2472 return ret;
Paul Bakkerb3869132013-02-28 17:21:01 +01002473}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002474#endif /* MBEDTLS_PKCS1_V15 */
Paul Bakkerb3869132013-02-28 17:21:01 +01002475
2476/*
Paul Bakker5121ce52009-01-03 21:22:43 +00002477 * Do an RSA operation to sign the message digest
2478 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002479int mbedtls_rsa_pkcs1_sign(mbedtls_rsa_context *ctx,
2480 int (*f_rng)(void *, unsigned char *, size_t),
2481 void *p_rng,
2482 mbedtls_md_type_t md_alg,
2483 unsigned int hashlen,
2484 const unsigned char *hash,
2485 unsigned char *sig)
Paul Bakker5121ce52009-01-03 21:22:43 +00002486{
Gilles Peskine449bd832023-01-11 14:50:10 +01002487 if ((md_alg != MBEDTLS_MD_NONE || hashlen != 0) && hash == NULL) {
Tuvshinzaya Erdenekhuu6a473b22022-08-05 15:49:56 +01002488 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
Gilles Peskine449bd832023-01-11 14:50:10 +01002489 }
Andrzej Kurekc470b6b2019-01-31 08:20:20 -05002490
Gilles Peskine449bd832023-01-11 14:50:10 +01002491 switch (ctx->padding) {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002492#if defined(MBEDTLS_PKCS1_V15)
2493 case MBEDTLS_RSA_PKCS_V15:
Gilles Peskine449bd832023-01-11 14:50:10 +01002494 return mbedtls_rsa_rsassa_pkcs1_v15_sign(ctx, f_rng, p_rng,
2495 md_alg, hashlen, hash, sig);
Paul Bakker48377d92013-08-30 12:06:24 +02002496#endif
Paul Bakker5121ce52009-01-03 21:22:43 +00002497
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002498#if defined(MBEDTLS_PKCS1_V21)
2499 case MBEDTLS_RSA_PKCS_V21:
Gilles Peskine449bd832023-01-11 14:50:10 +01002500 return mbedtls_rsa_rsassa_pss_sign(ctx, f_rng, p_rng, md_alg,
2501 hashlen, hash, sig);
Paul Bakker9dcc3222011-03-08 14:16:06 +00002502#endif
2503
Paul Bakker5121ce52009-01-03 21:22:43 +00002504 default:
Gilles Peskine449bd832023-01-11 14:50:10 +01002505 return MBEDTLS_ERR_RSA_INVALID_PADDING;
Paul Bakker5121ce52009-01-03 21:22:43 +00002506 }
Paul Bakker5121ce52009-01-03 21:22:43 +00002507}
2508
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002509#if defined(MBEDTLS_PKCS1_V21)
Paul Bakker5121ce52009-01-03 21:22:43 +00002510/*
Paul Bakkerb3869132013-02-28 17:21:01 +01002511 * Implementation of the PKCS#1 v2.1 RSASSA-PSS-VERIFY function
Paul Bakker5121ce52009-01-03 21:22:43 +00002512 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002513int mbedtls_rsa_rsassa_pss_verify_ext(mbedtls_rsa_context *ctx,
2514 mbedtls_md_type_t md_alg,
2515 unsigned int hashlen,
2516 const unsigned char *hash,
2517 mbedtls_md_type_t mgf1_hash_id,
2518 int expected_salt_len,
2519 const unsigned char *sig)
Paul Bakker5121ce52009-01-03 21:22:43 +00002520{
Janos Follath24eed8d2019-11-22 13:21:35 +00002521 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Paul Bakkerb3869132013-02-28 17:21:01 +01002522 size_t siglen;
2523 unsigned char *p;
Gilles Peskine6a54b022017-10-17 19:02:13 +02002524 unsigned char *hash_start;
Manuel Pégourié-Gonnard88579842023-03-28 11:20:23 +02002525 unsigned char result[MBEDTLS_MD_MAX_SIZE];
Paul Bakker23986e52011-04-24 08:57:21 +00002526 unsigned int hlen;
Gilles Peskine6a54b022017-10-17 19:02:13 +02002527 size_t observed_salt_len, msb;
Gilles Peskine449bd832023-01-11 14:50:10 +01002528 unsigned char buf[MBEDTLS_MPI_MAX_SIZE] = { 0 };
Paul Bakkerb3869132013-02-28 17:21:01 +01002529
Gilles Peskine449bd832023-01-11 14:50:10 +01002530 if ((md_alg != MBEDTLS_MD_NONE || hashlen != 0) && hash == NULL) {
Tuvshinzaya Erdenekhuu6a473b22022-08-05 15:49:56 +01002531 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
Gilles Peskine449bd832023-01-11 14:50:10 +01002532 }
Andrzej Kurekc470b6b2019-01-31 08:20:20 -05002533
Paul Bakker5121ce52009-01-03 21:22:43 +00002534 siglen = ctx->len;
2535
Gilles Peskine449bd832023-01-11 14:50:10 +01002536 if (siglen < 16 || siglen > sizeof(buf)) {
2537 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
2538 }
Paul Bakker5121ce52009-01-03 21:22:43 +00002539
Gilles Peskine449bd832023-01-11 14:50:10 +01002540 ret = mbedtls_rsa_public(ctx, sig, buf);
Paul Bakker5121ce52009-01-03 21:22:43 +00002541
Gilles Peskine449bd832023-01-11 14:50:10 +01002542 if (ret != 0) {
2543 return ret;
2544 }
Paul Bakker5121ce52009-01-03 21:22:43 +00002545
2546 p = buf;
2547
Gilles Peskine449bd832023-01-11 14:50:10 +01002548 if (buf[siglen - 1] != 0xBC) {
2549 return MBEDTLS_ERR_RSA_INVALID_PADDING;
Paul Bakkerb3869132013-02-28 17:21:01 +01002550 }
Paul Bakker9dcc3222011-03-08 14:16:06 +00002551
Gilles Peskine449bd832023-01-11 14:50:10 +01002552 if (md_alg != MBEDTLS_MD_NONE) {
2553 /* Gather length of hash to sign */
Manuel Pégourié-Gonnard9b41eb82023-03-28 11:14:24 +02002554 size_t exp_hashlen = mbedtls_md_get_size_from_type(md_alg);
Gilles Peskine449bd832023-01-11 14:50:10 +01002555 if (exp_hashlen == 0) {
2556 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
2557 }
2558
2559 if (hashlen != exp_hashlen) {
2560 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
2561 }
2562 }
2563
Manuel Pégourié-Gonnard9b41eb82023-03-28 11:14:24 +02002564 hlen = mbedtls_md_get_size_from_type(mgf1_hash_id);
Gilles Peskine449bd832023-01-11 14:50:10 +01002565 if (hlen == 0) {
2566 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
2567 }
Paul Bakker9dcc3222011-03-08 14:16:06 +00002568
Simon Butcher02037452016-03-01 21:19:12 +00002569 /*
2570 * Note: EMSA-PSS verification is over the length of N - 1 bits
2571 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002572 msb = mbedtls_mpi_bitlen(&ctx->N) - 1;
Paul Bakker9dcc3222011-03-08 14:16:06 +00002573
Gilles Peskine449bd832023-01-11 14:50:10 +01002574 if (buf[0] >> (8 - siglen * 8 + msb)) {
2575 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
2576 }
Gilles Peskineb00b0da2017-10-19 15:23:49 +02002577
Simon Butcher02037452016-03-01 21:19:12 +00002578 /* Compensate for boundary condition when applying mask */
Gilles Peskine449bd832023-01-11 14:50:10 +01002579 if (msb % 8 == 0) {
Paul Bakkerb3869132013-02-28 17:21:01 +01002580 p++;
2581 siglen -= 1;
2582 }
Paul Bakker9dcc3222011-03-08 14:16:06 +00002583
Gilles Peskine449bd832023-01-11 14:50:10 +01002584 if (siglen < hlen + 2) {
2585 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
2586 }
Gilles Peskine139108a2017-10-18 19:03:42 +02002587 hash_start = p + siglen - hlen - 1;
2588
Gilles Peskine449bd832023-01-11 14:50:10 +01002589 ret = mgf_mask(p, siglen - hlen - 1, hash_start, hlen, mgf1_hash_id);
2590 if (ret != 0) {
2591 return ret;
2592 }
Paul Bakker02303e82013-01-03 11:08:31 +01002593
Gilles Peskine449bd832023-01-11 14:50:10 +01002594 buf[0] &= 0xFF >> (siglen * 8 - msb);
Paul Bakker9dcc3222011-03-08 14:16:06 +00002595
Gilles Peskine449bd832023-01-11 14:50:10 +01002596 while (p < hash_start - 1 && *p == 0) {
Paul Bakkerb3869132013-02-28 17:21:01 +01002597 p++;
Gilles Peskine449bd832023-01-11 14:50:10 +01002598 }
Paul Bakker9dcc3222011-03-08 14:16:06 +00002599
Gilles Peskine449bd832023-01-11 14:50:10 +01002600 if (*p++ != 0x01) {
2601 return MBEDTLS_ERR_RSA_INVALID_PADDING;
2602 }
Paul Bakker9dcc3222011-03-08 14:16:06 +00002603
Dave Rodgmane4a6f5a2023-11-04 12:20:09 +00002604 observed_salt_len = (size_t) (hash_start - p);
Paul Bakker9dcc3222011-03-08 14:16:06 +00002605
Gilles Peskine449bd832023-01-11 14:50:10 +01002606 if (expected_salt_len != MBEDTLS_RSA_SALT_LEN_ANY &&
2607 observed_salt_len != (size_t) expected_salt_len) {
2608 return MBEDTLS_ERR_RSA_INVALID_PADDING;
Manuel Pégourié-Gonnard5ec628a2014-06-03 11:44:06 +02002609 }
2610
Simon Butcher02037452016-03-01 21:19:12 +00002611 /*
2612 * Generate H = Hash( M' )
2613 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002614 ret = hash_mprime(hash, hashlen, p, observed_salt_len,
2615 result, mgf1_hash_id);
2616 if (ret != 0) {
2617 return ret;
2618 }
Paul Bakker53019ae2011-03-25 13:58:48 +00002619
Gilles Peskine449bd832023-01-11 14:50:10 +01002620 if (memcmp(hash_start, result, hlen) != 0) {
2621 return MBEDTLS_ERR_RSA_VERIFY_FAILED;
2622 }
Andres Amaya Garcia698089e2017-06-28 11:46:46 +01002623
Gilles Peskine449bd832023-01-11 14:50:10 +01002624 return 0;
Paul Bakkerb3869132013-02-28 17:21:01 +01002625}
Manuel Pégourié-Gonnard5ec628a2014-06-03 11:44:06 +02002626
2627/*
2628 * Simplified PKCS#1 v2.1 RSASSA-PSS-VERIFY function
2629 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002630int mbedtls_rsa_rsassa_pss_verify(mbedtls_rsa_context *ctx,
2631 mbedtls_md_type_t md_alg,
2632 unsigned int hashlen,
2633 const unsigned char *hash,
2634 const unsigned char *sig)
Manuel Pégourié-Gonnard5ec628a2014-06-03 11:44:06 +02002635{
Andrzej Kurekc470b6b2019-01-31 08:20:20 -05002636 mbedtls_md_type_t mgf1_hash_id;
Gilles Peskine449bd832023-01-11 14:50:10 +01002637 if ((md_alg != MBEDTLS_MD_NONE || hashlen != 0) && hash == NULL) {
Tuvshinzaya Erdenekhuu6a473b22022-08-05 15:49:56 +01002638 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
Gilles Peskine449bd832023-01-11 14:50:10 +01002639 }
Andrzej Kurekc470b6b2019-01-31 08:20:20 -05002640
Gilles Peskine449bd832023-01-11 14:50:10 +01002641 mgf1_hash_id = (ctx->hash_id != MBEDTLS_MD_NONE)
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002642 ? (mbedtls_md_type_t) ctx->hash_id
Manuel Pégourié-Gonnard5ec628a2014-06-03 11:44:06 +02002643 : md_alg;
2644
Gilles Peskine449bd832023-01-11 14:50:10 +01002645 return mbedtls_rsa_rsassa_pss_verify_ext(ctx,
2646 md_alg, hashlen, hash,
2647 mgf1_hash_id,
2648 MBEDTLS_RSA_SALT_LEN_ANY,
2649 sig);
Manuel Pégourié-Gonnard5ec628a2014-06-03 11:44:06 +02002650
2651}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002652#endif /* MBEDTLS_PKCS1_V21 */
Paul Bakker40628ba2013-01-03 10:50:31 +01002653
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002654#if defined(MBEDTLS_PKCS1_V15)
Paul Bakkerb3869132013-02-28 17:21:01 +01002655/*
2656 * Implementation of the PKCS#1 v2.1 RSASSA-PKCS1-v1_5-VERIFY function
2657 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002658int mbedtls_rsa_rsassa_pkcs1_v15_verify(mbedtls_rsa_context *ctx,
2659 mbedtls_md_type_t md_alg,
2660 unsigned int hashlen,
2661 const unsigned char *hash,
2662 const unsigned char *sig)
Paul Bakkerb3869132013-02-28 17:21:01 +01002663{
Hanno Becker64a8c0a2017-09-06 12:39:49 +01002664 int ret = 0;
Andrzej Kurekc470b6b2019-01-31 08:20:20 -05002665 size_t sig_len;
Hanno Becker64a8c0a2017-09-06 12:39:49 +01002666 unsigned char *encoded = NULL, *encoded_expected = NULL;
Paul Bakkerb3869132013-02-28 17:21:01 +01002667
Gilles Peskine449bd832023-01-11 14:50:10 +01002668 if ((md_alg != MBEDTLS_MD_NONE || hashlen != 0) && hash == NULL) {
Tuvshinzaya Erdenekhuu6a473b22022-08-05 15:49:56 +01002669 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
Gilles Peskine449bd832023-01-11 14:50:10 +01002670 }
Andrzej Kurekc470b6b2019-01-31 08:20:20 -05002671
2672 sig_len = ctx->len;
2673
Hanno Becker64a8c0a2017-09-06 12:39:49 +01002674 /*
2675 * Prepare expected PKCS1 v1.5 encoding of hash.
2676 */
Paul Bakkerb3869132013-02-28 17:21:01 +01002677
Gilles Peskine449bd832023-01-11 14:50:10 +01002678 if ((encoded = mbedtls_calloc(1, sig_len)) == NULL ||
2679 (encoded_expected = mbedtls_calloc(1, sig_len)) == NULL) {
Hanno Becker64a8c0a2017-09-06 12:39:49 +01002680 ret = MBEDTLS_ERR_MPI_ALLOC_FAILED;
2681 goto cleanup;
2682 }
2683
Gilles Peskine449bd832023-01-11 14:50:10 +01002684 if ((ret = rsa_rsassa_pkcs1_v15_encode(md_alg, hashlen, hash, sig_len,
2685 encoded_expected)) != 0) {
Hanno Becker64a8c0a2017-09-06 12:39:49 +01002686 goto cleanup;
Gilles Peskine449bd832023-01-11 14:50:10 +01002687 }
Hanno Becker64a8c0a2017-09-06 12:39:49 +01002688
2689 /*
2690 * Apply RSA primitive to get what should be PKCS1 encoded hash.
2691 */
Paul Bakkerb3869132013-02-28 17:21:01 +01002692
Gilles Peskine449bd832023-01-11 14:50:10 +01002693 ret = mbedtls_rsa_public(ctx, sig, encoded);
2694 if (ret != 0) {
Hanno Becker64a8c0a2017-09-06 12:39:49 +01002695 goto cleanup;
Gilles Peskine449bd832023-01-11 14:50:10 +01002696 }
Paul Bakkerc70b9822013-04-07 22:00:46 +02002697
Simon Butcher02037452016-03-01 21:19:12 +00002698 /*
Hanno Becker64a8c0a2017-09-06 12:39:49 +01002699 * Compare
Simon Butcher02037452016-03-01 21:19:12 +00002700 */
Paul Bakkerc70b9822013-04-07 22:00:46 +02002701
Gilles Peskine449bd832023-01-11 14:50:10 +01002702 if ((ret = mbedtls_ct_memcmp(encoded, encoded_expected,
2703 sig_len)) != 0) {
Hanno Becker64a8c0a2017-09-06 12:39:49 +01002704 ret = MBEDTLS_ERR_RSA_VERIFY_FAILED;
2705 goto cleanup;
2706 }
Paul Bakkerc70b9822013-04-07 22:00:46 +02002707
Hanno Becker64a8c0a2017-09-06 12:39:49 +01002708cleanup:
Paul Bakkerc70b9822013-04-07 22:00:46 +02002709
Gilles Peskine449bd832023-01-11 14:50:10 +01002710 if (encoded != NULL) {
Tom Cosgroveca8c61b2023-07-17 15:17:40 +01002711 mbedtls_zeroize_and_free(encoded, sig_len);
Hanno Becker64a8c0a2017-09-06 12:39:49 +01002712 }
Paul Bakkerc70b9822013-04-07 22:00:46 +02002713
Gilles Peskine449bd832023-01-11 14:50:10 +01002714 if (encoded_expected != NULL) {
Tom Cosgroveca8c61b2023-07-17 15:17:40 +01002715 mbedtls_zeroize_and_free(encoded_expected, sig_len);
Hanno Becker64a8c0a2017-09-06 12:39:49 +01002716 }
Paul Bakkerc70b9822013-04-07 22:00:46 +02002717
Gilles Peskine449bd832023-01-11 14:50:10 +01002718 return ret;
Paul Bakker5121ce52009-01-03 21:22:43 +00002719}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002720#endif /* MBEDTLS_PKCS1_V15 */
Paul Bakker5121ce52009-01-03 21:22:43 +00002721
2722/*
Paul Bakkerb3869132013-02-28 17:21:01 +01002723 * Do an RSA operation and check the message digest
2724 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002725int mbedtls_rsa_pkcs1_verify(mbedtls_rsa_context *ctx,
2726 mbedtls_md_type_t md_alg,
2727 unsigned int hashlen,
2728 const unsigned char *hash,
2729 const unsigned char *sig)
Paul Bakkerb3869132013-02-28 17:21:01 +01002730{
Gilles Peskine449bd832023-01-11 14:50:10 +01002731 if ((md_alg != MBEDTLS_MD_NONE || hashlen != 0) && hash == NULL) {
Tuvshinzaya Erdenekhuu6a473b22022-08-05 15:49:56 +01002732 return MBEDTLS_ERR_RSA_BAD_INPUT_DATA;
Gilles Peskine449bd832023-01-11 14:50:10 +01002733 }
Andrzej Kurekc470b6b2019-01-31 08:20:20 -05002734
Gilles Peskine449bd832023-01-11 14:50:10 +01002735 switch (ctx->padding) {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002736#if defined(MBEDTLS_PKCS1_V15)
2737 case MBEDTLS_RSA_PKCS_V15:
Gilles Peskine449bd832023-01-11 14:50:10 +01002738 return mbedtls_rsa_rsassa_pkcs1_v15_verify(ctx, md_alg,
2739 hashlen, hash, sig);
Paul Bakker48377d92013-08-30 12:06:24 +02002740#endif
Paul Bakkerb3869132013-02-28 17:21:01 +01002741
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002742#if defined(MBEDTLS_PKCS1_V21)
2743 case MBEDTLS_RSA_PKCS_V21:
Gilles Peskine449bd832023-01-11 14:50:10 +01002744 return mbedtls_rsa_rsassa_pss_verify(ctx, md_alg,
2745 hashlen, hash, sig);
Paul Bakkerb3869132013-02-28 17:21:01 +01002746#endif
2747
2748 default:
Gilles Peskine449bd832023-01-11 14:50:10 +01002749 return MBEDTLS_ERR_RSA_INVALID_PADDING;
Paul Bakkerb3869132013-02-28 17:21:01 +01002750 }
2751}
2752
2753/*
Manuel Pégourié-Gonnard3053f5b2013-08-14 13:39:57 +02002754 * Copy the components of an RSA key
2755 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002756int mbedtls_rsa_copy(mbedtls_rsa_context *dst, const mbedtls_rsa_context *src)
Manuel Pégourié-Gonnard3053f5b2013-08-14 13:39:57 +02002757{
Janos Follath24eed8d2019-11-22 13:21:35 +00002758 int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
Manuel Pégourié-Gonnard3053f5b2013-08-14 13:39:57 +02002759
Manuel Pégourié-Gonnard3053f5b2013-08-14 13:39:57 +02002760 dst->len = src->len;
2761
Gilles Peskine449bd832023-01-11 14:50:10 +01002762 MBEDTLS_MPI_CHK(mbedtls_mpi_copy(&dst->N, &src->N));
2763 MBEDTLS_MPI_CHK(mbedtls_mpi_copy(&dst->E, &src->E));
Manuel Pégourié-Gonnard3053f5b2013-08-14 13:39:57 +02002764
Gilles Peskine449bd832023-01-11 14:50:10 +01002765 MBEDTLS_MPI_CHK(mbedtls_mpi_copy(&dst->D, &src->D));
2766 MBEDTLS_MPI_CHK(mbedtls_mpi_copy(&dst->P, &src->P));
2767 MBEDTLS_MPI_CHK(mbedtls_mpi_copy(&dst->Q, &src->Q));
Hanno Becker33c30a02017-08-23 07:00:22 +01002768
2769#if !defined(MBEDTLS_RSA_NO_CRT)
Gilles Peskine449bd832023-01-11 14:50:10 +01002770 MBEDTLS_MPI_CHK(mbedtls_mpi_copy(&dst->DP, &src->DP));
2771 MBEDTLS_MPI_CHK(mbedtls_mpi_copy(&dst->DQ, &src->DQ));
2772 MBEDTLS_MPI_CHK(mbedtls_mpi_copy(&dst->QP, &src->QP));
2773 MBEDTLS_MPI_CHK(mbedtls_mpi_copy(&dst->RP, &src->RP));
2774 MBEDTLS_MPI_CHK(mbedtls_mpi_copy(&dst->RQ, &src->RQ));
Hanno Becker33c30a02017-08-23 07:00:22 +01002775#endif
2776
Gilles Peskine449bd832023-01-11 14:50:10 +01002777 MBEDTLS_MPI_CHK(mbedtls_mpi_copy(&dst->RN, &src->RN));
Manuel Pégourié-Gonnard3053f5b2013-08-14 13:39:57 +02002778
Gilles Peskine449bd832023-01-11 14:50:10 +01002779 MBEDTLS_MPI_CHK(mbedtls_mpi_copy(&dst->Vi, &src->Vi));
2780 MBEDTLS_MPI_CHK(mbedtls_mpi_copy(&dst->Vf, &src->Vf));
Manuel Pégourié-Gonnardea53a552013-09-10 13:29:30 +02002781
Manuel Pégourié-Gonnard3053f5b2013-08-14 13:39:57 +02002782 dst->padding = src->padding;
Manuel Pégourié-Gonnardfdddac92014-03-25 15:58:35 +01002783 dst->hash_id = src->hash_id;
Manuel Pégourié-Gonnard3053f5b2013-08-14 13:39:57 +02002784
2785cleanup:
Gilles Peskine449bd832023-01-11 14:50:10 +01002786 if (ret != 0) {
2787 mbedtls_rsa_free(dst);
2788 }
Manuel Pégourié-Gonnard3053f5b2013-08-14 13:39:57 +02002789
Gilles Peskine449bd832023-01-11 14:50:10 +01002790 return ret;
Manuel Pégourié-Gonnard3053f5b2013-08-14 13:39:57 +02002791}
2792
2793/*
Paul Bakker5121ce52009-01-03 21:22:43 +00002794 * Free the components of an RSA key
2795 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002796void mbedtls_rsa_free(mbedtls_rsa_context *ctx)
Paul Bakker5121ce52009-01-03 21:22:43 +00002797{
Gilles Peskine449bd832023-01-11 14:50:10 +01002798 if (ctx == NULL) {
Andrzej Kurekc470b6b2019-01-31 08:20:20 -05002799 return;
Gilles Peskine449bd832023-01-11 14:50:10 +01002800 }
Andrzej Kurekc470b6b2019-01-31 08:20:20 -05002801
Gilles Peskine449bd832023-01-11 14:50:10 +01002802 mbedtls_mpi_free(&ctx->Vi);
2803 mbedtls_mpi_free(&ctx->Vf);
2804 mbedtls_mpi_free(&ctx->RN);
2805 mbedtls_mpi_free(&ctx->D);
2806 mbedtls_mpi_free(&ctx->Q);
2807 mbedtls_mpi_free(&ctx->P);
2808 mbedtls_mpi_free(&ctx->E);
2809 mbedtls_mpi_free(&ctx->N);
Paul Bakkerc9965dc2013-09-29 14:58:17 +02002810
Hanno Becker33c30a02017-08-23 07:00:22 +01002811#if !defined(MBEDTLS_RSA_NO_CRT)
Gilles Peskine449bd832023-01-11 14:50:10 +01002812 mbedtls_mpi_free(&ctx->RQ);
2813 mbedtls_mpi_free(&ctx->RP);
2814 mbedtls_mpi_free(&ctx->QP);
2815 mbedtls_mpi_free(&ctx->DQ);
2816 mbedtls_mpi_free(&ctx->DP);
Hanno Becker33c30a02017-08-23 07:00:22 +01002817#endif /* MBEDTLS_RSA_NO_CRT */
2818
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002819#if defined(MBEDTLS_THREADING_C)
Gilles Peskineeb940592021-02-01 17:57:41 +01002820 /* Free the mutex, but only if it hasn't been freed already. */
Gilles Peskine449bd832023-01-11 14:50:10 +01002821 if (ctx->ver != 0) {
2822 mbedtls_mutex_free(&ctx->mutex);
Gilles Peskineeb940592021-02-01 17:57:41 +01002823 ctx->ver = 0;
2824 }
Paul Bakkerc9965dc2013-09-29 14:58:17 +02002825#endif
Paul Bakker5121ce52009-01-03 21:22:43 +00002826}
2827
Hanno Beckerab377312017-08-23 16:24:51 +01002828#endif /* !MBEDTLS_RSA_ALT */
2829
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002830#if defined(MBEDTLS_SELF_TEST)
Paul Bakker5121ce52009-01-03 21:22:43 +00002831
Paul Bakker5121ce52009-01-03 21:22:43 +00002832
2833/*
2834 * Example RSA-1024 keypair, for test purposes
2835 */
2836#define KEY_LEN 128
2837
2838#define RSA_N "9292758453063D803DD603D5E777D788" \
2839 "8ED1D5BF35786190FA2F23EBC0848AEA" \
2840 "DDA92CA6C3D80B32C4D109BE0F36D6AE" \
2841 "7130B9CED7ACDF54CFC7555AC14EEBAB" \
2842 "93A89813FBF3C4F8066D2D800F7C38A8" \
2843 "1AE31942917403FF4946B0A83D3D3E05" \
2844 "EE57C6F5F5606FB5D4BC6CD34EE0801A" \
2845 "5E94BB77B07507233A0BC7BAC8F90F79"
2846
2847#define RSA_E "10001"
2848
2849#define RSA_D "24BF6185468786FDD303083D25E64EFC" \
2850 "66CA472BC44D253102F8B4A9D3BFA750" \
2851 "91386C0077937FE33FA3252D28855837" \
2852 "AE1B484A8A9A45F7EE8C0C634F99E8CD" \
2853 "DF79C5CE07EE72C7F123142198164234" \
2854 "CABB724CF78B8173B9F880FC86322407" \
2855 "AF1FEDFDDE2BEB674CA15F3E81A1521E" \
2856 "071513A1E85B5DFA031F21ECAE91A34D"
2857
2858#define RSA_P "C36D0EB7FCD285223CFB5AABA5BDA3D8" \
2859 "2C01CAD19EA484A87EA4377637E75500" \
2860 "FCB2005C5C7DD6EC4AC023CDA285D796" \
2861 "C3D9E75E1EFC42488BB4F1D13AC30A57"
2862
2863#define RSA_Q "C000DF51A7C77AE8D7C7370C1FF55B69" \
2864 "E211C2B9E5DB1ED0BF61D0D9899620F4" \
2865 "910E4168387E3C30AA1E00C339A79508" \
2866 "8452DD96A9A5EA5D9DCA68DA636032AF"
2867
Paul Bakker5121ce52009-01-03 21:22:43 +00002868#define PT_LEN 24
2869#define RSA_PT "\xAA\xBB\xCC\x03\x02\x01\x00\xFF\xFF\xFF\xFF\xFF" \
2870 "\x11\x22\x33\x0A\x0B\x0C\xCC\xDD\xDD\xDD\xDD\xDD"
2871
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002872#if defined(MBEDTLS_PKCS1_V15)
Gilles Peskine449bd832023-01-11 14:50:10 +01002873static int myrand(void *rng_state, unsigned char *output, size_t len)
Paul Bakker545570e2010-07-18 09:00:25 +00002874{
gufe44c2620da2020-08-03 17:56:50 +02002875#if !defined(__OpenBSD__) && !defined(__NetBSD__)
Paul Bakkera3d195c2011-11-27 21:07:34 +00002876 size_t i;
2877
Gilles Peskine449bd832023-01-11 14:50:10 +01002878 if (rng_state != NULL) {
Paul Bakker545570e2010-07-18 09:00:25 +00002879 rng_state = NULL;
Gilles Peskine449bd832023-01-11 14:50:10 +01002880 }
Paul Bakker545570e2010-07-18 09:00:25 +00002881
Gilles Peskine449bd832023-01-11 14:50:10 +01002882 for (i = 0; i < len; ++i) {
Paul Bakkera3d195c2011-11-27 21:07:34 +00002883 output[i] = rand();
Gilles Peskine449bd832023-01-11 14:50:10 +01002884 }
Paul Bakkerf96f7b62014-04-30 16:02:38 +02002885#else
Gilles Peskine449bd832023-01-11 14:50:10 +01002886 if (rng_state != NULL) {
Paul Bakkerf96f7b62014-04-30 16:02:38 +02002887 rng_state = NULL;
Gilles Peskine449bd832023-01-11 14:50:10 +01002888 }
Paul Bakkerf96f7b62014-04-30 16:02:38 +02002889
Gilles Peskine449bd832023-01-11 14:50:10 +01002890 arc4random_buf(output, len);
gufe44c2620da2020-08-03 17:56:50 +02002891#endif /* !OpenBSD && !NetBSD */
Paul Bakker48377d92013-08-30 12:06:24 +02002892
Gilles Peskine449bd832023-01-11 14:50:10 +01002893 return 0;
Paul Bakker545570e2010-07-18 09:00:25 +00002894}
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002895#endif /* MBEDTLS_PKCS1_V15 */
Paul Bakker545570e2010-07-18 09:00:25 +00002896
Paul Bakker5121ce52009-01-03 21:22:43 +00002897/*
2898 * Checkup routine
2899 */
Gilles Peskine449bd832023-01-11 14:50:10 +01002900int mbedtls_rsa_self_test(int verbose)
Paul Bakker5121ce52009-01-03 21:22:43 +00002901{
Paul Bakker3d8fb632014-04-17 12:42:41 +02002902 int ret = 0;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002903#if defined(MBEDTLS_PKCS1_V15)
Paul Bakker23986e52011-04-24 08:57:21 +00002904 size_t len;
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02002905 mbedtls_rsa_context rsa;
Paul Bakker5121ce52009-01-03 21:22:43 +00002906 unsigned char rsa_plaintext[PT_LEN];
2907 unsigned char rsa_decrypted[PT_LEN];
2908 unsigned char rsa_ciphertext[KEY_LEN];
Manuel Pégourié-Gonnardc1f10442023-03-16 10:58:19 +01002909#if defined(MBEDTLS_MD_CAN_SHA1)
Paul Bakker5690efc2011-05-26 13:16:06 +00002910 unsigned char sha1sum[20];
2911#endif
Paul Bakker5121ce52009-01-03 21:22:43 +00002912
Hanno Becker3a701162017-08-22 13:52:43 +01002913 mbedtls_mpi K;
2914
Gilles Peskine449bd832023-01-11 14:50:10 +01002915 mbedtls_mpi_init(&K);
2916 mbedtls_rsa_init(&rsa);
Paul Bakker5121ce52009-01-03 21:22:43 +00002917
Gilles Peskine449bd832023-01-11 14:50:10 +01002918 MBEDTLS_MPI_CHK(mbedtls_mpi_read_string(&K, 16, RSA_N));
2919 MBEDTLS_MPI_CHK(mbedtls_rsa_import(&rsa, &K, NULL, NULL, NULL, NULL));
2920 MBEDTLS_MPI_CHK(mbedtls_mpi_read_string(&K, 16, RSA_P));
2921 MBEDTLS_MPI_CHK(mbedtls_rsa_import(&rsa, NULL, &K, NULL, NULL, NULL));
2922 MBEDTLS_MPI_CHK(mbedtls_mpi_read_string(&K, 16, RSA_Q));
2923 MBEDTLS_MPI_CHK(mbedtls_rsa_import(&rsa, NULL, NULL, &K, NULL, NULL));
2924 MBEDTLS_MPI_CHK(mbedtls_mpi_read_string(&K, 16, RSA_D));
2925 MBEDTLS_MPI_CHK(mbedtls_rsa_import(&rsa, NULL, NULL, NULL, &K, NULL));
2926 MBEDTLS_MPI_CHK(mbedtls_mpi_read_string(&K, 16, RSA_E));
2927 MBEDTLS_MPI_CHK(mbedtls_rsa_import(&rsa, NULL, NULL, NULL, NULL, &K));
Hanno Becker3a701162017-08-22 13:52:43 +01002928
Gilles Peskine449bd832023-01-11 14:50:10 +01002929 MBEDTLS_MPI_CHK(mbedtls_rsa_complete(&rsa));
Paul Bakker5121ce52009-01-03 21:22:43 +00002930
Gilles Peskine449bd832023-01-11 14:50:10 +01002931 if (verbose != 0) {
2932 mbedtls_printf(" RSA key validation: ");
2933 }
Paul Bakker5121ce52009-01-03 21:22:43 +00002934
Gilles Peskine449bd832023-01-11 14:50:10 +01002935 if (mbedtls_rsa_check_pubkey(&rsa) != 0 ||
2936 mbedtls_rsa_check_privkey(&rsa) != 0) {
2937 if (verbose != 0) {
2938 mbedtls_printf("failed\n");
2939 }
Paul Bakker5121ce52009-01-03 21:22:43 +00002940
Hanno Becker5bc87292017-05-03 15:09:31 +01002941 ret = 1;
2942 goto cleanup;
Paul Bakker5121ce52009-01-03 21:22:43 +00002943 }
2944
Gilles Peskine449bd832023-01-11 14:50:10 +01002945 if (verbose != 0) {
2946 mbedtls_printf("passed\n PKCS#1 encryption : ");
2947 }
Paul Bakker5121ce52009-01-03 21:22:43 +00002948
Gilles Peskine449bd832023-01-11 14:50:10 +01002949 memcpy(rsa_plaintext, RSA_PT, PT_LEN);
Paul Bakker5121ce52009-01-03 21:22:43 +00002950
Gilles Peskine449bd832023-01-11 14:50:10 +01002951 if (mbedtls_rsa_pkcs1_encrypt(&rsa, myrand, NULL,
2952 PT_LEN, rsa_plaintext,
2953 rsa_ciphertext) != 0) {
2954 if (verbose != 0) {
2955 mbedtls_printf("failed\n");
2956 }
Paul Bakker5121ce52009-01-03 21:22:43 +00002957
Hanno Becker5bc87292017-05-03 15:09:31 +01002958 ret = 1;
2959 goto cleanup;
Paul Bakker5121ce52009-01-03 21:22:43 +00002960 }
2961
Gilles Peskine449bd832023-01-11 14:50:10 +01002962 if (verbose != 0) {
2963 mbedtls_printf("passed\n PKCS#1 decryption : ");
2964 }
Paul Bakker5121ce52009-01-03 21:22:43 +00002965
Gilles Peskine449bd832023-01-11 14:50:10 +01002966 if (mbedtls_rsa_pkcs1_decrypt(&rsa, myrand, NULL,
2967 &len, rsa_ciphertext, rsa_decrypted,
2968 sizeof(rsa_decrypted)) != 0) {
2969 if (verbose != 0) {
2970 mbedtls_printf("failed\n");
2971 }
Paul Bakker5121ce52009-01-03 21:22:43 +00002972
Hanno Becker5bc87292017-05-03 15:09:31 +01002973 ret = 1;
2974 goto cleanup;
Paul Bakker5121ce52009-01-03 21:22:43 +00002975 }
2976
Gilles Peskine449bd832023-01-11 14:50:10 +01002977 if (memcmp(rsa_decrypted, rsa_plaintext, len) != 0) {
2978 if (verbose != 0) {
2979 mbedtls_printf("failed\n");
2980 }
Paul Bakker5121ce52009-01-03 21:22:43 +00002981
Hanno Becker5bc87292017-05-03 15:09:31 +01002982 ret = 1;
2983 goto cleanup;
Paul Bakker5121ce52009-01-03 21:22:43 +00002984 }
2985
Gilles Peskine449bd832023-01-11 14:50:10 +01002986 if (verbose != 0) {
2987 mbedtls_printf("passed\n");
2988 }
Manuel Pégourié-Gonnardd1004f02015-08-07 10:46:54 +02002989
Manuel Pégourié-Gonnardc1f10442023-03-16 10:58:19 +01002990#if defined(MBEDTLS_MD_CAN_SHA1)
Gilles Peskine449bd832023-01-11 14:50:10 +01002991 if (verbose != 0) {
2992 mbedtls_printf(" PKCS#1 data sign : ");
Andres Amaya Garcia698089e2017-06-28 11:46:46 +01002993 }
Paul Bakker5121ce52009-01-03 21:22:43 +00002994
Manuel Pégourié-Gonnardb33ef742023-03-07 00:04:16 +01002995 if (mbedtls_md(mbedtls_md_info_from_type(MBEDTLS_MD_SHA1),
2996 rsa_plaintext, PT_LEN, sha1sum) != 0) {
Gilles Peskine449bd832023-01-11 14:50:10 +01002997 if (verbose != 0) {
2998 mbedtls_printf("failed\n");
2999 }
3000
3001 return 1;
3002 }
3003
3004 if (mbedtls_rsa_pkcs1_sign(&rsa, myrand, NULL,
3005 MBEDTLS_MD_SHA1, 20,
3006 sha1sum, rsa_ciphertext) != 0) {
3007 if (verbose != 0) {
3008 mbedtls_printf("failed\n");
3009 }
Paul Bakker5121ce52009-01-03 21:22:43 +00003010
Hanno Becker5bc87292017-05-03 15:09:31 +01003011 ret = 1;
3012 goto cleanup;
Paul Bakker5121ce52009-01-03 21:22:43 +00003013 }
3014
Gilles Peskine449bd832023-01-11 14:50:10 +01003015 if (verbose != 0) {
3016 mbedtls_printf("passed\n PKCS#1 sig. verify: ");
3017 }
Paul Bakker5121ce52009-01-03 21:22:43 +00003018
Gilles Peskine449bd832023-01-11 14:50:10 +01003019 if (mbedtls_rsa_pkcs1_verify(&rsa, MBEDTLS_MD_SHA1, 20,
3020 sha1sum, rsa_ciphertext) != 0) {
3021 if (verbose != 0) {
3022 mbedtls_printf("failed\n");
3023 }
Paul Bakker5121ce52009-01-03 21:22:43 +00003024
Hanno Becker5bc87292017-05-03 15:09:31 +01003025 ret = 1;
3026 goto cleanup;
Paul Bakker5121ce52009-01-03 21:22:43 +00003027 }
3028
Gilles Peskine449bd832023-01-11 14:50:10 +01003029 if (verbose != 0) {
3030 mbedtls_printf("passed\n");
3031 }
Manuel Pégourié-Gonnardc1f10442023-03-16 10:58:19 +01003032#endif /* MBEDTLS_MD_CAN_SHA1 */
Paul Bakker5121ce52009-01-03 21:22:43 +00003033
Gilles Peskine449bd832023-01-11 14:50:10 +01003034 if (verbose != 0) {
3035 mbedtls_printf("\n");
3036 }
Manuel Pégourié-Gonnardd1004f02015-08-07 10:46:54 +02003037
Paul Bakker3d8fb632014-04-17 12:42:41 +02003038cleanup:
Gilles Peskine449bd832023-01-11 14:50:10 +01003039 mbedtls_mpi_free(&K);
3040 mbedtls_rsa_free(&rsa);
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003041#else /* MBEDTLS_PKCS1_V15 */
Paul Bakker3e41fe82013-09-15 17:42:50 +02003042 ((void) verbose);
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003043#endif /* MBEDTLS_PKCS1_V15 */
Gilles Peskine449bd832023-01-11 14:50:10 +01003044 return ret;
Paul Bakker5121ce52009-01-03 21:22:43 +00003045}
3046
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003047#endif /* MBEDTLS_SELF_TEST */
Paul Bakker5121ce52009-01-03 21:22:43 +00003048
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +02003049#endif /* MBEDTLS_RSA_C */