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

randombit / botan / 22037645935

15 Feb 2026 02:49PM UTC coverage: 90.059% (-1.6%) from 91.706%
22037645935

push

github

web-flow
Merge pull request #5340 from randombit/jack/test-h-misc-cmp

Further cleanups of test predicates

102371 of 113671 relevant lines covered (90.06%)

11413670.75 hits per line

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

98.83
/src/tests/test_tls_session_manager.cpp
1
/*
2
* (C) 2022 Jack Lloyd
3
* (C) 2022 René Meusel - Rohde & Schwarz Cybersecurity
4
*
5
* Botan is released under the Simplified BSD License (see license.txt)
6
*/
7

8
#include "tests.h"
9

10
#if defined(BOTAN_HAS_TLS)
11

12
   #include <botan/assert.h>
13
   #include <botan/credentials_manager.h>
14
   #include <botan/hex.h>
15
   #include <botan/rng.h>
16
   #include <botan/tls_callbacks.h>
17
   #include <botan/tls_policy.h>
18
   #include <botan/tls_session_manager_hybrid.h>
19
   #include <botan/tls_session_manager_memory.h>
20
   #include <botan/tls_session_manager_stateless.h>
21
   #include <botan/internal/fmt.h>
22
   #include <array>
23
   #include <chrono>
24

25
   #if defined(BOTAN_HAS_TLS_SQLITE3_SESSION_MANAGER)
26
      #include <botan/tls_session_manager_sqlite.h>
27
   #endif
28

29
   #if defined(BOTAN_HAS_TLS_13)
30
      #include <botan/tls_psk_identity_13.h>
31
   #endif
32

33
   #if defined(BOTAN_TARGET_OS_HAS_FILESYSTEM)
34
      #include <version>
35
      #if defined(__cpp_lib_filesystem)
36
         #include <filesystem>
37
      #endif
38
   #endif
39

40
// This file contains a number of `Botan::TLS::Version_Code::TLS_V**` protocol
41
// version specifications. This is to work around a compiler bug in GCC 11.3
42
// where `Botan::TLS::Protocol_Version::TLS_V12` would lead to an "Internal
43
// Compiler Error" when used in the affected context.
44
//
45
// TODO: remove the workaround once GCC 11 is not supported anymore.
46

