Botan::SessionKeys Class Reference

#include <tls_session_key.h>

Public Member Functions
SymmetricKey	client_cipher_key () const
InitializationVector	client_iv () const
SymmetricKey	client_mac_key () const
SecureVector< byte >	master_secret () const
SymmetricKey	server_cipher_key () const
InitializationVector	server_iv () const
SymmetricKey	server_mac_key () const
	SessionKeys ()
	SessionKeys (const CipherSuite &, Version_Code, const MemoryRegion< byte > &, const MemoryRegion< byte > &, const MemoryRegion< byte > &)

Detailed Description

TLS Session Keys

Definition at line 20 of file tls_session_key.h.

Constructor & Destructor Documentation

SessionKeys() [1/2]

Botan::SessionKeys::SessionKeys ( )

inline

Definition at line 34 of file tls_session_key.h.

{}

SessionKeys() [2/2]

Botan::SessionKeys::SessionKeys	(	const CipherSuite &	suite,
		Version_Code	version,
		const MemoryRegion< byte > &	pre_master_secret,
		const MemoryRegion< byte > &	c_random,
		const MemoryRegion< byte > &	s_random )

SessionKeys Constructor

Definition at line 129 of file tls_session_key.cpp.

   {
   if(version != SSL_V3 && version != TLS_V10 && version != TLS_V11)
      throw Invalid_Argument("SessionKeys: Unknown version code");
 
   const size_t mac_keylen = output_length_of(suite.mac_algo());
   const size_t cipher_keylen = suite.cipher_keylen();
 
   size_t cipher_ivlen = 0;
   if(have_block_cipher(suite.cipher_algo()))
      cipher_ivlen = block_size_of(suite.cipher_algo());
 
   const size_t prf_gen = 2 * (mac_keylen + cipher_keylen + cipher_ivlen);
 
   SymmetricKey keyblock = (version == SSL_V3) ?
      ssl3_keygen(prf_gen, pre_master_secret, c_random, s_random) :
      tls1_keygen(prf_gen, pre_master_secret, c_random, s_random);
 
   const byte* key_data = keyblock.begin();
 
   c_mac = SymmetricKey(key_data, mac_keylen);
   key_data += mac_keylen;
 
   s_mac = SymmetricKey(key_data, mac_keylen);
   key_data += mac_keylen;
 
   c_cipher = SymmetricKey(key_data, cipher_keylen);
   key_data += cipher_keylen;
 
   s_cipher = SymmetricKey(key_data, cipher_keylen);
   key_data += cipher_keylen;
 
   c_iv = InitializationVector(key_data, cipher_ivlen);
   key_data += cipher_ivlen;
 
   s_iv = InitializationVector(key_data, cipher_ivlen);
   }

References Botan::OctetString::begin(), Botan::block_size_of(), Botan::CipherSuite::cipher_algo(), Botan::CipherSuite::cipher_keylen(), Botan::have_block_cipher(), Botan::CipherSuite::mac_algo(), Botan::output_length_of(), Botan::SSL_V3, Botan::TLS_V10, and Botan::TLS_V11.

Member Function Documentation

client_cipher_key()

SymmetricKey Botan::SessionKeys::client_cipher_key

(

)

const

Return the client cipher key

Definition at line 18 of file tls_session_key.cpp.

   {
   return c_cipher;
   }

Referenced by Botan::Record_Reader::set_keys(), and Botan::Record_Writer::set_keys().

client_iv()

InitializationVector Botan::SessionKeys::client_iv

(

)

const

Return the client cipher IV

Definition at line 50 of file tls_session_key.cpp.

   {
   return c_iv;
   }

Referenced by Botan::Record_Reader::set_keys(), and Botan::Record_Writer::set_keys().

client_mac_key()

SymmetricKey Botan::SessionKeys::client_mac_key

(

)

const

Return the client MAC key

Definition at line 34 of file tls_session_key.cpp.

   {
   return c_mac;
   }

Referenced by Botan::Record_Reader::set_keys(), and Botan::Record_Writer::set_keys().

master_secret()

SecureVector< byte > Botan::SessionKeys::master_secret

(

)

const

Return the TLS master secret

Definition at line 66 of file tls_session_key.cpp.

   {
   return master_sec;
   }

server_cipher_key()

SymmetricKey Botan::SessionKeys::server_cipher_key

(

)

const

Return the server cipher key

Definition at line 26 of file tls_session_key.cpp.

   {
   return s_cipher;
   }

Referenced by Botan::Record_Reader::set_keys(), and Botan::Record_Writer::set_keys().

server_iv()

InitializationVector Botan::SessionKeys::server_iv

(

)

const

Return the server cipher IV

Definition at line 58 of file tls_session_key.cpp.

   {
   return s_iv;
   }

Referenced by Botan::Record_Reader::set_keys(), and Botan::Record_Writer::set_keys().

server_mac_key()

SymmetricKey Botan::SessionKeys::server_mac_key

(

)

const

Return the server MAC key

Definition at line 42 of file tls_session_key.cpp.

   {
   return s_mac;
   }

Referenced by Botan::Record_Reader::set_keys(), and Botan::Record_Writer::set_keys().

---

The documentation for this class was generated from the following files:

• src/ssl/tls_session_key.h
• src/ssl/tls_session_key.cpp