lib/libUPnP/Neptune/Source/Core/NptCrypto.h

   1 /*****************************************************************
   2 |
   3 |   Neptune - Crypto
   4 |
   5 | Copyright (c) 2002-2010, Axiomatic Systems, LLC.
   6 | All rights reserved.
   7 |
   8 | Redistribution and use in source and binary forms, with or without
   9 | modification, are permitted provided that the following conditions are met:
  10 |     * Redistributions of source code must retain the above copyright
  11 |       notice, this list of conditions and the following disclaimer.
  12 |     * Redistributions in binary form must reproduce the above copyright
  13 |       notice, this list of conditions and the following disclaimer in the
  14 |       documentation and/or other materials provided with the distribution.
  15 |     * Neither the name of Axiomatic Systems nor the
  16 |       names of its contributors may be used to endorse or promote products
  17 |       derived from this software without specific prior written permission.
  18 |
  19 | THIS SOFTWARE IS PROVIDED BY AXIOMATIC SYSTEMS ''AS IS'' AND ANY
  20 | EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  21 | WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  22 | DISCLAIMED. IN NO EVENT SHALL AXIOMATIC SYSTEMS BE LIABLE FOR ANY
  23 | DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
  24 | (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  25 | LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  26 | ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  27 | (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
  28 | SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  29 |
  30  ****************************************************************/
  31
  32 #ifndef _NPT_CRYPTO_H_
  33 #define _NPT_CRYPTO_H_
  34
  35 /*----------------------------------------------------------------------
  36 |   includes
  37 +---------------------------------------------------------------------*/
  38 #include "NptTypes.h"
  39 #include "NptDataBuffer.h"
  40
  41 /*----------------------------------------------------------------------
  42 |   NPT_BlockCipher
  43 +---------------------------------------------------------------------*/
  44 class NPT_BlockCipher {
  45 public:
  46     // types
  47     typedef enum {
  48         AES_128
  49     } Algorithm;
  50
  51     typedef enum {
  52         ENCRYPT,
  53         DECRYPT
  54     } Direction;
  55
  56     // factory
  57     static NPT_Result Create(Algorithm         algorithm,
  58                              Direction         direction,
  59                              const NPT_UInt8*  key,
  60                              NPT_Size          key_size,
  61                              NPT_BlockCipher*& cipher);
  62
  63     // methods
  64     virtual           ~NPT_BlockCipher() {}
  65     virtual NPT_Size   GetBlockSize() = 0;
  66     virtual Direction  GetDirection() = 0;
  67     virtual Algorithm  GetAlgorithm() = 0;
  68     virtual NPT_Result ProcessBlock(const NPT_UInt8* input, NPT_UInt8* output) = 0;
  69     /**
  70      * @param iv Initial vector (same size as cipher block size), or NULL for an IV made up of all zeros.
  71      */
  72     virtual NPT_Result ProcessCbc(const NPT_UInt8* input, NPT_Size input_size, const NPT_UInt8* iv, NPT_DataBuffer& output);
  73
  74 protected:
  75     NPT_BlockCipher() {} // don't instantiate directly
  76 };
  77
  78 #endif // _NPT_CRYPTO_H_