#include <tls_session.h>

Inheritance diagram for Botan::TLS::Session_Base:

Public Member Functions
Ciphersuite	ciphersuite () const

uint16_t	ciphersuite_code () const

uint16_t	dtls_srtp_profile () const

const std::vector< X509_Certificate > &	peer_certs () const

std::shared_ptr< const Public_Key >	peer_raw_public_key () const

const Server_Information &	server_info () const

	Session_Base (std::chrono::system_clock::time_point start_time, Protocol_Version version, uint16_t ciphersuite, Connection_Side connection_side, uint16_t srtp_profile, bool extended_master_secret, bool encrypt_then_mac, std::vector< X509_Certificate > peer_certs, std::shared_ptr< const Public_Key > peer_raw_public_key, Server_Information server_info)

Connection_Side	side () const

std::chrono::system_clock::time_point	start_time () const

bool	supports_encrypt_then_mac () const

bool	supports_extended_master_secret () const

Protocol_Version	version () const

Protected Member Functions
	Session_Base ()=default

Protected Attributes
uint16_t	m_ciphersuite = 0

Connection_Side	m_connection_side {}

bool	m_encrypt_then_mac = false

bool	m_extended_master_secret = false

std::vector< X509_Certificate >	m_peer_certs

std::shared_ptr< const Public_Key >	m_peer_raw_public_key

Server_Information	m_server_info

uint16_t	m_srtp_profile = 0

std::chrono::system_clock::time_point	m_start_time

Protocol_Version	m_version

Detailed Description

Represents basic information about a session that can be both persisted for resumption and presented to the application as a summary of a specific just-established TLS session.

Definition at line 140 of file tls_session.h.

Constructor & Destructor Documentation

◆ Session_Base() [1/2]

Botan::TLS::Session_Base::Session_Base	(	std::chrono::system_clock::time_point	start_time,
		Protocol_Version	version,
		uint16_t	ciphersuite,
		Connection_Side	connection_side,
		uint16_t	srtp_profile,
		bool	extended_master_secret,
		bool	encrypt_then_mac,
		std::vector< X509_Certificate >	peer_certs,
		std::shared_ptr< const Public_Key >	peer_raw_public_key,
		Server_Information	server_info )

inline

Definition at line 142 of file tls_session.h.

                                                   :
            m_start_time(start_time),
            m_version(version),
            m_ciphersuite(ciphersuite),
            m_connection_side(connection_side),
            m_srtp_profile(srtp_profile),
            m_extended_master_secret(extended_master_secret),
            m_encrypt_then_mac(encrypt_then_mac),
            m_peer_certs(std::move(peer_certs)),
            m_peer_raw_public_key(std::move(peer_raw_public_key)),
            m_server_info(std::move(server_info)) {}

◆ Session_Base() [2/2]

Botan::TLS::Session_Base::Session_Base ( )

protecteddefault

Member Function Documentation

◆ ciphersuite()

Ciphersuite Botan::TLS::Session_Base::ciphersuite ( ) const

Get the ciphersuite info of the negotiated TLS session

Definition at line 86 of file tls_session.cpp.

                                            {
   auto suite = Ciphersuite::by_id(m_ciphersuite);
   if(!suite.has_value()) {
      throw Decoding_Error("Failed to find cipher suite for ID " + std::to_string(m_ciphersuite));
   }
   return suite.value();
}

References Botan::TLS::Ciphersuite::by_id(), and m_ciphersuite.

◆ ciphersuite_code()

uint16_t Botan::TLS::Session_Base::ciphersuite_code ( ) const

inline

Get the ciphersuite code of the negotiated TLS session

Definition at line 180 of file tls_session.h.

180{ return m_ciphersuite; }

Referenced by Botan::TLS::Client_Hello_12::Client_Hello_12(), and Botan::TLS::Session::Session().

◆ dtls_srtp_profile()

uint16_t Botan::TLS::Session_Base::dtls_srtp_profile ( ) const

inline

Get the negotiated DTLS-SRTP algorithm (RFC 5764)

Definition at line 195 of file tls_session.h.

195{ return m_srtp_profile; }

◆ peer_certs()

const std::vector< X509_Certificate > & Botan::TLS::Session_Base::peer_certs ( ) const

inline

Return the certificate chain of the peer (possibly empty)

Definition at line 212 of file tls_session.h.

212{ return m_peer_certs; }

◆ peer_raw_public_key()

std::shared_ptr< const Public_Key > Botan::TLS::Session_Base::peer_raw_public_key ( ) const

inline

Return the raw public key of the peer (possibly empty)

Definition at line 217 of file tls_session.h.

217{ return m_peer_raw_public_key; }

◆ server_info()

const Server_Information & Botan::TLS::Session_Base::server_info ( ) const

inline

Get information about the TLS server

Returns information that identifies the server side of the connection. This is useful for the client in that it identifies what was originally passed to the constructor. For the server, it includes the name the client specified in the server name indicator extension.

Definition at line 227 of file tls_session.h.

227{ return m_server_info; }

Referenced by Botan::TLS::Client_Hello_12::Client_Hello_12(), and Botan::TLS::Session_Manager_SQL::store().