7#include <botan/tls_algos.h>
9#include <botan/ec_group.h>
10#include <botan/exceptn.h>
11#include <botan/internal/fmt.h>
12#include <botan/internal/tls_messages_internal.h>
14#if defined(BOTAN_HAS_FRODOKEM)
15 #include <botan/frodo_mode.h>
59 throw Invalid_State(
"kex_method_to_string unknown enum value");
79 if(str ==
"ECDHE_PSK") {
83 if(str ==
"DHE_PSK") {
91 if(str ==
"KEM_PSK") {
99 if(str ==
"HYBRID_PSK") {
103 if(str ==
"UNDEFINED") {
122 throw Invalid_State(
"auth_method_to_string unknown enum value");
132 if(str ==
"IMPLICIT") {
135 if(str ==
"UNDEFINED") {
142#if defined(BOTAN_HAS_TLS_13_PQC)
147Group_Params pqc_hybrid_kem(Group_Params group) {
148 switch(group.code()) {
149 case Group_Params::HYBRID_X25519_ML_KEM_768:
150 case Group_Params::HYBRID_SECP256R1_ML_KEM_768:
151 return Group_Params::ML_KEM_768;
152 case Group_Params::HYBRID_SECP384R1_ML_KEM_1024:
153 return Group_Params::ML_KEM_1024;
155 case Group_Params::HYBRID_X25519_eFRODOKEM_640_SHAKE_OQS:
156 case Group_Params::HYBRID_SECP256R1_eFRODOKEM_640_SHAKE_OQS:
157 return Group_Params::eFRODOKEM_640_SHAKE_OQS;
158 case Group_Params::HYBRID_X25519_eFRODOKEM_640_AES_OQS:
159 case Group_Params::HYBRID_SECP256R1_eFRODOKEM_640_AES_OQS:
160 return Group_Params::eFRODOKEM_640_AES_OQS;
162 case Group_Params::HYBRID_X448_eFRODOKEM_976_SHAKE_OQS:
163 case Group_Params::HYBRID_SECP384R1_eFRODOKEM_976_SHAKE_OQS:
164 return Group_Params::eFRODOKEM_976_SHAKE_OQS;
165 case Group_Params::HYBRID_X448_eFRODOKEM_976_AES_OQS:
166 case Group_Params::HYBRID_SECP384R1_eFRODOKEM_976_AES_OQS:
167 return Group_Params::eFRODOKEM_976_AES_OQS;
169 case Group_Params::HYBRID_SECP521R1_eFRODOKEM_1344_SHAKE_OQS:
170 return Group_Params::eFRODOKEM_1344_SHAKE_OQS;
171 case Group_Params::HYBRID_SECP521R1_eFRODOKEM_1344_AES_OQS:
172 return Group_Params::eFRODOKEM_1344_AES_OQS;
175 return Group_Params::NONE;
194#if defined(BOTAN_HAS_DIFFIE_HELLMAN)
200#if defined(BOTAN_HAS_X25519)
206#if defined(BOTAN_HAS_X448)
212#if defined(BOTAN_HAS_ML_KEM)
218#if defined(BOTAN_HAS_FRODOKEM)
224#if defined(BOTAN_HAS_TLS_13_PQC)
236 group != Group_Params::BRAINPOOL256R1TLS13 &&
237 group != Group_Params::BRAINPOOL384R1TLS13 &&
238 group != Group_Params::BRAINPOOL512R1TLS13;
240 return group != Group_Params::BRAINPOOL256R1 &&
241 group != Group_Params::BRAINPOOL384R1 &&
242 group != Group_Params::BRAINPOOL512R1;
247 std::vector<Group_Params> usable;
248 for(
const auto group : groups) {
250 usable.push_back(group);
292 if(group_name ==
"secp256r1") {
293 return Group_Params::SECP256R1;
295 if(group_name ==
"secp384r1") {
296 return Group_Params::SECP384R1;
298 if(group_name ==
"secp521r1") {
299 return Group_Params::SECP521R1;
301 if(group_name ==
"brainpool256r1") {
302 return Group_Params::BRAINPOOL256R1;
304 if(group_name ==
"brainpool384r1") {
305 return Group_Params::BRAINPOOL384R1;
307 if(group_name ==
"brainpool512r1") {
308 return Group_Params::BRAINPOOL512R1;
310 if(group_name ==
"x25519") {
311 return Group_Params::X25519;
313 if(group_name ==
"x448") {
314 return Group_Params::X448;
316 if(group_name ==
"brainpool256r1tls13") {
317 return Group_Params::BRAINPOOL256R1TLS13;
319 if(group_name ==
"brainpool384r1tls13") {
320 return Group_Params::BRAINPOOL384R1TLS13;
322 if(group_name ==
"brainpool512r1tls13") {
323 return Group_Params::BRAINPOOL512R1TLS13;
326 if(group_name ==
"ffdhe/ietf/2048") {
327 return Group_Params::FFDHE_2048;
329 if(group_name ==
"ffdhe/ietf/3072") {
330 return Group_Params::FFDHE_3072;
332 if(group_name ==
"ffdhe/ietf/4096") {
333 return Group_Params::FFDHE_4096;
335 if(group_name ==
"ffdhe/ietf/6144") {
336 return Group_Params::FFDHE_6144;
338 if(group_name ==
"ffdhe/ietf/8192") {
339 return Group_Params::FFDHE_8192;
342 if(group_name ==
"ML-KEM-512") {
343 return Group_Params::ML_KEM_512;
345 if(group_name ==
"ML-KEM-768") {
346 return Group_Params::ML_KEM_768;
348 if(group_name ==
"ML-KEM-1024") {
349 return Group_Params::ML_KEM_1024;
352 if(group_name ==
"eFrodoKEM-640-SHAKE") {
353 return Group_Params::eFRODOKEM_640_SHAKE_OQS;
355 if(group_name ==
"eFrodoKEM-976-SHAKE") {
356 return Group_Params::eFRODOKEM_976_SHAKE_OQS;
358 if(group_name ==
"eFrodoKEM-1344-SHAKE") {
359 return Group_Params::eFRODOKEM_1344_SHAKE_OQS;
361 if(group_name ==
"eFrodoKEM-640-AES") {
362 return Group_Params::eFRODOKEM_640_AES_OQS;
364 if(group_name ==
"eFrodoKEM-976-AES") {
365 return Group_Params::eFRODOKEM_976_AES_OQS;
367 if(group_name ==
"eFrodoKEM-1344-AES") {
368 return Group_Params::eFRODOKEM_1344_AES_OQS;
371 if(group_name ==
"x25519/ML-KEM-768") {
372 return Group_Params::HYBRID_X25519_ML_KEM_768;
374 if(group_name ==
"secp256r1/ML-KEM-768") {
375 return Group_Params::HYBRID_SECP256R1_ML_KEM_768;
377 if(group_name ==
"secp384r1/ML-KEM-1024") {
378 return Group_Params::HYBRID_SECP384R1_ML_KEM_1024;
381 if(group_name ==
"x25519/eFrodoKEM-640-SHAKE") {
382 return Group_Params::HYBRID_X25519_eFRODOKEM_640_SHAKE_OQS;
384 if(group_name ==
"x25519/eFrodoKEM-640-AES") {
385 return Group_Params::HYBRID_X25519_eFRODOKEM_640_AES_OQS;
387 if(group_name ==
"x448/eFrodoKEM-976-SHAKE") {
388 return Group_Params::HYBRID_X448_eFRODOKEM_976_SHAKE_OQS;
390 if(group_name ==
"x448/eFrodoKEM-976-AES") {
391 return Group_Params::HYBRID_X448_eFRODOKEM_976_AES_OQS;
394 if(group_name ==
"secp256r1/eFrodoKEM-640-SHAKE") {
395 return Group_Params::HYBRID_SECP256R1_eFRODOKEM_640_SHAKE_OQS;
397 if(group_name ==
"secp256r1/eFrodoKEM-640-AES") {
398 return Group_Params::HYBRID_SECP256R1_eFRODOKEM_640_AES_OQS;
401 if(group_name ==
"secp384r1/eFrodoKEM-976-SHAKE") {
402 return Group_Params::HYBRID_SECP384R1_eFRODOKEM_976_SHAKE_OQS;
404 if(group_name ==
"secp384r1/eFrodoKEM-976-AES") {
405 return Group_Params::HYBRID_SECP384R1_eFRODOKEM_976_AES_OQS;
408 if(group_name ==
"secp521r1/eFrodoKEM-1344-SHAKE") {
409 return Group_Params::HYBRID_SECP521R1_eFRODOKEM_1344_SHAKE_OQS;
411 if(group_name ==
"secp521r1/eFrodoKEM-1344-AES") {
412 return Group_Params::HYBRID_SECP521R1_eFRODOKEM_1344_AES_OQS;
420 case Group_Params::SECP256R1:
422 case Group_Params::SECP384R1:
424 case Group_Params::SECP521R1:
426 case Group_Params::BRAINPOOL256R1:
427 return "brainpool256r1";
428 case Group_Params::BRAINPOOL384R1:
429 return "brainpool384r1";
430 case Group_Params::BRAINPOOL512R1:
431 return "brainpool512r1";
432 case Group_Params::X25519:
434 case Group_Params::X448:
436 case Group_Params::BRAINPOOL256R1TLS13:
437 return "brainpool256r1tls13";
438 case Group_Params::BRAINPOOL384R1TLS13:
439 return "brainpool384r1tls13";
440 case Group_Params::BRAINPOOL512R1TLS13:
441 return "brainpool512r1tls13";
443 case Group_Params::FFDHE_2048:
444 return "ffdhe/ietf/2048";
445 case Group_Params::FFDHE_3072:
446 return "ffdhe/ietf/3072";
447 case Group_Params::FFDHE_4096:
448 return "ffdhe/ietf/4096";
449 case Group_Params::FFDHE_6144:
450 return "ffdhe/ietf/6144";
451 case Group_Params::FFDHE_8192:
452 return "ffdhe/ietf/8192";
454 case Group_Params::ML_KEM_512:
456 case Group_Params::ML_KEM_768:
458 case Group_Params::ML_KEM_1024:
459 return "ML-KEM-1024";
461 case Group_Params::eFRODOKEM_640_SHAKE_OQS:
462 return "eFrodoKEM-640-SHAKE";
463 case Group_Params::eFRODOKEM_976_SHAKE_OQS:
464 return "eFrodoKEM-976-SHAKE";
465 case Group_Params::eFRODOKEM_1344_SHAKE_OQS:
466 return "eFrodoKEM-1344-SHAKE";
467 case Group_Params::eFRODOKEM_640_AES_OQS:
468 return "eFrodoKEM-640-AES";
469 case Group_Params::eFRODOKEM_976_AES_OQS:
470 return "eFrodoKEM-976-AES";
471 case Group_Params::eFRODOKEM_1344_AES_OQS:
472 return "eFrodoKEM-1344-AES";
474 case Group_Params::HYBRID_X25519_eFRODOKEM_640_SHAKE_OQS:
475 return "x25519/eFrodoKEM-640-SHAKE";
476 case Group_Params::HYBRID_X25519_eFRODOKEM_640_AES_OQS:
477 return "x25519/eFrodoKEM-640-AES";
478 case Group_Params::HYBRID_X448_eFRODOKEM_976_SHAKE_OQS:
479 return "x448/eFrodoKEM-976-SHAKE";
480 case Group_Params::HYBRID_X448_eFRODOKEM_976_AES_OQS:
481 return "x448/eFrodoKEM-976-AES";
482 case Group_Params::HYBRID_SECP256R1_eFRODOKEM_640_SHAKE_OQS:
483 return "secp256r1/eFrodoKEM-640-SHAKE";
484 case Group_Params::HYBRID_SECP256R1_eFRODOKEM_640_AES_OQS:
485 return "secp256r1/eFrodoKEM-640-AES";
486 case Group_Params::HYBRID_SECP384R1_eFRODOKEM_976_SHAKE_OQS:
487 return "secp384r1/eFrodoKEM-976-SHAKE";
488 case Group_Params::HYBRID_SECP384R1_eFRODOKEM_976_AES_OQS:
489 return "secp384r1/eFrodoKEM-976-AES";
490 case Group_Params::HYBRID_SECP521R1_eFRODOKEM_1344_SHAKE_OQS:
491 return "secp521r1/eFrodoKEM-1344-SHAKE";
492 case Group_Params::HYBRID_SECP521R1_eFRODOKEM_1344_AES_OQS:
493 return "secp521r1/eFrodoKEM-1344-AES";
495 case Group_Params::HYBRID_X25519_ML_KEM_768:
496 return "x25519/ML-KEM-768";
497 case Group_Params::HYBRID_SECP256R1_ML_KEM_768:
498 return "secp256r1/ML-KEM-768";
499 case Group_Params::HYBRID_SECP384R1_ML_KEM_1024:
500 return "secp384r1/ML-KEM-1024";
510 case Group_Params::BRAINPOOL256R1:
511 case Group_Params::BRAINPOOL256R1TLS13:
512 return "brainpool256r1";
513 case Group_Params::BRAINPOOL384R1:
514 case Group_Params::BRAINPOOL384R1TLS13:
515 return "brainpool384r1";
516 case Group_Params::BRAINPOOL512R1:
517 case Group_Params::BRAINPOOL512R1TLS13:
518 return "brainpool512r1";
530 return "RawPublicKey";
537 if(type_str ==
"X509") {
539 }
else if(type_str ==
"RawPublicKey") {
static bool supports_named_group(std::string_view name)
bool is_available() const
std::optional< std::string > to_algorithm_spec() const
constexpr bool is_dh_named_group() const
constexpr bool is_in_ffdhe_range() const
bool is_available() const
constexpr bool is_pqc_hybrid() const
constexpr bool is_kem() const
constexpr bool is_ecdh_named_curve() const
constexpr bool is_pure_frodokem() const
std::optional< Group_Params_Code > pqc_hybrid_ecc() const
std::optional< std::string > to_string() const
static std::optional< Group_Params > from_string(std::string_view group_name)
constexpr bool is_pure_ml_kem() const
constexpr bool is_x448() const
constexpr bool is_pure_ecc_group() const
constexpr bool is_x25519() const
bool is_pre_tls_13() const
Kex_Algo kex_method_from_string(std::string_view str)
std::string certificate_type_to_string(Certificate_Type type)
bool group_usable_in_version(Group_Params group, Protocol_Version version)
Auth_Method auth_method_from_string(std::string_view str)
std::string kdf_algo_to_string(KDF_Algo algo)
std::vector< Group_Params > groups_usable_in_version(std::span< const Group_Params > groups, Protocol_Version version)
bool group_may_be_ecc(Group_Params group)
std::string kex_method_to_string(Kex_Algo method)
std::string auth_method_to_string(Auth_Method method)
@ HYBRID_X448_eFRODOKEM_976_SHAKE_OQS
@ HYBRID_X25519_ML_KEM_768
@ HYBRID_X25519_eFRODOKEM_640_SHAKE_OQS
@ HYBRID_X448_eFRODOKEM_976_AES_OQS
@ HYBRID_SECP256R1_ML_KEM_768
@ HYBRID_SECP256R1_eFRODOKEM_640_SHAKE_OQS
@ HYBRID_SECP521R1_eFRODOKEM_1344_SHAKE_OQS
@ HYBRID_SECP384R1_eFRODOKEM_976_AES_OQS
@ HYBRID_SECP256R1_eFRODOKEM_640_AES_OQS
@ HYBRID_SECP384R1_ML_KEM_1024
@ HYBRID_X25519_eFRODOKEM_640_AES_OQS
@ HYBRID_SECP521R1_eFRODOKEM_1344_AES_OQS
@ HYBRID_SECP384R1_eFRODOKEM_976_SHAKE_OQS
Certificate_Type certificate_type_from_string(const std::string &type_str)
std::string fmt(std::string_view format, const T &... args)