21861369155

Committed 10 Feb 2026 01:47AM UTC coverage: 90.068% (-0.001%) from 90.069%

Build # 21861369155

Build Type

push

github

Committed by

web-flow

Commit Message

Merge pull request #5296 from randombit/jack/tls-header-patrol

Various changes to reduce header dependencies in TLS

Run Details

102224 of 113497 relevant lines covered (90.07%)

11437996.84 hits per line

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

85.98

/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_13)
      #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_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 {
            auto hello = Botan::TLS::Client_Hello_13::parse(input);

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

randombit / botan / 21861369155

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