#include <tls_extensions.h>

Inheritance diagram for Botan::TLS::Server_Name_Indicator:

Public Member Functions
bool	empty () const override

std::string	host_name () const

virtual bool	is_implemented () const

std::vector< uint8_t >	serialize (Connection_Side whoami) const override

	Server_Name_Indicator (std::string_view host_name)

	Server_Name_Indicator (TLS_Data_Reader &reader, uint16_t extension_size)

Extension_Code	type () const override

Static Public Member Functions
static Extension_Code	static_type ()

Detailed Description

Server Name Indicator extension (RFC 3546)

Definition at line 121 of file tls_extensions.h.

Constructor & Destructor Documentation

◆ Server_Name_Indicator() [1/2]

Botan::TLS::Server_Name_Indicator::Server_Name_Indicator ( std::string_view host_name )

inlineexplicit

Definition at line 129 of file tls_extensions.h.

129 :

130 m_sni_host_name(host_name) {}

Botan::TLS::Server_Name_Indicator::host_name

std::string host_name() const

Definition: tls_extensions.h:135

◆ Server_Name_Indicator() [2/2]

Botan::TLS::Server_Name_Indicator::Server_Name_Indicator	(	TLS_Data_Reader &	reader,
		uint16_t	extension_size
	)

Definition at line 250 of file tls_extensions.cpp.

   {
   /*
   * This is used by the server to confirm that it knew the name
   */
   if(extension_size == 0)
      return;
 
   uint16_t name_bytes = reader.get_uint16_t();
 
   if(name_bytes + 2 != extension_size)
      throw Decoding_Error("Bad encoding of SNI extension");
 
   while(name_bytes)
      {
      uint8_t name_type = reader.get_byte();
      name_bytes--;
 
      if(name_type == 0) // DNS
         {
         m_sni_host_name = reader.get_string(2, 1, 65535);
         name_bytes -= static_cast<uint16_t>(2 + m_sni_host_name.size());
         }
      else // some other unknown name type
         {
         reader.discard_next(name_bytes);
         name_bytes = 0;
         }
      }
   }

References Botan::TLS::TLS_Data_Reader::discard_next(), Botan::TLS::TLS_Data_Reader::get_byte(), Botan::TLS::TLS_Data_Reader::get_string(), and Botan::TLS::TLS_Data_Reader::get_uint16_t().

Member Function Documentation

◆ empty()

bool Botan::TLS::Server_Name_Indicator::empty ( ) const

inlineoverridevirtual

Returns: if we should encode this extension or not

Implements Botan::TLS::Extension.

Definition at line 139 of file tls_extensions.h.

139{ return false; }

◆ host_name()

std::string Botan::TLS::Server_Name_Indicator::host_name ( ) const

inline

Definition at line 135 of file tls_extensions.h.

135{ return m_sni_host_name; }

◆ is_implemented()

virtual bool Botan::TLS::Extension::is_implemented ( ) const

inlinevirtualinherited

Returns: true if this extension is known and implemented by Botan

Reimplemented in Botan::TLS::Unknown_Extension.

Definition at line 113 of file tls_extensions.h.

113{ return true; }

◆ serialize()

std::vector< uint8_t > Botan::TLS::Server_Name_Indicator::serialize ( Connection_Side whoami ) const

overridevirtual

Returns: serialized binary for the extension

Implements Botan::TLS::Extension.

Definition at line 282 of file tls_extensions.cpp.

   {
   // RFC 6066
   //    [...] the server SHALL include an extension of type "server_name" in
   //    the (extended) server hello. The "extension_data" field of this
   //    extension SHALL be empty.
   if(whoami == Connection_Side::Server)
      {
      return {};
      }
 
   std::vector<uint8_t> buf;
 
   size_t name_len = m_sni_host_name.size();
 
   buf.push_back(get_byte<0>(static_cast<uint16_t>(name_len+3)));
   buf.push_back(get_byte<1>(static_cast<uint16_t>(name_len+3)));
   buf.push_back(0); // DNS
 
   buf.push_back(get_byte<0>(static_cast<uint16_t>(name_len)));
   buf.push_back(get_byte<1>(static_cast<uint16_t>(name_len)));
 
   buf += std::make_pair(
      cast_char_ptr_to_uint8(m_sni_host_name.data()),
      m_sni_host_name.size());
 
   return buf;
   }