Click here to Skip to main content
15,881,812 members
Articles / Programming Languages / C++
Article

Hashing using the Win32 Crypto API

Rate me:
Please Sign up or sign in to vote.
4.80/5 (13 votes)
22 Jul 20056 min read 111.5K   2.7K   42   20
How to make hashing using the Win32 Crypto API.

Introduction

Hashing is one of the basic and often used features when working with crypto systems. It is used widely and can be used with different purposes. When a clear text is hashed, a relative unique “finger print” (the hash value) of the clear text is made. The hash value will often be shorter than the text which has been hashed. This will of course introduce some contradictions to the uniqueness that must be avoided as much as possible when making the (one-way) hashing algorithm. This is a problem, which can be minimized (but impossible to eliminate) mathematically only. This is one of the main reasons why you should not make a hashing algorithm yourself unless you completely master the mathematics behind. A rule of thumb is that it should be easy to evaluate H (x1) but difficult to find x1 (and x2).

H (x1) = H (x2), x1 != x2

Any contradictions to the uniqueness are basically a security risk because it will make it easier to find a text that will match the hashed value. When using the hash value to store passwords, it is even more clear how the disadvantages of the contradictions can be abused.

Birthday attack

A birthday attack is a type of cryptographic attack which exploits the mathematics behind the birthday paradox, making use of a space-time tradeoff. Specifically, if a function yields any of n different outputs with equal probability and n is sufficiently large, then after evaluating the function for about 1.2Ön different arguments, we expect to have found a pair of different arguments x1 and x2 with H (x1) = H (x2), known as a collision. If the outputs of the function are distributed unevenly, then a collision can be found even faster.

The paradox itself

The birthday paradox states that if there are 23 people in a room then there is a chance of more than 50% that at least two of them will have the same birthday. This means that a higher probability applies to a typical school class size of thirty, where the 'paradox' is often cited. For 60 or more people, the probability is greater than 99%. This is not a paradox in the sense of leading to a logical contradiction; it is a paradox in the sense that it is a mathematical truth that contradicts common intuition. Most people estimate that the chance is much lower than 50:50. Calculating this probability (and related ones) is the birthday problem. The mathematics behind it has been used to devise a well-known cryptographic attack named the birthday attack.

  1. H (x) outputs k bit.
  2. Choose x randomly and evaluate H (x) t times then.
  3. x1 and x2 => h(x1) = h(x2) where x1 != x2.
  4. It can then be expected that t is about 2^k/2.

When t(t-1)/2 pairs each with the probability of 2^-k, the probability for a collision will be:

(t/(t-1)) / (2^(k+1)) = t^2 / 2^k
t^2 = 2^k <=> T = sqr (2^k) = 2^k/2

To avoid this attack, the output length of the hash function used for a signature scheme can be chosen large enough so that the birthday attack becomes computationally infeasible, i.e. about twice as large as needed to prevent an ordinary brute force attack. In cryptanalysis, a brute force attack is a method of defeating a cryptographic scheme by trying a large number of possibilities.

Practical example

At a UNIX system a hashing value is generated of the users password, which is stored into the local system database / the file system. Every time the user enters the password it generates a hash and compares it to the local stored hash value. If these two matches, the user is authenticated otherwise the password is incorrect. With a badly implemented hashing algorithm, it is easier to find another password that will match the exact same hash value. In practice this means that more than one password can be used for the user accounts.

This is why it is very important to choose an aggressive cryptographic hashing algorithm and maintain a high complexity of passwords, as well as a short lifecycle of them to ensure that they are changed regularly. When choosing the time of the lifecycle, it is important that the lifecycle is shorter than the time it takes to find another value that matches the stored hash value.

Dictionary attack

A well-known attack to such systems is a dictionary attack. When performing a dictionary attack, the intruder is iterating through a list containing a large amount of words, e.g., a dictionary. The iteration will stop (or maybe just log) when it finds a word that matches the hash value. When the last word has been tried the process will terminate or it will start over with another user account. Different kinds of cycles have further been implemented to avoid the intruder detection being activated, when the attack is made online.

H (x1 || Ru) != H (x2), x1 != x2

Because of the risks of such an attack, most UNIX systems do not make a hash value based on the password only. Normally they include a random chosen (user specific) value, which is concatenated with the entered password where the random value is stored locally on the system and is changed regularly. This prevents offline dictionary attacks.

Using the code

The Secure Storage component is made like a MFC application. The component is encapsulating the hashing functionality in the Win32 Crypto API, which is placed in separated source and header files (the crypto.cpp and crypto.h files).

Sample screenshot

The functionality can be tried using the graphical user interface where clear text can be entered and a hash value is generated on behalf of it. The hash value will afterwards be shown in the disabled textbox.

