/*

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

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of "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:    SRTP Master key class.

*

*/

#ifndef __SRTP_MASTER_KEY_H__

#define __SRTP_MASTER_KEY_H__

// INCLUDES

#include <e32def.h>

#include <e32des8.h>

#include <e32base.h>

#include "srtpdef.h"

// STRUCT CLASSES

/**

* Contains an SRTP master key.

*/

class CSRTPMasterKey : public CBase

    {

    public: // constructor

        /**

        * Two-phased constructor.

        * CSRTPCryptoContext takes the ownership of MasterKey and MasterSalt 

        * @param aKey  The master key value. Local copy is made.

        * @param aMKI  The master key identifier value. Local copy is made.

        *   			MKI key is optional so if there is no MKI key then 

        *				gives empty string "".

        * @param aN_E  The bit length of the encryption key

        * @param aN_A  The bit length of the authentication key

        * @leave KErrNone if success, system-wide error code otherwise

        */

        IMPORT_C static CSRTPMasterKey* NewL( const TDesC8& aKey, 

                       const TDesC8& aMKI, 

                       TUint aN_E = KSRTPDefSessionEncryptionKeyLength, 

                       TUint aN_A = KSRTPDefSessionAuthenticationKeyLength );

        /**

        * Two-phased constructor.

        * CSRTPCryptoContext takes the ownership of MasterKey and MasterSalt 

        * @param aKey  The master key value. Local copy is made.

        * @param aMKI  The master key identifier value. Local copy is made.

        * @param aN_E  The bit length of the encryption key

        * @param aN_A  The bit length of the authentication key

        * @leave KErrNone if success, system-wide error code otherwise

        */

        IMPORT_C static CSRTPMasterKey* NewLC( const TDesC8& aKey, 

                       const TDesC8& aMKI, 

                       TUint aN_E = KSRTPDefSessionEncryptionKeyLength, 

                       TUint aN_A = KSRTPDefSessionAuthenticationKeyLength );

        /**

        * Destructor

        */

        ~CSRTPMasterKey();

        /*

		* Gets current master key value        

        * @return current master key value

        */                                

        IMPORT_C  const TDesC8& MasterKey() const;

        /*

		* Gets current MKI

        * @return current MKI

        */                                

        IMPORT_C  const TDesC8& MKI() const;

        /*

		* Gets current encryption key length

        * @return encryption key length

        */                                

        IMPORT_C  TUint EncrKeyLength() const;

        /*

		* Gets current authorization key length

        * @return authorization key length

        */                                

        IMPORT_C  TUint AuthKeyLength() const;

        /*

		* Check the validity of the whole SRTPMasterKey

        * @return validity of this SRTPMasterKey

        */

        IMPORT_C  TBool Valid() const;                         

    private: //methods

        CSRTPMasterKey( TUint aN_E, TUint aN_A );	              

        void ConstructL (  const TDesC8& aKey, 

                           const TDesC8& aMKI );

        /* assignment operator */

         const CSRTPMasterKey& operator=(const CSRTPMasterKey& aKey);      

    private: //data

        /**

        * The master key value.

        * The length of the key is determined by the Size() function.

        */

        HBufC8 *iKey;

        /**

        * The master key identifier value

        */

        HBufC8* iMKI;

        /**

        * The bit length of the encryption key

        */

        TUint iN_E;

        /**

        * The bit length of the authentication key

        */

        TUint iN_A;

        friend class CSRTPCryptoContext;

 	#ifdef EUNIT_TESTING

        friend class UT_CSRTPMasterKey;

    #endif 

    };

#endif // __SRTP_MASTER_KEY_H__