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:
11:96d87a5394ee
CBC mode completed

Who changed what in which revision?

UserRevisionLine numberNew contents of line
feb11 10:bc9c23aa3870 1 #include "HMAC.h"
feb11 10:bc9c23aa3870 2 #include <string.h>
feb11 10:bc9c23aa3870 3
feb11 10:bc9c23aa3870 4 HMAC::HMAC(HashAlgorithm *hashAlgo, uint8_t *k, uint32_t kl):
feb11 10:bc9c23aa3870 5 algo(hashAlgo),
feb11 10:bc9c23aa3870 6 keyLength(kl)
feb11 10:bc9c23aa3870 7 {
feb11 10:bc9c23aa3870 8 memcpy(key, k, keyLength);
feb11 10:bc9c23aa3870 9 uint8_t buffer[64];
feb11 10:bc9c23aa3870 10 memcpy(buffer, key, keyLength);
feb11 10:bc9c23aa3870 11 memset(&buffer[keyLength], 0, 64-keyLength);
feb11 10:bc9c23aa3870 12
feb11 10:bc9c23aa3870 13 for(int i = 0; i < 64; ++i)
feb11 10:bc9c23aa3870 14 buffer[i] ^= 0x36;
feb11 10:bc9c23aa3870 15
feb11 10:bc9c23aa3870 16 algo->update(buffer, 64);
feb11 10:bc9c23aa3870 17 }
feb11 10:bc9c23aa3870 18
feb11 10:bc9c23aa3870 19 HMAC::~HMAC()
feb11 10:bc9c23aa3870 20 {
feb11 10:bc9c23aa3870 21 delete algo;
feb11 10:bc9c23aa3870 22 }
feb11 10:bc9c23aa3870 23
feb11 10:bc9c23aa3870 24 void HMAC::update(uint8_t *data, uint32_t length)
feb11 10:bc9c23aa3870 25 {
feb11 10:bc9c23aa3870 26 algo->update(data, length);
feb11 10:bc9c23aa3870 27 }
feb11 10:bc9c23aa3870 28
feb11 10:bc9c23aa3870 29 void HMAC::finalize(uint8_t *hash)
feb11 10:bc9c23aa3870 30 {
feb11 10:bc9c23aa3870 31 uint8_t buffer[64], buffer2[64];
feb11 10:bc9c23aa3870 32 algo->finalize(buffer);
feb11 10:bc9c23aa3870 33
feb11 10:bc9c23aa3870 34 memcpy(buffer2, key, keyLength);
feb11 11:96d87a5394ee 35 memset(&buffer2[keyLength], 0, 64-keyLength);
feb11 10:bc9c23aa3870 36 for(int i = 0; i < 64; ++i)
feb11 10:bc9c23aa3870 37 buffer2[i] ^= 0x5C;
feb11 10:bc9c23aa3870 38
feb11 10:bc9c23aa3870 39 algo->update(buffer2, 64);
feb11 10:bc9c23aa3870 40 algo->update(buffer, algo->outputSize());
feb11 10:bc9c23aa3870 41 algo->finalize(hash);
feb11 10:bc9c23aa3870 42 }
feb11 10:bc9c23aa3870 43