eapol/eapol_framework/eapol_common/include/eapol_session_key.h
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Mon, 18 Jan 2010 20:22:35 +0200
changeset 2 1c7bc153c08e
parent 0 c8830336c852
child 26 9abfd4f00d37
permissions -rw-r--r--
Revision: 201001 Kit: 201003

/*
* 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: 5 %
*/

#if !defined(_EAPOL_SESSION_KEY_H_)
#define _EAPOL_SESSION_KEY_H_

#include "eap_variable_data.h"
#include "eapol_key_types.h"
#include "eap_am_export.h"


/// A eapol_session_key_c class.
/// This is used for session key encapsulation.
class EAP_EXPORT eapol_session_key_c
{
private:
	//--------------------------------------------------

	abs_eap_am_tools_c * const m_am_tools; ///< This is pointer to the tools class. @see abs_eap_am_tools_c.

	eap_variable_data_c m_key; ///< Here is the key.

	eap_variable_data_c m_sequence_number; ///< Here is the current sequence number for GTK. NOTE m_key_type should be GTK.

	eapol_key_type_e m_key_type; ///< This the type of the key.

	u32_t m_key_index; ///< This is the index of the key.

	bool m_key_tx_bit; ///< This is the TX bit of the key.

	bool m_is_valid;

	//--------------------------------------------------
protected:
	//--------------------------------------------------

	//--------------------------------------------------
public:
	//--------------------------------------------------

	/**
	 * The destructor of the eapol_session_key_c class does nothing special.
	 */
	EAP_FUNC_IMPORT virtual ~eapol_session_key_c();

	/**
	 * The constructor of the eapol_session_key_c class does nothing special.
	 */
	EAP_FUNC_IMPORT eapol_session_key_c(
		abs_eap_am_tools_c * const tools,
		eap_variable_data_c * const key, ///< Here is the key.
		const eapol_key_type_e key_type, ///< This the type of the key.
		const u32_t key_index, ///< This is the index of the key.
		const bool key_tx_bit, ///< This is the TX bit of the key.
		const u8_t * const key_RSC, ///< This is the RSC counter
		const u32_t key_RSC_size ///< This is the size of RSC counter
		);

	/**
	 * The constructor of the eapol_session_key_c class does nothing special.
	 */
	EAP_FUNC_IMPORT eapol_session_key_c(
		abs_eap_am_tools_c * const tools
		);

	EAP_FUNC_IMPORT const eap_variable_data_c * get_key() const;

	EAP_FUNC_IMPORT const eap_variable_data_c * get_sequence_number() const;

	EAP_FUNC_IMPORT eapol_key_type_e get_key_type() const;

	EAP_FUNC_IMPORT u32_t get_key_index() const;

	EAP_FUNC_IMPORT bool get_key_tx_bit() const;

	EAP_FUNC_IMPORT bool get_is_valid() const;


	EAP_FUNC_IMPORT eap_status_e set_key(const eap_variable_data_c * const key);

	EAP_FUNC_IMPORT eap_status_e set_sequence_number(eap_variable_data_c * const sequence_number);

	EAP_FUNC_IMPORT void set_key_type(const eapol_key_type_e key_type);

	EAP_FUNC_IMPORT void set_key_index(const u32_t key_index);

	EAP_FUNC_IMPORT void set_key_tx_bit(const bool key_tx_bit);

	EAP_FUNC_IMPORT static eap_const_string get_eapol_key_type_string(
		const eapol_key_type_e key_type);

	//--------------------------------------------------
}; // class eapol_session_key_c

#endif //#if !defined(_EAPOL_SESSION_KEY_H_)

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



// End.