/*

* Copyright (c) 2002-2008 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:  Client Class of ROAP Storage Server

*

*/

#ifndef ROAPSTORAGECLIENT_H

#define ROAPSTORAGECLIENT_H

#include <Oma2Agent.h>

//  INCLUDES

class CRSAPrivateKey;

class CRSAPublicKey;

class CDRMRIContext;

class CDRMDomainContext;

namespace Roap

    {

    // CLASS DECLARATION

    /**

    *  RRoapStorageClient

    *

    *  @lib drmserverinterfaces.lib

    *  @since Series 60 3.0

    */

    NONSHARABLE_CLASS( RRoapStorageClient ) : public RSessionBase

        {

    public:

        // Constructors and destructor

        /**

        * Two-phased constructor.

        */

        IMPORT_C RRoapStorageClient();

        /**

        * Destructor.

        */

        IMPORT_C virtual ~RRoapStorageClient();

    public:

        // New functions

        /**

        * ?member_description.

        * @since Series ?XX ?SeriesXX_version

        * @param ?arg1 ?description

        * @return ?description

        */

        //?type ?member_function( ?type ?arg1 );

        IMPORT_C TInt Connect();

        IMPORT_C TInt GetDevicePublicKeyL( CRSAPublicKey*& aPublicKey );

        IMPORT_C TInt GetDevicePublicKeyDerL( HBufC8*& aPublicKey );

        IMPORT_C TInt GetDevicePublicKeyHashL( TDes8& aHash );

        IMPORT_C TInt GetDeviceCertificateChainL(

            RPointerArray<HBufC8>& aCertChain );

        IMPORT_C TInt SignL( const TDesC8& aHash, HBufC8*& aSignature );

        IMPORT_C TInt RsaSignL( const TDesC8& aHash, HBufC8*& aSignature );

        IMPORT_C TBool VerifyL(

            const TDesC8& aSignature,

            const TDesC8& aHash,

            const RPointerArray<HBufC8>& aCertificateChain );

        IMPORT_C CDRMRIContext* GetRIContextL( const TDesC8& aRiID );

        IMPORT_C CDRMDomainContext* GetDomainContextL(

            const TDesC8& aDomainID );

        IMPORT_C void AddRIContextL( const CDRMRIContext& aRiContext );

        IMPORT_C void AddDomainContextL(

            const CDRMDomainContext& aDomainContext,

            const RPointerArray<HBufC8>& aMacs,

            const RPointerArray<HBufC8>& aDomainKeyElements,

            TKeyTransportScheme& aTransportScheme );

        IMPORT_C void DeleteRiContextL( const TDesC8& aRiID );

        IMPORT_C void DeleteDomainContextL( const TDesC8& aDomainID );

        IMPORT_C void DeleteExpiredRIsL( const TTime& aTime );

        IMPORT_C void DeleteExpiredDomainsL( const TTime& aTime );

        IMPORT_C void DeleteExpiredContextsL( const TTime& aTime );

        IMPORT_C void DeleteAllL();

        /*

        * WhiteListURLExistsL

        * @param aURL, url to be searched in white lists

        * @param (inout) aInPreconfiguredWhiteList

        *     as in parameter: define whether or not to search from

        *         pre-defined whitelist

        *         ETrue: given URL is not searched from whitelistURL

        *         EFalse: given URL is not searched from whitelistURL

        *     as out parameter: define whether or not url has been

        *         searched and found from pre-defined whitelist

        *         ETrue: parameter was initially false,

        *             hostname part of aURL does not match hostname part

        *             in any RI URL of any existing RI conext,

        *             and aURL matched at least one of pre-defined

        *             whitelist URLs

        *         EFalse otherwise

        *         @note EFalse also if hostname part of aURL

        *             matches any hostname part in any RI URLs

        *             of any existing RI context

        *

        * @return

        *     ETrue: aURL is in white list

        *     EFalse: aURL is not in white list

        */

        IMPORT_C TBool WhiteListURLExistsL( const TDesC8& aURL,

            TBool& aFromPreconfiguredWhiteList );

        IMPORT_C TInt SelectTrustedRootL(

            const RPointerArray<HBufC8>& aTrustedRoots,

            TDes8& aSelectedRoot ) const;

        IMPORT_C TInt SelectTrustedRootL( const TDesC8& aTrustedRoot ) const;

        IMPORT_C void

            GetTrustedRootsL( RPointerArray<HBufC8>& aTrustedRoots ) const;

        IMPORT_C HBufC8* GetRootCertificateL( const TDesC& aSubject ) const;

        IMPORT_C HBufC8* GetMeteringDataL(

            TDesC8& aRiId,

            TDes8& aMacKey,

            TDes8& aEncKeyHash,

            HBufC8*& aEncryptedMekAndMak );

        IMPORT_C void DeleteMeteringDataL( const TDesC8& aRiId );

        IMPORT_C void GetAllRIContextsL(

            RPointerArray<CDRMRIContext>& aRiContexts );

        IMPORT_C void UpdateRIContextL( const CDRMRIContext& aContext );

        IMPORT_C TBool UpdateDrmTimeL(

            const RPointerArray<HBufC8>& aCertChain,

            const RPointerArray<HBufC8>& aOCSPResponses,

            const TDesC8& aNonce );

        IMPORT_C TBool VerifyOcspResponsesL(

            const RPointerArray<HBufC8>& aOcspResponses,

            const TDesC8& aRiCaCert,

            const RPointerArray<HBufC8>& aCertSerialNums );

        IMPORT_C HBufC8* GetOcspResponderIdL( const TDesC8& aRiID );

    private:

        // Prohibit copy constructor if not deriving from CBase.

        RRoapStorageClient( const RRoapStorageClient& );

        // Prohibit assignment operator if not deriving from CBase.

        RRoapStorageClient& operator=( const RRoapStorageClient& );

        };

    }

#endif // ROAPSTORAGECLIENT_H

// End of File