/*

* 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.

*

*/

/*

* %version: %

*/

#if !defined(_EAP_TYPE_TLS_PEAP_H_)

#define _EAP_TYPE_TLS_PEAP_H_

#include "eap_tools.h"

#include "eap_am_export.h"

#include "abs_eap_am_type_tls_peap.h"

#include "eap_am_network_id.h"

#include "abs_eap_base_type.h"

#include "eap_base_type.h"

#include "eap_variable_data.h"

#include "abs_eap_base_timer.h"

#include "eap_crypto_api.h"

#include "eap_protocol_layer.h"

#include "eap_type_tls_peap_types.h"

#include "abs_tls_base_record.h"

#include "tls_record_header.h"

#include "eap_master_session_key.h"

class eap_tls_peap_header_c;

class abs_eap_am_tools_c;

class abs_eap_base_type_c;

class eap_am_type_tls_peap_c;

class tls_base_record_c;

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

/// This class is implementation of TLS/PEAP EAP type. See more detailed design and architecture document <a href="../../type/tls_peap/documentation/EAP_TLS_PEAP.doc">EAP_TLS_PEAP.doc</a>.

: public abs_eap_base_timer_c

, public eap_base_type_c

, public abs_eap_am_type_tls_peap_c

, public abs_tls_base_record_c

