/*
* Copyright (c) 2003-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: Class definition of TUtlCrypto.
*
*/



#if !defined(__UTLCRYPTO_H__)
#define __UTLCRYPTO_H__

#include <e32std.h>

class CSymmetricCipher;
class CDH;
class CDHKeyPair;
class CMessageDigest;
class CDSASignature;
class TUtlCrypto;


class CUtlSymmetricCipher : public CBase
/** 
* Symmetric cipher
* @internalComponent
*/
    {
    friend class TUtlCrypto;
public:
    IMPORT_C ~CUtlSymmetricCipher();
    
    IMPORT_C void Process(const TDesC8& aInput, TDes8& aOutput);
    IMPORT_C void ProcessFinalL(const TDesC8& aInput, TDes8& aOutput);
    IMPORT_C TInt MaxOutputLength(TInt aInputTextLength) const;
    IMPORT_C TInt MaxFinalOutputLength(TInt aInputTextLength) const;
    IMPORT_C void Reset();
    IMPORT_C TInt BlockSize() const;
    IMPORT_C TInt KeySize() const;
private:
    CUtlSymmetricCipher();
private:
    CSymmetricCipher* iSymmetricCipher;
    };


class CUtlMessageDigest : public CBase
/** 
* Message digester
* @internalComponent
*/
    {
    friend class TUtlCrypto;
public:
    IMPORT_C ~CUtlMessageDigest();

    IMPORT_C CMessageDigest* ReplicateL(void);
    IMPORT_C void Update(const TDesC8& aMessage);
    IMPORT_C TPtrC8 Final(const TDesC8& aMessage);
    IMPORT_C TPtrC8 Final(void);
    IMPORT_C CMessageDigest* CopyL(void);
    IMPORT_C TInt BlockSize(void) const;
    IMPORT_C TInt HashSize(void) const;
    IMPORT_C void Reset(void);
    
private:
    CUtlMessageDigest();
private:
    CMessageDigest* iMessageDigest;
    };


class CUtlDiffieHellman : public CBase
/** 
* Diffie-Hellman key exchange
* @internalComponent
*/
    {
    friend class TUtlCrypto;
public:
    IMPORT_C ~CUtlDiffieHellman();
    IMPORT_C const HBufC8* GenerateXL(void);
    IMPORT_C const HBufC8* CompleteKL(const TDesC8& aY);
    
private:
    CUtlDiffieHellman();
private:
    CDHKeyPair*     iDhKeyPair;
    CDH*            iDhKeyAgreement;
    TInt            iModulusLength;
    };


class TUtlCrypto
/** 
* Crypto factory
* @internalComponent
*/
    {
public:
    enum TUtlSymmetricCipherId
        { 
        EUtlSymmetricCipherDesCbc,  ///< DES
        EUtlSymmetricCipher3DesCbc, ///< 3DES
        EUtlSymmetricCipherAesCbc   ///< AES
        };
    
    enum TUtlMessageDigestId
        { 
        EUtlMessageDigestMd5,       ///< MD5
        EUtlMessageDigestSha1       ///< SHA1
        };
    
    enum TUtlCryptoVersion
        { 
        EUtlCryptoVersionOld,       ///< not Symbian crypto library
        EUtlCryptoVersionSymbian1   ///< Symbian crypto library
        };
    
public:
    IMPORT_C static CUtlSymmetricCipher* MakeSymmetricEncryptorL(TUtlSymmetricCipherId aCipherId,
                                                                 const TDesC8& aKey,
                                                                 const TDesC8& aIv=KNullDesC8);
    IMPORT_C static CUtlSymmetricCipher* MakeSymmetricDecryptorL(TUtlSymmetricCipherId aCipherId,
                                                                 const TDesC8& aKey,
                                                                 const TDesC8& aIv=KNullDesC8);

    IMPORT_C static CUtlMessageDigest* MakeMessageDigesterL(TUtlMessageDigestId aDigestId,
                                                            const TDesC8&       aHmacKey=KNullDesC8);
    
    IMPORT_C static CUtlDiffieHellman* MakeDiffieHellmanL(const TDesC8& aN, const TDesC8& aG);

    IMPORT_C static void RsaPublicKeyEncryptL(const TDesC8&    aPublicKeyData,
                                              const TDesC8&    aPlaintext,
                                              HBufC8*&         aCiphertext);

    IMPORT_C static void RsaPublicKeyDecryptL(const TDesC8&    aPublicKeyData,
                                              const TDesC8&    aCiphertext,
                                              HBufC8*&         aPlaintext);

    IMPORT_C static TBool DsaVerifySignatureL(const TDesC8&       aPublicKeyData,
                                              const TDesC8&       aDsaParams,
                                              const TDesC8&       aDsaSignatureR,
                                              const TDesC8&       aDsaSignatureS,
                                              const TDesC8&       aHashData);
    
    IMPORT_C static TBool IsWeakCryptoLibrary(void);
    
    IMPORT_C static TUtlCryptoVersion CryptoVersion(void);
    };

#endif