22032365202

Committed 15 Feb 2026 08:16AM UTC coverage: 89.995% (-0.007%) from 90.002%

Build # 22032365202

Build Type

push

github

Committed by

web-flow

Commit Message

Merge pull request #5293 from Rohde-Schwarz/refactor/tls12_13_client_hello

Refactor: Disentangle Client_Hello implementations

Run Details

102265 of 113634 relevant lines covered (90.0%)

11422362.32 hits per line

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

85.59

/src/cli/tls_utils.cpp

/*
* (C) 2016 Jack Lloyd
*
* Botan is released under the Simplified BSD License (see license.txt)
*/

#include "cli.h"

#if defined(BOTAN_HAS_TLS) && defined(BOTAN_TARGET_OS_HAS_FILESYSTEM)

   #include <botan/hex.h>
   #include <botan/tls_ciphersuite.h>
   #include <botan/tls_messages.h>
   #include <botan/tls_version.h>
   #include <botan/internal/fmt.h>
   #include <botan/internal/loadstor.h>
   #include <botan/internal/stl_util.h>
   #include <sstream>

   #if defined(BOTAN_HAS_TLS_12) && defined(BOTAN_HAS_TLS_13)
      #include <botan/tls_messages_12.h>
      #include <botan/tls_messages_13.h>
   #endif

   #include "tls_helpers.h"

namespace Botan_CLI {

class TLS_Ciphersuites final : public Command {
   public:
      TLS_Ciphersuites() : Command("tls_ciphers --policy=default --version=tls1.2") {}

      static Botan::TLS::Protocol_Version tls_version_from_str(const std::string& str) {
         if(str == "tls1.2" || str == "TLS1.2" || str == "TLS-1.2") {
            return Botan::TLS::Protocol_Version::TLS_V12;
         }
         if(str == "dtls1.2" || str == "DTLS1.2" || str == "DTLS-1.2") {
            return Botan::TLS::Protocol_Version::DTLS_V12;
         } else {
            throw CLI_Error("Unknown TLS version '" + str + "'");
         }
      }

      std::string group() const override { return "tls"; }

      std::string description() const override { return "Lists all ciphersuites for a policy and TLS version"; }

      void go() override {
         const std::string policy_type = get_arg("policy");
         const Botan::TLS::Protocol_Version version = tls_version_from_str(get_arg("version"));

         auto policy = load_tls_policy(policy_type);

         if(!policy->acceptable_protocol_version(version)) {
            error_output() << "Error: the policy specified does not allow the given TLS version\n";
            return;
         }

         for(const uint16_t suite_id : policy->ciphersuite_list(version)) {
            const auto s = Botan::TLS::Ciphersuite::by_id(suite_id);
            output() << ((s) ? s->to_string() : "unknown cipher suite") << "\n";
         }
      }
};

BOTAN_REGISTER_COMMAND("tls_ciphers", TLS_Ciphersuites);

   #if defined(BOTAN_HAS_TLS_12) && defined(BOTAN_HAS_TLS_13)

class TLS_Client_Hello_Reader final : public Command {
   public:
      TLS_Client_Hello_Reader() : Command("tls_client_hello --hex input") {}

      std::string group() const override { return "tls"; }

      std::string description() const override { return "Parse a TLS client hello message"; }

      void go() override {
         const std::string input_file = get_arg("input");
         std::vector<uint8_t> input;

         if(flag_set("hex")) {
            input = Botan::hex_decode(slurp_file_as_str(input_file));
         } else {
            input = slurp_file(input_file);
         }

         if(input.size() < 45) {
            error_output() << "Input too short to be valid\n";
            return;
         }

         // Input also contains the record layer header, strip it
         if(input[0] == 22) {
            const size_t len = Botan::make_uint16(input[3], input[4]);

            if(input.size() != len + 5) {
               error_output() << "Record layer length invalid\n";
               return;
            }

            input = std::vector<uint8_t>(input.begin() + 5, input.end());
         }

         // Assume the handshake header is there, strip it
         if(input[0] == 1) {
            const size_t hs_len = Botan::make_uint32(0, input[1], input[2], input[3]);

            if(input.size() != hs_len + 4) {
               error_output() << "Handshake layer length invalid\n";
               return;
            }

            input = std::vector<uint8_t>(input.begin() + 4, input.end());
         }

         try {
            output() << format_hello([&]() -> std::variant<Botan::TLS::Client_Hello_13, Botan::TLS::Client_Hello_12> {
               auto data = Botan::TLS::Client_Hello_13::parse(input);
               if(std::holds_alternative<Botan::TLS::Client_Hello_13>(data)) {
                  return std::get<Botan::TLS::Client_Hello_13>(std::move(data));
               } else {
                  return Botan::TLS::Client_Hello_12(input);
               }
            }());
         } catch(std::exception& e) {
            error_output() << "Parsing client hello failed: " << e.what() << "\n";
         }
      }

