diff -r 000000000000 -r 094583676ce7 wvsettings20/IMPSSrc/CIMPSSAPSecurer.h --- /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 + +// 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__ +