This library implements some hash and cryptographic algorithms.

Dependents:   mBuinoBlinky PB_Emma_Ethernet SLOTrashHTTP Garagem ... more

This library implements the following algorithms :

  • RC4
  • AES (AES-128, AES-192, AES-256)
  • DES
  • Triple DES (EDE)
  • MD2
  • MD4
  • MD5
  • SHA-1
  • SHA-2 (SHA-224, SHA-256, SHA-384, SHA-512)

The hash algorithms have been optimized for the mbed and you should get decent performance. However, I did not optimize the ciphers. Also, I did not test extensively these algorithms : it should work but you may find some bugs. Block ciphers support two modes : ECB and CBC.

Warning

If you are using SHA-384 or SHA-512, be aware that it produces large binary files and the compilation (using the online compiler) takes much longer to execute. It may happen that the compiler stops because it timed-out. In this case, just compile again and it should work.

Computing hash

You can compute the hash of some data in two different ways. The first one is the easiest, each hash algorithm has a static method that takes some data and compute the hash from it.

Computing hash using method 1

#include "Crypto.h"
#include "mbed.h"

static const char msg[] = "mbed is great !";

int main()
{
    uint8_t hash[16];
    MD2::computeHash(hash, (uint8_t*)msg, strlen(msg));
    printf("hash: ");
    for(int i = 0; i < 16; ++i)
        printf("%02x", hash[i]);
    printf("\n");
    
    return 0;
}

The second one is slightly slower (around 2-3% slower) but it allows you to compute the hash of some data in several steps (by calling update method). This is the method you should use if you need to compute the hash from a large source and you don't have enough memory to store it in a single buffer.

Computing hash using method 2

#include "Crypto.h"
#include "mbed.h"

static const char msg[] = "mbed is great !";

int main()
{
    uint8_t hash[16];
    MD2 h;
    h.update((uint8_t*)msg, strlen(msg));
    h.finalize(hash);
    printf("hash: ");
    for(int i = 0; i < 16; ++i)
        printf("%02x", hash[i]);
    printf("\n");
    
    return 0;
}

TODO

  • optimize ciphers
  • add doc
Committer:
feb11
Date:
Sun May 11 13:36:45 2014 +0000
Revision:
14:f04410cef037
Parent:
8:a090264e9b2d
CBC mode completed

Who changed what in which revision?

UserRevisionLine numberNew contents of line
feb11 8:a090264e9b2d 1 #ifndef BLOCK_CIPHER_H
feb11 8:a090264e9b2d 2 #define BLOCK_CIPHER_H
feb11 8:a090264e9b2d 3
feb11 8:a090264e9b2d 4 #include "Cipher.h"
feb11 8:a090264e9b2d 5
feb11 8:a090264e9b2d 6 enum BLOCK_CIPHER_MODE
feb11 8:a090264e9b2d 7 {
feb11 8:a090264e9b2d 8 ECB_MODE,
feb11 8:a090264e9b2d 9 CBC_MODE
feb11 8:a090264e9b2d 10 };
feb11 8:a090264e9b2d 11
feb11 8:a090264e9b2d 12 class BlockCipher : public Cipher
feb11 8:a090264e9b2d 13 {
feb11 8:a090264e9b2d 14 public :
feb11 8:a090264e9b2d 15
feb11 8:a090264e9b2d 16 BlockCipher(uint32_t bs, BLOCK_CIPHER_MODE m, uint8_t *iv = 0);
feb11 8:a090264e9b2d 17 virtual ~BlockCipher();
feb11 8:a090264e9b2d 18
feb11 8:a090264e9b2d 19 virtual CIPHER_TYPE getType() const;
feb11 8:a090264e9b2d 20 uint32_t getBlockSize() const;
feb11 8:a090264e9b2d 21
feb11 8:a090264e9b2d 22 virtual void encrypt(uint8_t *out, uint8_t *in, uint32_t length);
feb11 8:a090264e9b2d 23 virtual void decrypt(uint8_t *out, uint8_t *in, uint32_t length);
feb11 8:a090264e9b2d 24
feb11 8:a090264e9b2d 25 protected :
feb11 8:a090264e9b2d 26
feb11 8:a090264e9b2d 27 virtual void encryptBlock(uint8_t *out, uint8_t *in) = 0;
feb11 8:a090264e9b2d 28 virtual void decryptBlock(uint8_t *out, uint8_t *in) = 0;
feb11 8:a090264e9b2d 29
feb11 8:a090264e9b2d 30 private :
feb11 8:a090264e9b2d 31
feb11 8:a090264e9b2d 32 uint32_t blockSize;
feb11 8:a090264e9b2d 33 BLOCK_CIPHER_MODE mode;
feb11 8:a090264e9b2d 34 uint8_t *IV;
feb11 8:a090264e9b2d 35 };
feb11 8:a090264e9b2d 36
feb11 8:a090264e9b2d 37 #endif