   private:
      static std::string format_hello(
         const std::variant<Botan::TLS::Client_Hello_13, Botan::TLS::Client_Hello_12>& hello) {
         std::ostringstream oss;

         const auto* hello_base =
            std::visit([](const auto& ch) -> const Botan::TLS::Client_Hello* { return &ch; }, hello);

         const std::string version = std::visit(Botan::overloaded{
                                                   [](const Botan::TLS::Client_Hello_12&) { return "1.2"; },
                                                   [](const Botan::TLS::Client_Hello_13&) { return "1.3"; },
                                                },
                                                hello);

         oss << "Version: " << version << "\n"
             << "Random: " << Botan::hex_encode(hello_base->random()) << "\n";

         if(!hello_base->session_id().empty()) {
            oss << "SessionID: " << Botan::hex_encode(hello_base->session_id().get()) << "\n";
         }
         for(const uint16_t csuite_id : hello_base->ciphersuites()) {
            const auto csuite = Botan::TLS::Ciphersuite::by_id(csuite_id);
            if(csuite && csuite->valid()) {
               oss << "Cipher: " << csuite->to_string() << "\n";
            } else if(csuite_id == 0x00FF) {
               oss << "Cipher: EMPTY_RENEGOTIATION_INFO_SCSV\n";
            } else {
               oss << "Cipher: Unknown (" << std::hex << csuite_id << ")\n";
            }
         }

         oss << "Supported signature schemes: ";

         if(hello_base->signature_schemes().empty()) {
            oss << "Did not send signature_algorithms extension\n";
         } else {
            for(const Botan::TLS::Signature_Scheme scheme : hello_base->signature_schemes()) {
               try {
                  auto s = scheme.to_string();
                  oss << s << " ";
               } catch(...) {
                  oss << "(" << std::hex << static_cast<unsigned int>(scheme.wire_code()) << ") ";
               }
            }
            oss << "\n";
         }

         if(auto* sg = hello_base->extensions().get<Botan::TLS::Supported_Groups>()) {
            oss << "Supported Groups: ";
            for(const auto group : sg->groups()) {
               oss << group.to_string().value_or(Botan::fmt("Unknown group: {}", group.wire_code())) << " ";
            }
            oss << "\n";
         }

         std::map<std::string, bool> hello_flags;
         hello_flags["ALPN"] = hello_base->supports_alpn();

         std::visit(Botan::overloaded{
                       [&](const Botan::TLS::Client_Hello_12& ch12) {
                          hello_flags["Encrypt Then Mac"] = ch12.supports_encrypt_then_mac();
                          hello_flags["Extended Master Secret"] = ch12.supports_extended_master_secret();
                          hello_flags["Session Ticket"] = ch12.supports_session_ticket();
                       },
                       [&](const Botan::TLS::Client_Hello_13& ch13) {
                          if(auto* ks = ch13.extensions().get<Botan::TLS::Key_Share>()) {
                             oss << "Key Shares: ";
                             for(const auto group : ks->offered_groups()) {
                                oss << group.to_string().value_or(Botan::fmt("Unknown group: {}", group.wire_code()))
                                    << " ";
                             }
                             oss << "\n";
                          }
                       },
                    },
                    hello);

         for(auto&& i : hello_flags) {
            oss << "Supports " << i.first << "? " << (i.second ? "yes" : "no") << "\n";
         }

         return oss.str();
      }
};

BOTAN_REGISTER_COMMAND("tls_client_hello", TLS_Client_Hello_Reader);

   #endif

}  // namespace Botan_CLI

#endif

