cryptical_envelopment.h

Go to the documentation of this file.

#ifndef CRYPTICAL_ENVELOPMENT_CLASS
#define CRYPTICAL_ENVELOPMENT_CLASS
 
/*
*  Name   : cryptical_envelopment
*  Author : Chris Koeritz
*
*  Purpose:
*
*  A base class that implements the majority of encryption processing using the
*  OpenSSL EVP methods, aka the digital envelope routines.
*
*****
* Copyright (c) 2005-$now By Author.  This program is free software; you can
* redistribute it and/or modify it under the terms of the GNU General Public
* License as published by the Free Software Foundation; either version 2 of
* the License or (at your option) any later version.  This is online at:
*     http://www.fsf.org/copyleft/gpl.html
* Please send any updates to: fred@gruntose.com
*/
 
#include <basis/byte_array.h>
#include <basis/contracts.h>
 
// forward.
struct evp_cipher_st;
typedef struct evp_cipher_st EVP_CIPHER;
 
namespace crypto {
 
class cryptical_envelopment : public virtual basis::nameable
{
public:
  cryptical_envelopment(const EVP_CIPHER *cipher_type);
  cryptical_envelopment(const cryptical_envelopment &to_copy);  
 
  virtual ~cryptical_envelopment();
 
  cryptical_envelopment &operator = (const cryptical_envelopment &to_copy);
 
  bool set_key(int key_size);
 
  bool set_key(const basis::byte_array &new_key, int key_size);
 
  DEFINE_CLASS_NAME("cryptical_envelopment");
 
  int key_size() const;  // returns the size of our key, in bits.
 
  // derived classes must provide the min and max for key sizes.
  virtual int minimum_key_size_in_bits() const = 0;
  virtual int maximum_key_size_in_bits() const = 0;
 
  const basis::byte_array &get_key() const;  
 
  bool generate_key(int size, basis::byte_array &new_key);
 
  bool encrypt(const basis::byte_array &source, basis::byte_array &target) const;
 
  bool decrypt(const basis::byte_array &source, basis::byte_array &target) const;
 
  // seldom-needed methods...
 
  static const basis::byte_array &init_vector();
 
private:
  int _key_size;  
  basis::byte_array *_key;  
  const EVP_CIPHER *_cipher_type;  
};
 
} //namespace.
 
#endif