#include <tls_extensions.h>

Inheritance diagram for Botan::TLS::SRTP_Protection_Profiles:

Public Member Functions
bool	empty () const override
virtual bool	is_implemented () const
const std::vector< uint16_t > &	profiles () const
std::vector< uint8_t >	serialize (Connection_Side whoami) const override
	SRTP_Protection_Profiles (std::vector< uint16_t > pp)
	SRTP_Protection_Profiles (TLS_Data_Reader &reader, uint16_t extension_size)
	SRTP_Protection_Profiles (uint16_t pp)
Extension_Code	type () const override

Static Public Member Functions
static Extension_Code	static_type ()

Detailed Description

Used to indicate SRTP algorithms for DTLS (RFC 5764)

Definition at line 332 of file tls_extensions.h.

Constructor & Destructor Documentation

◆ SRTP_Protection_Profiles() [1/3]

Botan::TLS::SRTP_Protection_Profiles::SRTP_Protection_Profiles ( std::vector< uint16_t > pp )

inlineexplicit

Definition at line 344 of file tls_extensions.h.

344: m_pp(std::move(pp)) {}

◆ SRTP_Protection_Profiles() [2/3]

Botan::TLS::SRTP_Protection_Profiles::SRTP_Protection_Profiles ( uint16_t pp )

inlineexplicit

Definition at line 346 of file tls_extensions.h.

346: m_pp(1, pp) {}

◆ SRTP_Protection_Profiles() [3/3]

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

Definition at line 748 of file tls_extensions.cpp.

                                                                                                   {
   // RFC 5764 4.1.1: UseSRTPData consists of
   //    SRTPProtectionProfile SRTPProtectionProfiles<2..2^16-1>;
   //    opaque srtp_mki<0..255>;
   // for a wire size of 2 (profiles len) + 2*N + 1 (mki len) + mki_bytes,
   // with N >= 1.
   if(extension_size < 5) {
      throw Decoding_Error("Truncated SRTP protection extension");
   }
   const size_t max_profile_pairs = (static_cast<size_t>(extension_size) - 3) / 2;
   m_pp = reader.get_range<uint16_t>(2, 1, max_profile_pairs);
   const std::vector<uint8_t> mki = reader.get_range<uint8_t>(1, 0, 255);
 
   if(m_pp.size() * 2 + mki.size() + 3 != extension_size) {
      throw Decoding_Error("Bad encoding for SRTP protection extension");
   }
 
   if(!mki.empty()) {
      throw Decoding_Error("Unhandled non-empty MKI for SRTP protection extension");
   }
}

References Botan::TLS::TLS_Data_Reader::get_range().

Member Function Documentation

◆ empty()

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

inlineoverridevirtual

Predicate if a TLS extension should be included or not

Returns: true if this extension should be encoded, otherwise false

Implements Botan::TLS::Extension.

Definition at line 342 of file tls_extensions.h.

342{ return m_pp.empty(); }

◆ is_implemented()

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

inlinevirtualinherited

Predicate if the extension is known/implemented

Note: this exists primarily to support unknown extension handling and doesn't need to be overridden even in the custom extension case.

Returns: true if this extension is known

Reimplemented in Botan::TLS::Unknown_Extension.

Definition at line 113 of file tls_extensions.h.

113{ return true; }

◆ profiles()

const std::vector< uint16_t > & Botan::TLS::SRTP_Protection_Profiles::profiles ( ) const

inline

Definition at line 338 of file tls_extensions.h.

338{ return m_pp; }

◆ serialize()

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

overridevirtual

Serialize a TLS extension

Parameters

whoami which peer we are acting as in the protocol

Returns: serialized binary for the extension

Implements Botan::TLS::Extension.

Definition at line 770 of file tls_extensions.cpp.

                                                                              {
   std::vector<uint8_t> buf;
 
   const uint16_t pp_len = static_cast<uint16_t>(m_pp.size() * 2);
   buf.push_back(get_byte<0>(pp_len));
   buf.push_back(get_byte<1>(pp_len));
 
   for(const uint16_t pp : m_pp) {
      buf.push_back(get_byte<0>(pp));
      buf.push_back(get_byte<1>(pp));
   }
 
   buf.push_back(0);  // srtp_mki, always empty here
 
   return buf;
}