Introduction

AnCH cryptography library aims to provide facilities for cryptography.

This library is divided in functional parts. For now parts are:

hash: hash algorithms (MD5, SHA1, SHA2)
b2t: binary to text algorithms (base64)
encryption: cipher algorithms (AES)

There is also some other features like HMAC which depends on hash.

Prerequisites

You only need anch-utils library header files to compile this library.

Installation

TODO fill this section

Conception

Hashes

Every hash implementation inherits the anch::crypto::Hash class.
Hash is a template class which is parameterized by its ouput and block size. These parameters are used to other algorithms based on hash like anch::crypto::HMAC.

For now, implemented hashes are:

anch::crypto::MD5
anch::crypto::SHA1
anch::crypto::SHA2 : anch::crypto::SHA224 and anch::crypto::SHA256 which are type defintions of anch::crypto::SHA224_256 ; anch::crypto::SHA384 and anch::crypto::SHA512 which are type defintions of anch::crypto::SHA384_512

The SHA384 and SHA512 are optimized for 64-bits CPU. 32-bits CPU optimization isplanned for later.

Every Hash owns its context which is reset on each call.
Digest is computed on instanciation or by calling one of the Hash digest methods. Data to hash can be:

std::basic_string
uint8_t[] specifying its size
std::basic_istream

Hash result will be retrieved by calling method digest (without parameter).

Encryption

Only anch::crypto::AES is implemented for now. Other alogrithms are planned for implementation (DES, Triple DES, Camellia, ...).
AES has only 2 methods:

cipher which takes two uint8_t[16] as input and output parameters.
decipher which takes two uint8_t[16] as input and output parameters.

Secret key is expanded on instanciation and is reused for each block (on each call).

Future cipher block algorithms will have similar methods to implements different cipher block mode of operation (ECB, CBC, CTR, ...) with parallelization through ThreadPool.

Examples