A C++ library of encryption algorithms
Copyright (c) 2013 - 2017 Jason Lee @ calccrypto at gmail.com
Please see LICENSE file for license.
IMPORTANT:
This library was not written for actual use.
Rather, it was meant for educational purposes,
so if you choose to use it in a real setting
where secrecy is required, do so at your own risk.
People who use this library to learn about the
algorithms can easily add a few std::couts to
see the internal data.
Algorithms:
AES 128/192/256
Blowfish
Camellia 128/192/256
CAST-128 aka CAST5
CAST-256 aka CAST6
DES
DES-X
GOST 28147-89
IDEA
MISTY1
RC2
RC4 (Allegedly)
RC5-32/12/16 (can be changed)
RC6-32/20 (can be changed)
SAFER K-64
SEED
Skipjack
Triple DES
TEA
Twofish
XTEA
Modes of Operation (mod_op):
Electronic Codebook (ECB)
Cipher - Block Chaining (CBC)
Cipher Feedback (CFB)
Counter (CTR)
Output Feedback (OFB)
Propagating Cipher - Block Chaining (PCBC)
Notes:
Algorithms:
All above algorithms are derived from the "SymAlg" class,
which is used in the Mode of Operations template.
Algorithms will expect eactly 1 block or b bits of data in
8 bit ASCII, where b is the block size of the algorithm in
bits. If there are the wrong number of bits, the algorithm
should crash.
The keying algorithms will do the same, unless there are
defined padding methods.
blocksize() returns the blocksize in bits
Data padding is a hopefully correct implementation of PKCS5
Modes of Operation:
Only the general ideas of how each Mode of Operation works is used.
If any of the included algorithm has a specific method of running
under a certain Mode of Operation, it was probably not programmed.
The default Initialization Vector is just a series of 0s.
Build:
mkdir build
cd build
cmake ..
make
(optional) make test
(optional) make install
Usage:
'instance' is an instance of an algorithm
'key' is a string that is one key long for any algorithm
'plaintext' is a one block long string of non encrypted data
'ciphertext' is a one block long string of encrypted data
To run the algorithms separately (run on only 1 block), simply use '.encrypt(data)'
to encrypt or '.decrypt(data)' to decrypt, since the key has already been expanded.
Ex:
AES instance(key)
ciphertext = instance.encrypt(plaintext)
To encrypt or decrypt data using a Mode of Operation function, Simply create an instance of the mod_op.
The input is the entire data in one string.
Notes:
* ECB mode does not require an IV.
* Modes CFB, CTR, and OFB are always in encrypt mode (already programmed in)
* The other modes can use encrypt or decrypt instances of the algorithms
* IV are hex strings of any length, preferably one block long
* Any input with default value NULL can have any input. It does not matter
Ex:
Encrypting using CBC mode on AES:
SymAlg * instance = new AES(key)
data = CBC(instance, IV).encrypt(plaintext1 + plaintext2 + ... + plaintextN)
delete(instance)