47
namespace Botan_Tests {
48

49
class Test_Credentials_Manager : public Botan::Credentials_Manager {
7✔
50
   public:
51
      Botan::secure_vector<uint8_t> session_ticket_key() override {
55✔
52
         return Botan::hex_decode_locked("DEADFACECAFEBAAD");
55✔
53
      }
54
};
55

56
class Other_Test_Credentials_Manager : public Botan::Credentials_Manager {
1✔
57
   public:
58
      Botan::secure_vector<uint8_t> session_ticket_key() override {
1✔
59
         return Botan::hex_decode_locked("CAFEBAADFACEBABE");
1✔
60
      }
61
};
62

63
class Empty_Credentials_Manager : public Botan::Credentials_Manager {};
4✔
64

65
class Session_Manager_Callbacks : public Botan::TLS::Callbacks {
3✔
66
   public:
67
      void tls_emit_data(std::span<const uint8_t> /*data*/) override { BOTAN_ASSERT_NOMSG(false); }
×
68

69
      void tls_record_received(uint64_t /*record*/, std::span<const uint8_t> /*data*/) override {
×
70
         BOTAN_ASSERT_NOMSG(false);
×
71
      }
72

73
      void tls_alert(Botan::TLS::Alert /*alert*/) override { BOTAN_ASSERT_NOMSG(false); }
×
74

75
      void tls_session_established(const Botan::TLS::Session_Summary& /*summary*/) override {
×
76
         BOTAN_ASSERT_NOMSG(false);
×
77
      }
78

79
      std::chrono::system_clock::time_point tls_current_timestamp() override {
225✔
80
         return std::chrono::system_clock::now() + std::chrono::hours(m_ticks);
225✔
81
      }
82

83
      void tick() { ++m_ticks; }
13✔
84

85
   private:
86
      uint64_t m_ticks = 0;
87
};
88

89
class Session_Manager_Policy : public Botan::TLS::Policy {
6✔
90
   public:
91
      std::chrono::seconds session_ticket_lifetime() const override { return std::chrono::minutes(30); }
198✔
92

93
      bool reuse_session_tickets() const override { return m_allow_session_reuse; }
27✔
94

95
      size_t maximum_session_tickets_per_client_hello() const override { return m_session_limit; }
58✔
96

97
      void set_session_limit(size_t l) { m_session_limit = l; }
6✔
98

99
      void set_allow_session_reuse(bool b) { m_allow_session_reuse = b; }
4✔
100

101
   private:
102
      size_t m_session_limit = 1000;  // basically 'no limit'
103
      bool m_allow_session_reuse = true;
104
};
105

106
namespace {
107

108
decltype(auto) random_id(Botan::RandomNumberGenerator& rng) {
60✔
109
   return rng.random_vec<Botan::TLS::Session_ID>(32);
58✔
110
}
111

112
decltype(auto) random_ticket(Botan::RandomNumberGenerator& rng) {
29✔
113
   return rng.random_vec<Botan::TLS::Session_Ticket>(32);
27✔
114
}
115

116
decltype(auto) random_opaque_handle(Botan::RandomNumberGenerator& rng) {
1✔
117
   return rng.random_vec<Botan::TLS::Opaque_Session_Handle>(32);
1✔
118
}
119

120
const Botan::TLS::Server_Information& server_info() {
151✔
121
   static const Botan::TLS::Server_Information si("botan.randombit.net");
151✔
122
   return si;
151✔
123
}
124

125
decltype(auto) default_session(Botan::TLS::Connection_Side side,
118✔
126
                               Botan::TLS::Callbacks& cbs,
127
                               Botan::TLS::Protocol_Version version = Botan::TLS::Protocol_Version::TLS_V12) {
128
   if(version.is_pre_tls_13()) {
118✔
129
      return Botan::TLS::Session(
108✔
130
         {}, version, 0x009C, side, true, true, {}, server_info(), 0, cbs.tls_current_timestamp());
216✔
131
   } else {
132
   #if defined(BOTAN_HAS_TLS_13)
133
      return Botan::TLS::Session({},
10✔
134
                                 std::nullopt,
135
                                 0,
136
                                 std::chrono::seconds(1024),
10✔
137
                                 Botan::TLS::Protocol_Version::TLS_V13,
138
                                 Botan::TLS::Ciphersuite::from_name("AES_128_GCM_SHA256")->ciphersuite_code(),
10✔
139
                                 side,
140
                                 {},
141
                                 nullptr,
142
                                 server_info(),
143
                                 cbs.tls_current_timestamp());
20✔
144
   #else
145
      throw Test_Error("TLS 1.3 is not available in this build");
146
   #endif
147
   }
148
}
149

150
using namespace std::literals;
151

152
std::vector<Test::Result> test_session_manager_in_memory() {
1✔
153
   auto rng = Test::new_shared_rng(__func__);
1✔
154

155
   const Botan::TLS::Session_ID default_id = random_id(*rng);
1✔
156

157
   std::optional<Botan::TLS::Session_Manager_In_Memory> mgr;
1✔
158

159
   Session_Manager_Callbacks cbs;
1✔
160
   Session_Manager_Policy plcy;
1✔
161

162
   return {
1✔
163
      CHECK("creation", [&](auto&) { mgr.emplace(rng, 5); }),
1✔
164

165
      CHECK("empty cache does not obtain anything",
166
            [&](auto& result) {
1✔
167
               result.test_is_true("no session found via server info", mgr->find(server_info(), cbs, plcy).empty());
1✔
168

169
               const Botan::TLS::Session_ID mock_id = random_id(*rng);
1✔
170
               auto mock_ticket = rng->random_vec<Botan::TLS::Session_Ticket>(128);
1✔
171

172
               result.test_is_true("no session found via ID", !mgr->retrieve(mock_id, cbs, plcy));
3✔
173
               result.test_is_true("no session found via ID", !mgr->retrieve(mock_ticket, cbs, plcy));
3✔
174
            }),
2✔
175

176
      CHECK("clearing empty cache",
177
            [&](auto& result) { result.test_sz_eq("does not delete anything", mgr->remove_all(), 0); }),
1✔
178

179
      CHECK("establish new session",
180
            [&](auto& result) {
1✔
181
               auto handle = mgr->establish(default_session(Botan::TLS::Connection_Side::Server, cbs), default_id);
1✔
182
               if(result.test_is_true("establishment was successful", handle.has_value())) {
1✔
183
                  result.require("session id was set", handle->id().has_value());
1✔
184
                  result.test_is_true("session ticket was empty", !handle->ticket().has_value());
1✔
185
                  result.test_is_eq("session id is correct", handle->id().value(), default_id);
2✔
186
               }
187
            }),
1✔
188

189
      CHECK("obtain session from server info",
190
            [&](auto& result) {
1✔
191
               auto sessions = mgr->find(server_info(), cbs, plcy);
1✔
192
               if(result.test_is_true("session was found successfully", sessions.size() == 1)) {
1✔
193
                  result.test_is_eq("protocol version was echoed",
1✔
194
                                    sessions[0].session.version(),
1✔
195
                                    Botan::TLS::Protocol_Version(Botan::TLS::Version_Code::TLS_V12));
1✔
196
                  result.test_u16_eq(
1✔
197
                     "ciphersuite was echoed", sessions[0].session.ciphersuite_code(), uint16_t(0x009C));
1✔
198
                  result.test_is_eq("ID was echoed", sessions[0].handle.id().value(), default_id);
2✔
199
                  result.test_is_true("not a ticket", !sessions[0].handle.ticket().has_value());
1✔
200
               }
201
            }),
1✔
202

203
      CHECK("obtain session from ID",
204
            [&](auto& result) {
1✔
205
               auto session = mgr->retrieve(default_id, cbs, plcy);
2✔
206
               if(result.test_is_true("session was found successfully", session.has_value())) {
1✔
207
                  result.test_is_eq("protocol version was echoed",
1✔
208
                                    session->version(),
1✔
209
                                    Botan::TLS::Protocol_Version(Botan::TLS::Version_Code::TLS_V12));
1✔
210
                  result.test_u16_eq("ciphersuite was echoed", session->ciphersuite_code(), uint16_t(0x009C));
1✔
211
               }
212
            }),
1✔
213

214
      CHECK("obtain session from ID disguised as opaque handle",
215
            [&](auto& result) {
1✔
216
               auto session = mgr->retrieve(Botan::TLS::Opaque_Session_Handle(default_id), cbs, plcy);
2✔
217
               if(result.test_is_true("session was found successfully", session.has_value())) {
1✔
218
                  result.test_is_eq("protocol version was echoed",
1✔
219
                                    session->version(),
1✔
220
                                    Botan::TLS::Protocol_Version(Botan::TLS::Version_Code::TLS_V12));
1✔
221
                  result.test_u16_eq("ciphersuite was echoed", session->ciphersuite_code(), uint16_t(0x009C));
1✔
222
               }
223
            }),
1✔
224

225
      CHECK("obtain session from ticket == id does not work",
226
            [&](auto& result) {
1✔
227
               auto session = mgr->retrieve(Botan::TLS::Session_Ticket(default_id), cbs, plcy);
2✔
228
               result.test_is_true("session was not found", !session.has_value());
1✔
229
            }),
1✔
230

231
      CHECK("invalid ticket causes std::nullopt",
232
            [&](auto& result) {
1✔
233
               auto no_session = mgr->retrieve(random_ticket(*rng), cbs, plcy);
2✔
234
               result.test_is_true("std::nullopt on bogus ticket", !no_session.has_value());
1✔
235
            }),
1✔
236

237
      CHECK("invalid ID causes std::nullopt",
238
            [&](auto& result) {
1✔
239
               auto no_session = mgr->retrieve(random_id(*rng), cbs, plcy);
2✔
240
               result.test_is_true("std::nullopt on bogus ID", !no_session.has_value());
1✔
241
            }),
1✔
242

243
      CHECK("remove_all",
244
            [&](auto& result) {
1✔
245
               result.test_sz_eq("removed one element", mgr->remove_all(), 1);
1✔
246
               result.test_sz_eq("should be empty now", mgr->remove_all(), 0);
1✔
247
            }),
1✔
248

249
      CHECK("add session with ID",
250
            [&](auto& result) {
1✔
251
               const Botan::TLS::Session_ID new_id = random_id(*rng);
1✔
252

253
               mgr->store(default_session(Botan::TLS::Connection_Side::Client, cbs), new_id);
3✔
254
               result.require("obtain via ID", mgr->retrieve(new_id, cbs, plcy).has_value());
4✔
255

256
               auto sessions = mgr->find(server_info(), cbs, plcy);
1✔
257
               if(result.test_is_true("found via server info", sessions.size() == 1)) {
1✔
258
                  result.test_is_eq("protocol version was echoed",
1✔
259
                                    sessions[0].session.version(),
1✔
260
                                    Botan::TLS::Protocol_Version(Botan::TLS::Version_Code::TLS_V12));
1✔
261
                  result.test_u16_eq(
1✔
262
                     "ciphersuite was echoed", sessions[0].session.ciphersuite_code(), uint16_t(0x009C));
1✔
263
                  result.test_is_eq("ID was echoed", sessions[0].handle.id().value(), new_id);
2✔
264
                  result.test_is_true("ticket was not stored", !sessions[0].handle.ticket().has_value());
1✔
265
               }
266

267
               mgr->remove_all();
1✔
268
            }),
2✔
269

270
      CHECK("add session with ticket",
271
            [&](auto& result) {
1✔
272
               const Botan::TLS::Session_Ticket new_ticket = random_ticket(*rng);
1✔
273

274
               mgr->store(default_session(Botan::TLS::Connection_Side::Client, cbs), new_ticket);
3✔
275
               // cannot be obtained by (non-existent) ID or randomly generated ticket
276

277
               auto sessions = mgr->find(server_info(), cbs, plcy);
1✔
278
               if(result.test_is_true("found via server info", sessions.size() == 1)) {
1✔
279
                  result.test_is_eq("protocol version was echoed",
1✔
280
                                    sessions[0].session.version(),
1✔
281
                                    Botan::TLS::Protocol_Version(Botan::TLS::Version_Code::TLS_V12));
1✔
282
                  result.test_u16_eq(
1✔
283
                     "ciphersuite was echoed", sessions[0].session.ciphersuite_code(), uint16_t(0x009C));
1✔
284
                  result.test_is_true("ID was not stored", !sessions[0].handle.id().has_value());
1✔
285
                  result.test_is_eq("ticket was echoed", sessions[0].handle.ticket().value(), new_ticket);
2✔
286
               }
287

288
               mgr->remove_all();
1✔
289
            }),
2✔
290

291
      CHECK("removing by ID or opaque handle",
292
            [&](auto& result) {
1✔
293
               Botan::TLS::Session_Manager_In_Memory local_mgr(rng);
1✔
294

295
               const auto new_session1 =
1✔
296
                  local_mgr.establish(default_session(Botan::TLS::Connection_Side::Server, cbs), default_id);
297
               const auto new_session2 = local_mgr.establish(default_session(Botan::TLS::Connection_Side::Server, cbs));
1✔
298
               result.require(
1✔
299
                  "saving worked",
300
                  new_session1.has_value() && new_session1->id().has_value() && !new_session1->ticket().has_value());
4✔
301
               result.require(
1✔
302
                  "saving worked",
303
                  new_session2.has_value() && new_session2->id().has_value() && !new_session2->ticket().has_value());
4✔
304

305
               result.test_sz_eq("can find via server info", local_mgr.find(server_info(), cbs, plcy).size(), 2);
1✔
306

307
               result.test_sz_eq("one was deleted", local_mgr.remove(default_id), 1);
3✔
308
               result.test_is_true("cannot obtain via default ID anymore",
1✔
309
                                   !local_mgr.retrieve(default_id, cbs, plcy).has_value());
4✔
310
               result.test_sz_eq("can find less via server info", local_mgr.find(server_info(), cbs, plcy).size(), 1);
1✔
311

312
               result.test_sz_eq("last one was deleted",
2✔
313
                                 local_mgr.remove(Botan::TLS::Opaque_Session_Handle(new_session2->id().value())),
3✔
314
                                 1);
315
               result.test_is_true("cannot obtain via ID anymore",
1✔
316
                                   !local_mgr.retrieve(new_session2->id().value(), cbs, plcy).has_value());
4✔
317
               result.test_is_true("cannot find via server info", local_mgr.find(server_info(), cbs, plcy).empty());
1✔
318
            }),
2✔
319

320
      CHECK("removing by ticket or opaque handle",
321
            [&](auto& result) {
1✔
322
               Botan::TLS::Session_Manager_In_Memory local_mgr(rng);
1✔
323

324
               const Botan::TLS::Session_Ticket ticket1 = random_ticket(*rng);
1✔
325
               const Botan::TLS::Session_Ticket ticket2 = random_ticket(*rng);
1✔
326
               Botan::TLS::Session_Ticket ticket3 = random_ticket(*rng);
1✔
327

328
               local_mgr.store(default_session(Botan::TLS::Connection_Side::Client, cbs), ticket1);
2✔
329
               local_mgr.store(default_session(Botan::TLS::Connection_Side::Client, cbs), ticket2);
2✔
330
               local_mgr.store(default_session(Botan::TLS::Connection_Side::Client, cbs), ticket3);
2✔
331
               result.test_sz_eq("can find them via server info ", local_mgr.find(server_info(), cbs, plcy).size(), 3);
1✔
332

333
               result.test_sz_eq("remove one session by ticket", local_mgr.remove(ticket2), 1);
2✔
334
               result.test_sz_eq("can find two via server info", local_mgr.find(server_info(), cbs, plcy).size(), 2);
1✔
335

336
               result.test_sz_eq("remove one session by opaque handle",
2✔
337
                                 local_mgr.remove(Botan::TLS::Opaque_Session_Handle(ticket3.get())),
2✔
338
                                 1);
339
               result.test_sz_eq(
1✔
340
                  "can find only one via server info", local_mgr.find(server_info(), cbs, plcy).size(), 1);
341
            }),
3✔
342

343
      CHECK(
344
         "session purging",
345
         [&](auto& result) {
1✔
346
            result.require("max sessions is 5", mgr->capacity() == 5);
1✔
347

348
            // fill the Session_Manager up fully
349
            std::vector<Botan::TLS::Session_Handle> handles;
1✔
350
            handles.reserve(mgr->capacity());
1✔
351
            for(size_t i = 0; i < mgr->capacity(); ++i) {
6✔
352
               handles.push_back(
5✔
353
                  mgr->establish(default_session(Botan::TLS::Connection_Side::Server, cbs), random_id(*rng)).value());
15✔
354
            }
355

356
            for(const auto& handle : handles) {
6✔
357
               result.test_is_true("session still there", mgr->retrieve(handle, cbs, plcy).has_value());
10✔
358
            }
359

360
            // add one more session (causing a first purge to happen)
361
            handles.push_back(
1✔
362
               mgr->establish(default_session(Botan::TLS::Connection_Side::Server, cbs), random_id(*rng)).value());
3✔
363

364
            result.test_is_true("oldest session gone", !mgr->retrieve(handles[0], cbs, plcy).has_value());
1✔
365
            for(size_t i = 1; i < handles.size(); ++i) {
6✔
366
               result.test_is_true("session still there", mgr->retrieve(handles[i], cbs, plcy).has_value());
10✔
367
            }
368

369
            // remove a session to cause a 'gap' in the FIFO
370
            mgr->remove(handles[4]);
1✔
371
            result.test_is_true("oldest session gone", !mgr->retrieve(handles[0], cbs, plcy).has_value());
1✔
372
            result.test_is_true("deleted session gone", !mgr->retrieve(handles[4], cbs, plcy).has_value());
1✔
373
            for(size_t i = 1; i < handles.size(); ++i) {
6✔
374
               result.test_is_true("session still there", i == 4 || mgr->retrieve(handles[i], cbs, plcy).has_value());
9✔
375
            }
376

377
            // insert enough new sessions to fully purge the ones currently held
378
            for(size_t i = 0; i < mgr->capacity(); ++i) {
6✔
379
               handles.push_back(
5✔
380
                  mgr->establish(default_session(Botan::TLS::Connection_Side::Server, cbs), random_id(*rng)).value());
15✔
381
            }
382

383
            for(size_t i = 0; i < handles.size() - mgr->capacity(); ++i) {
7✔
384
               result.test_is_true("session gone", !mgr->retrieve(handles[i], cbs, plcy).has_value());
6✔
385
            }
386

387
            for(size_t i = handles.size() - mgr->capacity(); i < handles.size(); ++i) {
6✔
388
               result.test_is_true("session still there", mgr->retrieve(handles[i], cbs, plcy).has_value());
10✔
389
            }
390

391
            // clear it all out
392
            result.test_sz_eq("rest of the sessions removed", mgr->remove_all(), size_t(5));
1✔
393
         }),
1✔
394
   };
17✔
395
}
5✔
396

397
std::vector<Test::Result> test_session_manager_choose_ticket() {
1✔
398
   #if defined(BOTAN_HAS_TLS_13)
399
   Session_Manager_Callbacks cbs;
1✔
400
   Session_Manager_Policy plcy;
1✔
401

402
   auto rng = Test::new_shared_rng(__func__);
1✔
403

404
   auto default_session = [&](const std::string& suite,
9✔
405
                              Botan::TLS::Callbacks& mycbs,
406
                              Botan::TLS::Protocol_Version version = Botan::TLS::Protocol_Version::TLS_V13) {
407
      return (version.is_pre_tls_13())
8✔
408
                ? Botan::TLS::Session({},
8✔
409
                                      version,
410
                                      Botan::TLS::Ciphersuite::from_name(suite)->ciphersuite_code(),
1✔
411
                                      Botan::TLS::Connection_Side::Server,
412
                                      true,
413
                                      true,
414
                                      {},
415
                                      server_info(),
416
                                      0,
417
                                      mycbs.tls_current_timestamp())
1✔
418
                : Botan::TLS::Session({},
419
                                      std::nullopt,
420
                                      0,
421
                                      std::chrono::seconds(1024),
7✔
422
                                      version,
423
                                      Botan::TLS::Ciphersuite::from_name(suite)->ciphersuite_code(),
7✔
424
                                      Botan::TLS::Connection_Side::Server,
425
                                      {},
426
                                      nullptr,
427
                                      server_info(),
428
                                      mycbs.tls_current_timestamp());
23✔
429
   };
430

431
   auto ticket = [&](std::span<const uint8_t> identity) {
16✔
432
      return Botan::TLS::PskIdentity(std::vector(identity.begin(), identity.end()), 0);
15✔
433
   };
434

435
   return {
1✔
436
      CHECK("empty manager has nothing to choose from",
437
            [&](auto& result) {
1✔
438
               Botan::TLS::Session_Manager_In_Memory mgr(rng);
1✔
439

440
               Botan::TLS::Session_Ticket random_session_ticket = random_ticket(*rng);
1✔
441

442
               result.test_is_true("empty ticket list, no session",
1✔
443
                                   !mgr.choose_from_offered_tickets({}, "SHA-256", cbs, plcy).has_value());
2✔
444
               result.test_is_true(
1✔
445
                  "empty session manager, no session",
446
                  !mgr.choose_from_offered_tickets(std::vector{ticket(random_session_ticket)}, "SHA-256", cbs, plcy)
3✔
447
                      .has_value());
3✔
448
            }),
3✔
449

450
      CHECK("choose ticket by ID",
451
            [&](auto& result) {
1✔
452
               Botan::TLS::Session_Manager_In_Memory mgr(rng);
1✔
453
               std::vector<Botan::TLS::Session_Handle> handles;
1✔
454

455
               handles.push_back(mgr.establish(default_session("AES_128_GCM_SHA256", cbs)).value());
3✔
456
               handles.push_back(mgr.establish(default_session("AES_128_GCM_SHA256", cbs)).value());
3✔
457

458
               // choose from a list of tickets that contains only handles[0]
459
               auto session1 =
2✔
460
                  mgr.choose_from_offered_tickets(std::vector{ticket(handles[0].id().value())}, "SHA-256", cbs, plcy);
3✔
461
               result.require("ticket was chosen and produced a session (1)", session1.has_value());
1✔
462
               result.test_u16_eq("chosen offset", session1->second, uint16_t(0));
1✔
463

464
               // choose from a list of tickets that contains only handles[1]
465
               auto session2 =
2✔
466
                  mgr.choose_from_offered_tickets(std::vector{ticket(handles[1].id().value())}, "SHA-256", cbs, plcy);
3✔
467
               result.require("ticket was chosen and produced a session (2)", session2.has_value());
1✔
468
               result.test_u16_eq("chosen offset", session2->second, uint16_t(0));
1✔
469

470
               // choose from a list of tickets that contains a random ticket and handles[1]
471
               auto session3 = mgr.choose_from_offered_tickets(
2✔
472
                  std::vector{ticket(random_ticket(*rng)), ticket(handles[1].id().value())}, "SHA-256", cbs, plcy);
5✔
473
               result.require("ticket was chosen and produced a session (3)", session3.has_value());
1✔
474
               result.test_u16_eq("chosen second offset", session3->second, uint16_t(1));
1✔
475
            }),
13✔
476

477
      CHECK("choose ticket by ticket",
478
            [&](auto& result) {
1✔
479
               auto creds = std::make_shared<Test_Credentials_Manager>();
480
               Botan::TLS::Session_Manager_Stateless mgr(creds, rng);
1✔
481
               std::vector<Botan::TLS::Session_Handle> handles;
1✔
482

483
               handles.push_back(mgr.establish(default_session("AES_128_GCM_SHA256", cbs)).value());
3✔
484
               handles.push_back(mgr.establish(default_session("AES_128_GCM_SHA256", cbs)).value());
3✔
485

486
               // choose from a list of tickets that contains only handles[0]
487
               auto session1 = mgr.choose_from_offered_tickets(
2✔
488
                  std::vector{ticket(handles[0].ticket().value())}, "SHA-256", cbs, plcy);
4✔
489
               result.require("ticket was chosen and produced a session (1)", session1.has_value());
1✔
490
               result.test_u16_eq("chosen offset", session1->second, uint16_t(0));
1✔
491

492
               // choose from a list of tickets that contains only handles[1]
493
               auto session2 = mgr.choose_from_offered_tickets(
2✔
494
                  std::vector{ticket(handles[1].ticket().value())}, "SHA-256", cbs, plcy);
4✔
495
               result.require("ticket was chosen and produced a session (2)", session2.has_value());
1✔
496
               result.test_u16_eq("chosen offset", session2->second, uint16_t(0));
1✔
497

498
               // choose from a list of tickets that contains a random ticket and handles[1]
499
               auto session3 = mgr.choose_from_offered_tickets(
2✔
500
                  std::vector{ticket(random_ticket(*rng)), ticket(handles[1].ticket().value())}, "SHA-256", cbs, plcy);
5✔
501
               result.require("ticket was chosen and produced a session (3)", session3.has_value());
1✔
502
               result.test_u16_eq("chosen second offset", session3->second, uint16_t(1));
1✔
503
            }),
14✔
504

505
      CHECK("choose ticket based on requested hash function",
506
            [&](auto& result) {
1✔
507
               auto creds = std::make_shared<Test_Credentials_Manager>();
508
               Botan::TLS::Session_Manager_Stateless mgr(creds, rng);
1✔
509
               std::vector<Botan::TLS::Session_Handle> handles;
1✔
510

511
               handles.push_back(mgr.establish(default_session("AES_128_GCM_SHA256", cbs)).value());
3✔
512
               handles.push_back(mgr.establish(default_session("AES_256_GCM_SHA384", cbs)).value());
3✔
513

514
               auto session = mgr.choose_from_offered_tickets(std::vector{ticket(random_ticket(*rng)),
5✔
515
                                                                          ticket(handles[0].ticket().value()),
1✔
516
                                                                          ticket(handles[1].ticket().value())},
1✔
517
                                                              "SHA-384",
518
                                                              cbs,
519
                                                              plcy);
520
               result.require("ticket was chosen and produced a session", session.has_value());
1✔
521
               result.test_u16_eq("chosen second offset", session->second, uint16_t(2));
1✔
522
            }),
7✔
523

524
      CHECK("choose ticket based on protocol version",
525
            [&](auto& result) {
1✔
526
               auto creds = std::make_shared<Test_Credentials_Manager>();
527
               Botan::TLS::Session_Manager_Stateless mgr(creds, rng);
1✔
528
               std::vector<Botan::TLS::Session_Handle> handles;
1✔
529

530
               handles.push_back(
1✔
531
                  mgr.establish(default_session("AES_128_GCM_SHA256", cbs, Botan::TLS::Version_Code::TLS_V12)).value());
3✔
532
               handles.push_back(
1✔
533
                  mgr.establish(default_session("AES_128_GCM_SHA256", cbs, Botan::TLS::Version_Code::TLS_V13)).value());
3✔
534

535
               auto session = mgr.choose_from_offered_tickets(std::vector{ticket(random_ticket(*rng)),
5✔
536
                                                                          ticket(handles[0].ticket().value()),
1✔
537
                                                                          ticket(handles[1].ticket().value())},
1✔
538
                                                              "SHA-256",
539
                                                              cbs,
540
                                                              plcy);
541
               result.require("ticket was chosen and produced a session", session.has_value());
1✔
542
               result.test_u16_eq("chosen second offset (TLS 1.3 ticket)", session->second, uint16_t(2));
1✔
543
            }),
7✔
544
   };
7✔
545
   #else
546
   return {};
547
   #endif
548
}
2✔
549

550
std::vector<Test::Result> test_session_manager_stateless() {
1✔
551
   auto creds = std::make_shared<Test_Credentials_Manager>();
1✔
552

553
   auto rng = Test::new_shared_rng(__func__);
1✔
554

555
   Botan::TLS::Session_Manager_Stateless mgr(creds, rng);
1✔
556

557
   Session_Manager_Callbacks cbs;
1✔
558
   Session_Manager_Policy plcy;
1✔
559

560
   return {
1✔
561
      CHECK("establish with default parameters",
562
            [&](auto& result) {
1✔
563
               result.test_is_true("will emit tickets", mgr.emits_session_tickets());
1✔
564
               auto ticket = mgr.establish(default_session(Botan::TLS::Connection_Side::Server, cbs));
1✔
565
               result.test_is_true("returned ticket", ticket.has_value() && ticket->is_ticket());
1✔
566
            }),
1✔
567

568
      CHECK("establish with disabled tickets",
569
            [&](auto& result) {
1✔
570
               result.test_is_true("will emit tickets", mgr.emits_session_tickets());
1✔
571
               auto ticket =
1✔
572
                  mgr.establish(default_session(Botan::TLS::Connection_Side::Server, cbs), std::nullopt, true);
1✔
573
               result.test_is_true("returned std::nullopt", !ticket.has_value());
1✔
574
            }),
1✔
575

576
      CHECK("establish without ticket key in credentials manager",
577
            [&](auto& result) {
1✔
578
               Botan::TLS::Session_Manager_Stateless local_mgr(std::make_shared<Empty_Credentials_Manager>(), rng);
2✔
579

580
               result.test_is_true("won't emit tickets", !local_mgr.emits_session_tickets());
1✔
581
               auto ticket = local_mgr.establish(default_session(Botan::TLS::Connection_Side::Server, cbs));
1✔
582
               result.test_is_true("returned std::nullopt", !ticket.has_value());
1✔
583
            }),
1✔
584

585
      CHECK("retrieve via ticket",
586
            [&](auto& result) {
1✔
587
               auto ticket1 = mgr.establish(default_session(Botan::TLS::Connection_Side::Server, cbs));
1✔
588
               auto ticket2 = mgr.establish(default_session(Botan::TLS::Connection_Side::Server, cbs));
1✔
589
               result.require("tickets created successfully", ticket1.has_value() && ticket2.has_value());
1✔
590

591
               Botan::TLS::Session_Manager_Stateless local_mgr(creds, rng);
1✔
592
               result.test_is_true("can retrieve ticket 1", mgr.retrieve(ticket1.value(), cbs, plcy).has_value());
1✔
593
               result.test_is_true("can retrieve ticket 2 from different manager but sam credentials",
1✔
594
                                   local_mgr.retrieve(ticket2.value(), cbs, plcy).has_value());
1✔
595
            }),
3✔
596

597
      CHECK("retrieve via ID does not work",
598
            [&](auto& result) {
1✔
599
               auto ticket1 = mgr.establish(default_session(Botan::TLS::Connection_Side::Server, cbs));
1✔
600
               result.require("tickets created successfully", ticket1.has_value() && ticket1.has_value());
1✔
601

602
               result.test_is_true("retrieval by ID does not work",
1✔
603
                                   !mgr.retrieve(random_id(*rng), cbs, plcy).has_value());
3✔
604
            }),
1✔
605

606
      CHECK("retrieve via opaque handle does work",
607
            [&](auto& result) {
1✔
608
               auto ticket1 = mgr.establish(default_session(Botan::TLS::Connection_Side::Server, cbs));
1✔
609
               result.require("tickets created successfully", ticket1.has_value() && ticket1.has_value());
1✔
610

611
               result.test_is_true("retrieval by opaque handle",
1✔
612
                                   mgr.retrieve(ticket1->opaque_handle(), cbs, plcy).has_value());
3✔
613
            }),
1✔
614

615
      CHECK("no retrieve without or with wrong ticket key",
616
            [&](auto& result) {
1✔
617
               auto ticket1 = mgr.establish(default_session(Botan::TLS::Connection_Side::Server, cbs));
1✔
618
               result.require("tickets created successfully", ticket1.has_value() && ticket1.has_value());
1✔
619

620
               Botan::TLS::Session_Manager_Stateless local_mgr1(std::make_shared<Empty_Credentials_Manager>(), rng);
2✔
621

622
               Botan::TLS::Session_Manager_Stateless local_mgr2(std::make_shared<Other_Test_Credentials_Manager>(),
2✔
623
                                                                rng);
624

625
               result.test_is_true("no successful retrieval (without key)",
1✔
626
                                   !local_mgr1.retrieve(ticket1.value(), cbs, plcy).has_value());
1✔
627
               result.test_is_true("no successful retrieval (with wrong key)",
1✔
628
                                   !local_mgr2.retrieve(ticket1.value(), cbs, plcy).has_value());
1✔
629
               result.test_is_true("successful retrieval", mgr.retrieve(ticket1.value(), cbs, plcy).has_value());
1✔
630
            }),
2✔
631

632
      CHECK("Clients cannot be stateless",
633
            [&](auto& result) {
1✔
634
               result.test_throws("::store() does not work with ID", [&] {
1✔
635
                  mgr.store(default_session(Botan::TLS::Connection_Side::Client, cbs), random_id(*rng));
3✔
636
               });
637
               result.test_throws("::store() does not work with ticket", [&] {
1✔
638
                  mgr.store(default_session(Botan::TLS::Connection_Side::Client, cbs), random_ticket(*rng));
3✔
639
               });
640
               result.test_throws("::store() does not work with opaque handle", [&] {
1✔
641
                  mgr.store(default_session(Botan::TLS::Connection_Side::Client, cbs), random_opaque_handle(*rng));
3✔
642
               });
643

644
               auto ticket1 = mgr.establish(default_session(Botan::TLS::Connection_Side::Server, cbs));
1✔
645
               result.require("tickets created successfully", ticket1.has_value() && ticket1.has_value());
1✔
646
               result.test_is_true("finding tickets does not work", mgr.find(server_info(), cbs, plcy).empty());
1✔
647
            }),
1✔
648

649
      CHECK("remove is a NOOP",
650
            [&](auto& result) {
1✔
651
               auto ticket1 = mgr.establish(default_session(Botan::TLS::Connection_Side::Server, cbs));
1✔
652
               result.require("tickets created successfully", ticket1.has_value() && ticket1.has_value());
1✔
653

654
               result.test_sz_eq("remove the ticket", mgr.remove(ticket1.value()), 0);
1✔
655
               result.test_is_true("successful retrieval 1", mgr.retrieve(ticket1.value(), cbs, plcy).has_value());
1✔
656

657
               result.test_sz_eq("remove the ticket", mgr.remove_all(), 0);
1✔
658
               result.test_is_true("successful retrieval 1", mgr.retrieve(ticket1.value(), cbs, plcy).has_value());
2✔
659
            }),
1✔
660

661
      CHECK(
662
         "retrieval via ticket reconstructs the start_time stamp",
663
         [&](auto& result) {
1✔
664
            auto session_before = default_session(Botan::TLS::Connection_Side::Server, cbs);
1✔
665
            auto ticket = mgr.establish(session_before);
2✔
666
            result.require("got a ticket", ticket.has_value() && ticket->is_ticket());
1✔
667
            auto session_after = mgr.retrieve(ticket.value(), cbs, plcy);
1✔
668
            result.require("got the session back", session_after.has_value());
1✔
669

670
            result.test_u64_eq(
×
671
               "timestamps match",
672
               std::chrono::duration_cast<std::chrono::seconds>(session_before.start_time().time_since_epoch()).count(),
1✔
673
               std::chrono::duration_cast<std::chrono::seconds>(session_after->start_time().time_since_epoch())
1✔
674
                  .count());
1✔
675
         }),
2✔
676
   };
11✔
677
}
4✔
678

679
std::vector<Test::Result> test_session_manager_hybrid() {
1✔
680
   auto rng = Test::new_shared_rng(__func__);
1✔
681

682
   auto creds = std::make_shared<Test_Credentials_Manager>();
1✔
683
   Session_Manager_Callbacks cbs;
1✔
684
   Session_Manager_Policy plcy;
1✔
685

686
   // Runs the passed-in hybrid manager test lambdas for all available stateful
687
   // managers. The `make_manager()` helper is passed into the test code and
688
   // transparently constructs a hybrid manager with the respective internal
689
   // stateful manager.
690
   auto CHECK_all = [&](const std::string& name, auto lambda) -> std::vector<Test::Result> {
4✔
691
      const std::vector<std::pair<std::string, std::function<std::unique_ptr<Botan::TLS::Session_Manager>()>>>
692
         stateful_manager_factories = {
9✔
693
            {"In Memory",
694
             [&rng]() -> std::unique_ptr<Botan::TLS::Session_Manager> {
9✔
695
                return std::make_unique<Botan::TLS::Session_Manager_In_Memory>(rng, 10);
6✔
696
             }},
697
   #if defined(BOTAN_HAS_TLS_SQLITE3_SESSION_MANAGER)
698
            {"SQLite",
699
             [&rng]() -> std::unique_ptr<Botan::TLS::Session_Manager> {
9✔
700
                return std::make_unique<Botan::TLS::Session_Manager_SQLite>(
701
                   "secure_pw", rng, Test::temp_file_name("tls_session_manager_sqlite"), 10);
6✔
702
             }},
703
   #endif
704
         };
705

706
      std::vector<Test::Result> results;
3✔
707
      using namespace std::placeholders;
708
      for(const auto& factory_and_name : stateful_manager_factories) {
15✔
709
         const auto& stateful_manager_name = factory_and_name.first;
6✔
710
         const auto& stateful_manager_factory = factory_and_name.second;
6✔
711
         auto make_manager = [stateful_manager_factory, &creds, &rng](bool prefer_tickets) {
42✔
712
            return Botan::TLS::Session_Manager_Hybrid(stateful_manager_factory(), creds, rng, prefer_tickets);
48✔
713
         };
714

715
         auto nm = Botan::fmt("{} ({})", name, stateful_manager_name);
6✔
716
         auto fn = std::bind(lambda, make_manager, _1);  // NOLINT(*-avoid-bind)
6✔
717
         results.push_back(CHECK(nm.c_str(), fn));
18✔
718
      }
719
      return results;
3✔
720
   };
7✔
721

722
   return Test::flatten_result_lists({
3✔
723
      CHECK_all("ticket vs ID preference in establishment",
1✔
724
                [&](const auto& make_manager, auto& result) {
2✔
725
                   auto mgr_prefers_tickets = make_manager(true);
2✔
726
                   auto ticket1 =
2✔
727
                      mgr_prefers_tickets.establish(default_session(Botan::TLS::Connection_Side::Server, cbs));
2✔
728
                   result.test_is_true("emits a ticket", ticket1.has_value() && ticket1->is_ticket());
2✔
729

730
                   auto mgr_prefers_ids = make_manager(false);
2✔
731
                   auto ticket2 = mgr_prefers_ids.establish(default_session(Botan::TLS::Connection_Side::Server, cbs));
2✔
732
                   result.test_is_true("emits an ID", ticket2.has_value() && ticket2->is_id());
2✔
733

734
                   auto ticket3 = mgr_prefers_ids.establish(default_session(Botan::TLS::Connection_Side::Server, cbs),
2✔
735
                                                            std::nullopt,
736
                                                            true /* TLS 1.2 no ticket support */);
737
                   result.test_is_true("emits an ID", ticket3.has_value() && ticket3->is_id());
2✔
738

739
                   auto ticket4 = mgr_prefers_ids.establish(default_session(Botan::TLS::Connection_Side::Server, cbs),
2✔
740
                                                            std::nullopt,
741
                                                            true /* TLS 1.2 no ticket support */);
742
                   result.test_is_true("emits an ID", ticket4.has_value() && ticket4->is_id());
2✔
743
                }),
8✔
744

745
      CHECK_all(
1✔
746
         "ticket vs ID preference in retrieval",
747
         [&](const auto& make_manager, auto& result) {
2✔
748
            auto mgr_prefers_tickets = make_manager(true);
2✔
749
            auto mgr_prefers_ids = make_manager(false);
2✔
750

751
            auto id1 = mgr_prefers_tickets.underlying_stateful_manager()->establish(
2✔
752
               default_session(Botan::TLS::Connection_Side::Server, cbs));
753
            auto id2 = mgr_prefers_ids.underlying_stateful_manager()->establish(
2✔
754
               default_session(Botan::TLS::Connection_Side::Server, cbs));
755
            auto ticket = mgr_prefers_tickets.establish(default_session(Botan::TLS::Connection_Side::Server, cbs));
2✔
756

757
            result.require("establishments worked", id1.has_value() && id2.has_value() && ticket.has_value());
2✔
758

759
            result.test_is_true("mgr1 + ID1", mgr_prefers_tickets.retrieve(id1.value(), cbs, plcy).has_value());
2✔
760
            result.test_is_true("mgr1 + ID2", !mgr_prefers_tickets.retrieve(id2.value(), cbs, plcy).has_value());
2✔
761
            result.test_is_true("mgr2 + ID1", !mgr_prefers_ids.retrieve(id1.value(), cbs, plcy).has_value());
2✔
762
            result.test_is_true("mgr2 + ID2", mgr_prefers_ids.retrieve(id2.value(), cbs, plcy).has_value());
2✔
763
            result.test_is_true("mgr1 + ticket", mgr_prefers_tickets.retrieve(ticket.value(), cbs, plcy).has_value());
2✔
764
            result.test_is_true("mgr2 + ticket", mgr_prefers_ids.retrieve(ticket.value(), cbs, plcy).has_value());
4✔
765
         }),
6✔
766

767
      CHECK_all("no session tickets if hybrid manager cannot create them",
1✔
768
                [&](const auto& make_manager, auto& result) {
2✔
769
                   Botan::TLS::Session_Manager_Hybrid empty_mgr(
8✔
770
                      std::make_unique<Botan::TLS::Session_Manager_In_Memory>(rng, 10),
4✔
771
                      std::make_shared<Empty_Credentials_Manager>(),
772
                      rng);
773
                   auto mgr_prefers_tickets = make_manager(true);
2✔
774
                   auto mgr_prefers_ids = make_manager(false);
2✔
775

776
                   result.test_is_true("does not emit tickets", !empty_mgr.emits_session_tickets());
2✔
777
                   result.test_is_true("does emit tickets 1", mgr_prefers_tickets.emits_session_tickets());
2✔
778
                   result.test_is_true("does emit tickets 2", mgr_prefers_ids.emits_session_tickets());
2✔
779
                }),
2✔
780
   });
4✔
781
}
4✔
782

783
namespace {
784

785
class Temporary_Database_File {
786
   private:
787
      std::string m_temp_file;
788

789
   public:
790
      explicit Temporary_Database_File(const std::string& db_file) :
1✔
791
            m_temp_file(Test::data_file_as_temporary_copy(db_file)) {
1✔
792
         if(m_temp_file.empty()) {
1✔
793
            throw Test_Error("Failed to create temporary database file");
×
794
         }
795
      }
1✔
796

797
      ~Temporary_Database_File() {
1✔
798
   #if defined(BOTAN_TARGET_OS_HAS_FILESYSTEM) && defined(__cpp_lib_filesystem)
799
         if(!m_temp_file.empty()) {
1✔
800
            std::filesystem::remove(m_temp_file);
1✔
801
         }
802
   #endif
803
      }
1✔
804

805
      const std::string& get() const { return m_temp_file; }
806

807
      Temporary_Database_File(const Temporary_Database_File&) = delete;
808
      Temporary_Database_File& operator=(const Temporary_Database_File&) = delete;
809
      Temporary_Database_File(Temporary_Database_File&&) = delete;
810
      Temporary_Database_File& operator=(Temporary_Database_File&&) = delete;
811
};
812

813
}  // namespace
814

815
std::vector<Test::Result> test_session_manager_sqlite() {
1✔
816
   #if defined(BOTAN_HAS_TLS_SQLITE3_SESSION_MANAGER)
817
   auto rng = Test::new_shared_rng(__func__);
1✔
818
   Session_Manager_Callbacks cbs;
1✔
819
   Session_Manager_Policy plcy;
1✔
820

821
   return {
1✔
822
      CHECK(
823
         "migrate session database scheme (purges database)",
824
         [&](auto& result) {
1✔
825
            const Temporary_Database_File dbfile("tls-sessions/botan-2.19.3.sqlite");
1✔
826

827
            // legacy database (encrypted with 'thetruthisoutthere') containing:
828
            //    $ sqlite3 src/tests/data/tls-sessions/botan-2.19.3.sqlite  'SELECT * FROM tls_sessions;'
829
            //    63C136FAD49F05A184F910FD6568A3884164216C11E41CEBFDCD149AF66C1714|1673606906|cloudflare.com|443|...
830
            //    63C137030387E4A6CDAD303CCB1F53884944FDE5B4EDD91E6FCF74DCB033DCEB|1673606915|randombit.net|443|...
831
            Botan::TLS::Session_Manager_SQLite legacy_db("thetruthisoutthere", rng, dbfile.get());
1✔
832

833
            result.test_is_true("Session_ID for randombit.net is gone",
1✔
834
                                !legacy_db
835
                                    .retrieve(Botan::TLS::Session_ID(Botan::hex_decode(
2✔
836
                                                 "63C137030387E4A6CDAD303CCB1F53884944FDE5B4EDD91E6FCF74DCB033DCEB")),
837
                                              cbs,
838
                                              plcy)
839
                                    .has_value());
3✔
840
            result.test_is_true("Session_ID for cloudflare.com is gone",
1✔
841
                                !legacy_db
842
                                    .retrieve(Botan::TLS::Session_ID(Botan::hex_decode(
2✔
843
                                                 "63C136FAD49F05A184F910FD6568A3884164216C11E41CEBFDCD149AF66C1714")),
844
                                              cbs,
845
                                              plcy)
846
                                    .has_value());
3✔
847
            result.test_is_true(
2✔
848
               "no more session for randombit.net",
849
               legacy_db.find(Botan::TLS::Server_Information("randombit.net", 443), cbs, plcy).empty());
1✔
850
            result.test_is_true(
2✔
851
               "no more session for cloudflare.com",
852
               legacy_db.find(Botan::TLS::Server_Information("cloudflare.com", 443), cbs, plcy).empty());
1✔
853

854
            result.test_sz_eq("empty database won't get more empty", legacy_db.remove_all(), 0);
1✔
855
         }),
1✔
856

857
      CHECK("clearing empty database",
858
            [&](auto& result) {
1✔
859
               Botan::TLS::Session_Manager_SQLite mgr("thetruthisoutthere", rng, Test::temp_file_name("empty.sqlite"));
1✔
860
               result.test_sz_eq("does not delete anything", mgr.remove_all(), 0);
1✔
861
            }),
1✔
862

863
      CHECK("establish new session",
864
            [&](auto& result) {
1✔
865
               Botan::TLS::Session_Manager_SQLite mgr(
1✔
866
                  "thetruthisoutthere", rng, Test::temp_file_name("new_session.sqlite"));
1✔
867
               auto some_random_id = random_id(*rng);
1✔
868
               auto some_random_handle =
1✔
869
                  mgr.establish(default_session(Botan::TLS::Connection_Side::Server, cbs), some_random_id);
870
               result.require("establishment was successful", some_random_handle.has_value());
1✔
871
               result.require("session id was set", some_random_handle->id().has_value());
1✔
872
               result.test_eq("session id is correct", some_random_handle->id().value(), some_random_id);
2✔
873

874
               auto some_virtual_handle = mgr.establish(default_session(Botan::TLS::Connection_Side::Server, cbs));
1✔
875
               result.require("establishment was successful", some_virtual_handle.has_value());
1✔
876
               result.require("session id was set", some_virtual_handle->id().has_value());
1✔
877
            }),
3✔
878

879
      CHECK("retrieve session by ID",
880
            [&](auto& result) {
1✔
881
               Botan::TLS::Session_Manager_SQLite mgr(
1✔
882
                  "thetruthisoutthere", rng, Test::temp_file_name("retrieve_by_id.sqlite"));
1✔
883
               auto some_random_id = random_id(*rng);
1✔
884
               auto some_random_handle =
1✔
885
                  mgr.establish(default_session(Botan::TLS::Connection_Side::Server, cbs), some_random_id);
886
               auto some_virtual_handle = mgr.establish(default_session(Botan::TLS::Connection_Side::Server, cbs));
1✔
887

888
               result.require("establishment was successful",
1✔
889
                              some_random_handle->is_id() && some_virtual_handle->is_id());
1✔
890

891
               auto session1 = mgr.retrieve(some_random_handle.value(), cbs, plcy);
1✔
892
               if(result.test_is_true("found session by user-provided ID", session1.has_value())) {
1✔
893
                  result.test_is_eq("protocol version was echoed",
1✔
894
                                    session1->version(),
1✔
895
                                    Botan::TLS::Protocol_Version(Botan::TLS::Version_Code::TLS_V12));
1✔
896
                  result.test_u16_eq("ciphersuite was echoed", session1->ciphersuite_code(), uint16_t(0x009C));
1✔
897
               }
898

899
               auto session2 = mgr.retrieve(some_virtual_handle.value(), cbs, plcy);
1✔
900
               if(result.test_is_true("found session by manager-generated ID", session2.has_value())) {
1✔
901
                  result.test_is_eq("protocol version was echoed",
1✔
902
                                    session2->version(),
1✔
903
                                    Botan::TLS::Protocol_Version(Botan::TLS::Version_Code::TLS_V12));
1✔
904
                  result.test_u16_eq("ciphersuite was echoed", session2->ciphersuite_code(), uint16_t(0x009C));
1✔
905
               }
906

907
               auto session3 = mgr.retrieve(random_id(*rng), cbs, plcy);
2✔
908
               result.test_is_true("random ID creates empty result", !session3.has_value());
1✔
909
            }),
6✔
910

911
      CHECK("retrieval via ticket creates empty result",
912
            [&](auto& result) {
1✔
913
               Botan::TLS::Session_Manager_SQLite mgr(
1✔
914
                  "thetruthisoutthere", rng, Test::temp_file_name("retrieve_by_ticket.sqlite"));
1✔
915
               auto some_random_handle =
1✔
916
                  mgr.establish(default_session(Botan::TLS::Connection_Side::Server, cbs), random_id(*rng));
1✔
917
               auto some_virtual_handle = mgr.establish(default_session(Botan::TLS::Connection_Side::Server, cbs));
1✔
918

919
               result.test_is_true("std::nullopt on random ticket",
1✔
920
                                   !mgr.retrieve(random_ticket(*rng), cbs, plcy).has_value());
3✔
921
            }),
2✔
922

923
      CHECK("storing sessions and finding them by server info",
924
            [&](auto& result) {
1✔
925
               Botan::TLS::Session_Manager_SQLite mgr(
1✔
926
                  "thetruthisoutthere", rng, Test::temp_file_name("store_and_find.sqlite"));
1✔
927
               auto id = random_id(*rng);
1✔
928
               auto ticket = random_ticket(*rng);
1✔
929
               mgr.store(default_session(Botan::TLS::Connection_Side::Client, cbs), id);
2✔
930
               mgr.store(default_session(Botan::TLS::Connection_Side::Client, cbs), ticket);
2✔
931

932
               auto found_sessions = mgr.find(server_info(), cbs, plcy);
1✔
933
               if(result.test_sz_eq("found both sessions", found_sessions.size(), 2)) {
1✔
934
                  for(const auto& [session, handle] : found_sessions) {
3✔
935
                     result.test_is_true("ID matches", !handle.is_id() || handle.id().value() == id);
3✔
936
                     result.test_is_true("ticket matches", !handle.is_ticket() || handle.ticket().value() == ticket);
3✔
937
                  }
938
               }
939
            }),
3✔
940

941
      CHECK("removing sessions",
942
            [&](auto& result) {
1✔
943
               Botan::TLS::Session_Manager_SQLite mgr("thetruthisoutthere", rng, Test::temp_file_name("remove.sqlite"));
1✔
944
               auto id = random_id(*rng);
1✔
945
               auto ticket = random_ticket(*rng);
1✔
946
               mgr.store(default_session(Botan::TLS::Connection_Side::Client, cbs), id);
2✔
947
               mgr.store(default_session(Botan::TLS::Connection_Side::Client, cbs), ticket);
2✔
948
               mgr.store(default_session(Botan::TLS::Connection_Side::Client, cbs), random_id(*rng));
2✔
949
               mgr.store(default_session(Botan::TLS::Connection_Side::Client, cbs), random_ticket(*rng));
2✔
950

951
               result.test_sz_eq("deletes one session by ID", mgr.remove(id), 1);
2✔
952
               result.test_sz_eq("deletes one session by ticket", mgr.remove(ticket), 1);
2✔
953

954
               auto found_sessions = mgr.find(server_info(), cbs, plcy);
1✔
955
               if(result.test_sz_eq("found some other sessions", found_sessions.size(), 2)) {
1✔
956
                  for(const auto& [session, handle] : found_sessions) {
3✔
957
                     result.test_is_true("ID does not match", !handle.is_id() || handle.id().value() != id);
4✔
958
                     result.test_is_true("ticket does not match",
2✔
959
                                         !handle.is_ticket() || handle.ticket().value() != ticket);
5✔
960
                  }
961
               }
962

963
               result.test_sz_eq("removing the rest of the sessions", mgr.remove_all(), 2);
1✔
964
            }),
3✔
965

966
      CHECK("old sessions are purged when needed",
967
            [&](auto& result) {
1✔
968
               Botan::TLS::Session_Manager_SQLite mgr(
1✔
969
                  "thetruthisoutthere", rng, Test::temp_file_name("purging.sqlite"), 1);
1✔
970

971
               std::vector<Botan::TLS::Session_ID> ids = {random_id(*rng), random_id(*rng), random_id(*rng)};
5✔
972
               mgr.establish(default_session(Botan::TLS::Connection_Side::Server, cbs), ids[0]);
2✔
973
               result.require("new ID exists", mgr.retrieve(ids[0], cbs, plcy).has_value());
4✔
974

975
               // Session timestamps are saved with second-resolution. If more than
976
               // one session has the same (coarse) timestamp it is undefined which
977
               // will be purged first. The clock tick ensures that session's
978
               // timestamps are unique.
979
               cbs.tick();
1✔
980
               mgr.establish(default_session(Botan::TLS::Connection_Side::Server, cbs), ids[1]);
2✔
981
               result.require("first ID is gone", !mgr.retrieve(ids[0], cbs, plcy).has_value());
3✔
982
               result.require("new ID exists", mgr.retrieve(ids[1], cbs, plcy).has_value());
4✔
983

984
               cbs.tick();
1✔
985
               mgr.establish(default_session(Botan::TLS::Connection_Side::Server, cbs), ids[2]);
2✔
986
               result.require("second ID is gone", !mgr.retrieve(ids[1], cbs, plcy).has_value());
3✔
987
               result.require("new ID exists", mgr.retrieve(ids[2], cbs, plcy).has_value());
4✔
988

989
               result.test_sz_eq("only one entry exists", mgr.remove_all(), 1);
1✔
990
            }),
2✔
991

992
      CHECK("session purging can be disabled",
993
            [&](auto& result) {
1✔
994
               Botan::TLS::Session_Manager_SQLite mgr(
1✔
995
                  "thetruthisoutthere", rng, Test::temp_file_name("purging.sqlite"), 0 /* no pruning! */);
1✔
996

997
               for(size_t i = 0; i < 25; ++i) {
26✔
998
                  mgr.establish(default_session(Botan::TLS::Connection_Side::Server, cbs), random_id(*rng));
50✔
999
               }
1000

1001
               result.test_sz_eq("no entries were purged along the way", mgr.remove_all(), 25);
1✔
1002
            }),
1✔
1003
   };
10✔
1004
   #else
1005
   return {};
1006
   #endif
1007
}
3✔
1008

1009
std::vector<Test::Result> tls_session_manager_expiry() {
1✔
1010
   auto rng = Test::new_shared_rng(__func__);
1✔
1011
   Session_Manager_Callbacks cbs;
1✔
1012
   Session_Manager_Policy plcy;
1✔
1013

1014
   auto CHECK_all = [&](const std::string& name, auto lambda) -> std::vector<Test::Result> {
6✔
1015
      const std::vector<std::pair<std::string, std::function<std::unique_ptr<Botan::TLS::Session_Manager>()>>>
1016
         stateful_manager_factories = {
20✔
1017
            {"In Memory",
1018
             [&rng]() -> std::unique_ptr<Botan::TLS::Session_Manager> {
10✔
1019
                return std::make_unique<Botan::TLS::Session_Manager_In_Memory>(rng, 10);
5✔
1020
             }},
1021
            {"Stateless",
1022
             [&]() -> std::unique_ptr<Botan::TLS::Session_Manager> {
7✔
1023
                return std::make_unique<Botan::TLS::Session_Manager_Stateless>(
1024
                   std::make_shared<Test_Credentials_Manager>(), rng);
2✔
1025
             }},
1026
   #if defined(BOTAN_HAS_TLS_SQLITE3_SESSION_MANAGER)
1027
            {"SQLite",
1028
             [&rng]() -> std::unique_ptr<Botan::TLS::Session_Manager> {
10✔
1029
                return std::make_unique<Botan::TLS::Session_Manager_SQLite>(
1030
                   "secure_pw", rng, Test::temp_file_name("tls_session_manager_sqlite"), 10);
5✔
1031
             }},
1032
   #endif
1033
         };
1034

1035
      std::vector<Test::Result> results;
5✔
1036
      results.reserve(stateful_manager_factories.size());
5✔
1037
      using namespace std::placeholders;
1038
      for(const auto& [sub_name, factory] : stateful_manager_factories) {
20✔
1039
         auto nm = Botan::fmt("{} ({})", name, sub_name);
15✔
1040
         auto fn = std::bind(lambda, sub_name, factory, _1);  // NOLINT(*-avoid-bind)
15✔
1041
         results.push_back(CHECK(nm.c_str(), fn));
30✔
1042
      }
1043
      return results;
5✔
1044
   };
11✔
1045

1046
   return Test::flatten_result_lists({
5✔
1047
      CHECK_all("sessions expire",
1✔
1048
                [&](const auto&, const auto& factory, auto& result) {
3✔
1049
                   auto mgr = factory();
3✔
1050

1051
                   auto handle = mgr->establish(default_session(Botan::TLS::Connection_Side::Server, cbs));
3✔
1052
                   result.require("saved successfully", handle.has_value());
3✔
1053
                   result.require("session was found", mgr->retrieve(handle.value(), cbs, plcy).has_value());
3✔
1054
                   cbs.tick();
3✔
1055
                   result.test_is_true("session has expired", !mgr->retrieve(handle.value(), cbs, plcy).has_value());
3✔
1056
                   result.test_sz_eq("session was deleted when it expired", mgr->remove_all(), 0);
3✔
1057
                }),
6✔
1058

1059
         CHECK_all("expired sessions are not found",
1✔
1060
                   [&](const std::string& type, const auto& factory, auto& result) {
3✔
1061
                      if(type == "Stateless") {
3✔
1062
                         return;  // this manager can neither store nor find anything
1✔
1063
                      }
1064

1065
                      auto mgr = factory();
2✔
1066

1067
                      auto handle_old = random_id(*rng);
2✔
1068
                      mgr->store(default_session(Botan::TLS::Connection_Side::Client, cbs), handle_old);
6✔
1069
                      result.require("session was found", mgr->retrieve(handle_old, cbs, plcy).has_value());
8✔
1070

1071
                      cbs.tick();
2✔
1072
                      auto handle_new = random_id(*rng);
2✔
1073
                      mgr->store(default_session(Botan::TLS::Connection_Side::Client, cbs), handle_new);
6✔
1074
                      result.require("session was found", mgr->retrieve(handle_new, cbs, plcy).has_value());
8✔
1075

1076
                      auto sessions_and_handles = mgr->find(server_info(), cbs, plcy);
2✔
1077
                      result.require("sessions are found", !sessions_and_handles.empty());
2✔
1078
                      result.test_sz_eq("exactly one session is found", sessions_and_handles.size(), 1);
2✔
1079
                      result.test_is_eq(
2✔
1080
                         "the new session is found", sessions_and_handles.front().handle.id().value(), handle_new);
6✔
1081

1082
                      result.test_sz_eq("old session was deleted when it expired", mgr->remove_all(), 1);
2✔
1083
                   }),
8✔
1084

1085
         CHECK_all(
1✔
1086
            "session tickets are not reused",
1087
            [&](const std::string& type, const auto& factory, auto& result) {
3✔
1088
               if(type == "Stateless") {
3✔
1089
                  return;  // this manager can neither store nor find anything
1✔
1090
               }
1091

1092
               auto mgr = factory();
2✔
1093

1094
               auto handle_1 = random_id(*rng);
2✔
1095
               mgr->store(default_session(Botan::TLS::Connection_Side::Client, cbs, Botan::TLS::Version_Code::TLS_V12),
6✔
1096
                          handle_1);
1097
               auto handle_2 = random_ticket(*rng);
2✔
1098
               mgr->store(default_session(Botan::TLS::Connection_Side::Client, cbs, Botan::TLS::Version_Code::TLS_V12),
6✔
1099
                          handle_2);
1100

1101
   #if defined(BOTAN_HAS_TLS_13)
1102
               auto handle_3 = random_id(*rng);
2✔
1103
               mgr->store(default_session(Botan::TLS::Connection_Side::Client, cbs, Botan::TLS::Version_Code::TLS_V13),
6✔
1104
                          handle_3);
1105
               auto handle_4 = random_ticket(*rng);
2✔
1106
               mgr->store(default_session(Botan::TLS::Connection_Side::Client, cbs, Botan::TLS::Version_Code::TLS_V13),
6✔
1107
                          handle_4);
1108
   #endif
1109

1110
               plcy.set_allow_session_reuse(false);
2✔
1111

1112
               auto sessions_and_handles1 = mgr->find(server_info(), cbs, plcy);
2✔
1113
               result.require("all sessions are found", sessions_and_handles1.size() > 1);
2✔
1114

1115
               auto sessions_and_handles2 = mgr->find(server_info(), cbs, plcy);
2✔
1116
               result.test_sz_eq("only one session is found", sessions_and_handles2.size(), 1);
2✔
1117
               result.test_is_true("found session is the Session_ID", sessions_and_handles2.front().handle.is_id());
2✔
1118
               result.test_is_eq(
2✔
1119
                  "found session is the Session_ID", sessions_and_handles2.front().handle.id().value(), handle_1);
6✔
1120
               result.test_is_true("found session is TLS 1.2",
2✔
1121
                                   sessions_and_handles2.front().session.version().is_pre_tls_13());
2✔
1122
            }),
12✔
1123

1124
         CHECK_all("number of found tickets is capped",
1✔
1125
                   [&](const std::string& type, const auto& factory, auto& result) {
3✔
1126
                      if(type == "Stateless") {
3✔
1127
                         return;  // this manager can neither store nor find anything
1✔
1128
                      }
1129

1130
                      auto mgr = factory();
2✔
1131

1132
                      std::array<Botan::TLS::Session_Ticket, 5> tickets;
2✔
1133
                      for(auto& ticket : tickets) {
12✔
1134
                         ticket = random_ticket(*rng);
10✔
1135
                         mgr->store(default_session(Botan::TLS::Connection_Side::Client, cbs), ticket);
30✔
1136
                      }
1137

1138
                      plcy.set_allow_session_reuse(true);
2✔
1139

1140
                      plcy.set_session_limit(1);
2✔
1141
                      result.test_sz_eq("find one",
2✔
1142
                                        mgr->find(server_info(), cbs, plcy).size(),
2✔
1143
                                        plcy.maximum_session_tickets_per_client_hello());
2✔
1144

1145
                      plcy.set_session_limit(3);
2✔
1146
                      result.test_sz_eq("find three",
2✔
1147
                                        mgr->find(server_info(), cbs, plcy).size(),
2✔
1148
                                        plcy.maximum_session_tickets_per_client_hello());
2✔
1149

1150
                      plcy.set_session_limit(10);
2✔
1151
                      result.test_sz_eq("find all five", mgr->find(server_info(), cbs, plcy).size(), 5);
2✔
1152
                   }),
4✔
1153

1154
   #if defined(BOTAN_HAS_TLS_13)
1155
         CHECK_all("expired tickets are not selected for PSK resumption",
1✔
1156
                   [&](const auto&, const auto& factory, auto& result) {
3✔
1157
                      auto ticket = [&](const Botan::TLS::Session_Handle& handle) {
12✔
1158
                         return Botan::TLS::PskIdentity(handle.opaque_handle().get(), 0);
12✔
1159
                      };
1160

1161
                      auto mgr = factory();
3✔
1162

1163
                      auto old_handle = mgr->establish(
3✔
1164
                         default_session(Botan::TLS::Connection_Side::Server, cbs, Botan::TLS::Version_Code::TLS_V13));
1165
                      cbs.tick();
3✔
1166
                      auto new_handle = mgr->establish(
3✔
1167
                         default_session(Botan::TLS::Connection_Side::Server, cbs, Botan::TLS::Version_Code::TLS_V13));
1168
                      result.require("both sessions are stored", old_handle.has_value() && new_handle.has_value());
3✔
1169

1170
                      auto session_and_index = mgr->choose_from_offered_tickets(
12✔
1171
                         std::vector{ticket(old_handle.value()), ticket(new_handle.value())}, "SHA-256", cbs, plcy);
6✔
1172
                      result.require("a ticket was chosen", session_and_index.has_value());
3✔
1173
                      result.test_u16_eq("the new ticket was chosen", session_and_index->second, uint16_t(1));
3✔
1174

1175
                      cbs.tick();
3✔
1176

1177
                      auto nothing = mgr->choose_from_offered_tickets(
12✔
1178
                         std::vector{ticket(new_handle.value()), ticket(old_handle.value())}, "SHA-256", cbs, plcy);
6✔
1179
                      result.require("all tickets are expired", !nothing.has_value());
3✔
1180
                   }),
33✔
1181
   #endif
1182
   });
6✔
1183
}
3✔
1184

1185
}  // namespace
1186

1187
BOTAN_REGISTER_TEST_FN("tls",
1188
                       "tls_session_manager",
1189
                       test_session_manager_in_memory,
1190
                       test_session_manager_choose_ticket,
1191
                       test_session_manager_stateless,
1192
                       test_session_manager_hybrid,
1193
                       test_session_manager_sqlite,
1194
                       tls_session_manager_expiry);
1195

1196
}  // namespace Botan_Tests
1197

1198
#endif  // BOTAN_HAS_TLS
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

© 2026 Coveralls, Inc