ArduinoLibs
 All Classes Files Functions Variables Typedefs Enumerations Enumerator Groups Pages
SHA256.cpp
1 /*
2  * Copyright (C) 2015 Southern Storm Software, Pty Ltd.
3  *
4  * Permission is hereby granted, free of charge, to any person obtaining a
5  * copy of this software and associated documentation files (the "Software"),
6  * to deal in the Software without restriction, including without limitation
7  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8  * and/or sell copies of the Software, and to permit persons to whom the
9  * Software is furnished to do so, subject to the following conditions:
10  *
11  * The above copyright notice and this permission notice shall be included
12  * in all copies or substantial portions of the Software.
13  *
14  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
15  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
17  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
18  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
19  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
20  * DEALINGS IN THE SOFTWARE.
21  */
22 
23 #include "SHA256.h"
24 #include "Crypto.h"
25 #include "utility/RotateUtil.h"
26 #include "utility/EndianUtil.h"
27 #include "utility/ProgMemUtil.h"
28 #include <string.h>
29 
43 {
44  reset();
45 }
46 
52 {
53  clean(state);
54 }
55 
56 size_t SHA256::hashSize() const
57 {
58  return 32;
59 }
60 
61 size_t SHA256::blockSize() const
62 {
63  return 64;
64 }
65 
67 {
68  state.h[0] = 0x6a09e667;
69  state.h[1] = 0xbb67ae85;
70  state.h[2] = 0x3c6ef372;
71  state.h[3] = 0xa54ff53a,
72  state.h[4] = 0x510e527f;
73  state.h[5] = 0x9b05688c;
74  state.h[6] = 0x1f83d9ab;
75  state.h[7] = 0x5be0cd19;
76  state.chunkSize = 0;
77  state.finalized = false;
78  state.length = 0;
79 }
80 
81 void SHA256::update(const void *data, size_t len)
82 {
83  // Reset the hashing process if finalize() was called previously.
84  if (state.finalized)
85  reset();
86 
87  // Update the total length (in bits, not bytes).
88  state.length += ((uint64_t)len) << 3;
89 
90  // Break the input up into 512-bit chunks and process each in turn.
91  const uint8_t *d = (const uint8_t *)data;
92  while (len > 0) {
93  uint8_t size = 64 - state.chunkSize;
94  if (size > len)
95  size = len;
96  memcpy(((uint8_t *)state.w) + state.chunkSize, d, size);
97  state.chunkSize += size;
98  len -= size;
99  d += size;
100  if (state.chunkSize == 64) {
101  processChunk();
102  state.chunkSize = 0;
103  }
104  }
105 }
106 
107 void SHA256::finalize(void *hash, size_t len)
108 {
109  // Finalize the hash if necessary.
110  if (!state.finalized) {
111  // Pad the last chunk. We may need two padding chunks if there
112  // isn't enough room in the first for the padding and length.
113  uint8_t *wbytes = (uint8_t *)state.w;
114  if (state.chunkSize <= (64 - 9)) {
115  wbytes[state.chunkSize] = 0x80;
116  memset(wbytes + state.chunkSize + 1, 0x00, 64 - 8 - (state.chunkSize + 1));
117  state.w[14] = htobe32((uint32_t)(state.length >> 32));
118  state.w[15] = htobe32((uint32_t)state.length);
119  processChunk();
120  } else {
121  wbytes[state.chunkSize] = 0x80;
122  memset(wbytes + state.chunkSize + 1, 0x00, 64 - (state.chunkSize + 1));
123  processChunk();
124  memset(wbytes, 0x00, 64 - 8);
125  state.w[14] = htobe32((uint32_t)(state.length >> 32));
126  state.w[15] = htobe32((uint32_t)state.length);
127  processChunk();
128  }
129 
130  // Convert the result into big endian and return it.
131  for (uint8_t posn = 0; posn < 8; ++posn)
132  state.w[posn] = htobe32(state.h[posn]);
133  state.finalized = true;
134  }
135 
136  // Copy the hash to the caller's return buffer.
137  if (len > 32)
138  len = 32;
139  memcpy(hash, state.w, len);
140 }
141 
143 {
144  clean(state);
145  reset();
146 }
147 
153 void SHA256::processChunk()
154 {
155  // Round constants for SHA-256.
156  static uint32_t const k[64] PROGMEM = {
157  0x428a2f98, 0x71374491, 0xb5c0fbcf, 0xe9b5dba5,
158  0x3956c25b, 0x59f111f1, 0x923f82a4, 0xab1c5ed5,
159  0xd807aa98, 0x12835b01, 0x243185be, 0x550c7dc3,
160  0x72be5d74, 0x80deb1fe, 0x9bdc06a7, 0xc19bf174,
161  0xe49b69c1, 0xefbe4786, 0x0fc19dc6, 0x240ca1cc,
162  0x2de92c6f, 0x4a7484aa, 0x5cb0a9dc, 0x76f988da,
163  0x983e5152, 0xa831c66d, 0xb00327c8, 0xbf597fc7,
164  0xc6e00bf3, 0xd5a79147, 0x06ca6351, 0x14292967,
165  0x27b70a85, 0x2e1b2138, 0x4d2c6dfc, 0x53380d13,
166  0x650a7354, 0x766a0abb, 0x81c2c92e, 0x92722c85,
167  0xa2bfe8a1, 0xa81a664b, 0xc24b8b70, 0xc76c51a3,
168  0xd192e819, 0xd6990624, 0xf40e3585, 0x106aa070,
169  0x19a4c116, 0x1e376c08, 0x2748774c, 0x34b0bcb5,
170  0x391c0cb3, 0x4ed8aa4a, 0x5b9cca4f, 0x682e6ff3,
171  0x748f82ee, 0x78a5636f, 0x84c87814, 0x8cc70208,
172  0x90befffa, 0xa4506ceb, 0xbef9a3f7, 0xc67178f2
173  };
174 
175  // Convert the first 16 words from big endian to host byte order.
176  uint8_t index;
177  for (index = 0; index < 16; ++index)
178  state.w[index] = be32toh(state.w[index]);
179 
180  // Initialise working variables to the current hash value.
181  uint32_t a = state.h[0];
182  uint32_t b = state.h[1];
183  uint32_t c = state.h[2];
184  uint32_t d = state.h[3];
185  uint32_t e = state.h[4];
186  uint32_t f = state.h[5];
187  uint32_t g = state.h[6];
188  uint32_t h = state.h[7];
189 
190  // Perform the first 16 rounds of the compression function main loop.
191  uint32_t temp1, temp2;
192  for (index = 0; index < 16; ++index) {
193  temp1 = h + pgm_read_dword(k + index) + state.w[index] +
194  (rightRotate6(e) ^ rightRotate11(e) ^ rightRotate25(e)) +
195  ((e & f) ^ ((~e) & g));
196  temp2 = (rightRotate2(a) ^ rightRotate13(a) ^ rightRotate22(a)) +
197  ((a & b) ^ (a & c) ^ (b & c));
198  h = g;
199  g = f;
200  f = e;
201  e = d + temp1;
202  d = c;
203  c = b;
204  b = a;
205  a = temp1 + temp2;
206  }
207 
208  // Perform the 48 remaining rounds. We expand the first 16 words to
209  // 64 in-place in the "w" array. This saves 192 bytes of memory
210  // that would have otherwise need to be allocated to the "w" array.
211  for (; index < 64; ++index) {
212  // Expand the next word.
213  temp1 = state.w[(index - 15) & 0x0F];
214  temp2 = state.w[(index - 2) & 0x0F];
215  temp1 = state.w[index & 0x0F] =
216  state.w[(index - 16) & 0x0F] + state.w[(index - 7) & 0x0F] +
217  (rightRotate7(temp1) ^ rightRotate18(temp1) ^ (temp1 >> 3)) +
218  (rightRotate17(temp2) ^ rightRotate19(temp2) ^ (temp2 >> 10));
219 
220  // Perform the round.
221  temp1 = h + pgm_read_dword(k + index) + temp1 +
222  (rightRotate6(e) ^ rightRotate11(e) ^ rightRotate25(e)) +
223  ((e & f) ^ ((~e) & g));
224  temp2 = (rightRotate2(a) ^ rightRotate13(a) ^ rightRotate22(a)) +
225  ((a & b) ^ (a & c) ^ (b & c));
226  h = g;
227  g = f;
228  f = e;
229  e = d + temp1;
230  d = c;
231  c = b;
232  b = a;
233  a = temp1 + temp2;
234  }
235 
236  // Add the compressed chunk to the current hash value.
237  state.h[0] += a;
238  state.h[1] += b;
239  state.h[2] += c;
240  state.h[3] += d;
241  state.h[4] += e;
242  state.h[5] += f;
243  state.h[6] += g;
244  state.h[7] += h;
245 
246  // Attempt to clean up the stack.
247  a = b = c = d = e = f = g = h = temp1 = temp2 = 0;
248 }
void reset()
Resets the hash ready for a new hashing process.
Definition: SHA256.cpp:66
SHA256()
Constructs a SHA-256 hash object.
Definition: SHA256.cpp:42
void finalize(void *hash, size_t len)
Finalizes the hashing process and returns the hash.
Definition: SHA256.cpp:107
virtual ~SHA256()
Destroys this SHA-256 hash object after clearing sensitive information.
Definition: SHA256.cpp:51
size_t blockSize() const
Size of the internal block used by the hash algorithm.
Definition: SHA256.cpp:61
void update(const void *data, size_t len)
Updates the hash with more data.
Definition: SHA256.cpp:81
size_t hashSize() const
Size of the hash result from finalize().
Definition: SHA256.cpp:56
void clear()
Clears the hash state, removing all sensitive data, and then resets the hash ready for a new hashing ...
Definition: SHA256.cpp:142