HashFunction Class

Properties   Methods   Events   Configuration Settings   Errors  

The HashFunction class implements a wide variety of algorithms for message hashing.

Syntax

class secureblackbox.HashFunction

Remarks

HashFunction allows you to hash messages using a variety of industry standard hashing algorithms. Algorithms of both Hash and HMAC type are supported.

You can feed your data to HashFunction in one go, or in chunks. Use hash method to initialize the hash function, pass the buffer, and calculate the hash in one line of code. Alternatively, use reset, update, and finish in sequence to perform each of those steps individually. You can call update (and its update_file and update_stream variants) repeatedly between reset and finish, effectively passing the data in a number of portions:

  // Feeding the data in one go:
  Hashfunction hf = new Hashfunction();
  hf.Algorithm = "SHA256";
  byte[] hash = hf.Hash(buffer);

  // Feeding data chunk by chunk:
  Hashfunction hf = new Hashfunction();
  hf.Algorithm = "SHA256";
  hf.Reset(); 
  hf.Update(buffer1);
  hf.Update(buffer2);
  hf.Update(buffer3);
  byte[] hash = hf.Finish();

To use keyed HMAC, you need to provide the secret key first. Use CryptoKeyManager to create and initialize the key object:

  Cryptokeymanager km = new Cryptokeymanager();
  km.ImportBytes(hmacKey, Constants.kffDER, "SHA256", "", "", Constants.ktSecret);

  Hashfunction hf = new Hashfunction();
  hf.Algorithm = "SHA256";
  hf.Key = km.Key;
  byte[] hash = hf.Hash(buffer);

Use output_encoding to set the desired encoding method.