/*

 * Copyright (c) 2005-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: 

 * tcertuils.h

 *

 */

 /**

  @file 

  @internalTechnology

 */

 #ifndef __TCERTUTILS_H__

 #define __TCERTUTILS_H__

 #include <e32base.h>

 #include <x509cert.h>

 #include <unifiedcertstore.h>

 #include <pkixcertchain.h>

 #include "t_output.h"

 /**

 CCertUtils provides various functions often used in tests.

 This class has changed because the functions are asynchronous now. 

 The function are no longer static as we need an instance to serve as

 an active object.

 */

 class CCertUtils : public CActive

 	{

 public:

 	/**

 	 * This enumeration enumerates all the states used for the

 	 * RunL function.

 	 */

 	enum TState

 		{

 		EAddCACerts,

 		EAddCert,

 		EAddCACertGetCAEntry,

 		EAddCACertSetApplications,

 		EAddCACertSetTrust,

 		EAddCACertFinished,

 		ERemoveCertsGetCACerts,

 		ERemoveCertsCACertsRetrieved,

 		ERemoveCertsRemoveCACerts,

 		ERemoveCertsGetUserCerts,

 		ERemoveCertsUserCertsRetrieved,

 		ERemoveCertsRemoveUserCerts,

 		ERemoveCertsFinished

 		};	

 public:

 	IMPORT_C static CCertUtils* NewL(RFs& aFs);

 	IMPORT_C static CCertUtils* NewLC(RFs& aFs);

 	/**

 	The destructor destroys all the members of CCertUtils but only destroys

 	iStoreManager if the CCertStoreManager instance was created by this CCertUtils

 	instance. It doesn't destroy it if it was passed as an argument in the 

 	constructor.

 	*/

 	IMPORT_C virtual ~CCertUtils();

 	/**

 	Certificate handling functions

 	*/

 	IMPORT_C void AddCertL(const TDesC& aLabel, 

 							TCertificateFormat aFormat,

 							TCertificateOwnerType aCertificateOwnerType, 

 							TInt aTrustedUsage, 

 							const TDesC& aCertificatePath, 

 							const TDesC& aCertificateFileName, 

 							TRequestStatus& aStatus);

 	IMPORT_C void AddCert(const TDesC& aLabel, 

 							TCertificateFormat aFormat,

 							TCertificateOwnerType aCertificateOwnerType, 

 							TInt aTrustedUsage, 

 							const TDesC& aCertificatePath, 

 							const TDesC& aCertificateFileName, 

 							CUnifiedCertStore& aUnifiedCertStore, 

 							TRequestStatus& aStatus);

 	IMPORT_C void AddCACertsL(const CDesCArray& aRoots, 

 							const CDesCArray& aLabels,

 							TCertificateFormat aFormat, 

 							TInt aTrustedUsage, 

 							const TDesC& aPath, 

 							TRequestStatus& aStatus);

 	IMPORT_C void AddCACertsL(const CDesCArray& aRoots, 

 							const CDesCArray& aLabels,

 							TCertificateFormat aFormat, 

 							TInt aTrustedUsage, 

 							const TDesC& aPath, 

 							CUnifiedCertStore& aUnifiedCertStore, 

 							TRequestStatus& aStatus);

 	IMPORT_C void RemoveCertsL(TRequestStatus& aStatus);

 	IMPORT_C void RemoveCertsL(CUnifiedCertStore& aUnifiedCertStore, 

 							TRequestStatus& aStatus);

 	IMPORT_C static CCertificate* CertFromFileLC(const TDesC& aFilename, 

 							const TDesC& aPathname, 

 							RFs& aFs, 

 							TCertificateFormat aFormat);

 	IMPORT_C static CCertificate* CertFromFileL(const TDesC& aFilename,

 							const TDesC& aPathname, 

 							RFs& aFs, 

 							TCertificateFormat aFormat);

 	IMPORT_C static void WriteError(TValidationError aError, Output& aOut);

 	IMPORT_C static TPtrC MapError(TValidationError aError);

 	IMPORT_C static TValidationError MapError(const TDesC& aError);

 	IMPORT_C static TPtrC ParseElement(const TDesC& aBuf, const TDesC& aStart, const TDesC& aEnd, TInt& aPos, TInt& aError);

 	IMPORT_C HBufC* DiagnosticLC() const;

 	IMPORT_C void AddApplicationL(const TDesC& aName, TUid aUid) const;

 	IMPORT_C void RemoveApplicationL(TUid aUid) const;

 private:

 	/**

 	This constructor constructs a CCertUtils instance without initializing

 	iStoreManager. A store manager will be created if one is needed and

 	will be destroyed by the destructor.

 	@param aFs A file server session. The file server session must have opened.

 	*/

 	CCertUtils(RFs& aFs);

 	void ConstructL();

 	//Virtual from CActive

 	void RunL();

 	void DoCancel();

     TInt RunError(TInt aError);

 private:

 	// The following functions handle the different RunL states

 	void HandleEAddCACertsL();

 	void HandleEAddCACertL();

 	void HandleEAddCACertGetCAEntry();

 	void HandleEAddCACertSetApplicationsL();

 	void HandleEAddCACertSetTrust();

 	void HandleEAddCACertFinishedL();

 	void HandleERemoveCertsGetCACerts();

 	void HandleERemoveCertsCACertsRetrieved();

 	void HandleERemoveCertsRemoveCACerts();

 	void HandleERemoveCertsGetUserCerts();

 	void HandleERemoveCertsUserCertsRetrieved();

 	void HandleERemoveCertsRemoveUserCerts();

 	void HandleERemoveCertsFinished();

 private:

 	/**

 	File Server Sessioin

 	*/

 	RFs& iFs;

 	/**

 	The state used to know what RunL should do

 	*/

 	TState iState;

 	/**

 	The store managers will be used for certificate store operations,

 	*/

 	CUnifiedCertStore* iUnifiedCertStore;

 	CUnifiedCertStore* iCreatedUnifiedCertStore;

 	/**

 	These members are used to store the arguments of the functions

 	because most of the things are handled in a RunL.

 	*/

 	const CDesCArray* iRoots;					// Used by AddCertsL

 	const CDesCArray* iLabels;					// Used by AddCertsL

 	TCertificateFormat iFormat;

 	TInt iTrustedUsage;							// Used by AddCertsL, AddCert

 	RArray<TUid> iTrusters;						// Used by AddCertsL, AddCert

 	const TDesC* iPath;							// Used by AddCertsL, AddCert

 	TRequestStatus* iOriginalRequestStatus;		// Used by AddCertsL, AddCert

 	TInt iIndex;								// Used by AddCertsL to know 

 												// which certificate to add next

 												// Used by RemoveCerts

 	CCertUtils* iSecondCertUtils;				// Used by AddCertsL to add each individual

 												// certificate

 	const TDesC* iLabel;						// Used by AddCert

 	TCertificateOwnerType iCertificateOwnerType;

 	const TDesC* iCertificateFileName;			// Used by AddCert 

 	CCertificate* iCertificate;					// Used by AddCACert

 	MCTWritableCertStore *iStore;				// Used by AddCACert

 	TPtrC8 iEncoding;							// Used by AddCACert

 	HBufC* iCertData;

 	HBufC* iLabelData;

 	/**

 	This is a filter used by the GetCACerts function. We use the filter constructed

 	by the constructor with no argument, the filter doesn't filter anything.

 	*/

 	CCertAttributeFilter* iCAFilter;				// Used by RemoveCerts

 	RMPointerArray<CCTCertInfo> iCACertStoreEntries;	// Used by RemoveCerts

 	/**

 	This is a filter used by the GetUserCerts function. We use the filter constructed

 	by the constructot with no argument, the filter doesn't filter anything.

 	*/

 	CCertAttributeFilter* iUserFilter;			// Used by RemoveCerts

 	RMPointerArray<CCTCertInfo> iUserCertStoreEntries; // Used by RemoveCerts

 public:

 	/**

 	A diagnostic variable for when an error occurs. It stores the state at which

 	the error occurred.

 	*/

 	TState iDiagnosticState;

 	/** 

 	A diagnostic variable for when an error occurs. It is an info message set

 	to whatever is relevant for the error.

 	*/

 	TBuf<400> iDiagnosticMessage;

 	};

 #endif