• Home
  • Features
  • Pricing
  • Docs
  • Announcements
  • Sign In

randombit / botan / 5454043422

04 Jul 2023 11:13AM CUT coverage: 91.659% (-0.07%) from 91.732%
5454043422

Pull #3609

github

web-flow
Merge 5741e183c into cf8d8a6ca
Pull Request #3609: [TLS 1.3] Hybrid PQ/T key establishment

78635 of 85791 relevant lines covered (91.66%)

12300857.61 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

93.45
/src/lib/pubkey/rsa/rsa.cpp
1
/*
2
* RSA
3
* (C) 1999-2010,2015,2016,2018,2019,2023 Jack Lloyd
4
*
5
* Botan is released under the Simplified BSD License (see license.txt)
6
*/
7

8
#include <botan/rsa.h>
9

10
#include <botan/ber_dec.h>
11
#include <botan/der_enc.h>
12
#include <botan/reducer.h>
13
#include <botan/internal/blinding.h>
14
#include <botan/internal/divide.h>
15
#include <botan/internal/emsa.h>
16
#include <botan/internal/fmt.h>
17
#include <botan/internal/keypair.h>
18
#include <botan/internal/monty.h>
19
#include <botan/internal/monty_exp.h>
20
#include <botan/internal/parsing.h>
21
#include <botan/internal/pk_ops_impl.h>
22
#include <botan/internal/pss_params.h>
23
#include <botan/internal/workfactor.h>
24

25
#if defined(BOTAN_HAS_THREAD_UTILS)
26
   #include <botan/internal/thread_pool.h>
27
#endif
28

