// Copyright (c) 2007-2009 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:

//

/**

 @file

 @publishedPartner

 @released

*/

#include <e32base.h>

#ifndef KEYASSOCIATION_H

#define KEYASSOCIATION_H

namespace StreamAccess

	{

	/**

 	Defines the key association abstraction. In streaming protection, keys can be used slightly differently

	for different protection layers. In IPSec they are used as a part of SA (Security Associations), while in SRTP they

	are used as the Master Key - used for deriving the decryption and the authentication keys.

 	*/

	class CKeyAssociation : public CBase

		{

	public:	 

		IMPORT_C virtual ~CKeyAssociation();

		};

	/**

 	Defines a key association for the IPSec protocol.

 	*/

	class CIpSecKeyAssociation : public CKeyAssociation

		{

	friend class CIpSecKeyStreamSink;

	public:

		 /** Constructs a new key association for IPSec.

		 @param aSpi The SPI (security parameter index) to be used.

		 @param aEncryptionKey The encryption key to be used in this association. Please note that the ownership on aEncryptionKey is passed to the newly created object.

		 @param aAuthenticationKey The authentication key to be used in this association. Please note that the ownership on aAuthenticationKey is passed to the newly created object.		 

		 @leave One of the system-wide error codes.

		 */

		 IMPORT_C static CIpSecKeyAssociation* NewL(TInt32 aSpi, HBufC8* aEncryptionKey, HBufC8* aAuthenticationKey);

		 /**

		 @see CIpSecKeyAssociation::NewL

		 */

		 IMPORT_C static CIpSecKeyAssociation* NewLC(TInt32 aSpi, HBufC8* aEncryptionKey, HBufC8* aAuthenticationKey);

	private:

		 TInt32 GetSpiL() const;

		 const HBufC8* GetEncryptionKeyL() const;

		 const HBufC8* GetAuthenticationKeyL() const;

	private:

		 CIpSecKeyAssociation(TInt32 aSpi, HBufC8* aEncryptionKey, HBufC8* aAuthenticationKey);

	private:

		 TInt32 iSpi;

		 HBufC8 *iEncryptionKey;

		 HBufC8 *iAuthenticationKey;

		};

	} // namespace StreamAccess

#endif // KEYASSOCIATION_H