/*

* Copyright (c) 2001-2006 Nokia Corporation and/or its subsidiary(-ies).

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of the License "Eclipse Public License v1.0"

* which accompanies this distribution, and is available

* at the URL "http://www.eclipse.org/legal/epl-v10.html".

*

* Initial Contributors:

* Nokia Corporation - initial contribution.

*

* Contributors:

*

* Description:  EAP and WLAN authentication protocols.

*

*/

/*

*/

#if !defined(_TLS_HANDSHAKE_MESSAGE_H_)

#define _TLS_HANDSHAKE_MESSAGE_H_

#include "eap_tools.h"

#include "eap_array.h"

#include "eap_variable_data.h"

#include "tls_handshake_header.h"

#include "tls_peap_types.h"

#include "abs_tls_message_hash.h"

#if defined(USE_EAP_TLS_SESSION_TICKET)

#include "tls_extension.h"

#endif // #if defined(USE_EAP_TLS_SESSION_TICKET)

/** @file */

//----------------------------------------------------------------------------

/// This class defines one TLS handshake message.

/**

 * This is class of the TLS-handshake message.

 * The parse_tls_protocol_handshake() function parses each TLS-handshake message

 * and generates this object. Parse and analyse of TLS-handshake is asyncronous.

 * m_is_analysed tells this message is analysed.

 * Analysed messages are skipped during the asyncronous

 * analyse of messages. Asyncronous analyse is needed

 * because of the PKI functions are asyncronous in

 * Symbian.

 */

{

private:

	//--------------------------------------------------

	/// This is pointer to the tools class. @see abs_eap_am_tools_c.

	abs_eap_am_tools_c * const m_am_tools;

	/// This is pointer to interface of message HASH creation. See abs_tls_message_hash_c.

	abs_tls_message_hash_c * const m_message_hash;

	/// This buffer includes data of the handshake message.

	eap_variable_data_c m_tls_handshake_message_buffer;

	/// This The current time and date in standard UNIX 32-bit format (seconds

	/// since the midnight starting Jan 1, 1970, GMT) according to the sender's internal clock.

	eap_variable_data_c m_unix_time; 

	/// 28 bytes generated by a secure random number generator.

	eap_variable_data_c m_random_value;

	/// This is variable length. If not empty, the value identifies a session between the

	/// same client and server whose security parameters the client wishes to reuse.

	eap_variable_data_c m_session_id; 

	/// This is list of cipher suites.

	eap_array_c<u16_t> m_cipher_suites;

	/// This is list of compression methods.

	eap_array_c<u8_t> m_compression_methods;

#if defined(USE_EAP_TLS_SESSION_TICKET)

	/// This is list of TLS extensions.

	eap_array_c<tls_extension_c> m_tls_extensions;

#endif // #if defined(USE_EAP_TLS_SESSION_TICKET)

	/// This is certificate chain.

	eap_array_c<eap_variable_data_c> m_certificate_chain;

	/// This is list of certificaet authorities.

	eap_array_c<eap_variable_data_c> m_certificate_authorities;

	/// This is list of certificaet types.

	eap_array_c<u8_t> m_certificate_types;

	/// This is encrypted premaster secret.

	eap_variable_data_c m_encrypted_premaster_secret;

	/// This is ephemeral Diffie-Hellman public key.

	eap_variable_data_c m_public_dhe_key;

	/// This is ephemeral Diffie-Hellman prime.

	eap_variable_data_c m_dhe_prime;

	/// This is ephemeral Diffie-Hellman group generator.

	eap_variable_data_c m_dhe_group_generator;

	/// This is signed message hash.

	eap_variable_data_c m_signed_message_hash;

	/// This is finished data of TLS-Handshake/Finished message.

	eap_variable_data_c m_finished_data;

	/// This is the selected cipher suite.

	tls_cipher_suites_e m_selected_cipher_suite;

	/// This is the selected compression method.

	tls_compression_method_e m_selected_compression_method;

	/// This is handshake type. See tls_handshake_type_e.

	tls_handshake_type_e m_handshake_type;

	/// This flag tells this message is analysed.

	bool m_is_analysed;

	/// This indicates whether this object was generated successfully.

	bool m_is_valid;

	/// This indicates whether this object is client (true) or server (false).

	bool m_is_client;

	//--------------------------------------------------

	/**

	 * The set_is_valid() function sets the state of the object valid.

	 * The creator of this object calls this function after it is initialized. 

	 */

		u16_t * const value,

		abs_eap_am_tools_c * const m_am_tools);

	//--------------------------------------------------

