os/security/crypto/weakcryptospi/source/symmetric/arc4shim.h
author sl
Tue, 10 Jun 2014 14:32:02 +0200
changeset 1 260cb5ec6c19
permissions -rw-r--r--
Update contrib.
     1 /*
     2 * Copyright (c) 2006-2009 Nokia Corporation and/or its subsidiary(-ies).
     3 * All rights reserved.
     4 * This component and the accompanying materials are made available
     5 * under the terms of the License "Eclipse Public License v1.0"
     6 * which accompanies this distribution, and is available
     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".
     8 *
     9 * Initial Contributors:
    10 * Nokia Corporation - initial contribution.
    11 *
    12 * Contributors:
    13 *
    14 * Description: 
    15 * ARC4 shim classes definition
    16 *
    17 */
    18 
    19 
    20 /**
    21  @file
    22  @internalComponent
    23  @released
    24 */
    25 
    26 #ifndef ARC4SHIM_H
    27 #define ARC4SHIM_H
    28 
    29 #include <arc4.h>
    30 
    31 namespace CryptoSpi
    32 	{
    33 	class CCryptoParams;
    34 	class CSymmetricCipher;
    35 	class CKey;
    36 	}
    37 	
    38 NONSHARABLE_CLASS(CArc4Shim) : public CARC4
    39 {
    40 public:
    41 	/**
    42 	Creates a CArc4Shim object which has the same interface as CARC4 
    43 	but delegates all work to a Crypto SPI plug-in.
    44 	@param aKey					The key to use. aKey must be less 
    45 								than or equal to KRC4MaxKeySizeBytes.  
    46 	@param aDiscardBytes		The number of bytes to drop from the 
    47 								beginning of the key stream.
    48 	@return						A pointer to a CArc4Shim instance
    49 	@leave KErrKeyNotWeakEnough	If the key size is larger than that 
    50 								allowed by the cipher strength 
    51 								restrictions of the crypto library.
    52 								See TCrypto::IsSymmetricWeakEnoughL()
    53 	*/
    54 	static CArc4Shim* NewL(const TDesC8& aKey, TUint aDiscardBytes);
    55 	
    56 	/**
    57 	Creates a CArc4Shim object which has the same interface as CARC4,
    58 	and leave it on the cleanup stack. but delegates all work to a 
    59 	Crypto SPI plug-in.
    60 	@param aKey					The key to use. aKey must be less 
    61 								than or equal to KRC4MaxKeySizeBytes.  
    62 	@param aDiscardBytes		The number of bytes to drop from the 
    63 								beginning of the key stream.
    64 	@return						A pointer to a CArc4Shim instance
    65 	@leave KErrKeyNotWeakEnough	If the key size is larger than that 
    66 								allowed by the cipher strength 
    67 								restrictions of the crypto library.
    68 								See TCrypto::IsSymmetricWeakEnoughL()
    69 	*/
    70 	static CArc4Shim* NewLC(const TDesC8& aKey, TUint aDiscardBytes);
    71 
    72 	/**
    73 	Destructor
    74 	*/
    75 	~CArc4Shim();
    76 
    77 	// From CSymmetricCipher class
    78 	void Reset();
    79 	TInt BlockSize() const;
    80 	TInt KeySize() const;		
    81 	void Process(const TDesC8& aInput, TDes8& aOutput);
    82 	void ProcessFinalL(const TDesC8& aInput, TDes8& aOutput);
    83 	TInt MaxOutputLength(TInt aInputLength) const;
    84 	TInt MaxFinalOutputLength(TInt aInputLength) const;
    85 
    86 private:
    87 	/** 
    88 	Constructor
    89 	*/
    90 	CArc4Shim();
    91 
    92 	/**
    93 	Second Phase Constructor
    94 	*/
    95 	void ConstructL(const TDesC8& aKey, TUint aDiscardBytes);
    96 		
    97 private:
    98 	/// SPI delegate
    99 	CryptoSpi::CSymmetricCipher* iSymmetricCipherImpl;
   100 		
   101 	/// SPI requires all key to passed as key-objects
   102 	CryptoSpi::CKey* iKey;
   103 	
   104 	CryptoSpi::CCryptoParams* iAlgorithmParams;
   105 };
   106 
   107 #endif // ARC4SHIM_H