29
namespace Botan {
30

31
class RSA_Public_Data final {
32
   public:
33
      RSA_Public_Data(BigInt&& n, BigInt&& e) :
14,057✔
34
            m_n(n),
14,057✔
35
            m_e(e),
14,057✔
36
            m_monty_n(std::make_shared<Montgomery_Params>(m_n)),
14,057✔
37
            m_public_modulus_bits(m_n.bits()),
14,057✔
38
            m_public_modulus_bytes(m_n.bytes()) {}
14,057✔
39

40
      BigInt public_op(const BigInt& m) const {
26,488✔
41
         const size_t powm_window = 1;
26,488✔
42
         auto powm_m_n = monty_precompute(m_monty_n, m, powm_window, false);
26,488✔
43
         return monty_execute_vartime(*powm_m_n, m_e);
26,488✔
44
      }
26,488✔
45

46
      const BigInt& get_n() const { return m_n; }
27,863✔
47

48
      const BigInt& get_e() const { return m_e; }
3✔
49

50
      size_t public_modulus_bits() const { return m_public_modulus_bits; }
20,056✔
51

52
      size_t public_modulus_bytes() const { return m_public_modulus_bytes; }
30,101✔
53

54
   private:
55
      BigInt m_n;
56
      BigInt m_e;
57
      std::shared_ptr<const Montgomery_Params> m_monty_n;
58
      size_t m_public_modulus_bits;
59
      size_t m_public_modulus_bytes;
60
};
61

62
class RSA_Private_Data final {
63
   public:
64
      RSA_Private_Data(BigInt&& d, BigInt&& p, BigInt&& q, BigInt&& d1, BigInt&& d2, BigInt&& c) :
2,563✔
65
            m_d(d),
2,563✔
66
            m_p(p),
2,563✔
67
            m_q(q),
2,563✔
68
            m_d1(d1),
2,563✔
69
            m_d2(d2),
2,563✔
70
            m_c(c),
2,563✔
71
            m_mod_p(m_p),
2,563✔
72
            m_mod_q(m_q),
2,563✔
73
            m_monty_p(std::make_shared<Montgomery_Params>(m_p, m_mod_p)),
2,563✔
74
            m_monty_q(std::make_shared<Montgomery_Params>(m_q, m_mod_q)),
2,563✔
75
            m_p_bits(m_p.bits()),
2,563✔
76
            m_q_bits(m_q.bits()) {}
2,563✔
77

78
      const BigInt& get_d() const { return m_d; }
1✔
79

80
      const BigInt& get_p() const { return m_p; }
4,842✔
81

82
      const BigInt& get_q() const { return m_q; }
9,683✔
83

84
      const BigInt& get_d1() const { return m_d1; }
4,841✔
85

86
      const BigInt& get_d2() const { return m_d2; }
4,841✔
87

88
      const BigInt& get_c() const { return m_c; }
×
89

90
      const Modular_Reducer& mod_p() const { return m_mod_p; }
9,682✔
91

92
      const Modular_Reducer& mod_q() const { return m_mod_q; }
4,841✔
93

94
      const std::shared_ptr<const Montgomery_Params>& monty_p() const { return m_monty_p; }
4,841✔
95

96
      const std::shared_ptr<const Montgomery_Params>& monty_q() const { return m_monty_q; }
4,841✔
97

98
      size_t p_bits() const { return m_p_bits; }
1,323✔
99

100
      size_t q_bits() const { return m_q_bits; }
1,323✔
101

102
   private:
103
      BigInt m_d;
104
      BigInt m_p;
105
      BigInt m_q;
106
      BigInt m_d1;
107
      BigInt m_d2;
108
      BigInt m_c;
109

110
      Modular_Reducer m_mod_p;
111
      Modular_Reducer m_mod_q;
112
      std::shared_ptr<const Montgomery_Params> m_monty_p;
113
      std::shared_ptr<const Montgomery_Params> m_monty_q;
114
      size_t m_p_bits;
115
      size_t m_q_bits;
116
};
117

118
std::shared_ptr<const RSA_Public_Data> RSA_PublicKey::public_data() const {
12,472✔
119
   return m_public;
12,472✔
120
}
121

122
const BigInt& RSA_PublicKey::get_int_field(std::string_view field) const {
8✔
123
   if(field == "n") {
11✔
124
      return m_public->get_n();
3✔
125
   } else if(field == "e") {
5✔
126
      return m_public->get_e();
3✔
127
   } else {
128
      return Public_Key::get_int_field(field);
2✔
129
   }
130
}
131

132
const BigInt& RSA_PublicKey::get_n() const {
525✔
133
   return m_public->get_n();
525✔
134
}
135

136
const BigInt& RSA_PublicKey::get_e() const {
496✔
137
   return m_public->get_e();
496✔
138
}
139

140
void RSA_PublicKey::init(BigInt&& n, BigInt&& e) {
14,879✔
141
   if(n.is_negative() || n.is_even() || n.bits() < 5 /* n >= 3*5 */ || e.is_negative() || e.is_even()) {
44,010✔
142
      throw Decoding_Error("Invalid RSA public key parameters");
822✔
143
   }
144
   m_public = std::make_shared<RSA_Public_Data>(std::move(n), std::move(e));
14,057✔
145
}
14,057✔
146

147
RSA_PublicKey::RSA_PublicKey(const AlgorithmIdentifier& /*unused*/, std::span<const uint8_t> key_bits) {
11,826✔
148
   BigInt n, e;
11,826✔
149
   BER_Decoder(key_bits).start_sequence().decode(n).decode(e).end_cons();
12,697✔
150

151
   init(std::move(n), std::move(e));
11,792✔
152
}
23,652✔
153

154
bool RSA_PublicKey::supports_operation(PublicKeyOperation op) const {
1,083✔
155
   return op == PublicKeyOperation::Signature || op == PublicKeyOperation::Encryption ||
1,083✔
156
          op == PublicKeyOperation::KeyEncapsulation;
1,083✔
157
}
158

159
RSA_PublicKey::RSA_PublicKey(const BigInt& modulus, const BigInt& exponent) {
521✔
160
   BigInt n = modulus;
521✔
161
   BigInt e = exponent;
521✔
162
   init(std::move(n), std::move(e));
521✔
163
}
1,042✔
164

165
size_t RSA_PublicKey::key_length() const {
4,942✔
166
   return m_public->public_modulus_bits();
4,942✔
167
}
168

169
size_t RSA_PublicKey::estimated_strength() const {
3,421✔
170
   return if_work_factor(key_length());
3,421✔
171
}
172

173
AlgorithmIdentifier RSA_PublicKey::algorithm_identifier() const {
403✔
174
   return AlgorithmIdentifier(object_identifier(), AlgorithmIdentifier::USE_NULL_PARAM);
403✔
175
}
176

177
std::vector<uint8_t> RSA_PublicKey::public_key_bits() const {
341✔
178
   std::vector<uint8_t> output;
341✔
179
   DER_Encoder der(output);
341✔
180
   der.start_sequence().encode(get_n()).encode(get_e()).end_cons();
341✔
181

182
   return output;
341✔
183
}
341✔
184

185
/*
186
* Check RSA Public Parameters
187
*/
188
bool RSA_PublicKey::check_key(RandomNumberGenerator& /*rng*/, bool /*strong*/) const {
9✔
189
   if(get_n() < 35 || get_n().is_even() || get_e() < 3 || get_e().is_even()) {
27✔
190
      return false;
×
191
   }
192
   return true;
193
}
194

195
std::shared_ptr<const RSA_Private_Data> RSA_PrivateKey::private_data() const {
1,323✔
196
   return m_private;
1,323✔
197
}
198

199
secure_vector<uint8_t> RSA_PrivateKey::private_key_bits() const {
94✔
200
   return DER_Encoder()
188✔
201
      .start_sequence()
94✔
202
      .encode(static_cast<size_t>(0))
94✔
203
      .encode(get_n())
94✔
204
      .encode(get_e())
94✔
205
      .encode(get_d())
94✔
206
      .encode(get_p())
94✔
207
      .encode(get_q())
94✔
208
      .encode(get_d1())
94✔
209
      .encode(get_d2())
94✔
210
      .encode(get_c())
94✔
211
      .end_cons()
94✔
212
      .get_contents();
188✔
213
}
214

215
const BigInt& RSA_PrivateKey::get_p() const {
170✔
216
   return m_private->get_p();
170✔
217
}
218

219
const BigInt& RSA_PrivateKey::get_q() const {
169✔
220
   return m_private->get_q();
169✔
221
}
222

223
const BigInt& RSA_PrivateKey::get_d() const {
137✔
224
   return m_private->get_d();
137✔
225
}
226

227
const BigInt& RSA_PrivateKey::get_c() const {
107✔
228
   return m_private->get_c();
107✔
229
}
230

231
const BigInt& RSA_PrivateKey::get_d1() const {
107✔
232
   return m_private->get_d1();
107✔
233
}
234

235
const BigInt& RSA_PrivateKey::get_d2() const {
107✔
236
   return m_private->get_d2();
107✔
237
}
238

239
void RSA_PrivateKey::init(BigInt&& d, BigInt&& p, BigInt&& q, BigInt&& d1, BigInt&& d2, BigInt&& c) {
2,563✔
240
   m_private = std::make_shared<RSA_Private_Data>(
7,689✔
241
      std::move(d), std::move(p), std::move(q), std::move(d1), std::move(d2), std::move(c));
2,563✔
242
}
2,563✔
243

244
RSA_PrivateKey::RSA_PrivateKey(const AlgorithmIdentifier& /*unused*/, std::span<const uint8_t> key_bits) {
2,103✔
245
   BigInt n, e, d, p, q, d1, d2, c;
2,103✔
246

247
   BER_Decoder(key_bits)
2,126✔
248
      .start_sequence()
4,199✔
249
      .decode_and_check<size_t>(0, "Unknown PKCS #1 key format version")
4,189✔
250
      .decode(n)
2,093✔
251
      .decode(e)
2,092✔
252
      .decode(d)
2,091✔
253
      .decode(p)
2,091✔
254
      .decode(q)
2,091✔
255
      .decode(d1)
2,090✔
256
      .decode(d2)
2,089✔
257
      .decode(c)
2,085✔
258
      .end_cons();
2,085✔
259

260
   RSA_PublicKey::init(std::move(n), std::move(e));
2,082✔
261

262
   RSA_PrivateKey::init(std::move(d), std::move(p), std::move(q), std::move(d1), std::move(d2), std::move(c));
2,080✔
263
}
16,824✔
264

265
RSA_PrivateKey::RSA_PrivateKey(
428✔
266
   const BigInt& prime1, const BigInt& prime2, const BigInt& exp, const BigInt& d_exp, const BigInt& mod) {
428✔
267
   BigInt p = prime1;
428✔
268
   BigInt q = prime2;
428✔
269
   BigInt n = mod;
428✔
270
   if(n.is_zero()) {
856✔
271
      n = p * q;
427✔
272
   }
273

274
   BigInt e = exp;
428✔
275

276
   BigInt d = d_exp;
428✔
277

278
   const BigInt p_minus_1 = p - 1;
428✔
279
   const BigInt q_minus_1 = q - 1;
428✔
280

281
   if(d.is_zero()) {
856✔
282
      const BigInt phi_n = lcm(p_minus_1, q_minus_1);
427✔
283
      d = inverse_mod(e, phi_n);
427✔
284
   }
427✔
285

286
   BigInt d1 = ct_modulo(d, p_minus_1);
428✔
287
   BigInt d2 = ct_modulo(d, q_minus_1);
428✔
288
   BigInt c = inverse_mod(q, p);
428✔
289

290
   RSA_PublicKey::init(std::move(n), std::move(e));
428✔
291

292
   RSA_PrivateKey::init(std::move(d), std::move(p), std::move(q), std::move(d1), std::move(d2), std::move(c));
428✔
293
}
4,280✔
294

295
/*
296
* Create a RSA private key
297
*/
298
RSA_PrivateKey::RSA_PrivateKey(RandomNumberGenerator& rng, size_t bits, size_t exp) {
56✔
299
   if(bits < 1024) {
56✔
300
      throw Invalid_Argument(fmt("Cannot create an RSA key only {} bits long", bits));
×
301
   }
302

303
   if(exp < 3 || exp % 2 == 0) {
56✔
304
      throw Invalid_Argument("Invalid RSA encryption exponent");
×
305
   }
306

307
   const size_t p_bits = (bits + 1) / 2;
56✔
308
   const size_t q_bits = bits - p_bits;
56✔
309

310
   BigInt p, q, n;
56✔
311
   BigInt e = BigInt::from_u64(exp);
56✔
312

313
   for(size_t attempt = 0;; ++attempt) {
11✔
314
      if(attempt > 10) {
67✔
315
         throw Internal_Error("RNG failure during RSA key generation");
1✔
316
      }
317

318
      // TODO could generate primes in thread pool
319
      p = generate_rsa_prime(rng, rng, p_bits, e);
66✔
320
      q = generate_rsa_prime(rng, rng, q_bits, e);
66✔
321

322
      const BigInt diff = p - q;
66✔
323
      if(diff.bits() < (bits / 2) - 100) {
66✔
324
         continue;
11✔
325
      }
326

327
      n = p * q;
55✔
328

329
      if(n.bits() != bits) {
55✔
330
         continue;
×
331
      }
332

333
      break;
55✔
334
   }
11✔
335

336
   const BigInt p_minus_1 = p - 1;
55✔
337
   const BigInt q_minus_1 = q - 1;
55✔
338

339
   const BigInt phi_n = lcm(p_minus_1, q_minus_1);
55✔
340
   // This is guaranteed because p,q == 3 mod 4
341
   BOTAN_DEBUG_ASSERT(low_zero_bits(phi_n) == 1);
55✔
342

343
   BigInt d = inverse_mod(e, phi_n);
55✔
344
   BigInt d1 = ct_modulo(d, p_minus_1);
55✔
345
   BigInt d2 = ct_modulo(d, q_minus_1);
55✔
346
   BigInt c = inverse_mod(q, p);
55✔
347

348
   RSA_PublicKey::init(std::move(n), std::move(e));
55✔
349

350
   RSA_PrivateKey::init(std::move(d), std::move(p), std::move(q), std::move(d1), std::move(d2), std::move(c));
55✔
351
}
609✔
352

353
const BigInt& RSA_PrivateKey::get_int_field(std::string_view field) const {
6✔
354
   if(field == "p") {
10✔
355
      return m_private->get_p();
1✔
356
   } else if(field == "q") {
8✔
357
      return m_private->get_q();
1✔
358
   } else if(field == "d") {
6✔
359
      return m_private->get_d();
1✔
360
   } else if(field == "c") {
5✔
361
      return m_private->get_c();
×
362
   } else if(field == "d1") {
3✔
363
      return m_private->get_d1();
×
364
   } else if(field == "d2") {
3✔
365
      return m_private->get_d2();
×
366
   } else {
367
      return RSA_PublicKey::get_int_field(field);
3✔
368
   }
369
}
370

371
std::unique_ptr<Public_Key> RSA_PrivateKey::public_key() const {
5✔
372
   return std::make_unique<RSA_PublicKey>(get_n(), get_e());
5✔
373
}
374

375
/*
376
* Check Private RSA Parameters
377
*/
378
bool RSA_PrivateKey::check_key(RandomNumberGenerator& rng, bool strong) const {
11✔
379
   if(get_n() < 35 || get_n().is_even() || get_e() < 3 || get_e().is_even()) {
33✔
380
      return false;
×
381
   }
382

383
   if(get_d() < 2 || get_p() < 3 || get_q() < 3) {
11✔
384
      return false;
×
385
   }
386

387
   if(get_p() * get_q() != get_n()) {
22✔
388
      return false;
389
   }
390

391
   if(get_p() == get_q()) {
11✔
392
      return false;
393
   }
394

395
   if(get_d1() != ct_modulo(get_d(), get_p() - 1)) {
33✔
396
      return false;
397
   }
398
   if(get_d2() != ct_modulo(get_d(), get_q() - 1)) {
33✔
399
      return false;
400
   }
401
   if(get_c() != inverse_mod(get_q(), get_p())) {
22✔
402
      return false;
403
   }
404

405
   const size_t prob = (strong) ? 128 : 12;
11✔
406

407
   if(!is_prime(get_p(), rng, prob)) {
11✔
408
      return false;
409
   }
410
   if(!is_prime(get_q(), rng, prob)) {
10✔
411
      return false;
412
   }
413

414
   if(strong) {
10✔
415
      if(ct_modulo(get_e() * get_d(), lcm(get_p() - 1, get_q() - 1)) != 1) {
56✔
416
         return false;
417
      }
418

419
      return KeyPair::signature_consistency_check(rng, *this, "EMSA4(SHA-256)");
8✔
420
   }
421

422
   return true;
423
}
424

425
namespace {
426

427
/**
428
* RSA private (decrypt/sign) operation
429
*/
430
class RSA_Private_Operation {
431
   protected:
432
      size_t public_modulus_bits() const { return m_public->public_modulus_bits(); }
1,498✔
433

434
      size_t public_modulus_bytes() const { return m_public->public_modulus_bytes(); }
5,260✔
435

436
      explicit RSA_Private_Operation(const RSA_PrivateKey& rsa, RandomNumberGenerator& rng) :
1,323✔
437
            m_public(rsa.public_data()),
1,323✔
438
            m_private(rsa.private_data()),
1,323✔
439
            m_blinder(
2,646✔
440
               m_public->get_n(),
1,323✔
441
               rng,
442
               [this](const BigInt& k) { return m_public->public_op(k); },
1,329✔
443
               [this](const BigInt& k) { return inverse_mod(k, m_public->get_n()); }),
1,329✔
444
            m_blinding_bits(64),
1,323✔
445
            m_max_d1_bits(m_private->p_bits() + m_blinding_bits),
1,323✔
446
            m_max_d2_bits(m_private->q_bits() + m_blinding_bits) {}
1,323✔
447

448
      secure_vector<uint8_t> raw_op(const uint8_t input[], size_t input_len) {
4,856✔
449
         if(input_len > public_modulus_bytes()) {
4,856✔
450
            throw Decoding_Error("RSA input is too long for this key");
×
451
         }
452
         const BigInt input_bn(input, input_len);
4,856✔
453
         if(input_bn >= m_public->get_n()) {
4,856✔
454
            throw Decoding_Error("RSA input is too large for this key");
14✔
455
         }
456

457
         // TODO: This should be a function on blinder
458
         // BigInt Blinder::run_blinded_function(std::function<BigInt, BigInt> fn, const BigInt& input);
459

460
         const BigInt recovered = m_blinder.unblind(rsa_private_op(m_blinder.blind(input_bn)));
9,697✔
461
         BOTAN_ASSERT(input_bn == m_public->public_op(recovered), "RSA consistency check");
14,523✔
462
         return BigInt::encode_1363(recovered, m_public->public_modulus_bytes());
4,841✔
463
      }
9,682✔
464

465
   private:
466
      BigInt rsa_private_op(const BigInt& m) const {
4,841✔
467
         /*
468
         TODO
469
         Consider using Montgomery reduction instead of Barrett, using
470
         the "Smooth RSA-CRT" method. https://eprint.iacr.org/2007/039.pdf
471
         */
472

473
         static constexpr size_t powm_window = 4;
4,841✔
474

475
         // Compute this in main thread to avoid racing on the rng
476
         const BigInt d1_mask(m_blinder.rng(), m_blinding_bits);
4,841✔
477

478
#if defined(BOTAN_HAS_THREAD_UTILS) && !defined(BOTAN_HAS_VALGRIND)
479
   #define BOTAN_RSA_USE_ASYNC
480
#endif
481

482
#if defined(BOTAN_RSA_USE_ASYNC)
483
         /*
484
         * Precompute m.sig_words in the main thread before calling async. Otherwise
485
         * the two threads race (during Modular_Reducer::reduce) and while the output
486
         * is correct in both threads, helgrind warns.
487
         */
488
         m.sig_words();
4,841✔
489

490
         auto future_j1 = Thread_Pool::global_instance().run([this, &m, &d1_mask]() {
4,841✔
491
#endif
492
            const BigInt masked_d1 = m_private->get_d1() + (d1_mask * (m_private->get_p() - 1));
9,682✔
493
            auto powm_d1_p = monty_precompute(m_private->monty_p(), m_private->mod_p().reduce(m), powm_window);
4,841✔
494
            BigInt j1 = monty_execute(*powm_d1_p, masked_d1, m_max_d1_bits);
4,841✔
495

496
#if defined(BOTAN_RSA_USE_ASYNC)
497
            return j1;
4,841✔
498
         });
14,523✔
499
#endif
500

501
         const BigInt d2_mask(m_blinder.rng(), m_blinding_bits);
4,841✔
502
         const BigInt masked_d2 = m_private->get_d2() + (d2_mask * (m_private->get_q() - 1));
9,682✔
503
         auto powm_d2_q = monty_precompute(m_private->monty_q(), m_private->mod_q().reduce(m), powm_window);
4,841✔
504
         const BigInt j2 = monty_execute(*powm_d2_q, masked_d2, m_max_d2_bits);
4,841✔
505

506
#if defined(BOTAN_RSA_USE_ASYNC)
507
         BigInt j1 = future_j1.get();
4,841✔
508
#endif
509

510
         /*
511
         * To recover the final value from the CRT representation (j1,j2)
512
         * we use Garner's algorithm:
513
         * c = q^-1 mod p (this is precomputed)
514
         * h = c*(j1-j2) mod p
515
         * m = j2 + h*q
516
         *
517
         * We must avoid leaking if j1 >= j2 or not, as doing so allows deriving
518
         * information about the secret prime. Do this by first adding p to j1,
519
         * which should ensure the subtraction of j2 does not underflow. But
520
         * this may still underflow if p and q are imbalanced in size.
521
         */
522

523
         j1 =
4,841✔
524
            m_private->mod_p().multiply(m_private->mod_p().reduce((m_private->get_p() + j1) - j2), m_private->get_c());
19,364✔
525
         return j1 * m_private->get_q() + j2;
9,682✔
526
      }
29,046✔
527

528
      std::shared_ptr<const RSA_Public_Data> m_public;
529
      std::shared_ptr<const RSA_Private_Data> m_private;
530

531
      // XXX could the blinder starting pair be shared?
532
      Blinder m_blinder;
533
      const size_t m_blinding_bits;
534
      const size_t m_max_d1_bits;
535
      const size_t m_max_d2_bits;
536
};
537

538
class RSA_Signature_Operation final : public PK_Ops::Signature,
×
539
                                      private RSA_Private_Operation {
540
   public:
541
      void update(const uint8_t msg[], size_t msg_len) override { m_emsa->update(msg, msg_len); }
1,499✔
542

543
      secure_vector<uint8_t> sign(RandomNumberGenerator& rng) override {
1,498✔
544
         const size_t max_input_bits = public_modulus_bits() - 1;
1,498✔
545
         const auto msg = m_emsa->raw_data();
1,498✔
546
         const auto padded = m_emsa->encoding_of(msg, max_input_bits, rng);
1,498✔
547
         return raw_op(padded.data(), padded.size());
1,497✔
548
      }
2,993✔
549

550
      size_t signature_length() const override { return public_modulus_bytes(); }
268✔
551

552
      AlgorithmIdentifier algorithm_identifier() const override;
553

554
      std::string hash_function() const override { return m_emsa->hash_function(); }
115✔
555

556
      RSA_Signature_Operation(const RSA_PrivateKey& rsa, std::string_view padding, RandomNumberGenerator& rng) :
1,100✔
557
            RSA_Private_Operation(rsa, rng), m_emsa(EMSA::create_or_throw(padding)) {}
1,100✔
558

559
   private:
560
      std::unique_ptr<EMSA> m_emsa;
561
};
562

563
AlgorithmIdentifier RSA_Signature_Operation::algorithm_identifier() const {
74✔
564
   const std::string emsa_name = m_emsa->name();
74✔
565

566
   try {
74✔
567
      const std::string full_name = "RSA/" + emsa_name;
74✔
568
      const OID oid = OID::from_string(full_name);
74✔
569
      return AlgorithmIdentifier(oid, AlgorithmIdentifier::USE_EMPTY_PARAM);
53✔
570
   } catch(Lookup_Error&) {}
127✔
571

572
   if(emsa_name.starts_with("EMSA4(")) {
21✔
573
      auto parameters = PSS_Params::from_emsa_name(m_emsa->name()).serialize();
42✔
574
      return AlgorithmIdentifier("RSA/EMSA4", parameters);
21✔
575
   }
21✔
576

577
   throw Not_Implemented("No algorithm identifier defined for RSA with " + emsa_name);
×
578
}
74✔
579

580
class RSA_Decryption_Operation final : public PK_Ops::Decryption_with_EME,
×
581
                                       private RSA_Private_Operation {
582
   public:
583
      RSA_Decryption_Operation(const RSA_PrivateKey& rsa, std::string_view eme, RandomNumberGenerator& rng) :
212✔
584
            PK_Ops::Decryption_with_EME(eme), RSA_Private_Operation(rsa, rng) {}
212✔
585

586
      size_t plaintext_length(size_t /*ctext_len*/) const override { return public_modulus_bytes(); }
125✔
587

588
      secure_vector<uint8_t> raw_decrypt(const uint8_t input[], size_t input_len) override {
3,348✔
589
         return raw_op(input, input_len);
3,348✔
590
      }
591
};
592

593
class RSA_KEM_Decryption_Operation final : public PK_Ops::KEM_Decryption_with_KDF,
×
594
                                           private RSA_Private_Operation {
595
   public:
596
      RSA_KEM_Decryption_Operation(const RSA_PrivateKey& key, std::string_view kdf, RandomNumberGenerator& rng) :
11✔
597
            PK_Ops::KEM_Decryption_with_KDF(kdf), RSA_Private_Operation(key, rng) {}
11✔
598

599
      size_t raw_kem_shared_key_length() const override { return public_modulus_bytes(); }
11✔
600

601
      void raw_kem_decrypt(std::span<uint8_t> out_shared_key, std::span<const uint8_t> encapsulated_key) override {
11✔
602
         auto shared_key = raw_op(encapsulated_key.data(), encapsulated_key.size());
11✔
603

604
         // TODO: avoid copy by letting raw_op() work on std::span<>
605
         BOTAN_ASSERT_NOMSG(out_shared_key.size() == shared_key.size());
11✔
606
         std::copy(shared_key.begin(), shared_key.end(), out_shared_key.data());
22✔
607
      }
11✔
608
};
609

610
/**
611
* RSA public (encrypt/verify) operation
612
*/
613
class RSA_Public_Operation {
×
614
   public:
615
      explicit RSA_Public_Operation(const RSA_PublicKey& rsa) : m_public(rsa.public_data()) {}
10,955✔
616

617
      size_t public_modulus_bits() const { return m_public->public_modulus_bits(); }
20,056✔
618

619
   protected:
620
      BigInt public_op(const BigInt& m) const {
20,341✔
621
         if(m >= m_public->get_n()) {
20,341✔
622
            throw Decoding_Error("RSA public op - input is too large");
23✔
623
         }
624

625
         return m_public->public_op(m);
20,318✔
626
      }
627

628
      size_t public_modulus_bytes() const { return m_public->public_modulus_bytes(); }
20,584✔
629

630
      const BigInt& get_n() const { return m_public->get_n(); }
11✔
631

632
   private:
633
      std::shared_ptr<const RSA_Public_Data> m_public;
634
};
635

636
class RSA_Encryption_Operation final : public PK_Ops::Encryption_with_EME,
×
637
                                       private RSA_Public_Operation {
638
   public:
639
      RSA_Encryption_Operation(const RSA_PublicKey& rsa, std::string_view eme) :
183✔
640
            PK_Ops::Encryption_with_EME(eme), RSA_Public_Operation(rsa) {}
183✔
641

642
      size_t ciphertext_length(size_t /*ptext_len*/) const override { return public_modulus_bytes(); }
125✔
643

644
      size_t max_ptext_input_bits() const override { return public_modulus_bits() - 1; }
374✔
645

646
      secure_vector<uint8_t> raw_encrypt(const uint8_t input[],
251✔
647
                                         size_t input_len,
648
                                         RandomNumberGenerator& /*rng*/) override {
649
         BigInt input_bn(input, input_len);
251✔
650
         return BigInt::encode_1363(public_op(input_bn), public_modulus_bytes());
502✔
651
      }
251✔
652
};
653

654
class RSA_Verify_Operation final : public PK_Ops::Verification,
×
655
                                   private RSA_Public_Operation {
656
   public:
657
      void update(const uint8_t msg[], size_t msg_len) override { m_emsa->update(msg, msg_len); }
20,155✔
658

659
      bool is_valid_signature(const uint8_t sig[], size_t sig_len) override {
20,153✔
660
         const auto msg = m_emsa->raw_data();
20,153✔
661
         const auto message_repr = recover_message_repr(sig, sig_len);
20,153✔
662
         return m_emsa->verify(message_repr, msg, public_modulus_bits() - 1);
20,056✔
663
      }
40,067✔
664

665
      RSA_Verify_Operation(const RSA_PublicKey& rsa, std::string_view padding) :
10,955✔
666
            RSA_Public_Operation(rsa), m_emsa(EMSA::create_or_throw(padding)) {}
10,955✔
667

668
      std::string hash_function() const override { return m_emsa->hash_function(); }
8,974✔
669

670
   private:
671
      std::vector<uint8_t> recover_message_repr(const uint8_t input[], size_t input_len) {
20,153✔
672
         if(input_len > public_modulus_bytes()) {
20,153✔
673
            throw Decoding_Error("RSA signature too large to be valid for this key");
74✔
674
         }
675
         BigInt input_bn(input, input_len);
20,079✔
676
         return BigInt::encode(public_op(input_bn));
40,135✔
677
      }
20,056✔
678

679
      std::unique_ptr<EMSA> m_emsa;
680
};
681

682
class RSA_KEM_Encryption_Operation final : public PK_Ops::KEM_Encryption_with_KDF,
×
683
                                           private RSA_Public_Operation {
684
   public:
685
      RSA_KEM_Encryption_Operation(const RSA_PublicKey& key, std::string_view kdf) :
11✔
686
            PK_Ops::KEM_Encryption_with_KDF(kdf), RSA_Public_Operation(key) {}
11✔
687

688
   private:
689
      size_t raw_kem_shared_key_length() const override { return public_modulus_bytes(); }
11✔
690

691
      size_t encapsulated_key_length() const override { return public_modulus_bytes(); }
44✔
692

693
      void raw_kem_encrypt(std::span<uint8_t> out_encapsulated_key,
11✔
694
                           std::span<uint8_t> raw_shared_key,
695
                           RandomNumberGenerator& rng) override {
696
         const BigInt r = BigInt::random_integer(rng, 1, get_n());
11✔
697
         const BigInt c = public_op(r);
11✔
698

699
         // TODO: simplify that once BigInt::encode_1363() has a std::span<> overload
700
         BigInt::encode_1363(out_encapsulated_key.data(), out_encapsulated_key.size(), c);
11✔
701
         BigInt::encode_1363(raw_shared_key.data(), raw_shared_key.size(), r);
11✔
702
      }
22✔
703
};
704

705
}  // namespace
706

707
std::unique_ptr<PK_Ops::Encryption> RSA_PublicKey::create_encryption_op(RandomNumberGenerator& /*rng*/,
552✔
708
                                                                        std::string_view params,
709
                                                                        std::string_view provider) const {
710
   if(provider == "base" || provider.empty()) {
676✔
711
      return std::make_unique<RSA_Encryption_Operation>(*this, params);
183✔
712
   }
713
   throw Provider_Not_Found(algo_name(), provider);
738✔
714
}
715

716
std::unique_ptr<PK_Ops::KEM_Encryption> RSA_PublicKey::create_kem_encryption_op(std::string_view params,
11✔
717
                                                                                std::string_view provider) const {
718
   if(provider == "base" || provider.empty()) {
11✔
719
      return std::make_unique<RSA_KEM_Encryption_Operation>(*this, params);
11✔
720
   }
721
   throw Provider_Not_Found(algo_name(), provider);
×
722
}
723

724
std::unique_ptr<PK_Ops::Verification> RSA_PublicKey::create_verification_op(std::string_view params,
4,034✔
725
                                                                            std::string_view provider) const {
726
   if(provider == "base" || provider.empty()) {
4,805✔
727
      return std::make_unique<RSA_Verify_Operation>(*this, params);
1,724✔
728
   }
729

730
   throw Provider_Not_Found(algo_name(), provider);
4,620✔
731
}
732

733
namespace {
734

735
std::string parse_rsa_signature_algorithm(const AlgorithmIdentifier& alg_id) {
9,234✔
736
   const auto sig_info = split_on(alg_id.oid().to_formatted_string(), '/');
9,234✔
737

738
   if(sig_info.empty() || sig_info.size() != 2 || sig_info[0] != "RSA") {
9,234✔
739
      throw Decoding_Error("Unknown AlgorithmIdentifier for RSA X.509 signatures");
1✔
740
   }
741

742
   std::string padding = sig_info[1];
9,233✔
743

744
   if(padding == "EMSA4") {
9,233✔
745
      // "MUST contain RSASSA-PSS-params"
746
      if(alg_id.parameters().empty()) {
534✔
747
         throw Decoding_Error("PSS params must be provided");
×
748
      }
749

750
      PSS_Params pss_params(alg_id.parameters());
534✔
751

752
      // hash_algo must be SHA1, SHA2-224, SHA2-256, SHA2-384 or SHA2-512
753
      const std::string hash_algo = pss_params.hash_function();
534✔
754
      if(hash_algo != "SHA-1" && hash_algo != "SHA-224" && hash_algo != "SHA-256" && hash_algo != "SHA-384" &&
534✔
755
         hash_algo != "SHA-512") {
10✔
756
         throw Decoding_Error("Unacceptable hash for PSS signatures");
×
757
      }
758

759
      if(pss_params.mgf_function() != "MGF1") {
534✔
760
         throw Decoding_Error("Unacceptable MGF for PSS signatures");
×
761
      }
762

763
      // For MGF1, it is strongly RECOMMENDED that the underlying hash
764
      // function be the same as the one identified by hashAlgorithm
765
      //
766
      // Must be SHA1, SHA2-224, SHA2-256, SHA2-384 or SHA2-512
767
      if(pss_params.hash_algid() != pss_params.mgf_hash_algid()) {
534✔
768
         throw Decoding_Error("Unacceptable MGF hash for PSS signatures");
2✔
769
      }
770

771
      if(pss_params.trailer_field() != 1) {
532✔
772
         throw Decoding_Error("Unacceptable trailer field for PSS signatures");
×
773
      }
774

775
      padding += fmt("({},MGF1,{})", hash_algo, pss_params.salt_length());
1,588✔
776
   }
534✔
777

778
   return padding;
9,231✔
779
}
9,234✔
780

781
}  // namespace
782

783
std::unique_ptr<PK_Ops::Verification> RSA_PublicKey::create_x509_verification_op(const AlgorithmIdentifier& alg_id,
9,234✔
784
                                                                                 std::string_view provider) const {
785
   if(provider == "base" || provider.empty()) {
9,234✔
786
      return std::make_unique<RSA_Verify_Operation>(*this, parse_rsa_signature_algorithm(alg_id));
9,766✔
787
   }
788

789
   throw Provider_Not_Found(algo_name(), provider);
×
790
}
791

792
std::unique_ptr<PK_Ops::Decryption> RSA_PrivateKey::create_decryption_op(RandomNumberGenerator& rng,
656✔
793
                                                                         std::string_view params,
794
                                                                         std::string_view provider) const {
795
   if(provider == "base" || provider.empty()) {
805✔
796
      return std::make_unique<RSA_Decryption_Operation>(*this, params, rng);
212✔
797
   }
798

799
   throw Provider_Not_Found(algo_name(), provider);
888✔
800
}
801

802
std::unique_ptr<PK_Ops::KEM_Decryption> RSA_PrivateKey::create_kem_decryption_op(RandomNumberGenerator& rng,
11✔
803
                                                                                 std::string_view params,
804
                                                                                 std::string_view provider) const {
805
   if(provider == "base" || provider.empty()) {
11✔
806
      return std::make_unique<RSA_KEM_Decryption_Operation>(*this, params, rng);
11✔
807
   }
808

809
   throw Provider_Not_Found(algo_name(), provider);
×
810
}
811

812
std::unique_ptr<PK_Ops::Signature> RSA_PrivateKey::create_signature_op(RandomNumberGenerator& rng,
1,901✔
813
                                                                       std::string_view params,
814
                                                                       std::string_view provider) const {
815
   if(provider == "base" || provider.empty()) {
2,169✔
816
      return std::make_unique<RSA_Signature_Operation>(*this, params, rng);
1,100✔
817
   }
818

819
   throw Provider_Not_Found(algo_name(), provider);
1,602✔
820
}
821

822
}  // namespace Botan
STATUS · Troubleshooting · Open an Issue · Sales · Support · CAREERS · ENTERPRISE · START FREE · SCHEDULE DEMO
ANNOUNCEMENTS · TWITTER · TOS & SLA · Supported CI Services · What's a CI service? · Automated Testing

© 2025 Coveralls, Inc