{

private:

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

	/// This is pointer to the tools class.

	abs_eap_am_tools_c * const m_am_tools;

	/// This is pointer to adaptation module of TLS/PEAP EAP type.

	eap_am_type_tls_peap_c * m_am_type_tls_peap;

	/// This is pointer to TLS implementation.

	tls_base_record_c * m_tls_record;

	/// This is the realm part of NAI of the authenticator.

	/// Client uses this as a realm part on the NAI.

	eap_variable_data_c m_nai_realm;

	/// This is the full NAI of the client.

	eap_variable_data_c m_NAI;

	/// This is the identity used in EAP-Identity.

	eap_variable_data_c m_current_identity;

	/// This is network identity of the sent packet from this authentication session.

	eap_am_network_id_c m_send_network_id;

	/// This is offset in bytes of the EAP-type header in the packet buffer.

	/// Offset is described in abs_eap_base_type_c::get_header_offset().

	u32_t m_tls_peap_header_offset;

	/// This is maximum transfer unit in bytes.

	/// MTU is described in abs_eap_base_type_c::get_header_offset().

	u32_t m_MTU;

	/// This is length of the trailer in bytes.

	/// Trailer length is described in abs_eap_base_type_c::get_header_offset().

	u32_t m_trailer_length;

	/// This is the state of this authentication session.

	eap_type_tls_peap_state_variable_e m_state;

	/// This is the saved previous state of this authentication session.

	eap_type_tls_peap_state_variable_e m_saved_previous_state;

	/// This is the state of reassembly.

	eap_type_tls_peap_reassembly_state_e m_reassembly_state;

	/// This is the saved previous state of reassembly.

	eap_type_tls_peap_reassembly_state_e m_saved_previous_reassembly_state;

	/// This is the offset of next fragment to be send from m_tls_message_buffer.

	u32_t m_tls_message_send_offset;

	/// This is the buffer for TLS-message reassembly and fragmentation.

	eap_variable_data_c m_tls_message_buffer;

	/// m_master_session_key.

	eap_master_session_key_c m_master_session_key;

	/// This is u32_t array of accepted PEAP versions.

	eap_variable_data_c m_accepted_PEAP_versions;

	/// This the current EAP-type (TLS, PEAP or TTLS).

	const eap_type_value_e m_current_eap_type;

	/// This separates different PEAP versions.

	/// This is the configured default PEAP version.

	peap_version_e m_configured_peap_version;

	/// This separates different PEAP versions.

	/// This is the current active PEAP version.

	peap_version_e m_current_peap_version;

	u8_t m_first_fragment_eap_identifier;

	tls_session_type_e m_tls_session_type;

	bool m_tunneled_eap_type_active;

	eap_state_variable_e m_tunneled_eap_type_authentication_state;

	bool m_free_am_type_tls_peap;

	bool m_free_tls_record;

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

	bool m_is_valid;

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

	/// In terms of EAP-protocol whether this network entity is EAP-supplicant (true) or EAP-authenticator (false).

	bool m_is_client;

	/// True value of this flag indicates the EAP-Success packet must be received

	/// in successfull authentication of clien.

	/// This value is configured with EAP_TLS_PEAP_wait_eap_success_packet.

	bool m_wait_eap_success_packet;

	/// True value of this flag indicates the identifier of the EAP-Response/Identity must be checked.

	/// This is not possible cases where identifier of the EAP-Request/Identity is generated by other network entities.

	bool m_check_identifier_of_eap_identity_response;

	/// True value means this is a test version of TLS/PEAP.

	bool m_tls_peap_test_version;

	/// This flag forces check of NAI realm. Realm must be the same as given in EAP_TLS_PEAP_manual_realm configuration option.

	/// Default value is false, check is not done by default.

	bool m_check_nai_realm;

#if defined(USE_EAP_TLS_IDENTITY_PRIVACY)

	/// Flag causes TLS to use identity privacy.

	bool m_tls_use_identity_privacy;

#endif //#if defined(USE_EAP_TLS_IDENTITY_PRIVACY)

	/// This flag indicates whether the EAP-Failure was received.

	/// On successfull authentication bogus EAP-Failure is ignored.

	bool m_failure_message_received;

	/// This variable is set true when authentication finished successfully.

	bool m_authentication_finished_successfully;

	/// This variable stores the last used EAP-Identifier.

	/// Client will always send EAP-Response with this identifier.

	/// Server will always send EAP-Request with this identifier increased by one.

	/// Server increase this identifier after successfull packet send.

	u8_t m_last_eap_identifier;

	/// This flag is set true when shutdown is called.

	/// This is for internal sanity check.

	bool m_shutdown_was_called;

	/// This configurable option selects whether the TLS/PEAP version of Tppd

	/// is used, the length field is added to all message fragments

	/// even the message fits to one fragment except EAP-TLS-start, EAP-TLS-Acknowledge and

	/// PEAP-application data. The client acknowledges tunneled EAP-Success message

	/// with empty PEAP message.

	bool m_use_tppd_tls_peap;

	/// On fast session resume server does not send tunneled EAP-Success.

	/// Instead it sends plain EAP-Success.

	/// True value of this flag allows this plain EAP-Success.

	bool m_use_tppd_peapv1_acknowledge_hack;

	/// This flag tells the send message includes TLS-Handshake message.

	/// Note the received messages are not marked.

	/// This information is needed in some PEAP versions.

	/// All messages including TLS-Handshake message must have PEAP L bit and four octet TLS message length field.

	bool m_includes_tls_handshake_message;

	bool m_use_eap_expanded_type;

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

	/**

	 * This function generates a new NAI from domain and identity.

	 */

		eap_variable_data_c * const new_nai, ///< This is the new generated NAI.

		const eap_variable_data_c * const domain, ///< This is the domain part of the NAI.

		const eap_variable_data_c * const identity ///< This is identity.

		);

	/**

	 * This function handles the received TLS/PEAP EAP packet.

	 *

	 * First is checked the valid massage is received in valid state.

	 *

	 * Second is parsed the payloads and checked syntax of the received TLS/PEAP EAP packet.

	 * See also parse_tls_peap_packet().

	 *

	 * Third is analysed the TLS/PEAP EAP packet. This includes the payload and values of each payload.

	 * See also analyse_tls_peap_packet().

	 */

		const eap_am_network_id_c * const receive_network_id, ///< This is the network identity of the received EAP packet.

		eap_tls_peap_header_c * const tls_peap, ///< This is pointer to EAP header including EAP-TLS/PEAP fields.

		const u32_t tls_peap_length ///< This is length of received TLS/PEAP EAP packet.

		);

	/**

	 * This function analyses the received TLS/PEAP EAP packet.

	 * Each sub-type is handled in separate function.

	 * @see Client messages are handled in handle_start_request_message() and handle_challenge_request_message(). 

	 * @see Server messages are handled in handle_start_response_message() and handle_challenge_response_message(). 

	 */

		const eap_am_network_id_c * const receive_network_id, ///< This is the network identity of the received EAP packet.

		eap_tls_peap_header_c * const received_tls_peap, ///< This is pointer to EAP header including EAP-TLS/PEAP fields.

		const u32_t tls_peap_packet_length ///< This is length of received TLS/PEAP EAP packet.

		);

	/**

	 * This function parses the payloads starting from specified payload (p_payload).

	 * Function parses all payloads from the buffer.

	 * Payloads are stored to p_tls_peap_payloads.

	 * @return If the length of the buffer and sum of the length of all payloads does not match

	 * function returns eap_status_header_corrupted.

	 * Also error is returned when illegal payload attribute is recognised.

	 */

		u32_t * const buffer_length ///< This is the length of the buffer. This must match with the length of all payloads.

		);

	/**

	 * This function checks the version list payload of the TLS/PEAP EAP packet is correct.

	 */

		const u16_t version_list_length,

		u8_t * version_list);

	/**

	 * This function parses all payloads of the whole TLS/PEAP EAP packet.

	 * Payloads are stored to p_tls_peap_payloads.

	 * @see parse_tls_peap_payload().

	 */

		eap_tls_peap_header_c * const tls_peap, ///< This is pointer to EAP header including EAP-TLS/PEAP fields.

		const u32_t tls_peap_packet_length ///< This is length of received TLS/PEAP EAP packet.

		);

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

	/**

	 * This function returns the domain name, realm part of NAI.

	 */

	/**

	 * This function returns the full NAI.

	 */

	/**

	 * This is the situation before the update_buffer_indexes() call.

	 * @code

	 * 

	 * |<---------buffer_offset-------->|<----------buffer_free----------------->|

	 * |                                |                                        |

	 * |          +-----+---------------+--------------------+                   |

	 * |          | EAP |  data         | new payload        |                   |

	 * |          +-----+---------------+--------------------+                   |

	 * |          |                                                              |

	 * |<-offset->|<----MTU----------------------------------------------------->|<-trailer->|

	 * |                                                                                     |

	 * |<-----------------------maximum_buffer_size----------------------------------------->|

	 *                                                                                    

	 * @endcode

	 *

	 * This is the situation after the update_buffer_indexes() call.

	 * @code

	 * 

	 * |<-----------------buffer_offset--------------------->|<---buffer_free--->|

	 * |                                                     |                   |

	 * |          +-----+---------------+--------------------+                   |

	 * |          | EAP |  data         | new payload        |                   |

	 * |          +-----+---------------+--------------------+                   |

	 * |          |                                                              |

	 * |<-offset->|<----MTU----------------------------------------------------->|<-trailer->|

	 * |                                                                                     |

	 * |<-----------------------maximum_buffer_size----------------------------------------->|

	 *

	 * @endcode

	 *

	 * Note maximum_buffer_size could be larger than (m_tls_peap_header_offset + m_MTU + m_trailer_length).

	 */

		const u32_t maximum_buffer_size,

		const u32_t payload_size,

		u32_t * const buffer_offset,

		u32_t * const buffer_free);

	/**

	 * This is the situation before the update_payload_indexes() call.

	 * @code

	 * 

	 * |<---------buffer_offset-------->|<----------buffer_free----------------->|

	 * |                                |                                        |

	 * |                |<-data_offset->|<--------data_free--------------------->|

	 * |                |               |                                        |

	 * |                |               |<---payload_size--->|                   |

	 * |                |               |                    |                   |

	 * |          +-----+---------------+--------------------+                   |

	 * |          | EAP |  data         | new payload        |                   |

	 * |          +-----+---------------+--------------------+                   |

	 * |          |                                                              |

	 * |<-offset->|<----MTU----------------------------------------------------->|<-trailer->|

	 * |                                                                                     |

	 * |<-----------------------maximum_buffer_size----------------------------------------->|

	 *                                                                                    

	 * @endcode

	 *

	 * This is the situation after the update_payload_indexes() call.

	 * @code

	 * 

	 * |<-----------------buffer_offset--------------------->|<---buffer_free--->|

	 * |                                                     |                   |

	 * |                |<----------data_offset------------->|<----data_free---->|

	 * |                |                                    |                   |

	 * |                |               |<---payload_size--->|                   |

	 * |                |               |                    |                   |

	 * |          +-----+---------------+--------------------+                   |

	 * |          | EAP |  data         | new payload        |                   |

	 * |          +-----+---------------+--------------------+                   |

	 * |          |                                                              |

	 * |<-offset->|<----MTU----------------------------------------------------->|<-trailer->|

	 * |                                                                                     |

	 * |<-----------------------maximum_buffer_size----------------------------------------->|

	 *

	 * @endcode

	 *

	 * Note maximum_buffer_size could be larger than (m_tls_peap_header_offset + m_MTU + m_trailer_length).

	 */

		const u32_t maximum_buffer_size,

		const u32_t eap_header_size,

		const u32_t payload_size,

		u32_t * const data_offset,

		u32_t * const data_free,

		u32_t * const buffer_offset,

		u32_t * const buffer_free);

	/**

	 * This function reads the identity payload. Identity is stored to handler->get_identity().

	 */

		const u8_t * const identity, ///< This is pointer to received EAP-Identity buffer.

		const u32_t identity_length ///< This is length of received EAP-Identity buffer.

		);

	/**

	 * This function handles the received EAP-Response/Identity message.

	 * First function parses the identity.

	 * The send_start_request_message() function will send the EAP-Request/SIM/Start message.

	 */

		eap_header_rd_c * const eap_header, ///< This is the received EAP-Identity packet, pointer points to the header.

		const u32_t tls_peap_packet_length ///< This is length of received TLS/PEAP EAP packet.

		);

	/**

	 * This function chechs NAI.

	 */

		const u8_t * const identity,

		const u32_t identity_length,

		const u8_t * const at_character);

	/**

	 * This function traces the EAP packet.

	 */

		eap_const_string prefix,

		const eap_am_network_id_c * const receive_network_id,

		eap_header_wr_c * const received_eap,

		const u32_t eap_packet_length);

	/**

	 * This function returns m_master_session_key.

	 */

	eap_master_session_key_c * get_master_session_key();

	/**

	 * This function finishes the successfull authentication.

	 * Generated keys are offered to lower layer.

	 * Connection handle is initialised.

	 */

		const bool send_tppd_peapv1_empty_acknowledge,

		const bool do_quiet_finish,

		const bool do_send_empty_acknowledge);

	/**

	 * This function sends a notification of possible failed authentication

	 * to lower layer.

	 */

	/**

	 * This function returns the state of this authentication session.

	 */

	/**

	 * This function sets the new state and notifies the lower layer of this change.

	 */

	/**

	 * This function saves the current m_state to m_saved_previous_state.

	 * The saved state is restored in error case.

	 */

	/**

	 * This function restores the saved state.

	 */

	/**

	 * This function returns the state of reassembly.

	 */

	/**

	 * This function sets the new reassembly state.

	 */

	/**

	 * This function saves the current m_reassembly_state to m_saved_previous_reassembly_state.

	 * The saved state is restored in error case.

	 */

	/**

	 * This function restores the saved reassembly state.

	 */

	/**

	 * This function returns the send network identity of this session.

	 */

	/**

	 * This function stores the last EAP-Identifier.

	 */

	/**

	 * This function returns the last stored EAP-Identifier.

	 */

	eap_status_e check_received_eap_identifier(

		const eap_header_wr_c * const eap_header);

	/**