1	/*
2	* (C) 2016 Jack Lloyd
3	*
4	* Botan is released under the Simplified BSD License (see license.txt)
5	*/
6
7	#include "cli.h"
8
9	#if defined(BOTAN_HAS_TLS) && defined(BOTAN_TARGET_OS_HAS_FILESYSTEM)
10
11	#include <botan/hex.h>
12	#include <botan/tls_ciphersuite.h>
13	#include <botan/tls_messages.h>
14	#include <botan/tls_version.h>
15	#include <botan/internal/fmt.h>
16	#include <botan/internal/loadstor.h>
17	#include <botan/internal/stl_util.h>
18	#include <sstream>
19
20	#if defined(BOTAN_HAS_TLS_12) && defined(BOTAN_HAS_TLS_13)
21	#include <botan/tls_messages_12.h>
22	#include <botan/tls_messages_13.h>
23	#endif
24
25	#include "tls_helpers.h"
26
27	namespace Botan_CLI {
28
29	class TLS_Ciphersuites final : public Command {
30	public:
31	TLS_Ciphersuites() : Command("tls_ciphers --policy=default --version=tls1.2") {}	12✔
32
33	static Botan::TLS::Protocol_Version tls_version_from_str(const std::string& str) {	5✔
34	if(str == "tls1.2" \|\| str == "TLS1.2" \|\| str == "TLS-1.2") {	5✔
35	return Botan::TLS::Protocol_Version::TLS_V12;	5✔
36	}
37	if(str == "dtls1.2" \|\| str == "DTLS1.2" \|\| str == "DTLS-1.2") {	×
38	return Botan::TLS::Protocol_Version::DTLS_V12;	×
39	} else {
40	throw CLI_Error("Unknown TLS version '" + str + "'");	×
41	}
42	}
43
44	std::string group() const override { return "tls"; }	1✔
45
46	std::string description() const override { return "Lists all ciphersuites for a policy and TLS version"; }	1✔
47
48	void go() override {	5✔
49	const std::string policy_type = get_arg("policy");	5✔
50	const Botan::TLS::Protocol_Version version = tls_version_from_str(get_arg("version"));	10✔
51
52	auto policy = load_tls_policy(policy_type);	5✔
53
54	if(!policy->acceptable_protocol_version(version)) {	5✔
55	error_output() << "Error: the policy specified does not allow the given TLS version\n";	×
56	return;	×
57	}
58
59	for(const uint16_t suite_id : policy->ciphersuite_list(version)) {	119✔
60	const auto s = Botan::TLS::Ciphersuite::by_id(suite_id);	114✔
61	output() << ((s) ? s->to_string() : "unknown cipher suite") << "\n";	456✔
62	}	5✔
63	}	5✔
64	};
65
66	BOTAN_REGISTER_COMMAND("tls_ciphers", TLS_Ciphersuites);	6✔
67
68	#if defined(BOTAN_HAS_TLS_12) && defined(BOTAN_HAS_TLS_13)
69
70	class TLS_Client_Hello_Reader final : public Command {
71	public:
72	TLS_Client_Hello_Reader() : Command("tls_client_hello --hex input") {}	6✔
73
74	std::string group() const override { return "tls"; }	1✔
75
76	std::string description() const override { return "Parse a TLS client hello message"; }	1✔
77
78	void go() override {	2✔
79	const std::string input_file = get_arg("input");	2✔
80	std::vector<uint8_t> input;	2✔
81
82	if(flag_set("hex")) {	2✔
83	input = Botan::hex_decode(slurp_file_as_str(input_file));	4✔
84	} else {
85	input = slurp_file(input_file);	×
86	}
87
88	if(input.size() < 45) {	2✔
89	error_output() << "Input too short to be valid\n";	×
90	return;
91	}
92
93	// Input also contains the record layer header, strip it
94	if(input[0] == 22) {	2✔
95	const size_t len = Botan::make_uint16(input[3], input[4]);	2✔
96
97	if(input.size() != len + 5) {	2✔
98	error_output() << "Record layer length invalid\n";	×
99	return;
100	}
101
102	input = std::vector<uint8_t>(input.begin() + 5, input.end());	4✔
103	}
104
105	// Assume the handshake header is there, strip it
106	if(input[0] == 1) {	2✔
107	const size_t hs_len = Botan::make_uint32(0, input[1], input[2], input[3]);	2✔
108
109	if(input.size() != hs_len + 4) {	2✔
110	error_output() << "Handshake layer length invalid\n";	×
111	return;
112	}
113
114	input = std::vector<uint8_t>(input.begin() + 4, input.end());	4✔
115	}
116
117	try {	2✔
118	output() << format_hello([&]() -> std::variant<Botan::TLS::Client_Hello_13, Botan::TLS::Client_Hello_12> {	6✔
119	auto data = Botan::TLS::Client_Hello_13::parse(input);	2✔
120	if(std::holds_alternative<Botan::TLS::Client_Hello_13>(data)) {	2✔
121	return std::get<Botan::TLS::Client_Hello_13>(std::move(data));	1✔
122	} else {
123	return Botan::TLS::Client_Hello_12(input);	2✔
124	}
125	}());	8✔
126	} catch(std::exception& e) {	×
127	error_output() << "Parsing client hello failed: " << e.what() << "\n";	×
128	}	×
129	}	2✔
130
131	private:
132	static std::string format_hello(	2✔
133	const std::variant<Botan::TLS::Client_Hello_13, Botan::TLS::Client_Hello_12>& hello) {
134	std::ostringstream oss;	2✔
135
136	const auto* hello_base =	2✔
137	std::visit([](const auto& ch) -> const Botan::TLS::Client_Hello* { return &ch; }, hello);	2✔
138
139	const std::string version = std::visit(Botan::overloaded{	4✔
140	[](const Botan::TLS::Client_Hello_12&) { return "1.2"; },	1✔
141	[](const Botan::TLS::Client_Hello_13&) { return "1.3"; },
142	},
143	hello);	3✔
144
145	oss << "Version: " << version << "\n"	2✔
146	<< "Random: " << Botan::hex_encode(hello_base->random()) << "\n";	2✔
147
148	if(!hello_base->session_id().empty()) {	2✔
149	oss << "SessionID: " << Botan::hex_encode(hello_base->session_id().get()) << "\n";	2✔
150	}
151	for(const uint16_t csuite_id : hello_base->ciphersuites()) {	43✔
152	const auto csuite = Botan::TLS::Ciphersuite::by_id(csuite_id);	41✔
153	if(csuite && csuite->valid()) {	41✔
154	oss << "Cipher: " << csuite->to_string() << "\n";	111✔
155	} else if(csuite_id == 0x00FF) {	4✔
156	oss << "Cipher: EMPTY_RENEGOTIATION_INFO_SCSV\n";	×
157	} else {
158	oss << "Cipher: Unknown (" << std::hex << csuite_id << ")\n";	4✔
159	}
160	}
161
162	oss << "Supported signature schemes: ";	2✔
163
164	if(hello_base->signature_schemes().empty()) {	2✔
165	oss << "Did not send signature_algorithms extension\n";	×
166	} else {
167	for(const Botan::TLS::Signature_Scheme scheme : hello_base->signature_schemes()) {	20✔
168	try {	18✔
169	auto s = scheme.to_string();	18✔
170	oss << s << " ";	18✔
171	} catch(...) {	18✔
172	oss << "(" << std::hex << static_cast<unsigned int>(scheme.wire_code()) << ") ";	×
173	}	×
174	}	2✔
175	oss << "\n";	2✔
176	}
177
178	if(auto* sg = hello_base->extensions().get<Botan::TLS::Supported_Groups>()) {	2✔
179	oss << "Supported Groups: ";	2✔
180	for(const auto group : sg->groups()) {	26✔
181	oss << group.to_string().value_or(Botan::fmt("Unknown group: {}", group.wire_code())) << " ";	96✔
182	}
183	oss << "\n";	2✔
184	}
185
186	std::map<std::string, bool> hello_flags;	2✔
187	hello_flags["ALPN"] = hello_base->supports_alpn();	2✔
188
189	std::visit(Botan::overloaded{	2✔
190	[&](const Botan::TLS::Client_Hello_12& ch12) {	1✔
191	hello_flags["Encrypt Then Mac"] = ch12.supports_encrypt_then_mac();	1✔
192	hello_flags["Extended Master Secret"] = ch12.supports_extended_master_secret();	1✔
193	hello_flags["Session Ticket"] = ch12.supports_session_ticket();	1✔
194	},	1✔
195	[&](const Botan::TLS::Client_Hello_13& ch13) {	1✔
196	if(auto* ks = ch13.extensions().get<Botan::TLS::Key_Share>()) {	1✔
197	oss << "Key Shares: ";	1✔
198	for(const auto group : ks->offered_groups()) {	2✔
199	oss << group.to_string().value_or(Botan::fmt("Unknown group: {}", group.wire_code()))	4✔
200	<< " ";	2✔
201	}	1✔
202	oss << "\n";	1✔
203	}
204	},	1✔
205	},
206	hello);
207
208	for(auto&& i : hello_flags) {	7✔
209	oss << "Supports " << i.first << "? " << (i.second ? "yes" : "no") << "\n";	7✔
210	}
211
212	return oss.str();	4✔
213	}	2✔
214	};
215
216	BOTAN_REGISTER_COMMAND("tls_client_hello", TLS_Client_Hello_Reader);	3✔
217
218	#endif
219
220	} // namespace Botan_CLI
221
222	#endif

randombit / botan / 22032365202

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

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