diff -r 000000000000 -r 62f9d29f7211 webservices/wsutils/inc/sencryptoutils.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/webservices/wsutils/inc/sencryptoutils.h Thu Jan 07 16:19:19 2010 +0200 @@ -0,0 +1,129 @@ +/* +* Copyright (c) 2009 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: Header declaration +* +*/ + + + + +#ifndef C_SEN_CRYPTO_UTILS_H +#define C_SEN_CRYPTO_UTILS_H + +#include + + +/** + * Set of static convenience methods to help in cryptography + */ +class SenCryptoUtils + { + public: + /** + * Algorithm taken from of TLS specification RFC 2246 - 5.HMAC and the pseudorandom function + * + * P_hash(secret, seed) = HMAC_hash(secret, A(1) + seed) + + * HMAC_hash(secret, A(2) + seed) + + * HMAC_hash(secret, A(3) + seed) + ... + * + * Where + indicates concatenation. + * + * A() is defined as: + * A(0) = seed + * A(i) = HMAC_hash(secret, A(i-1)) + * + * P_hash can be iterated as many times as is necessary to produce the + * required quantity of data. For example, if P_SHA-1 was being used to + * create 64 bytes of data, it would have to be iterated 4 times + * (through A(4)), creating 80 bytes of output data; the last 16 bytes + * of the final iteration would then be discarded, leaving 64 bytes of + * output data. + * @param aSecret - secret + * @param aSeed - seed + * @param aLength - length of new secret + * @since Series60 3.2.3 + */ + IMPORT_C static HBufC8* GetPSHA1HashL( const TDesC8& aSecret, + const TDesC8& aSeed, + const TInt aLength ); + + /* + * Encode data into Base64 format + * @param aData - source data + * @return encoded data, if some problem occurs, NULL is returned + * @since Series60 3.2.3 + */ + IMPORT_C static HBufC8* EncodeBase64L(const TDesC8& aData); + + /* + * Decode data from Base64 format + * @param aData - source data + * @return decoded data, if some problem occurs, NULL is returned + * @since Series60 3.2.3 + */ + IMPORT_C static HBufC8* DecodeBase64L(const TDesC8& aData); + + /* + * Randomize some data and hash it using MD5 digest algorithm. + * @return hashed randomized data (constant length of hash according to MD5 specification) + * @since Series60 3.2.3 + */ + IMPORT_C static HBufC8* RandomAndHashMd5LC(); + + /* + * Create tag from security token. + * @param aSecret security context token. + * @param aValueType Indicates what the security token is + * @return tag with encoded (base64) token. + */ + IMPORT_C static HBufC8* CreateEncodedBinarySecretL( const TDesC8& aSecret, + const TDesC8& aValueType ); + + /* + * Timestamp as number of seconds since 1 january 1970. + * Calculated for present phone time. + * @return timestamp value + * @since Series60 3.2.3 + */ + IMPORT_C static HBufC8* GetTimestampL(); + + + /* + * Timestamp as number of seconds since 1 january 1970. + * Calculated for provided time. + * @param aTime base for generated timestamp + * @return timestamp value + * @since Series60 5.0 + */ + IMPORT_C static HBufC8* GetTimestampL(TTime aTime); + + + /* + * Randomize some data (based on time) and hash it using MD5 digest algorithm, + * convert each byte to hex nember representation + * @return hashed randomized data (constant length of hash according to MD5 specification + * doubled during hex conversion) + * @since Series60 3.2.3 + */ + IMPORT_C static HBufC8* GetRandomNonceL(); + + private: + /** + * Hide default C++ constructor. + */ + SenCryptoUtils(); + }; + +#endif // C_SEN_CRYPTO_UTILS_H +