You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
327 lines
9.3 KiB
327 lines
9.3 KiB
/** |
|
* Secure Hash Algorithm with 256-bit digest (SHA-256) implementation. |
|
* |
|
* See FIPS 180-2 for details. |
|
* |
|
* @author Dave Longley |
|
* |
|
* Copyright (c) 2010-2015 Digital Bazaar, Inc. |
|
*/ |
|
var forge = require('./forge'); |
|
require('./md'); |
|
require('./util'); |
|
|
|
var sha256 = module.exports = forge.sha256 = forge.sha256 || {}; |
|
forge.md.sha256 = forge.md.algorithms.sha256 = sha256; |
|
|
|
/** |
|
* Creates a SHA-256 message digest object. |
|
* |
|
* @return a message digest object. |
|
*/ |
|
sha256.create = function() { |
|
// do initialization as necessary |
|
if(!_initialized) { |
|
_init(); |
|
} |
|
|
|
// SHA-256 state contains eight 32-bit integers |
|
var _state = null; |
|
|
|
// input buffer |
|
var _input = forge.util.createBuffer(); |
|
|
|
// used for word storage |
|
var _w = new Array(64); |
|
|
|
// message digest object |
|
var md = { |
|
algorithm: 'sha256', |
|
blockLength: 64, |
|
digestLength: 32, |
|
// 56-bit length of message so far (does not including padding) |
|
messageLength: 0, |
|
// true message length |
|
fullMessageLength: null, |
|
// size of message length in bytes |
|
messageLengthSize: 8 |
|
}; |
|
|
|
/** |
|
* Starts the digest. |
|
* |
|
* @return this digest object. |
|
*/ |
|
md.start = function() { |
|
// up to 56-bit message length for convenience |
|
md.messageLength = 0; |
|
|
|
// full message length (set md.messageLength64 for backwards-compatibility) |
|
md.fullMessageLength = md.messageLength64 = []; |
|
var int32s = md.messageLengthSize / 4; |
|
for(var i = 0; i < int32s; ++i) { |
|
md.fullMessageLength.push(0); |
|
} |
|
_input = forge.util.createBuffer(); |
|
_state = { |
|
h0: 0x6A09E667, |
|
h1: 0xBB67AE85, |
|
h2: 0x3C6EF372, |
|
h3: 0xA54FF53A, |
|
h4: 0x510E527F, |
|
h5: 0x9B05688C, |
|
h6: 0x1F83D9AB, |
|
h7: 0x5BE0CD19 |
|
}; |
|
return md; |
|
}; |
|
// start digest automatically for first time |
|
md.start(); |
|
|
|
/** |
|
* Updates the digest with the given message input. The given input can |
|
* treated as raw input (no encoding will be applied) or an encoding of |
|
* 'utf8' maybe given to encode the input using UTF-8. |
|
* |
|
* @param msg the message input to update with. |
|
* @param encoding the encoding to use (default: 'raw', other: 'utf8'). |
|
* |
|
* @return this digest object. |
|
*/ |
|
md.update = function(msg, encoding) { |
|
if(encoding === 'utf8') { |
|
msg = forge.util.encodeUtf8(msg); |
|
} |
|
|
|
// update message length |
|
var len = msg.length; |
|
md.messageLength += len; |
|
len = [(len / 0x100000000) >>> 0, len >>> 0]; |
|
for(var i = md.fullMessageLength.length - 1; i >= 0; --i) { |
|
md.fullMessageLength[i] += len[1]; |
|
len[1] = len[0] + ((md.fullMessageLength[i] / 0x100000000) >>> 0); |
|
md.fullMessageLength[i] = md.fullMessageLength[i] >>> 0; |
|
len[0] = ((len[1] / 0x100000000) >>> 0); |
|
} |
|
|
|
// add bytes to input buffer |
|
_input.putBytes(msg); |
|
|
|
// process bytes |
|
_update(_state, _w, _input); |
|
|
|
// compact input buffer every 2K or if empty |
|
if(_input.read > 2048 || _input.length() === 0) { |
|
_input.compact(); |
|
} |
|
|
|
return md; |
|
}; |
|
|
|
/** |
|
* Produces the digest. |
|
* |
|
* @return a byte buffer containing the digest value. |
|
*/ |
|
md.digest = function() { |
|
/* Note: Here we copy the remaining bytes in the input buffer and |
|
add the appropriate SHA-256 padding. Then we do the final update |
|
on a copy of the state so that if the user wants to get |
|
intermediate digests they can do so. */ |
|
|
|
/* Determine the number of bytes that must be added to the message |
|
to ensure its length is congruent to 448 mod 512. In other words, |
|
the data to be digested must be a multiple of 512 bits (or 128 bytes). |
|
This data includes the message, some padding, and the length of the |
|
message. Since the length of the message will be encoded as 8 bytes (64 |
|
bits), that means that the last segment of the data must have 56 bytes |
|
(448 bits) of message and padding. Therefore, the length of the message |
|
plus the padding must be congruent to 448 mod 512 because |
|
512 - 128 = 448. |
|
|
|
In order to fill up the message length it must be filled with |
|
padding that begins with 1 bit followed by all 0 bits. Padding |
|
must *always* be present, so if the message length is already |
|
congruent to 448 mod 512, then 512 padding bits must be added. */ |
|
|
|
var finalBlock = forge.util.createBuffer(); |
|
finalBlock.putBytes(_input.bytes()); |
|
|
|
// compute remaining size to be digested (include message length size) |
|
var remaining = ( |
|
md.fullMessageLength[md.fullMessageLength.length - 1] + |
|
md.messageLengthSize); |
|
|
|
// add padding for overflow blockSize - overflow |
|
// _padding starts with 1 byte with first bit is set (byte value 128), then |
|
// there may be up to (blockSize - 1) other pad bytes |
|
var overflow = remaining & (md.blockLength - 1); |
|
finalBlock.putBytes(_padding.substr(0, md.blockLength - overflow)); |
|
|
|
// serialize message length in bits in big-endian order; since length |
|
// is stored in bytes we multiply by 8 and add carry from next int |
|
var next, carry; |
|
var bits = md.fullMessageLength[0] * 8; |
|
for(var i = 0; i < md.fullMessageLength.length - 1; ++i) { |
|
next = md.fullMessageLength[i + 1] * 8; |
|
carry = (next / 0x100000000) >>> 0; |
|
bits += carry; |
|
finalBlock.putInt32(bits >>> 0); |
|
bits = next >>> 0; |
|
} |
|
finalBlock.putInt32(bits); |
|
|
|
var s2 = { |
|
h0: _state.h0, |
|
h1: _state.h1, |
|
h2: _state.h2, |
|
h3: _state.h3, |
|
h4: _state.h4, |
|
h5: _state.h5, |
|
h6: _state.h6, |
|
h7: _state.h7 |
|
}; |
|
_update(s2, _w, finalBlock); |
|
var rval = forge.util.createBuffer(); |
|
rval.putInt32(s2.h0); |
|
rval.putInt32(s2.h1); |
|
rval.putInt32(s2.h2); |
|
rval.putInt32(s2.h3); |
|
rval.putInt32(s2.h4); |
|
rval.putInt32(s2.h5); |
|
rval.putInt32(s2.h6); |
|
rval.putInt32(s2.h7); |
|
return rval; |
|
}; |
|
|
|
return md; |
|
}; |
|
|
|
// sha-256 padding bytes not initialized yet |
|
var _padding = null; |
|
var _initialized = false; |
|
|
|
// table of constants |
|
var _k = null; |
|
|
|
/** |
|
* Initializes the constant tables. |
|
*/ |
|
function _init() { |
|
// create padding |
|
_padding = String.fromCharCode(128); |
|
_padding += forge.util.fillString(String.fromCharCode(0x00), 64); |
|
|
|
// create K table for SHA-256 |
|
_k = [ |
|
0x428a2f98, 0x71374491, 0xb5c0fbcf, 0xe9b5dba5, |
|
0x3956c25b, 0x59f111f1, 0x923f82a4, 0xab1c5ed5, |
|
0xd807aa98, 0x12835b01, 0x243185be, 0x550c7dc3, |
|
0x72be5d74, 0x80deb1fe, 0x9bdc06a7, 0xc19bf174, |
|
0xe49b69c1, 0xefbe4786, 0x0fc19dc6, 0x240ca1cc, |
|
0x2de92c6f, 0x4a7484aa, 0x5cb0a9dc, 0x76f988da, |
|
0x983e5152, 0xa831c66d, 0xb00327c8, 0xbf597fc7, |
|
0xc6e00bf3, 0xd5a79147, 0x06ca6351, 0x14292967, |
|
0x27b70a85, 0x2e1b2138, 0x4d2c6dfc, 0x53380d13, |
|
0x650a7354, 0x766a0abb, 0x81c2c92e, 0x92722c85, |
|
0xa2bfe8a1, 0xa81a664b, 0xc24b8b70, 0xc76c51a3, |
|
0xd192e819, 0xd6990624, 0xf40e3585, 0x106aa070, |
|
0x19a4c116, 0x1e376c08, 0x2748774c, 0x34b0bcb5, |
|
0x391c0cb3, 0x4ed8aa4a, 0x5b9cca4f, 0x682e6ff3, |
|
0x748f82ee, 0x78a5636f, 0x84c87814, 0x8cc70208, |
|
0x90befffa, 0xa4506ceb, 0xbef9a3f7, 0xc67178f2]; |
|
|
|
// now initialized |
|
_initialized = true; |
|
} |
|
|
|
/** |
|
* Updates a SHA-256 state with the given byte buffer. |
|
* |
|
* @param s the SHA-256 state to update. |
|
* @param w the array to use to store words. |
|
* @param bytes the byte buffer to update with. |
|
*/ |
|
function _update(s, w, bytes) { |
|
// consume 512 bit (64 byte) chunks |
|
var t1, t2, s0, s1, ch, maj, i, a, b, c, d, e, f, g, h; |
|
var len = bytes.length(); |
|
while(len >= 64) { |
|
// the w array will be populated with sixteen 32-bit big-endian words |
|
// and then extended into 64 32-bit words according to SHA-256 |
|
for(i = 0; i < 16; ++i) { |
|
w[i] = bytes.getInt32(); |
|
} |
|
for(; i < 64; ++i) { |
|
// XOR word 2 words ago rot right 17, rot right 19, shft right 10 |
|
t1 = w[i - 2]; |
|
t1 = |
|
((t1 >>> 17) | (t1 << 15)) ^ |
|
((t1 >>> 19) | (t1 << 13)) ^ |
|
(t1 >>> 10); |
|
// XOR word 15 words ago rot right 7, rot right 18, shft right 3 |
|
t2 = w[i - 15]; |
|
t2 = |
|
((t2 >>> 7) | (t2 << 25)) ^ |
|
((t2 >>> 18) | (t2 << 14)) ^ |
|
(t2 >>> 3); |
|
// sum(t1, word 7 ago, t2, word 16 ago) modulo 2^32 |
|
w[i] = (t1 + w[i - 7] + t2 + w[i - 16]) | 0; |
|
} |
|
|
|
// initialize hash value for this chunk |
|
a = s.h0; |
|
b = s.h1; |
|
c = s.h2; |
|
d = s.h3; |
|
e = s.h4; |
|
f = s.h5; |
|
g = s.h6; |
|
h = s.h7; |
|
|
|
// round function |
|
for(i = 0; i < 64; ++i) { |
|
// Sum1(e) |
|
s1 = |
|
((e >>> 6) | (e << 26)) ^ |
|
((e >>> 11) | (e << 21)) ^ |
|
((e >>> 25) | (e << 7)); |
|
// Ch(e, f, g) (optimized the same way as SHA-1) |
|
ch = g ^ (e & (f ^ g)); |
|
// Sum0(a) |
|
s0 = |
|
((a >>> 2) | (a << 30)) ^ |
|
((a >>> 13) | (a << 19)) ^ |
|
((a >>> 22) | (a << 10)); |
|
// Maj(a, b, c) (optimized the same way as SHA-1) |
|
maj = (a & b) | (c & (a ^ b)); |
|
|
|
// main algorithm |
|
t1 = h + s1 + ch + _k[i] + w[i]; |
|
t2 = s0 + maj; |
|
h = g; |
|
g = f; |
|
f = e; |
|
// `>>> 0` necessary to avoid iOS/Safari 10 optimization bug |
|
// can't truncate with `| 0` |
|
e = (d + t1) >>> 0; |
|
d = c; |
|
c = b; |
|
b = a; |
|
// `>>> 0` necessary to avoid iOS/Safari 10 optimization bug |
|
// can't truncate with `| 0` |
|
a = (t1 + t2) >>> 0; |
|
} |
|
|
|
// update hash state |
|
s.h0 = (s.h0 + a) | 0; |
|
s.h1 = (s.h1 + b) | 0; |
|
s.h2 = (s.h2 + c) | 0; |
|
s.h3 = (s.h3 + d) | 0; |
|
s.h4 = (s.h4 + e) | 0; |
|
s.h5 = (s.h5 + f) | 0; |
|
s.h6 = (s.h6 + g) | 0; |
|
s.h7 = (s.h7 + h) | 0; |
|
len -= 64; |
|
} |
|
}
|
|
|