wvsettings20/IMPSSrc/CIMPSSAPSecurer.h
changeset 0 094583676ce7
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/wvsettings20/IMPSSrc/CIMPSSAPSecurer.h	Thu Dec 17 08:41:52 2009 +0200
@@ -0,0 +1,128 @@
+/*
+* Copyright (c) 2005 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:  IMPS SAP Settings Store implementation.
+*
+*/
+
+
+#ifndef __CIMPSSAPSECURER_H__
+#define __CIMPSSAPSECURER_H__
+
+// INCLUDES
+#include <e32base.h>
+
+// FORWARD DECLARATIONS
+class C3DES; 				// 3DES block ciphers for encryption/decryption
+class CBlockTransformation;	// block transformer
+
+// CONST
+const TInt KSSS3DESKeySize = 24; // 24 bytes
+
+/**
+*  Implementation for CIMPSSAPSettingsStore.
+*  Handles the 3DES encryption and decryption of SAP passwords.
+*
+*  @see CIMPSSAPSettingStore
+*  @lib WVSAPSettings.dll
+*  @since 3.1
+*/
+NONSHARABLE_CLASS( CIMPSSAPSecurer ) : public CBase
+    {
+
+public:  // Constructors and destructor
+
+    /**
+    * Two-phased constructor.
+    */
+    static CIMPSSAPSecurer* NewL();
+
+    /**
+    * Destructor.
+    */
+    virtual ~CIMPSSAPSecurer();
+
+private: //Constructors
+
+    /**
+    * C++ default constructor.
+    */
+    CIMPSSAPSecurer();
+
+    /**
+    * By default Symbian 2nd phase constructor is private.
+    */
+    void ConstructL();
+
+public:
+
+    /**
+     * Encrypts given buffer and returns ownership
+     * of the buffer to calling object
+     *
+     * @param aPwdBuffer The password to be encrypted
+     * @return HBufC* Result of encryption
+     * @since 3.1
+     */
+    HBufC* EncryptPwdL( const TDesC& aPwdBuffer );
+
+    /**
+     * Decrypts given buffer and returns ownership
+     * of the buffer to calling object
+     *
+     * @param aPwdBuffer The password to be decrypted
+     * @return HBufC* Result of decryption
+     * @since 3.1
+     */
+    HBufC* DecryptPwdL( const TDesC& aPwdBuffer );
+
+public:
+
+    /**
+     * Fetches the phone's serial number (IMEI number).
+     *
+     * @param aImei Pointer to descriptor where the IMEI is saved.
+     * @since 3.1
+     */
+    void FetchIMEI( TPtr8& aImei );
+
+    /**
+     * Gets the encryption key for use with 3DES encryption.
+     *
+     * @param aKey Pointer to descriptor where the key is saved.
+     * @since 3.1
+     */
+
+    void GetPwdKeyL( TPtr8& aKey );
+
+private: // data
+
+    // Key for encrypting/decrypting user password in SAP container (own)
+    HBufC8* iEncryptionKey;
+
+    // A buffer for encryption/decryption handling to avoid
+    // reoccurring allocs (own)
+    HBufC8* iTransformBlock;
+
+    // Password encryptor (own)
+    CBlockTransformation* iEncryptor;
+
+    // Password decryptor (own)
+    CBlockTransformation* iDecryptor;
+
+    };
+
+
+
+#endif // __CIMPSSAPSECURER_H__
+