/*

* Copyright (c) 2006 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:   The header file of TrustedSitesStore

*

*/

#ifndef __TRUSTEDSITESSTORE_H__

#define __TRUSTEDSITESSTORE_H__

#include <e32base.h>

class RDevTokenClientSession;

/**

 * Handle trusted sites store

 *

 * The class implementes the interface to handle the trust sites store.

 * Trusted sites are stored associated with certificates, which means for this

 * site the attached certificate is trusted.

 * 

 *  @lib DevTokenClient.dll

 *  @since S60 v3.2

 */

class CTrustSitesStore : public CBase

    {

    public:  

        IMPORT_C static CTrustSitesStore* NewL();

        IMPORT_C virtual ~CTrustSitesStore();

    public: // New functions

        /**

         * add new trust record to trust site store

         *

         * @param aCert a certificate

         * @param aSiteName trusted site name

         * @return 

         */

        IMPORT_C TInt AddL( const TDesC8& aCert, const TDesC& aTrustedSite );

        /**

         * add forgiven site 

         *

         * @param aSite the untrusted certificate from this site is allowed

         * @param aIsOutOfDateAllowed outofdate certificate is allowed 

         * @return 

         */

        IMPORT_C TInt AddForgivenSiteL( const TDesC& aSite, const TBool& aIsOutOfDateAllowed );        

        /**

         * Remove forgiven sites set by this client 

         *

         * @param aSite, empty then remove all of the forgiven sites set by the client

         *               otherwise, remove the given site from forgiven site list

         * @return 

         */

        IMPORT_C TInt RemoveForgivenSiteL( const TDesC& aSite = KNullDesC );

        /**

         * check whether the given cert is trusted for the given site

         *

         * @param aCert a certificate

         * @param aSiteName trusted site name

         * @return ETrue /EFalse

         */

        IMPORT_C TBool IsTrustedSiteL( const TDesC8& aCert, const TDesC& aTrustedSite );

        /**

         * check whether out of date certificate is allowed for this site

         *

         * @param aCertificate 

         * @param aTrustedSite 

         * @return ETrue/EFalse

         */

        IMPORT_C TBool IsOutOfDateAllowedL( const TDesC8& aCertificate, const TDesC& aTrustedSite );

        /**

         * list all of the sites for which the cert is trusted

         *

         * @param aCert a certificate

         * @param aListOfSites trusted sites' name

         * @param aMessage IPC message

         * @return ETrue /EFalse

         */

        IMPORT_C TInt GetTrustedSitesL( const TDesC8& aCert, RPointerArray<HBufC>& aListOfSites );

    private:

        CTrustSitesStore();

        void ConstructL();

        void FreeRequestBuffer();

        TInt AllocRequestBuffer(TInt aReqdSize);

        void SendSyncRequestAndHandleOverflowL(TInt aInitialBufSize,

                                               const TIpcArgs& aArgs);

    private:

        RDevTokenClientSession* iClientSession;

        HBufC8* iRequestDataBuf;    

        TPtr8 iRequestPtr;

    };

#endif //__TRUSTEDSITESSTORE_H__

//EOF