protected:

	//--------------------------------------------------

	//--------------------------------------------------

public:

	//--------------------------------------------------

	/**

	 * The destructor of the tls_handshake_message_c class does nothing special.

	 */

	/**

	 * The constructor of the tls_handshake_message_c class simply initializes the attributes.

	 */

		abs_eap_am_tools_c * const tools,

		abs_tls_message_hash_c * const message_hash,

		const bool is_client);

	/**

	 * Object must indicate it's validity.

	 * If object initialization fails this function must return false.

	 * @return This function returns the validity of this object.

	 */

	/**

	 * This function sets this message is analysed.

	 */

	/**

	 * This function returns whether message is analysed (true) or not (false).

	 */

	/**

	 * This function creates data of the Handshake message to internal buffer.

	 * Later this data is added to final TLS-record buffer.

	 */

	/**

	 * This function copies the appropriate fields of the TLS-handshake message.

	 */

	/**

	 * This function sets the type of TLS-handshake message.

	 */

	/**

	 * This function returns the type of TLS-handshake message.

	 */

	/**

	 * This function copies the list of the cipher suites.

	 */

		EAP_TEMPLATE_CONST eap_array_c<u16_t> * const cipher_suites);

	/**

	 * This function returns the list of the cipher suites.

	 */

	/**

	 * This function copies the list of the compression methods.

	 */

		EAP_TEMPLATE_CONST eap_array_c<u8_t> * const compression_methods);

	/**

	 * This function returns the list of the compression methods.

	 */

#if defined(USE_EAP_TLS_SESSION_TICKET)

	/**

	 * This function copies the list of the TLS extensions.

	 */

		EAP_TEMPLATE_CONST eap_array_c<tls_extension_c> * const compression_methods);

#endif // #if defined(USE_EAP_TLS_SESSION_TICKET)

#if defined(USE_EAP_TLS_SESSION_TICKET)

	/**

	 * This function returns the list of the TLS extensions.

	 */

#endif // #if defined(USE_EAP_TLS_SESSION_TICKET)

	/**

	 * This function copies the random value.

	 */

		const eap_variable_data_c * const random_value);

	/**

	 * This function returns the random value.

	 */

	/**

	 * This function copies the session id.

	 */

		const eap_variable_data_c * const session_id);

	/**

	 * This function returns the session id.

	 */

	/**

	 * This function copies the certificate chain.

	 */

		EAP_TEMPLATE_CONST eap_array_c<eap_variable_data_c> * const certificate_chain);

	/**

	 * This function returns the certificate chain.

	 */

	/**

	 * This function copies the list of the certificate authorities.

	 */

		EAP_TEMPLATE_CONST eap_array_c<eap_variable_data_c> * const certificate_authorities);

	/**

	 * This function returns the list of the certificate authorities.

	 */

	/**

	 * This function copies the list of the certificate types.

	 */

		EAP_TEMPLATE_CONST eap_array_c<u8_t> * const certificate_types);

	/**

	 * This function returns the list of the certificate types.

	 */

	/**

	 * This function sets the list of the selected cipher suite.

	 */

	/**

	 * This function returns the list of the selected cipher suite.

	 */

	/**

	 * This function sets the list of the selected compression method.

	 */

	/**

	 * This function returns the list of the selected compression method.

	 */

	/**

	 * This function copies the encrypted premaster secret.

	 */

	/**

	 * This function returns the encrypted premaster secret.

	 */

	/**

	 * This function copies the ephemeral Diffie-Hellman public key.

	 */

	/**

	 * This function returns the ephemeral Diffie-Hellman public key.

	 */

	/**

	 * This function copies the ephemeral Diffie-Hellman prime.

	 */

	/**

	 * This function returns the ephemeral Diffie-Hellman prime.

	 */

	/**

	 * This function copies the ephemeral Diffie-Hellman group generator.

	 */

	/**

	 * This function returns the ephemeral Diffie-Hellman group generator.

	 */

	/**

	 * This function copies the signed message HASH.

	 */

	/**

	 * This function returns the signed message HASH.

	 */

	/**

	 * This function copies the TLS-finished data.

	 */

	/**

	 * This function returns the TLS-finished data.

	 */

	/**

	 * This function adds data of the TLS-handshake message to tls_message_buffer.

	 */

		eap_variable_data_c * const tls_message_buffer);

	// 

	//--------------------------------------------------

}; // class tls_handshake_message_c

//--------------------------------------------------

#endif //#if !defined(_TLS_HANDSHAKE_MESSAGE_H_)

// End.