void make_hash(const char * data, BYTE ** hash, long * len)
{
 HCRYPTPROV hProv = 0;
 HCRYPTHASH hHash = 0;
 BYTE *pbHash = NULL;
 DWORD dwHashLen;

 BYTE * pbBuffer = NULL;
 DWORD dwCount;
 DWORD i;
 unsigned long bufLen = 0;

 if(!CryptAcquireContext(&hProv, NULL, NULL, PROV_RSA_FULL, 0)) {
  return;
 }
 if(!CryptCreateHash(hProv, CALG_MD5, 0, 0, &hHash)) {
  return;
 }

 bufLen = strlen(data);

 pbBuffer = (BYTE*)malloc(bufLen +1);
 memset(pbBuffer, 0, bufLen +1);




 for(i = 0 ; i < bufLen ; i++) {
  pbBuffer[i] = (BYTE)data[i];
 }

 if(!CryptHashData(hHash, pbBuffer, bufLen, 0)) {
  return;
 }

 dwCount = sizeof(DWORD);
 if(!CryptGetHashParam(hHash, HP_HASHSIZE, (BYTE *)&dwHashLen, &dwCount, 0)) {
  return;
 }
 if((pbHash = (unsigned char*)malloc(dwHashLen)) == NULL) {
  return;
 }


 memset(pbHash, 0, dwHashLen);

 if(!CryptGetHashParam(hHash, HP_HASHVAL, pbHash, &dwHashLen, 0)) {
  return;
 }

 *hash = pbHash;
 *len = dwHashLen;

 if(hHash) CryptDestroyHash(hHash);
 if(hProv) CryptReleaseContext(hProv,0);
}

When making the hash value programmatically the method as outlined above is used. It takes three arguments; the data that has to be hashed (the clear text), a byte pointer initially set to NULL, which will be pointing at the hash value, and finally the length of the hash value.

{
    BYTE * hash = NULL;
    long len = 0;
    make_hash("Text to be hashed", &hash, &len);
}

When showing the hash value it can be cast to a char pointer (char *) but this have the disadvantages that not all characters are shown as is. A better way to show the hash value is to stream it to a file, which can be read afterwards.

void write_file(const char * filename, unsigned char * data, long length)
{
    FILE * fp = fopen(filename, "w+b");
    if (fp) {
        fwrite(data, 1, length, fp);
        fclose(fp);
    }
}

Please notice that the file is being written as binary. The reason for this is that we are writing binary data to the file.

Points of interest

Using the Win32 Crypto API, please notice that it might not necessary compile as is. This is because a pre-processor definition is missing in the project.

#define _WIN32_WINNT 0x0400

When defining the above globally to the project, it will be possible to compile code that is using the Crypto API. My suggestion is to place the definition in the StdAfx.h file.

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here


Written By
Technical Lead
Denmark Denmark
I'm a technical lead and software architect, who holds a master's degree from Aarhus University, Denmark. I have commercial experience with IT and software engineering since mid-nineties and my professionalism has been confirmed by IEEE with my elevation to Senior Member.


Active help channel - Codementor
https://www.codementor.io/jessn/profile


Deprecated help channel - Support & help
https://groups.google.com/forum/#!forum/nielsen-tools-support

Comments and Discussions

 
QuestionCryptCreateHash(hProv, CALG_SHA_256, 0, 0, &hHash) ... it is failing giving error as " NTE_BAD_ALGID" .... Pin
GK Developer9-Aug-14 2:42
GK Developer9-Aug-14 2:42 
GeneralYour Code is Broken Pin
deusprogrammer8-Jun-11 11:52
deusprogrammer8-Jun-11 11:52 
GeneralNull terminate the hash before display Pin
OllieBrown23-Mar-07 7:01
OllieBrown23-Mar-07 7:01 
GeneralRe: Null terminate the hash before display Pin
Jessn25-Mar-07 22:09
Jessn25-Mar-07 22:09 
GeneralComparing the hash Pin
vgandhi25-Jan-07 0:26
vgandhi25-Jan-07 0:26 
AnswerRe: Comparing the hash Pin
Jessn15-May-09 4:40
Jessn15-May-09 4:40 
GeneralRe: Comparing the hash Pin
Member 448141821-Jul-10 3:17
Member 448141821-Jul-10 3:17 
AnswerRe: Comparing the hash Pin
Jessn22-Jul-10 21:32
Jessn22-Jul-10 21:32 
GeneralRe: Comparing the hash Pin
Member 448141822-Jul-10 22:10
Member 448141822-Jul-10 22:10 
QuestioncryptoAcquireContext() on windows 98 Pin
rajeevktripathi9-Feb-06 2:50
rajeevktripathi9-Feb-06 2:50 
AnswerRe: cryptoAcquireContext() on windows 98 Pin
Jessn9-Feb-06 3:12
Jessn9-Feb-06 3:12 
Generalcant compile win32 crypto API Pin
adeelg6-Dec-05 19:12
adeelg6-Dec-05 19:12 
GeneralRe: cant compile win32 crypto API [modified] Pin
Jessn10-Jan-06 22:37
Jessn10-Jan-06 22:37 
GeneralReferences Pin
Jessn13-Nov-05 4:17
Jessn13-Nov-05 4:17 
Generalthis is crap !!! Pin
Anonymous28-Sep-05 16:31
Anonymous28-Sep-05 16:31 
AnswerRe: this is crap !!! Pin
T1TAN30-Sep-05 11:15
T1TAN30-Sep-05 11:15 
GeneralRe: this is crap !!! Pin
Anonymous2-Oct-05 14:38
Anonymous2-Oct-05 14:38 
GeneralRe: this is crap !!! Pin
T1TAN2-Oct-05 23:14
T1TAN2-Oct-05 23:14 
GeneralRe: this is crap !!! Pin
Jessn13-Nov-05 3:42
Jessn13-Nov-05 3:42 
GeneralPerf implications of CAPI Pin
Umut Alev25-Jul-05 21:29
Umut Alev25-Jul-05 21:29 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.