source: Dev/trunk/src/client/dojox/encoding/crypto/SimpleAES.js @ 527

Last change on this file since 527 was 483, checked in by hendrikvanantwerpen, 11 years ago

Added Dojo 1.9.3 release.

File size: 13.4 KB
Line 
1define(["../base64", "./_base"],
2 function(base64, crypto){
3
4        // Sbox is pre-computed multiplicative inverse in GF(2^8) used in SubBytes and KeyExpansion [5.1.1]
5        var Sbox =      [0x63,0x7c,0x77,0x7b,0xf2,0x6b,0x6f,0xc5,0x30,0x01,0x67,0x2b,0xfe,0xd7,0xab,0x76,
6                                 0xca,0x82,0xc9,0x7d,0xfa,0x59,0x47,0xf0,0xad,0xd4,0xa2,0xaf,0x9c,0xa4,0x72,0xc0,
7                                 0xb7,0xfd,0x93,0x26,0x36,0x3f,0xf7,0xcc,0x34,0xa5,0xe5,0xf1,0x71,0xd8,0x31,0x15,
8                                 0x04,0xc7,0x23,0xc3,0x18,0x96,0x05,0x9a,0x07,0x12,0x80,0xe2,0xeb,0x27,0xb2,0x75,
9                                 0x09,0x83,0x2c,0x1a,0x1b,0x6e,0x5a,0xa0,0x52,0x3b,0xd6,0xb3,0x29,0xe3,0x2f,0x84,
10                                 0x53,0xd1,0x00,0xed,0x20,0xfc,0xb1,0x5b,0x6a,0xcb,0xbe,0x39,0x4a,0x4c,0x58,0xcf,
11                                 0xd0,0xef,0xaa,0xfb,0x43,0x4d,0x33,0x85,0x45,0xf9,0x02,0x7f,0x50,0x3c,0x9f,0xa8,
12                                 0x51,0xa3,0x40,0x8f,0x92,0x9d,0x38,0xf5,0xbc,0xb6,0xda,0x21,0x10,0xff,0xf3,0xd2,
13                                 0xcd,0x0c,0x13,0xec,0x5f,0x97,0x44,0x17,0xc4,0xa7,0x7e,0x3d,0x64,0x5d,0x19,0x73,
14                                 0x60,0x81,0x4f,0xdc,0x22,0x2a,0x90,0x88,0x46,0xee,0xb8,0x14,0xde,0x5e,0x0b,0xdb,
15                                 0xe0,0x32,0x3a,0x0a,0x49,0x06,0x24,0x5c,0xc2,0xd3,0xac,0x62,0x91,0x95,0xe4,0x79,
16                                 0xe7,0xc8,0x37,0x6d,0x8d,0xd5,0x4e,0xa9,0x6c,0x56,0xf4,0xea,0x65,0x7a,0xae,0x08,
17                                 0xba,0x78,0x25,0x2e,0x1c,0xa6,0xb4,0xc6,0xe8,0xdd,0x74,0x1f,0x4b,0xbd,0x8b,0x8a,
18                                 0x70,0x3e,0xb5,0x66,0x48,0x03,0xf6,0x0e,0x61,0x35,0x57,0xb9,0x86,0xc1,0x1d,0x9e,
19                                 0xe1,0xf8,0x98,0x11,0x69,0xd9,0x8e,0x94,0x9b,0x1e,0x87,0xe9,0xce,0x55,0x28,0xdf,
20                                 0x8c,0xa1,0x89,0x0d,0xbf,0xe6,0x42,0x68,0x41,0x99,0x2d,0x0f,0xb0,0x54,0xbb,0x16];
21
22        // Rcon is Round Constant used for the Key Expansion [1st col is 2^(r-1) in GF(2^8)] [5.2]
23        var Rcon = [ [0x00, 0x00, 0x00, 0x00],
24                                 [0x01, 0x00, 0x00, 0x00],
25                                 [0x02, 0x00, 0x00, 0x00],
26                                 [0x04, 0x00, 0x00, 0x00],
27                                 [0x08, 0x00, 0x00, 0x00],
28                                 [0x10, 0x00, 0x00, 0x00],
29                                 [0x20, 0x00, 0x00, 0x00],
30                                 [0x40, 0x00, 0x00, 0x00],
31                                 [0x80, 0x00, 0x00, 0x00],
32                                 [0x1b, 0x00, 0x00, 0x00],
33                                 [0x36, 0x00, 0x00, 0x00] ];
34
35        /*
36         * AES Cipher function: encrypt 'input' with Rijndael algorithm
37         *
38         *       takes   byte-array 'input' (16 bytes)
39         *                       2D byte-array key schedule 'w' (Nr+1 x Nb bytes)
40         *
41         *       applies Nr rounds (10/12/14) using key schedule w for 'add round key' stage
42         *
43         *       returns byte-array encrypted value (16 bytes)
44         */
45        function Cipher(input, w) {        // main Cipher function [ᅵᅵ5.1]
46          var Nb = 4;                           // block size (in words): no of columns in state (fixed at 4 for AES)
47          var Nr = w.length/Nb - 1; // no of rounds: 10/12/14 for 128/192/256-bit keys
48
49          var state = [[],[],[],[]];  // initialise 4xNb byte-array 'state' with input [3.4]
50          for (var i=0; i<4*Nb; i++) state[i%4][Math.floor(i/4)] = input[i];
51
52          state = AddRoundKey(state, w, 0, Nb);
53
54          for (var round=1; round<Nr; round++) {
55                state = SubBytes(state, Nb);
56                state = ShiftRows(state, Nb);
57                state = MixColumns(state, Nb);
58                state = AddRoundKey(state, w, round, Nb);
59          }
60
61          state = SubBytes(state, Nb);
62          state = ShiftRows(state, Nb);
63          state = AddRoundKey(state, w, Nr, Nb);
64
65          var output = new Array(4*Nb);  // convert state to 1-d array before returning [3.4]
66          for (var i=0; i<4*Nb; i++) output[i] = state[i%4][Math.floor(i/4)];
67          return output;
68        }
69
70
71        function SubBytes(s, Nb) {        // apply SBox to state S [5.1.1]
72          for (var r=0; r<4; r++) {
73                for (var c=0; c<Nb; c++) s[r][c] = Sbox[s[r][c]];
74          }
75          return s;
76        }
77
78
79        function ShiftRows(s, Nb) {        // shift row r of state S left by r bytes [5.1.2]
80          var t = new Array(4);
81          for (var r=1; r<4; r++) {
82                for (var c=0; c<4; c++) t[c] = s[r][(c+r)%Nb];  // shift into temp copy
83                for (var c=0; c<4; c++) s[r][c] = t[c];                 // and copy back
84          }                      // note that this will work for Nb=4,5,6, but not 7,8 (always 4 for AES):
85          return s;      // see fp.gladman.plus.com/cryptography_technology/rijndael/aes.spec.311.pdf
86        }
87
88
89        function MixColumns(s, Nb) {   // combine bytes of each col of state S [5.1.3]
90          for (var c=0; c<4; c++) {
91                var a = new Array(4);  // 'a' is a copy of the current column from 's'
92                var b = new Array(4);  // 'b' is aᅵށ{02} in GF(2^8)
93                for (var i=0; i<4; i++) {
94                  a[i] = s[i][c];
95                  b[i] = s[i][c]&0x80 ? s[i][c]<<1 ^ 0x011b : s[i][c]<<1;
96                }
97                // a[n] ^ b[n] is aᅵށ{03} in GF(2^8)
98                s[0][c] = b[0] ^ a[1] ^ b[1] ^ a[2] ^ a[3]; // 2*a0 + 3*a1 + a2 + a3
99                s[1][c] = a[0] ^ b[1] ^ a[2] ^ b[2] ^ a[3]; // a0 * 2*a1 + 3*a2 + a3
100                s[2][c] = a[0] ^ a[1] ^ b[2] ^ a[3] ^ b[3]; // a0 + a1 + 2*a2 + 3*a3
101                s[3][c] = a[0] ^ b[0] ^ a[1] ^ a[2] ^ b[3]; // 3*a0 + a1 + a2 + 2*a3
102          }
103          return s;
104        }
105
106
107        function AddRoundKey(state, w, rnd, Nb) {  // xor Round Key into state S [5.1.4]
108          for (var r=0; r<4; r++) {
109                for (var c=0; c<Nb; c++) state[r][c] ^= w[rnd*4+c][r];
110          }
111          return state;
112        }
113
114
115        function KeyExpansion(key) {  // generate Key Schedule (byte-array Nr+1 x Nb) from Key [5.2]
116          var Nb = 4;                    // block size (in words): no of columns in state (fixed at 4 for AES)
117          var Nk = key.length/4  // key length (in words): 4/6/8 for 128/192/256-bit keys
118          var Nr = Nk + 6;               // no of rounds: 10/12/14 for 128/192/256-bit keys
119
120          var w = new Array(Nb*(Nr+1));
121          var temp = new Array(4);
122
123          for (var i=0; i<Nk; i++) {
124                var r = [key[4*i], key[4*i+1], key[4*i+2], key[4*i+3]];
125                w[i] = r;
126          }
127
128          for (var i=Nk; i<(Nb*(Nr+1)); i++) {
129                w[i] = new Array(4);
130                for (var t=0; t<4; t++) temp[t] = w[i-1][t];
131                if (i % Nk == 0) {
132                  temp = SubWord(RotWord(temp));
133                  for (var t=0; t<4; t++) temp[t] ^= Rcon[i/Nk][t];
134                } else if (Nk > 6 && i%Nk == 4) {
135                  temp = SubWord(temp);
136                }
137                for (var t=0; t<4; t++) w[i][t] = w[i-Nk][t] ^ temp[t];
138          }
139
140          return w;
141        }
142
143        function SubWord(w) {    // apply SBox to 4-byte word w
144          for (var i=0; i<4; i++) w[i] = Sbox[w[i]];
145          return w;
146        }
147
148        function RotWord(w) {    // rotate 4-byte word w left by one byte
149          w[4] = w[0];
150          for (var i=0; i<4; i++) w[i] = w[i+1];
151          return w;
152        }
153
154        /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -  */
155
156        /*
157         * Use AES to encrypt 'plaintext' with 'password' using 'nBits' key, in 'Counter' mode of operation
158         *                                                       - see http://csrc.nist.gov/publications/nistpubs/800-38a/sp800-38a.pdf
159         *       for each block
160         *       - outputblock = cipher(counter, key)
161         *       - cipherblock = plaintext xor outputblock
162         */
163        function AESEncryptCtr(plaintext, password, nBits) {
164          if (!(nBits==128 || nBits==192 || nBits==256)) return '';      // standard allows 128/192/256 bit keys
165
166          // for this example script, generate the key by applying Cipher to 1st 16/24/32 chars of password;
167          // for real-world applications, a more secure approach would be to hash the password e.g. with SHA-1
168          var nBytes = nBits/8;  // no bytes in key
169          var pwBytes = new Array(nBytes);
170          for (var i=0; i<nBytes; i++) pwBytes[i] = password.charCodeAt(i) & 0xff;
171
172          var key = Cipher(pwBytes, KeyExpansion(pwBytes));
173
174          key = key.concat(key.slice(0, nBytes-16));  // key is now 16/24/32 bytes long
175
176          // initialise counter block (NIST SP800-38A B.2): millisecond time-stamp for nonce in 1st 8 bytes,
177          // block counter in 2nd 8 bytes
178          var blockSize = 16;  // block size fixed at 16 bytes / 128 bits (Nb=4) for AES
179          var counterBlock = new Array(blockSize);      // block size fixed at 16 bytes / 128 bits (Nb=4) for AES
180          var nonce = (new Date()).getTime();  // milliseconds since 1-Jan-1970
181
182          // encode nonce in two stages to cater for JavaScript 32-bit limit on bitwise ops
183          for (var i=0; i<4; i++) counterBlock[i] = (nonce >>> i*8) & 0xff;
184          for (var i=0; i<4; i++) counterBlock[i+4] = (nonce/0x100000000 >>> i*8) & 0xff;
185
186          // generate key schedule - an expansion of the key into distinct Key Rounds for each round
187          var keySchedule = KeyExpansion(key);
188
189          var blockCount = Math.ceil(plaintext.length/blockSize);
190          var ciphertext = new Array(blockCount);  // ciphertext as array of strings
191
192          for (var b=0; b<blockCount; b++) {
193                // set counter (block #) in last 8 bytes of counter block (leaving nonce in 1st 8 bytes)
194                // again done in two stages for 32-bit ops
195                for (var c=0; c<4; c++) counterBlock[15-c] = (b >>> c*8) & 0xff;
196                for (var c=0; c<4; c++) counterBlock[15-c-4] = (b/0x100000000 >>> c*8)
197
198                var cipherCntr = Cipher(counterBlock, keySchedule);      // -- encrypt counter block --
199
200                // calculate length of final block:
201                var blockLength = b<blockCount-1 ? blockSize : (plaintext.length-1)%blockSize+1;
202
203                var ct = '';
204                for (var i=0; i<blockLength; i++) {      // -- xor plaintext with ciphered counter byte-by-byte --
205                  var plaintextByte = plaintext.charCodeAt(b*blockSize+i);
206                  var cipherByte = plaintextByte ^ cipherCntr[i];
207                  //ct += String.fromCharCode(cipherByte);
208                  ct += ((cipherByte < 16) ? "0" : "") + cipherByte.toString(16);
209                }
210                // ct is now ciphertext for this block
211
212                ciphertext[b] = ct; // escCtrlChars(ct);  // escape troublesome characters in ciphertext
213          }
214
215          // convert the nonce to a string to go on the front of the ciphertext
216          var ctrTxt = '';
217          for (var i=0; i<8; i++) ctrTxt += ((counterBlock[i] < 16) ? "0" : "") + counterBlock[i].toString(16); //String.fromCharCode(counterBlock[i]);
218          //ctrTxt = escCtrlChars(ctrTxt);
219
220          // use '-' to separate blocks, use Array.join to concatenate arrays of strings for efficiency
221          return ctrTxt + ' ' + ciphertext.join(' ');
222        }
223
224        function stringToHex(s){
225                var ret = [];
226                s.replace(/(..)/g, function(str){
227                        ret.push(parseInt(str, 16));
228                });
229                return ret;
230        }
231
232        /*
233         * Use AES to decrypt 'ciphertext' with 'password' using 'nBits' key, in Counter mode of operation
234         *
235         *       for each block
236         *       - outputblock = cipher(counter, key)
237         *       - cipherblock = plaintext xor outputblock
238         */
239        function AESDecryptCtr(ciphertext, password, nBits) {
240          if (!(nBits==128 || nBits==192 || nBits==256)) return '';      // standard allows 128/192/256 bit keys
241
242          var nBytes = nBits/8;  // no bytes in key
243          var pwBytes = new Array(nBytes);
244          for (var i=0; i<nBytes; i++) pwBytes[i] = password.charCodeAt(i) & 0xff;
245          var pwKeySchedule = KeyExpansion(pwBytes);
246          var key = Cipher(pwBytes, pwKeySchedule);
247          key = key.concat(key.slice(0, nBytes-16));  // key is now 16/24/32 bytes long
248
249          var keySchedule = KeyExpansion(key);
250
251          ciphertext = ciphertext.split(' ');  // split ciphertext into array of block-length strings
252
253          // recover nonce from 1st element of ciphertext
254          var blockSize = 16;  // block size fixed at 16 bytes / 128 bits (Nb=4) for AES
255          var counterBlock = new Array(blockSize);
256          var ctrTxt = ciphertext[0]; //unescCtrlChars(ciphertext[0]);
257          counterBlock = stringToHex(ctrTxt);
258
259          var plaintext = new Array(ciphertext.length-1);
260
261          for (var b=1; b<ciphertext.length; b++) {
262                // set counter (block #) in last 8 bytes of counter block (leaving nonce in 1st 8 bytes)
263                for (var c=0; c<4; c++) counterBlock[15-c] = ((b-1) >>> c*8) & 0xff;
264                for (var c=0; c<4; c++) counterBlock[15-c-4] = ((b/0x100000000-1) >>> c*8) & 0xff;
265
266                var cipherCntr = Cipher(counterBlock, keySchedule);      // encrypt counter block
267
268                //ciphertext[b] = ciphertext[b]; //unescCtrlChars(ciphertext[b]);
269
270                var pt = '';
271                var tmp = stringToHex(ciphertext[b]);
272                for (var i=0; i<tmp.length; i++) {
273                  // -- xor plaintext with ciphered counter byte-by-byte --
274                  var ciphertextByte = ciphertext[b].charCodeAt(i);
275                  var plaintextByte = tmp[i] ^ cipherCntr[i];
276                  pt += String.fromCharCode(plaintextByte);
277                }
278                // pt is now plaintext for this block
279
280                plaintext[b-1] = pt;  // b-1 'cos no initial nonce block in plaintext
281          }
282
283          return plaintext.join('');
284        }
285
286        /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -  */
287
288        function escCtrlChars(str) {  // escape control chars which might cause problems handling ciphertext
289          return str.replace(/[\0\t\n\v\f\r\xa0!-]/g, function(c) { return '!' + c.charCodeAt(0) + '!'; });
290        }  // \xa0 to cater for bug in Firefox; include '-' to leave it free for use as a block marker
291
292        function unescCtrlChars(str) {  // unescape potentially problematic control characters
293          return str.replace(/!\d\d?\d?!/g, function(c) { return String.fromCharCode(c.slice(1,-1)); });
294        }
295
296        /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -  */
297
298        crypto.SimpleAES = new (function(){
299                // summary:
300                //              SimpleAES, ported from dojox.sql, and done without the need for
301                //              a Google Gears worker pool.
302                // description:
303                //              Taken from http://www.movable-type.co.uk/scripts/aes.html by
304                //              Chris Veness (CLA signed); adapted for Dojo by Brad Neuberg
305                //              (bkn3 AT columbia.edu) and moved to DojoX crypto by Tom Trenka
306                //              (ttrenka AT gmail.com).
307                //
308                //              A few notes:
309                //              1) This algorithm uses a customized version of CBC mode by creating
310                //              a nonce, using it as an initialization vector, and storing the
311                //              IV as the first portion of the encrypted text.  Because of this, it
312                //              is HIGHLY PROBABLE that it will NOT be usable by other AES implementations.
313                //              2) All encoding is done in hex format; other encoding formats (such
314                //              as base 64) are not supported.
315                //              3) The bit depth of the key is hardcoded at 256, despite the ability
316                //              of the code to handle all three recommended bit depths.
317                //              4) The passed key will be padded (as opposed to enforcing a strict
318                //              length) with null bytes.
319                this.encrypt = function(/* String */plaintext, /* String */key){
320                        // summary:
321                        //              Encrypt the passed plaintext using the key, with a
322                        //              hardcoded bit depth of 256.
323                        return AESEncryptCtr(plaintext, key, 256);      //      String
324                };
325                this.decrypt = function(/* String */ciphertext, /* String */key){
326                        // summary:
327                        //              Decrypt the passed ciphertext using the key at a fixed
328                        //              bit depth of 256.
329                        return AESDecryptCtr(ciphertext, key, 256);     //      String
330                };
331        })();
332
333        return crypto.SimpleAES;
334});
Note: See TracBrowser for help on using the repository browser.