webservices/wsutils/inc/sencryptoutils.h
changeset 0 62f9d29f7211
--- /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 <hash.h>
+
+
+/**
+ * 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 <BinarySecret> tag from security token.
+        * @param aSecret security context token.
+        * @param aValueType Indicates what the security token is
+        * @return <BinarySecret> 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
+