Rijndael.php 56 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479
  1. <?php
  2. /* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4: */
  3. /**
  4. * Pure-PHP implementation of Rijndael.
  5. *
  6. * Does not use mcrypt, even when available, for reasons that are explained below.
  7. *
  8. * PHP versions 4 and 5
  9. *
  10. * If {@link Crypt_Rijndael::setBlockLength() setBlockLength()} isn't called, it'll be assumed to be 128 bits. If
  11. * {@link Crypt_Rijndael::setKeyLength() setKeyLength()} isn't called, it'll be calculated from
  12. * {@link Crypt_Rijndael::setKey() setKey()}. ie. if the key is 128-bits, the key length will be 128-bits. If it's
  13. * 136-bits it'll be null-padded to 160-bits and 160 bits will be the key length until
  14. * {@link Crypt_Rijndael::setKey() setKey()} is called, again, at which point, it'll be recalculated.
  15. *
  16. * Not all Rijndael implementations may support 160-bits or 224-bits as the block length / key length. mcrypt, for example,
  17. * does not. AES, itself, only supports block lengths of 128 and key lengths of 128, 192, and 256.
  18. * {@link http://csrc.nist.gov/archive/aes/rijndael/Rijndael-ammended.pdf#page=10 Rijndael-ammended.pdf#page=10} defines the
  19. * algorithm for block lengths of 192 and 256 but not for block lengths / key lengths of 160 and 224. Indeed, 160 and 224
  20. * are first defined as valid key / block lengths in
  21. * {@link http://csrc.nist.gov/archive/aes/rijndael/Rijndael-ammended.pdf#page=44 Rijndael-ammended.pdf#page=44}:
  22. * Extensions: Other block and Cipher Key lengths.
  23. *
  24. * {@internal The variable names are the same as those in
  25. * {@link http://www.csrc.nist.gov/publications/fips/fips197/fips-197.pdf#page=10 fips-197.pdf#page=10}.}}
  26. *
  27. * Here's a short example of how to use this library:
  28. * <code>
  29. * <?php
  30. * include('Crypt/Rijndael.php');
  31. *
  32. * $rijndael = new Crypt_Rijndael();
  33. *
  34. * $rijndael->setKey('abcdefghijklmnop');
  35. *
  36. * $size = 10 * 1024;
  37. * $plaintext = '';
  38. * for ($i = 0; $i < $size; $i++) {
  39. * $plaintext.= 'a';
  40. * }
  41. *
  42. * echo $rijndael->decrypt($rijndael->encrypt($plaintext));
  43. * ?>
  44. * </code>
  45. *
  46. * LICENSE: Permission is hereby granted, free of charge, to any person obtaining a copy
  47. * of this software and associated documentation files (the "Software"), to deal
  48. * in the Software without restriction, including without limitation the rights
  49. * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  50. * copies of the Software, and to permit persons to whom the Software is
  51. * furnished to do so, subject to the following conditions:
  52. *
  53. * The above copyright notice and this permission notice shall be included in
  54. * all copies or substantial portions of the Software.
  55. *
  56. * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  57. * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  58. * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  59. * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  60. * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  61. * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  62. * THE SOFTWARE.
  63. *
  64. * @category Crypt
  65. * @package Crypt_Rijndael
  66. * @author Jim Wigginton <terrafrost@php.net>
  67. * @copyright MMVIII Jim Wigginton
  68. * @license http://www.opensource.org/licenses/mit-license.html MIT License
  69. * @version $Id: Rijndael.php,v 1.12 2010/02/09 06:10:26 terrafrost Exp $
  70. * @link http://phpseclib.sourceforge.net
  71. */
  72. /**#@+
  73. * @access public
  74. * @see Crypt_Rijndael::encrypt()
  75. * @see Crypt_Rijndael::decrypt()
  76. */
  77. /**
  78. * Encrypt / decrypt using the Counter mode.
  79. *
  80. * Set to -1 since that's what Crypt/Random.php uses to index the CTR mode.
  81. *
  82. * @link http://en.wikipedia.org/wiki/Block_cipher_modes_of_operation#Counter_.28CTR.29
  83. */
  84. define('CRYPT_RIJNDAEL_MODE_CTR', -1);
  85. /**
  86. * Encrypt / decrypt using the Electronic Code Book mode.
  87. *
  88. * @link http://en.wikipedia.org/wiki/Block_cipher_modes_of_operation#Electronic_codebook_.28ECB.29
  89. */
  90. define('CRYPT_RIJNDAEL_MODE_ECB', 1);
  91. /**
  92. * Encrypt / decrypt using the Code Book Chaining mode.
  93. *
  94. * @link http://en.wikipedia.org/wiki/Block_cipher_modes_of_operation#Cipher-block_chaining_.28CBC.29
  95. */
  96. define('CRYPT_RIJNDAEL_MODE_CBC', 2);
  97. /**
  98. * Encrypt / decrypt using the Cipher Feedback mode.
  99. *
  100. * @link http://en.wikipedia.org/wiki/Block_cipher_modes_of_operation#Cipher_feedback_.28CFB.29
  101. */
  102. define('CRYPT_RIJNDAEL_MODE_CFB', 3);
  103. /**
  104. * Encrypt / decrypt using the Cipher Feedback mode.
  105. *
  106. * @link http://en.wikipedia.org/wiki/Block_cipher_modes_of_operation#Output_feedback_.28OFB.29
  107. */
  108. define('CRYPT_RIJNDAEL_MODE_OFB', 4);
  109. /**#@-*/
  110. /**#@+
  111. * @access private
  112. * @see Crypt_Rijndael::Crypt_Rijndael()
  113. */
  114. /**
  115. * Toggles the internal implementation
  116. */
  117. define('CRYPT_RIJNDAEL_MODE_INTERNAL', 1);
  118. /**
  119. * Toggles the mcrypt implementation
  120. */
  121. define('CRYPT_RIJNDAEL_MODE_MCRYPT', 2);
  122. /**#@-*/
  123. /**
  124. * Pure-PHP implementation of Rijndael.
  125. *
  126. * @author Jim Wigginton <terrafrost@php.net>
  127. * @version 0.1.0
  128. * @access public
  129. * @package Crypt_Rijndael
  130. */
  131. class Crypt_Rijndael {
  132. /**
  133. * The Encryption Mode
  134. *
  135. * @see Crypt_Rijndael::Crypt_Rijndael()
  136. * @var Integer
  137. * @access private
  138. */
  139. var $mode;
  140. /**
  141. * The Key
  142. *
  143. * @see Crypt_Rijndael::setKey()
  144. * @var String
  145. * @access private
  146. */
  147. var $key = "\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0";
  148. /**
  149. * The Initialization Vector
  150. *
  151. * @see Crypt_Rijndael::setIV()
  152. * @var String
  153. * @access private
  154. */
  155. var $iv = '';
  156. /**
  157. * A "sliding" Initialization Vector
  158. *
  159. * @see Crypt_Rijndael::enableContinuousBuffer()
  160. * @var String
  161. * @access private
  162. */
  163. var $encryptIV = '';
  164. /**
  165. * A "sliding" Initialization Vector
  166. *
  167. * @see Crypt_Rijndael::enableContinuousBuffer()
  168. * @var String
  169. * @access private
  170. */
  171. var $decryptIV = '';
  172. /**
  173. * Continuous Buffer status
  174. *
  175. * @see Crypt_Rijndael::enableContinuousBuffer()
  176. * @var Boolean
  177. * @access private
  178. */
  179. var $continuousBuffer = false;
  180. /**
  181. * Padding status
  182. *
  183. * @see Crypt_Rijndael::enablePadding()
  184. * @var Boolean
  185. * @access private
  186. */
  187. var $padding = true;
  188. /**
  189. * Does the key schedule need to be (re)calculated?
  190. *
  191. * @see setKey()
  192. * @see setBlockLength()
  193. * @see setKeyLength()
  194. * @var Boolean
  195. * @access private
  196. */
  197. var $changed = true;
  198. /**
  199. * Has the key length explicitly been set or should it be derived from the key, itself?
  200. *
  201. * @see setKeyLength()
  202. * @var Boolean
  203. * @access private
  204. */
  205. var $explicit_key_length = false;
  206. /**
  207. * The Key Schedule
  208. *
  209. * @see _setup()
  210. * @var Array
  211. * @access private
  212. */
  213. var $w;
  214. /**
  215. * The Inverse Key Schedule
  216. *
  217. * @see _setup()
  218. * @var Array
  219. * @access private
  220. */
  221. var $dw;
  222. /**
  223. * The Block Length
  224. *
  225. * @see setBlockLength()
  226. * @var Integer
  227. * @access private
  228. * @internal The max value is 32, the min value is 16. All valid values are multiples of 4. Exists in conjunction with
  229. * $Nb because we need this value and not $Nb to pad strings appropriately.
  230. */
  231. var $block_size = 16;
  232. /**
  233. * The Block Length divided by 32
  234. *
  235. * @see setBlockLength()
  236. * @var Integer
  237. * @access private
  238. * @internal The max value is 256 / 32 = 8, the min value is 128 / 32 = 4. Exists in conjunction with $block_size
  239. * because the encryption / decryption / key schedule creation requires this number and not $block_size. We could
  240. * derive this from $block_size or vice versa, but that'd mean we'd have to do multiple shift operations, so in lieu
  241. * of that, we'll just precompute it once.
  242. *
  243. */
  244. var $Nb = 4;
  245. /**
  246. * The Key Length
  247. *
  248. * @see setKeyLength()
  249. * @var Integer
  250. * @access private
  251. * @internal The max value is 256 / 8 = 32, the min value is 128 / 8 = 16. Exists in conjunction with $key_size
  252. * because the encryption / decryption / key schedule creation requires this number and not $key_size. We could
  253. * derive this from $key_size or vice versa, but that'd mean we'd have to do multiple shift operations, so in lieu
  254. * of that, we'll just precompute it once.
  255. */
  256. var $key_size = 16;
  257. /**
  258. * The Key Length divided by 32
  259. *
  260. * @see setKeyLength()
  261. * @var Integer
  262. * @access private
  263. * @internal The max value is 256 / 32 = 8, the min value is 128 / 32 = 4
  264. */
  265. var $Nk = 4;
  266. /**
  267. * The Number of Rounds
  268. *
  269. * @var Integer
  270. * @access private
  271. * @internal The max value is 14, the min value is 10.
  272. */
  273. var $Nr;
  274. /**
  275. * Shift offsets
  276. *
  277. * @var Array
  278. * @access private
  279. */
  280. var $c;
  281. /**
  282. * Precomputed mixColumns table
  283. *
  284. * @see Crypt_Rijndael()
  285. * @var Array
  286. * @access private
  287. */
  288. var $t0;
  289. /**
  290. * Precomputed mixColumns table
  291. *
  292. * @see Crypt_Rijndael()
  293. * @var Array
  294. * @access private
  295. */
  296. var $t1;
  297. /**
  298. * Precomputed mixColumns table
  299. *
  300. * @see Crypt_Rijndael()
  301. * @var Array
  302. * @access private
  303. */
  304. var $t2;
  305. /**
  306. * Precomputed mixColumns table
  307. *
  308. * @see Crypt_Rijndael()
  309. * @var Array
  310. * @access private
  311. */
  312. var $t3;
  313. /**
  314. * Precomputed invMixColumns table
  315. *
  316. * @see Crypt_Rijndael()
  317. * @var Array
  318. * @access private
  319. */
  320. var $dt0;
  321. /**
  322. * Precomputed invMixColumns table
  323. *
  324. * @see Crypt_Rijndael()
  325. * @var Array
  326. * @access private
  327. */
  328. var $dt1;
  329. /**
  330. * Precomputed invMixColumns table
  331. *
  332. * @see Crypt_Rijndael()
  333. * @var Array
  334. * @access private
  335. */
  336. var $dt2;
  337. /**
  338. * Precomputed invMixColumns table
  339. *
  340. * @see Crypt_Rijndael()
  341. * @var Array
  342. * @access private
  343. */
  344. var $dt3;
  345. /**
  346. * Is the mode one that is paddable?
  347. *
  348. * @see Crypt_Rijndael::Crypt_Rijndael()
  349. * @var Boolean
  350. * @access private
  351. */
  352. var $paddable = false;
  353. /**
  354. * Encryption buffer for CTR, OFB and CFB modes
  355. *
  356. * @see Crypt_Rijndael::encrypt()
  357. * @var String
  358. * @access private
  359. */
  360. var $enbuffer = array('encrypted' => '', 'xor' => '');
  361. /**
  362. * Decryption buffer for CTR, OFB and CFB modes
  363. *
  364. * @see Crypt_Rijndael::decrypt()
  365. * @var String
  366. * @access private
  367. */
  368. var $debuffer = array('ciphertext' => '');
  369. /**
  370. * Default Constructor.
  371. *
  372. * Determines whether or not the mcrypt extension should be used. $mode should only, at present, be
  373. * CRYPT_RIJNDAEL_MODE_ECB or CRYPT_RIJNDAEL_MODE_CBC. If not explictly set, CRYPT_RIJNDAEL_MODE_CBC will be used.
  374. *
  375. * @param optional Integer $mode
  376. * @return Crypt_Rijndael
  377. * @access public
  378. */
  379. function Crypt_Rijndael($mode = CRYPT_RIJNDAEL_MODE_CBC)
  380. {
  381. switch ($mode) {
  382. case CRYPT_RIJNDAEL_MODE_ECB:
  383. case CRYPT_RIJNDAEL_MODE_CBC:
  384. $this->paddable = true;
  385. $this->mode = $mode;
  386. break;
  387. case CRYPT_RIJNDAEL_MODE_CTR:
  388. case CRYPT_RIJNDAEL_MODE_CFB:
  389. case CRYPT_RIJNDAEL_MODE_OFB:
  390. $this->mode = $mode;
  391. break;
  392. default:
  393. $this->paddable = true;
  394. $this->mode = CRYPT_RIJNDAEL_MODE_CBC;
  395. }
  396. $t3 = &$this->t3;
  397. $t2 = &$this->t2;
  398. $t1 = &$this->t1;
  399. $t0 = &$this->t0;
  400. $dt3 = &$this->dt3;
  401. $dt2 = &$this->dt2;
  402. $dt1 = &$this->dt1;
  403. $dt0 = &$this->dt0;
  404. // according to <http://csrc.nist.gov/archive/aes/rijndael/Rijndael-ammended.pdf#page=19> (section 5.2.1),
  405. // precomputed tables can be used in the mixColumns phase. in that example, they're assigned t0...t3, so
  406. // those are the names we'll use.
  407. $t3 = array(
  408. 0x6363A5C6, 0x7C7C84F8, 0x777799EE, 0x7B7B8DF6, 0xF2F20DFF, 0x6B6BBDD6, 0x6F6FB1DE, 0xC5C55491,
  409. 0x30305060, 0x01010302, 0x6767A9CE, 0x2B2B7D56, 0xFEFE19E7, 0xD7D762B5, 0xABABE64D, 0x76769AEC,
  410. 0xCACA458F, 0x82829D1F, 0xC9C94089, 0x7D7D87FA, 0xFAFA15EF, 0x5959EBB2, 0x4747C98E, 0xF0F00BFB,
  411. 0xADADEC41, 0xD4D467B3, 0xA2A2FD5F, 0xAFAFEA45, 0x9C9CBF23, 0xA4A4F753, 0x727296E4, 0xC0C05B9B,
  412. 0xB7B7C275, 0xFDFD1CE1, 0x9393AE3D, 0x26266A4C, 0x36365A6C, 0x3F3F417E, 0xF7F702F5, 0xCCCC4F83,
  413. 0x34345C68, 0xA5A5F451, 0xE5E534D1, 0xF1F108F9, 0x717193E2, 0xD8D873AB, 0x31315362, 0x15153F2A,
  414. 0x04040C08, 0xC7C75295, 0x23236546, 0xC3C35E9D, 0x18182830, 0x9696A137, 0x05050F0A, 0x9A9AB52F,
  415. 0x0707090E, 0x12123624, 0x80809B1B, 0xE2E23DDF, 0xEBEB26CD, 0x2727694E, 0xB2B2CD7F, 0x75759FEA,
  416. 0x09091B12, 0x83839E1D, 0x2C2C7458, 0x1A1A2E34, 0x1B1B2D36, 0x6E6EB2DC, 0x5A5AEEB4, 0xA0A0FB5B,
  417. 0x5252F6A4, 0x3B3B4D76, 0xD6D661B7, 0xB3B3CE7D, 0x29297B52, 0xE3E33EDD, 0x2F2F715E, 0x84849713,
  418. 0x5353F5A6, 0xD1D168B9, 0x00000000, 0xEDED2CC1, 0x20206040, 0xFCFC1FE3, 0xB1B1C879, 0x5B5BEDB6,
  419. 0x6A6ABED4, 0xCBCB468D, 0xBEBED967, 0x39394B72, 0x4A4ADE94, 0x4C4CD498, 0x5858E8B0, 0xCFCF4A85,
  420. 0xD0D06BBB, 0xEFEF2AC5, 0xAAAAE54F, 0xFBFB16ED, 0x4343C586, 0x4D4DD79A, 0x33335566, 0x85859411,
  421. 0x4545CF8A, 0xF9F910E9, 0x02020604, 0x7F7F81FE, 0x5050F0A0, 0x3C3C4478, 0x9F9FBA25, 0xA8A8E34B,
  422. 0x5151F3A2, 0xA3A3FE5D, 0x4040C080, 0x8F8F8A05, 0x9292AD3F, 0x9D9DBC21, 0x38384870, 0xF5F504F1,
  423. 0xBCBCDF63, 0xB6B6C177, 0xDADA75AF, 0x21216342, 0x10103020, 0xFFFF1AE5, 0xF3F30EFD, 0xD2D26DBF,
  424. 0xCDCD4C81, 0x0C0C1418, 0x13133526, 0xECEC2FC3, 0x5F5FE1BE, 0x9797A235, 0x4444CC88, 0x1717392E,
  425. 0xC4C45793, 0xA7A7F255, 0x7E7E82FC, 0x3D3D477A, 0x6464ACC8, 0x5D5DE7BA, 0x19192B32, 0x737395E6,
  426. 0x6060A0C0, 0x81819819, 0x4F4FD19E, 0xDCDC7FA3, 0x22226644, 0x2A2A7E54, 0x9090AB3B, 0x8888830B,
  427. 0x4646CA8C, 0xEEEE29C7, 0xB8B8D36B, 0x14143C28, 0xDEDE79A7, 0x5E5EE2BC, 0x0B0B1D16, 0xDBDB76AD,
  428. 0xE0E03BDB, 0x32325664, 0x3A3A4E74, 0x0A0A1E14, 0x4949DB92, 0x06060A0C, 0x24246C48, 0x5C5CE4B8,
  429. 0xC2C25D9F, 0xD3D36EBD, 0xACACEF43, 0x6262A6C4, 0x9191A839, 0x9595A431, 0xE4E437D3, 0x79798BF2,
  430. 0xE7E732D5, 0xC8C8438B, 0x3737596E, 0x6D6DB7DA, 0x8D8D8C01, 0xD5D564B1, 0x4E4ED29C, 0xA9A9E049,
  431. 0x6C6CB4D8, 0x5656FAAC, 0xF4F407F3, 0xEAEA25CF, 0x6565AFCA, 0x7A7A8EF4, 0xAEAEE947, 0x08081810,
  432. 0xBABAD56F, 0x787888F0, 0x25256F4A, 0x2E2E725C, 0x1C1C2438, 0xA6A6F157, 0xB4B4C773, 0xC6C65197,
  433. 0xE8E823CB, 0xDDDD7CA1, 0x74749CE8, 0x1F1F213E, 0x4B4BDD96, 0xBDBDDC61, 0x8B8B860D, 0x8A8A850F,
  434. 0x707090E0, 0x3E3E427C, 0xB5B5C471, 0x6666AACC, 0x4848D890, 0x03030506, 0xF6F601F7, 0x0E0E121C,
  435. 0x6161A3C2, 0x35355F6A, 0x5757F9AE, 0xB9B9D069, 0x86869117, 0xC1C15899, 0x1D1D273A, 0x9E9EB927,
  436. 0xE1E138D9, 0xF8F813EB, 0x9898B32B, 0x11113322, 0x6969BBD2, 0xD9D970A9, 0x8E8E8907, 0x9494A733,
  437. 0x9B9BB62D, 0x1E1E223C, 0x87879215, 0xE9E920C9, 0xCECE4987, 0x5555FFAA, 0x28287850, 0xDFDF7AA5,
  438. 0x8C8C8F03, 0xA1A1F859, 0x89898009, 0x0D0D171A, 0xBFBFDA65, 0xE6E631D7, 0x4242C684, 0x6868B8D0,
  439. 0x4141C382, 0x9999B029, 0x2D2D775A, 0x0F0F111E, 0xB0B0CB7B, 0x5454FCA8, 0xBBBBD66D, 0x16163A2C
  440. );
  441. $dt3 = array(
  442. 0xF4A75051, 0x4165537E, 0x17A4C31A, 0x275E963A, 0xAB6BCB3B, 0x9D45F11F, 0xFA58ABAC, 0xE303934B,
  443. 0x30FA5520, 0x766DF6AD, 0xCC769188, 0x024C25F5, 0xE5D7FC4F, 0x2ACBD7C5, 0x35448026, 0x62A38FB5,
  444. 0xB15A49DE, 0xBA1B6725, 0xEA0E9845, 0xFEC0E15D, 0x2F7502C3, 0x4CF01281, 0x4697A38D, 0xD3F9C66B,
  445. 0x8F5FE703, 0x929C9515, 0x6D7AEBBF, 0x5259DA95, 0xBE832DD4, 0x7421D358, 0xE0692949, 0xC9C8448E,
  446. 0xC2896A75, 0x8E7978F4, 0x583E6B99, 0xB971DD27, 0xE14FB6BE, 0x88AD17F0, 0x20AC66C9, 0xCE3AB47D,
  447. 0xDF4A1863, 0x1A3182E5, 0x51336097, 0x537F4562, 0x6477E0B1, 0x6BAE84BB, 0x81A01CFE, 0x082B94F9,
  448. 0x48685870, 0x45FD198F, 0xDE6C8794, 0x7BF8B752, 0x73D323AB, 0x4B02E272, 0x1F8F57E3, 0x55AB2A66,
  449. 0xEB2807B2, 0xB5C2032F, 0xC57B9A86, 0x3708A5D3, 0x2887F230, 0xBFA5B223, 0x036ABA02, 0x16825CED,
  450. 0xCF1C2B8A, 0x79B492A7, 0x07F2F0F3, 0x69E2A14E, 0xDAF4CD65, 0x05BED506, 0x34621FD1, 0xA6FE8AC4,
  451. 0x2E539D34, 0xF355A0A2, 0x8AE13205, 0xF6EB75A4, 0x83EC390B, 0x60EFAA40, 0x719F065E, 0x6E1051BD,
  452. 0x218AF93E, 0xDD063D96, 0x3E05AEDD, 0xE6BD464D, 0x548DB591, 0xC45D0571, 0x06D46F04, 0x5015FF60,
  453. 0x98FB2419, 0xBDE997D6, 0x4043CC89, 0xD99E7767, 0xE842BDB0, 0x898B8807, 0x195B38E7, 0xC8EEDB79,
  454. 0x7C0A47A1, 0x420FE97C, 0x841EC9F8, 0x00000000, 0x80868309, 0x2BED4832, 0x1170AC1E, 0x5A724E6C,
  455. 0x0EFFFBFD, 0x8538560F, 0xAED51E3D, 0x2D392736, 0x0FD9640A, 0x5CA62168, 0x5B54D19B, 0x362E3A24,
  456. 0x0A67B10C, 0x57E70F93, 0xEE96D2B4, 0x9B919E1B, 0xC0C54F80, 0xDC20A261, 0x774B695A, 0x121A161C,
  457. 0x93BA0AE2, 0xA02AE5C0, 0x22E0433C, 0x1B171D12, 0x090D0B0E, 0x8BC7ADF2, 0xB6A8B92D, 0x1EA9C814,
  458. 0xF1198557, 0x75074CAF, 0x99DDBBEE, 0x7F60FDA3, 0x01269FF7, 0x72F5BC5C, 0x663BC544, 0xFB7E345B,
  459. 0x4329768B, 0x23C6DCCB, 0xEDFC68B6, 0xE4F163B8, 0x31DCCAD7, 0x63851042, 0x97224013, 0xC6112084,
  460. 0x4A247D85, 0xBB3DF8D2, 0xF93211AE, 0x29A16DC7, 0x9E2F4B1D, 0xB230F3DC, 0x8652EC0D, 0xC1E3D077,
  461. 0xB3166C2B, 0x70B999A9, 0x9448FA11, 0xE9642247, 0xFC8CC4A8, 0xF03F1AA0, 0x7D2CD856, 0x3390EF22,
  462. 0x494EC787, 0x38D1C1D9, 0xCAA2FE8C, 0xD40B3698, 0xF581CFA6, 0x7ADE28A5, 0xB78E26DA, 0xADBFA43F,
  463. 0x3A9DE42C, 0x78920D50, 0x5FCC9B6A, 0x7E466254, 0x8D13C2F6, 0xD8B8E890, 0x39F75E2E, 0xC3AFF582,
  464. 0x5D80BE9F, 0xD0937C69, 0xD52DA96F, 0x2512B3CF, 0xAC993BC8, 0x187DA710, 0x9C636EE8, 0x3BBB7BDB,
  465. 0x267809CD, 0x5918F46E, 0x9AB701EC, 0x4F9AA883, 0x956E65E6, 0xFFE67EAA, 0xBCCF0821, 0x15E8E6EF,
  466. 0xE79BD9BA, 0x6F36CE4A, 0x9F09D4EA, 0xB07CD629, 0xA4B2AF31, 0x3F23312A, 0xA59430C6, 0xA266C035,
  467. 0x4EBC3774, 0x82CAA6FC, 0x90D0B0E0, 0xA7D81533, 0x04984AF1, 0xECDAF741, 0xCD500E7F, 0x91F62F17,
  468. 0x4DD68D76, 0xEFB04D43, 0xAA4D54CC, 0x9604DFE4, 0xD1B5E39E, 0x6A881B4C, 0x2C1FB8C1, 0x65517F46,
  469. 0x5EEA049D, 0x8C355D01, 0x877473FA, 0x0B412EFB, 0x671D5AB3, 0xDBD25292, 0x105633E9, 0xD647136D,
  470. 0xD7618C9A, 0xA10C7A37, 0xF8148E59, 0x133C89EB, 0xA927EECE, 0x61C935B7, 0x1CE5EDE1, 0x47B13C7A,
  471. 0xD2DF599C, 0xF2733F55, 0x14CE7918, 0xC737BF73, 0xF7CDEA53, 0xFDAA5B5F, 0x3D6F14DF, 0x44DB8678,
  472. 0xAFF381CA, 0x68C43EB9, 0x24342C38, 0xA3405FC2, 0x1DC37216, 0xE2250CBC, 0x3C498B28, 0x0D9541FF,
  473. 0xA8017139, 0x0CB3DE08, 0xB4E49CD8, 0x56C19064, 0xCB84617B, 0x32B670D5, 0x6C5C7448, 0xB85742D0
  474. );
  475. for ($i = 0; $i < 256; $i++) {
  476. $t2[$i << 8] = (($t3[$i] << 8) & 0xFFFFFF00) | (($t3[$i] >> 24) & 0x000000FF);
  477. $t1[$i << 16] = (($t3[$i] << 16) & 0xFFFF0000) | (($t3[$i] >> 16) & 0x0000FFFF);
  478. $t0[$i << 24] = (($t3[$i] << 24) & 0xFF000000) | (($t3[$i] >> 8) & 0x00FFFFFF);
  479. $dt2[$i << 8] = (($this->dt3[$i] << 8) & 0xFFFFFF00) | (($dt3[$i] >> 24) & 0x000000FF);
  480. $dt1[$i << 16] = (($this->dt3[$i] << 16) & 0xFFFF0000) | (($dt3[$i] >> 16) & 0x0000FFFF);
  481. $dt0[$i << 24] = (($this->dt3[$i] << 24) & 0xFF000000) | (($dt3[$i] >> 8) & 0x00FFFFFF);
  482. }
  483. }
  484. /**
  485. * Sets the key.
  486. *
  487. * Keys can be of any length. Rijndael, itself, requires the use of a key that's between 128-bits and 256-bits long and
  488. * whose length is a multiple of 32. If the key is less than 256-bits and the key length isn't set, we round the length
  489. * up to the closest valid key length, padding $key with null bytes. If the key is more than 256-bits, we trim the
  490. * excess bits.
  491. *
  492. * If the key is not explicitly set, it'll be assumed to be all null bytes.
  493. *
  494. * @access public
  495. * @param String $key
  496. */
  497. function setKey($key)
  498. {
  499. $this->key = $key;
  500. $this->changed = true;
  501. }
  502. /**
  503. * Sets the initialization vector. (optional)
  504. *
  505. * SetIV is not required when CRYPT_RIJNDAEL_MODE_ECB is being used. If not explictly set, it'll be assumed
  506. * to be all zero's.
  507. *
  508. * @access public
  509. * @param String $iv
  510. */
  511. function setIV($iv)
  512. {
  513. $this->encryptIV = $this->decryptIV = $this->iv = str_pad(substr($iv, 0, $this->block_size), $this->block_size, chr(0));
  514. }
  515. /**
  516. * Sets the key length
  517. *
  518. * Valid key lengths are 128, 160, 192, 224, and 256. If the length is less than 128, it will be rounded up to
  519. * 128. If the length is greater then 128 and invalid, it will be rounded down to the closest valid amount.
  520. *
  521. * @access public
  522. * @param Integer $length
  523. */
  524. function setKeyLength($length)
  525. {
  526. $length >>= 5;
  527. if ($length > 8) {
  528. $length = 8;
  529. } else if ($length < 4) {
  530. $length = 4;
  531. }
  532. $this->Nk = $length;
  533. $this->key_size = $length << 2;
  534. $this->explicit_key_length = true;
  535. $this->changed = true;
  536. }
  537. /**
  538. * Sets the password.
  539. *
  540. * Depending on what $method is set to, setPassword()'s (optional) parameters are as follows:
  541. * {@link http://en.wikipedia.org/wiki/PBKDF2 pbkdf2}:
  542. * $hash, $salt, $count
  543. * Set $dkLen by calling setKeyLength()
  544. *
  545. * @param String $password
  546. * @param optional String $method
  547. * @access public
  548. */
  549. function setPassword($password, $method = 'pbkdf2')
  550. {
  551. $key = '';
  552. switch ($method) {
  553. default: // 'pbkdf2'
  554. list(, , $hash, $salt, $count) = func_get_args();
  555. if (!isset($hash)) {
  556. $hash = 'sha1';
  557. }
  558. // WPA and WPA use the SSID as the salt
  559. if (!isset($salt)) {
  560. $salt = 'phpseclib/salt';
  561. }
  562. // RFC2898#section-4.2 uses 1,000 iterations by default
  563. // WPA and WPA2 use 4,096.
  564. if (!isset($count)) {
  565. $count = 1000;
  566. }
  567. if (!class_exists('Crypt_Hash')) {
  568. require_once('Crypt/Hash.php');
  569. }
  570. $i = 1;
  571. while (strlen($key) < $this->key_size) { // $dkLen == $this->key_size
  572. //$dk.= $this->_pbkdf($password, $salt, $count, $i++);
  573. $hmac = new Crypt_Hash();
  574. $hmac->setHash($hash);
  575. $hmac->setKey($password);
  576. $f = $u = $hmac->hash($salt . pack('N', $i++));
  577. for ($j = 2; $j <= $count; $j++) {
  578. $u = $hmac->hash($u);
  579. $f^= $u;
  580. }
  581. $key.= $f;
  582. }
  583. }
  584. $this->setKey(substr($key, 0, $this->key_size));
  585. }
  586. /**
  587. * Sets the block length
  588. *
  589. * Valid block lengths are 128, 160, 192, 224, and 256. If the length is less than 128, it will be rounded up to
  590. * 128. If the length is greater then 128 and invalid, it will be rounded down to the closest valid amount.
  591. *
  592. * @access public
  593. * @param Integer $length
  594. */
  595. function setBlockLength($length)
  596. {
  597. $length >>= 5;
  598. if ($length > 8) {
  599. $length = 8;
  600. } else if ($length < 4) {
  601. $length = 4;
  602. }
  603. $this->Nb = $length;
  604. $this->block_size = $length << 2;
  605. $this->changed = true;
  606. }
  607. /**
  608. * Generate CTR XOR encryption key
  609. *
  610. * Encrypt the output of this and XOR it against the ciphertext / plaintext to get the
  611. * plaintext / ciphertext in CTR mode.
  612. *
  613. * @see Crypt_Rijndael::decrypt()
  614. * @see Crypt_Rijndael::encrypt()
  615. * @access public
  616. * @param Integer $length
  617. * @param String $iv
  618. */
  619. function _generate_xor($length, &$iv)
  620. {
  621. $xor = '';
  622. $block_size = $this->block_size;
  623. $num_blocks = floor(($length + ($block_size - 1)) / $block_size);
  624. for ($i = 0; $i < $num_blocks; $i++) {
  625. $xor.= $iv;
  626. for ($j = 4; $j <= $block_size; $j+=4) {
  627. $temp = substr($iv, -$j, 4);
  628. switch ($temp) {
  629. case "\xFF\xFF\xFF\xFF":
  630. $iv = substr_replace($iv, "\x00\x00\x00\x00", -$j, 4);
  631. break;
  632. case "\x7F\xFF\xFF\xFF":
  633. $iv = substr_replace($iv, "\x80\x00\x00\x00", -$j, 4);
  634. break 2;
  635. default:
  636. extract(unpack('Ncount', $temp));
  637. $iv = substr_replace($iv, pack('N', $count + 1), -$j, 4);
  638. break 2;
  639. }
  640. }
  641. }
  642. return $xor;
  643. }
  644. /**
  645. * Encrypts a message.
  646. *
  647. * $plaintext will be padded with additional bytes such that it's length is a multiple of the block size. Other Rjindael
  648. * implementations may or may not pad in the same manner. Other common approaches to padding and the reasons why it's
  649. * necessary are discussed in the following
  650. * URL:
  651. *
  652. * {@link http://www.di-mgt.com.au/cryptopad.html http://www.di-mgt.com.au/cryptopad.html}
  653. *
  654. * An alternative to padding is to, separately, send the length of the file. This is what SSH, in fact, does.
  655. * strlen($plaintext) will still need to be a multiple of 8, however, arbitrary values can be added to make it that
  656. * length.
  657. *
  658. * @see Crypt_Rijndael::decrypt()
  659. * @access public
  660. * @param String $plaintext
  661. */
  662. function encrypt($plaintext)
  663. {
  664. $this->_setup();
  665. if ($this->paddable) {
  666. $plaintext = $this->_pad($plaintext);
  667. }
  668. $block_size = $this->block_size;
  669. $buffer = &$this->enbuffer;
  670. $continuousBuffer = $this->continuousBuffer;
  671. $ciphertext = '';
  672. switch ($this->mode) {
  673. case CRYPT_RIJNDAEL_MODE_ECB:
  674. for ($i = 0; $i < strlen($plaintext); $i+=$block_size) {
  675. $ciphertext.= $this->_encryptBlock(substr($plaintext, $i, $block_size));
  676. }
  677. break;
  678. case CRYPT_RIJNDAEL_MODE_CBC:
  679. $xor = $this->encryptIV;
  680. for ($i = 0; $i < strlen($plaintext); $i+=$block_size) {
  681. $block = substr($plaintext, $i, $block_size);
  682. $block = $this->_encryptBlock($block ^ $xor);
  683. $xor = $block;
  684. $ciphertext.= $block;
  685. }
  686. if ($this->continuousBuffer) {
  687. $this->encryptIV = $xor;
  688. }
  689. break;
  690. case CRYPT_RIJNDAEL_MODE_CTR:
  691. $xor = $this->encryptIV;
  692. if (!empty($buffer['encrypted'])) {
  693. for ($i = 0; $i < strlen($plaintext); $i+=$block_size) {
  694. $block = substr($plaintext, $i, $block_size);
  695. $buffer['encrypted'].= $this->_encryptBlock($this->_generate_xor($block_size, $xor));
  696. $key = $this->_string_shift($buffer['encrypted'], $block_size);
  697. $ciphertext.= $block ^ $key;
  698. }
  699. } else {
  700. for ($i = 0; $i < strlen($plaintext); $i+=$block_size) {
  701. $block = substr($plaintext, $i, $block_size);
  702. $key = $this->_encryptBlock($this->_generate_xor($block_size, $xor));
  703. $ciphertext.= $block ^ $key;
  704. }
  705. }
  706. if ($this->continuousBuffer) {
  707. $this->encryptIV = $xor;
  708. if ($start = strlen($plaintext) % $block_size) {
  709. $buffer['encrypted'] = substr($key, $start) . $buffer['encrypted'];
  710. }
  711. }
  712. break;
  713. case CRYPT_RIJNDAEL_MODE_CFB:
  714. if (!empty($buffer['xor'])) {
  715. $ciphertext = $plaintext ^ $buffer['xor'];
  716. $iv = $buffer['encrypted'] . $ciphertext;
  717. $start = strlen($ciphertext);
  718. $buffer['encrypted'].= $ciphertext;
  719. $buffer['xor'] = substr($buffer['xor'], strlen($ciphertext));
  720. } else {
  721. $ciphertext = '';
  722. $iv = $this->encryptIV;
  723. $start = 0;
  724. }
  725. for ($i = $start; $i < strlen($plaintext); $i+=$block_size) {
  726. $block = substr($plaintext, $i, $block_size);
  727. $xor = $this->_encryptBlock($iv);
  728. $iv = $block ^ $xor;
  729. if ($continuousBuffer && strlen($iv) != $block_size) {
  730. $buffer = array(
  731. 'encrypted' => $iv,
  732. 'xor' => substr($xor, strlen($iv))
  733. );
  734. }
  735. $ciphertext.= $iv;
  736. }
  737. if ($this->continuousBuffer) {
  738. $this->encryptIV = $iv;
  739. }
  740. break;
  741. case CRYPT_RIJNDAEL_MODE_OFB:
  742. $xor = $this->encryptIV;
  743. if (strlen($buffer)) {
  744. for ($i = 0; $i < strlen($plaintext); $i+=$block_size) {
  745. $xor = $this->_encryptBlock($xor);
  746. $buffer.= $xor;
  747. $key = $this->_string_shift($buffer, $block_size);
  748. $ciphertext.= substr($plaintext, $i, $block_size) ^ $key;
  749. }
  750. } else {
  751. for ($i = 0; $i < strlen($plaintext); $i+=$block_size) {
  752. $xor = $this->_encryptBlock($xor);
  753. $ciphertext.= substr($plaintext, $i, $block_size) ^ $xor;
  754. }
  755. $key = $xor;
  756. }
  757. if ($this->continuousBuffer) {
  758. $this->encryptIV = $xor;
  759. if ($start = strlen($plaintext) % $block_size) {
  760. $buffer = substr($key, $start) . $buffer;
  761. }
  762. }
  763. }
  764. return $ciphertext;
  765. }
  766. /**
  767. * Decrypts a message.
  768. *
  769. * If strlen($ciphertext) is not a multiple of the block size, null bytes will be added to the end of the string until
  770. * it is.
  771. *
  772. * @see Crypt_Rijndael::encrypt()
  773. * @access public
  774. * @param String $ciphertext
  775. */
  776. function decrypt($ciphertext)
  777. {
  778. $this->_setup();
  779. if ($this->paddable) {
  780. // we pad with chr(0) since that's what mcrypt_generic does. to quote from http://php.net/function.mcrypt-generic :
  781. // "The data is padded with "\0" to make sure the length of the data is n * blocksize."
  782. $ciphertext = str_pad($ciphertext, strlen($ciphertext) + ($this->block_size - strlen($ciphertext) % $this->block_size) % $this->block_size, chr(0));
  783. }
  784. $block_size = $this->block_size;
  785. $buffer = &$this->debuffer;
  786. $continuousBuffer = $this->continuousBuffer;
  787. $plaintext = '';
  788. switch ($this->mode) {
  789. case CRYPT_RIJNDAEL_MODE_ECB:
  790. for ($i = 0; $i < strlen($ciphertext); $i+=$block_size) {
  791. $plaintext.= $this->_decryptBlock(substr($ciphertext, $i, $block_size));
  792. }
  793. break;
  794. case CRYPT_RIJNDAEL_MODE_CBC:
  795. $xor = $this->decryptIV;
  796. for ($i = 0; $i < strlen($ciphertext); $i+=$block_size) {
  797. $block = substr($ciphertext, $i, $block_size);
  798. $plaintext.= $this->_decryptBlock($block) ^ $xor;
  799. $xor = $block;
  800. }
  801. if ($this->continuousBuffer) {
  802. $this->decryptIV = $xor;
  803. }
  804. break;
  805. case CRYPT_RIJNDAEL_MODE_CTR:
  806. $xor = $this->decryptIV;
  807. if (!empty($buffer['ciphertext'])) {
  808. for ($i = 0; $i < strlen($ciphertext); $i+=$block_size) {
  809. $block = substr($ciphertext, $i, $block_size);
  810. $buffer['ciphertext'].= $this->_encryptBlock($this->_generate_xor($block_size, $xor));
  811. $key = $this->_string_shift($buffer['ciphertext'], $block_size);
  812. $plaintext.= $block ^ $key;
  813. }
  814. } else {
  815. for ($i = 0; $i < strlen($ciphertext); $i+=$block_size) {
  816. $block = substr($ciphertext, $i, $block_size);
  817. $key = $this->_encryptBlock($this->_generate_xor($block_size, $xor));
  818. $plaintext.= $block ^ $key;
  819. }
  820. }
  821. if ($this->continuousBuffer) {
  822. $this->decryptIV = $xor;
  823. if ($start = strlen($ciphertext) % $block_size) {
  824. $buffer['ciphertext'] = substr($key, $start) . $buffer['encrypted'];
  825. }
  826. }
  827. break;
  828. case CRYPT_RIJNDAEL_MODE_CFB:
  829. if (!empty($buffer['ciphertext'])) {
  830. $plaintext = $ciphertext ^ substr($this->decryptIV, strlen($buffer['ciphertext']));
  831. $buffer['ciphertext'].= substr($ciphertext, 0, strlen($plaintext));
  832. if (strlen($buffer['ciphertext']) == $block_size) {
  833. $xor = $this->_encryptBlock($buffer['ciphertext']);
  834. $buffer['ciphertext'] = '';
  835. }
  836. $start = strlen($plaintext);
  837. $block = $this->decryptIV;
  838. } else {
  839. $plaintext = '';
  840. $xor = $this->_encryptBlock($this->decryptIV);
  841. $start = 0;
  842. }
  843. for ($i = $start; $i < strlen($ciphertext); $i+=$block_size) {
  844. $block = substr($ciphertext, $i, $block_size);
  845. $plaintext.= $block ^ $xor;
  846. if ($continuousBuffer && strlen($block) != $block_size) {
  847. $buffer['ciphertext'].= $block;
  848. $block = $xor;
  849. } else if (strlen($block) == $block_size) {
  850. $xor = $this->_encryptBlock($block);
  851. }
  852. }
  853. if ($this->continuousBuffer) {
  854. $this->decryptIV = $block;
  855. }
  856. break;
  857. case CRYPT_RIJNDAEL_MODE_OFB:
  858. $xor = $this->decryptIV;
  859. if (strlen($buffer)) {
  860. for ($i = 0; $i < strlen($ciphertext); $i+=$block_size) {
  861. $xor = $this->_encryptBlock($xor);
  862. $buffer.= $xor;
  863. $key = $this->_string_shift($buffer, $block_size);
  864. $plaintext.= substr($ciphertext, $i, $block_size) ^ $key;
  865. }
  866. } else {
  867. for ($i = 0; $i < strlen($ciphertext); $i+=$block_size) {
  868. $xor = $this->_encryptBlock($xor);
  869. $plaintext.= substr($ciphertext, $i, $block_size) ^ $xor;
  870. }
  871. $key = $xor;
  872. }
  873. if ($this->continuousBuffer) {
  874. $this->decryptIV = $xor;
  875. if ($start = strlen($ciphertext) % $block_size) {
  876. $buffer = substr($key, $start) . $buffer;
  877. }
  878. }
  879. }
  880. return $this->paddable ? $this->_unpad($plaintext) : $plaintext;
  881. }
  882. /**
  883. * Encrypts a block
  884. *
  885. * @access private
  886. * @param String $in
  887. * @return String
  888. */
  889. function _encryptBlock($in)
  890. {
  891. $state = array();
  892. $words = unpack('N*word', $in);
  893. $w = $this->w;
  894. $t0 = $this->t0;
  895. $t1 = $this->t1;
  896. $t2 = $this->t2;
  897. $t3 = $this->t3;
  898. $Nb = $this->Nb;
  899. $Nr = $this->Nr;
  900. $c = $this->c;
  901. // addRoundKey
  902. $i = 0;
  903. foreach ($words as $word) {
  904. $state[] = $word ^ $w[0][$i++];
  905. }
  906. // fips-197.pdf#page=19, "Figure 5. Pseudo Code for the Cipher", states that this loop has four components -
  907. // subBytes, shiftRows, mixColumns, and addRoundKey. fips-197.pdf#page=30, "Implementation Suggestions Regarding
  908. // Various Platforms" suggests that performs enhanced implementations are described in Rijndael-ammended.pdf.
  909. // Rijndael-ammended.pdf#page=20, "Implementation aspects / 32-bit processor", discusses such an optimization.
  910. // Unfortunately, the description given there is not quite correct. Per aes.spec.v316.pdf#page=19 [1],
  911. // equation (7.4.7) is supposed to use addition instead of subtraction, so we'll do that here, as well.
  912. // [1] http://fp.gladman.plus.com/cryptography_technology/rijndael/aes.spec.v316.pdf
  913. $temp = array();
  914. for ($round = 1; $round < $Nr; $round++) {
  915. $i = 0; // $c[0] == 0
  916. $j = $c[1];
  917. $k = $c[2];
  918. $l = $c[3];
  919. while ($i < $this->Nb) {
  920. $temp[$i] = $t0[$state[$i] & 0xFF000000] ^
  921. $t1[$state[$j] & 0x00FF0000] ^
  922. $t2[$state[$k] & 0x0000FF00] ^
  923. $t3[$state[$l] & 0x000000FF] ^
  924. $w[$round][$i];
  925. $i++;
  926. $j = ($j + 1) % $Nb;
  927. $k = ($k + 1) % $Nb;
  928. $l = ($l + 1) % $Nb;
  929. }
  930. for ($i = 0; $i < $Nb; $i++) {
  931. $state[$i] = $temp[$i];
  932. }
  933. }
  934. // subWord
  935. for ($i = 0; $i < $Nb; $i++) {
  936. $state[$i] = $this->_subWord($state[$i]);
  937. }
  938. // shiftRows + addRoundKey
  939. $i = 0; // $c[0] == 0
  940. $j = $c[1];
  941. $k = $c[2];
  942. $l = $c[3];
  943. while ($i < $this->Nb) {
  944. $temp[$i] = ($state[$i] & 0xFF000000) ^
  945. ($state[$j] & 0x00FF0000) ^
  946. ($state[$k] & 0x0000FF00) ^
  947. ($state[$l] & 0x000000FF) ^
  948. $w[$Nr][$i];
  949. $i++;
  950. $j = ($j + 1) % $Nb;
  951. $k = ($k + 1) % $Nb;
  952. $l = ($l + 1) % $Nb;
  953. }
  954. $state = $temp;
  955. array_unshift($state, 'N*');
  956. return call_user_func_array('pack', $state);
  957. }
  958. /**
  959. * Decrypts a block
  960. *
  961. * @access private
  962. * @param String $in
  963. * @return String
  964. */
  965. function _decryptBlock($in)
  966. {
  967. $state = array();
  968. $words = unpack('N*word', $in);
  969. $num_states = count($state);
  970. $dw = $this->dw;
  971. $dt0 = $this->dt0;
  972. $dt1 = $this->dt1;
  973. $dt2 = $this->dt2;
  974. $dt3 = $this->dt3;
  975. $Nb = $this->Nb;
  976. $Nr = $this->Nr;
  977. $c = $this->c;
  978. // addRoundKey
  979. $i = 0;
  980. foreach ($words as $word) {
  981. $state[] = $word ^ $dw[$Nr][$i++];
  982. }
  983. $temp = array();
  984. for ($round = $Nr - 1; $round > 0; $round--) {
  985. $i = 0; // $c[0] == 0
  986. $j = $Nb - $c[1];
  987. $k = $Nb - $c[2];
  988. $l = $Nb - $c[3];
  989. while ($i < $Nb) {
  990. $temp[$i] = $dt0[$state[$i] & 0xFF000000] ^
  991. $dt1[$state[$j] & 0x00FF0000] ^
  992. $dt2[$state[$k] & 0x0000FF00] ^
  993. $dt3[$state[$l] & 0x000000FF] ^
  994. $dw[$round][$i];
  995. $i++;
  996. $j = ($j + 1) % $Nb;
  997. $k = ($k + 1) % $Nb;
  998. $l = ($l + 1) % $Nb;
  999. }
  1000. for ($i = 0; $i < $Nb; $i++) {
  1001. $state[$i] = $temp[$i];
  1002. }
  1003. }
  1004. // invShiftRows + invSubWord + addRoundKey
  1005. $i = 0; // $c[0] == 0
  1006. $j = $Nb - $c[1];
  1007. $k = $Nb - $c[2];
  1008. $l = $Nb - $c[3];
  1009. while ($i < $Nb) {
  1010. $temp[$i] = $dw[0][$i] ^
  1011. $this->_invSubWord(($state[$i] & 0xFF000000) |
  1012. ($state[$j] & 0x00FF0000) |
  1013. ($state[$k] & 0x0000FF00) |
  1014. ($state[$l] & 0x000000FF));
  1015. $i++;
  1016. $j = ($j + 1) % $Nb;
  1017. $k = ($k + 1) % $Nb;
  1018. $l = ($l + 1) % $Nb;
  1019. }
  1020. $state = $temp;
  1021. array_unshift($state, 'N*');
  1022. return call_user_func_array('pack', $state);
  1023. }
  1024. /**
  1025. * Setup Rijndael
  1026. *
  1027. * Validates all the variables and calculates $Nr - the number of rounds that need to be performed - and $w - the key
  1028. * key schedule.
  1029. *
  1030. * @access private
  1031. */
  1032. function _setup()
  1033. {
  1034. // Each number in $rcon is equal to the previous number multiplied by two in Rijndael's finite field.
  1035. // See http://en.wikipedia.org/wiki/Finite_field_arithmetic#Multiplicative_inverse
  1036. static $rcon = array(0,
  1037. 0x01000000, 0x02000000, 0x04000000, 0x08000000, 0x10000000,
  1038. 0x20000000, 0x40000000, 0x80000000, 0x1B000000, 0x36000000,
  1039. 0x6C000000, 0xD8000000, 0xAB000000, 0x4D000000, 0x9A000000,
  1040. 0x2F000000, 0x5E000000, 0xBC000000, 0x63000000, 0xC6000000,
  1041. 0x97000000, 0x35000000, 0x6A000000, 0xD4000000, 0xB3000000,
  1042. 0x7D000000, 0xFA000000, 0xEF000000, 0xC5000000, 0x91000000
  1043. );
  1044. if (!$this->changed) {
  1045. return;
  1046. }
  1047. if (!$this->explicit_key_length) {
  1048. // we do >> 2, here, and not >> 5, as we do above, since strlen($this->key) tells us the number of bytes - not bits
  1049. $length = strlen($this->key) >> 2;
  1050. if ($length > 8) {
  1051. $length = 8;
  1052. } else if ($length < 4) {
  1053. $length = 4;
  1054. }
  1055. $this->Nk = $length;
  1056. $this->key_size = $length << 2;
  1057. }
  1058. $this->key = str_pad(substr($this->key, 0, $this->key_size), $this->key_size, chr(0));
  1059. $this->encryptIV = $this->decryptIV = $this->iv = str_pad(substr($this->iv, 0, $this->block_size), $this->block_size, chr(0));
  1060. // see Rijndael-ammended.pdf#page=44
  1061. $this->Nr = max($this->Nk, $this->Nb) + 6;
  1062. // shift offsets for Nb = 5, 7 are defined in Rijndael-ammended.pdf#page=44,
  1063. // "Table 8: Shift offsets in Shiftrow for the alternative block lengths"
  1064. // shift offsets for Nb = 4, 6, 8 are defined in Rijndael-ammended.pdf#page=14,
  1065. // "Table 2: Shift offsets for different block lengths"
  1066. switch ($this->Nb) {
  1067. case 4:
  1068. case 5:
  1069. case 6:
  1070. $this->c = array(0, 1, 2, 3);
  1071. break;
  1072. case 7:
  1073. $this->c = array(0, 1, 2, 4);
  1074. break;
  1075. case 8:
  1076. $this->c = array(0, 1, 3, 4);
  1077. }
  1078. $key = $this->key;
  1079. $w = array_values(unpack('N*words', $key));
  1080. $length = $this->Nb * ($this->Nr + 1);
  1081. for ($i = $this->Nk; $i < $length; $i++) {
  1082. $temp = $w[$i - 1];
  1083. if ($i % $this->Nk == 0) {
  1084. // according to <http://php.net/language.types.integer>, "the size of an integer is platform-dependent".
  1085. // on a 32-bit machine, it's 32-bits, and on a 64-bit machine, it's 64-bits. on a 32-bit machine,
  1086. // 0xFFFFFFFF << 8 == 0xFFFFFF00, but on a 64-bit machine, it equals 0xFFFFFFFF00. as such, doing 'and'
  1087. // with 0xFFFFFFFF (or 0xFFFFFF00) on a 32-bit machine is unnecessary, but on a 64-bit machine, it is.
  1088. $temp = (($temp << 8) & 0xFFFFFF00) | (($temp >> 24) & 0x000000FF); // rotWord
  1089. $temp = $this->_subWord($temp) ^ $rcon[$i / $this->Nk];
  1090. } else if ($this->Nk > 6 && $i % $this->Nk == 4) {
  1091. $temp = $this->_subWord($temp);
  1092. }
  1093. $w[$i] = $w[$i - $this->Nk] ^ $temp;
  1094. }
  1095. // convert the key schedule from a vector of $Nb * ($Nr + 1) length to a matrix with $Nr + 1 rows and $Nb columns
  1096. // and generate the inverse key schedule. more specifically,
  1097. // according to <http://csrc.nist.gov/archive/aes/rijndael/Rijndael-ammended.pdf#page=23> (section 5.3.3),
  1098. // "The key expansion for the Inverse Cipher is defined as follows:
  1099. // 1. Apply the Key Expansion.
  1100. // 2. Apply InvMixColumn to all Round Keys except the first and the last one."
  1101. // also, see fips-197.pdf#page=27, "5.3.5 Equivalent Inverse Cipher"
  1102. $temp = array();
  1103. for ($i = $row = $col = 0; $i < $length; $i++, $col++) {
  1104. if ($col == $this->Nb) {
  1105. if ($row == 0) {
  1106. $this->dw[0] = $this->w[0];
  1107. } else {
  1108. // subWord + invMixColumn + invSubWord = invMixColumn
  1109. $j = 0;
  1110. while ($j < $this->Nb) {
  1111. $dw = $this->_subWord($this->w[$row][$j]);
  1112. $temp[$j] = $this->dt0[$dw & 0xFF000000] ^
  1113. $this->dt1[$dw & 0x00FF0000] ^
  1114. $this->dt2[$dw & 0x0000FF00] ^
  1115. $this->dt3[$dw & 0x000000FF];
  1116. $j++;
  1117. }
  1118. $this->dw[$row] = $temp;
  1119. }
  1120. $col = 0;
  1121. $row++;
  1122. }
  1123. $this->w[$row][$col] = $w[$i];
  1124. }
  1125. $this->dw[$row] = $this->w[$row];
  1126. $this->changed = false;
  1127. }
  1128. /**
  1129. * Performs S-Box substitutions
  1130. *
  1131. * @access private
  1132. */
  1133. function _subWord($word)
  1134. {
  1135. static $sbox0, $sbox1, $sbox2, $sbox3;
  1136. if (empty($sbox0)) {
  1137. $sbox0 = array(
  1138. 0x63, 0x7C, 0x77, 0x7B, 0xF2, 0x6B, 0x6F, 0xC5, 0x30, 0x01, 0x67, 0x2B, 0xFE, 0xD7, 0xAB, 0x76,
  1139. 0xCA, 0x82, 0xC9, 0x7D, 0xFA, 0x59, 0x47, 0xF0, 0xAD, 0xD4, 0xA2, 0xAF, 0x9C, 0xA4, 0x72, 0xC0,
  1140. 0xB7, 0xFD, 0x93, 0x26, 0x36, 0x3F, 0xF7, 0xCC, 0x34, 0xA5, 0xE5, 0xF1, 0x71, 0xD8, 0x31, 0x15,
  1141. 0x04, 0xC7, 0x23, 0xC3, 0x18, 0x96, 0x05, 0x9A, 0x07, 0x12, 0x80, 0xE2, 0xEB, 0x27, 0xB2, 0x75,
  1142. 0x09, 0x83, 0x2C, 0x1A, 0x1B, 0x6E, 0x5A, 0xA0, 0x52, 0x3B, 0xD6, 0xB3, 0x29, 0xE3, 0x2F, 0x84,
  1143. 0x53, 0xD1, 0x00, 0xED, 0x20, 0xFC, 0xB1, 0x5B, 0x6A, 0xCB, 0xBE, 0x39, 0x4A, 0x4C, 0x58, 0xCF,
  1144. 0xD0, 0xEF, 0xAA, 0xFB, 0x43, 0x4D, 0x33, 0x85, 0x45, 0xF9, 0x02, 0x7F, 0x50, 0x3C, 0x9F, 0xA8,
  1145. 0x51, 0xA3, 0x40, 0x8F, 0x92, 0x9D, 0x38, 0xF5, 0xBC, 0xB6, 0xDA, 0x21, 0x10, 0xFF, 0xF3, 0xD2,
  1146. 0xCD, 0x0C, 0x13, 0xEC, 0x5F, 0x97, 0x44, 0x17, 0xC4, 0xA7, 0x7E, 0x3D, 0x64, 0x5D, 0x19, 0x73,
  1147. 0x60, 0x81, 0x4F, 0xDC, 0x22, 0x2A, 0x90, 0x88, 0x46, 0xEE, 0xB8, 0x14, 0xDE, 0x5E, 0x0B, 0xDB,
  1148. 0xE0, 0x32, 0x3A, 0x0A, 0x49, 0x06, 0x24, 0x5C, 0xC2, 0xD3, 0xAC, 0x62, 0x91, 0x95, 0xE4, 0x79,
  1149. 0xE7, 0xC8, 0x37, 0x6D, 0x8D, 0xD5, 0x4E, 0xA9, 0x6C, 0x56, 0xF4, 0xEA, 0x65, 0x7A, 0xAE, 0x08,
  1150. 0xBA, 0x78, 0x25, 0x2E, 0x1C, 0xA6, 0xB4, 0xC6, 0xE8, 0xDD, 0x74, 0x1F, 0x4B, 0xBD, 0x8B, 0x8A,
  1151. 0x70, 0x3E, 0xB5, 0x66, 0x48, 0x03, 0xF6, 0x0E, 0x61, 0x35, 0x57, 0xB9, 0x86, 0xC1, 0x1D, 0x9E,
  1152. 0xE1, 0xF8, 0x98, 0x11, 0x69, 0xD9, 0x8E, 0x94, 0x9B, 0x1E, 0x87, 0xE9, 0xCE, 0x55, 0x28, 0xDF,
  1153. 0x8C, 0xA1, 0x89, 0x0D, 0xBF, 0xE6, 0x42, 0x68, 0x41, 0x99, 0x2D, 0x0F, 0xB0, 0x54, 0xBB, 0x16
  1154. );
  1155. $sbox1 = array();
  1156. $sbox2 = array();
  1157. $sbox3 = array();
  1158. for ($i = 0; $i < 256; $i++) {
  1159. $sbox1[$i << 8] = $sbox0[$i] << 8;
  1160. $sbox2[$i << 16] = $sbox0[$i] << 16;
  1161. $sbox3[$i << 24] = $sbox0[$i] << 24;
  1162. }
  1163. }
  1164. return $sbox0[$word & 0x000000FF] |
  1165. $sbox1[$word & 0x0000FF00] |
  1166. $sbox2[$word & 0x00FF0000] |
  1167. $sbox3[$word & 0xFF000000];
  1168. }
  1169. /**
  1170. * Performs inverse S-Box substitutions
  1171. *
  1172. * @access private
  1173. */
  1174. function _invSubWord($word)
  1175. {
  1176. static $sbox0, $sbox1, $sbox2, $sbox3;
  1177. if (empty($sbox0)) {
  1178. $sbox0 = array(
  1179. 0x52, 0x09, 0x6A, 0xD5, 0x30, 0x36, 0xA5, 0x38, 0xBF, 0x40, 0xA3, 0x9E, 0x81, 0xF3, 0xD7, 0xFB,
  1180. 0x7C, 0xE3, 0x39, 0x82, 0x9B, 0x2F, 0xFF, 0x87, 0x34, 0x8E, 0x43, 0x44, 0xC4, 0xDE, 0xE9, 0xCB,
  1181. 0x54, 0x7B, 0x94, 0x32, 0xA6, 0xC2, 0x23, 0x3D, 0xEE, 0x4C, 0x95, 0x0B, 0x42, 0xFA, 0xC3, 0x4E,
  1182. 0x08, 0x2E, 0xA1, 0x66, 0x28, 0xD9, 0x24, 0xB2, 0x76, 0x5B, 0xA2, 0x49, 0x6D, 0x8B, 0xD1, 0x25,
  1183. 0x72, 0xF8, 0xF6, 0x64, 0x86, 0x68, 0x98, 0x16, 0xD4, 0xA4, 0x5C, 0xCC, 0x5D, 0x65, 0xB6, 0x92,
  1184. 0x6C, 0x70, 0x48, 0x50, 0xFD, 0xED, 0xB9, 0xDA, 0x5E, 0x15, 0x46, 0x57, 0xA7, 0x8D, 0x9D, 0x84,
  1185. 0x90, 0xD8, 0xAB, 0x00, 0x8C, 0xBC, 0xD3, 0x0A, 0xF7, 0xE4, 0x58, 0x05, 0xB8, 0xB3, 0x45, 0x06,
  1186. 0xD0, 0x2C, 0x1E, 0x8F, 0xCA, 0x3F, 0x0F, 0x02, 0xC1, 0xAF, 0xBD, 0x03, 0x01, 0x13, 0x8A, 0x6B,
  1187. 0x3A, 0x91, 0x11, 0x41, 0x4F, 0x67, 0xDC, 0xEA, 0x97, 0xF2, 0xCF, 0xCE, 0xF0, 0xB4, 0xE6, 0x73,
  1188. 0x96, 0xAC, 0x74, 0x22, 0xE7, 0xAD, 0x35, 0x85, 0xE2, 0xF9, 0x37, 0xE8, 0x1C, 0x75, 0xDF, 0x6E,
  1189. 0x47, 0xF1, 0x1A, 0x71, 0x1D, 0x29, 0xC5, 0x89, 0x6F, 0xB7, 0x62, 0x0E, 0xAA, 0x18, 0xBE, 0x1B,
  1190. 0xFC, 0x56, 0x3E, 0x4B, 0xC6, 0xD2, 0x79, 0x20, 0x9A, 0xDB, 0xC0, 0xFE, 0x78, 0xCD, 0x5A, 0xF4,
  1191. 0x1F, 0xDD, 0xA8, 0x33, 0x88, 0x07, 0xC7, 0x31, 0xB1, 0x12, 0x10, 0x59, 0x27, 0x80, 0xEC, 0x5F,
  1192. 0x60, 0x51, 0x7F, 0xA9, 0x19, 0xB5, 0x4A, 0x0D, 0x2D, 0xE5, 0x7A, 0x9F, 0x93, 0xC9, 0x9C, 0xEF,
  1193. 0xA0, 0xE0, 0x3B, 0x4D, 0xAE, 0x2A, 0xF5, 0xB0, 0xC8, 0xEB, 0xBB, 0x3C, 0x83, 0x53, 0x99, 0x61,
  1194. 0x17, 0x2B, 0x04, 0x7E, 0xBA, 0x77, 0xD6, 0x26, 0xE1, 0x69, 0x14, 0x63, 0x55, 0x21, 0x0C, 0x7D
  1195. );
  1196. $sbox1 = array();
  1197. $sbox2 = array();
  1198. $sbox3 = array();
  1199. for ($i = 0; $i < 256; $i++) {
  1200. $sbox1[$i << 8] = $sbox0[$i] << 8;
  1201. $sbox2[$i << 16] = $sbox0[$i] << 16;
  1202. $sbox3[$i << 24] = $sbox0[$i] << 24;
  1203. }
  1204. }
  1205. return $sbox0[$word & 0x000000FF] |
  1206. $sbox1[$word & 0x0000FF00] |
  1207. $sbox2[$word & 0x00FF0000] |
  1208. $sbox3[$word & 0xFF000000];
  1209. }
  1210. /**
  1211. * Pad "packets".
  1212. *
  1213. * Rijndael works by encrypting between sixteen and thirty-two bytes at a time, provided that number is also a multiple
  1214. * of four. If you ever need to encrypt or decrypt something that isn't of the proper length, it becomes necessary to
  1215. * pad the input so that it is of the proper length.
  1216. *
  1217. * Padding is enabled by default. Sometimes, however, it is undesirable to pad strings. Such is the case in SSH,
  1218. * where "packets" are padded with random bytes before being encrypted. Unpad these packets and you risk stripping
  1219. * away characters that shouldn't be stripped away. (SSH knows how many bytes are added because the length is
  1220. * transmitted separately)
  1221. *
  1222. * @see Crypt_Rijndael::disablePadding()
  1223. * @access public
  1224. */
  1225. function enablePadding()
  1226. {
  1227. $this->padding = true;
  1228. }
  1229. /**
  1230. * Do not pad packets.
  1231. *
  1232. * @see Crypt_Rijndael::enablePadding()
  1233. * @access public
  1234. */
  1235. function disablePadding()
  1236. {
  1237. $this->padding = false;
  1238. }
  1239. /**
  1240. * Pads a string
  1241. *
  1242. * Pads a string using the RSA PKCS padding standards so that its length is a multiple of the blocksize.
  1243. * $block_size - (strlen($text) % $block_size) bytes are added, each of which is equal to
  1244. * chr($block_size - (strlen($text) % $block_size)
  1245. *
  1246. * If padding is disabled and $text is not a multiple of the blocksize, the string will be padded regardless
  1247. * and padding will, hence forth, be enabled.
  1248. *
  1249. * @see Crypt_Rijndael::_unpad()
  1250. * @access private
  1251. */
  1252. function _pad($text)
  1253. {
  1254. $length = strlen($text);
  1255. if (!$this->padding) {
  1256. if ($length % $this->block_size == 0) {
  1257. return $text;
  1258. } else {
  1259. user_error("The plaintext's length ($length) is not a multiple of the block size ({$this->block_size})", E_USER_NOTICE);
  1260. $this->padding = true;
  1261. }
  1262. }
  1263. $pad = $this->block_size - ($length % $this->block_size);
  1264. return str_pad($text, $length + $pad, chr($pad));
  1265. }
  1266. /**
  1267. * Unpads a string.
  1268. *
  1269. * If padding is enabled and the reported padding length is invalid the encryption key will be assumed to be wrong
  1270. * and false will be returned.
  1271. *
  1272. * @see Crypt_Rijndael::_pad()
  1273. * @access private
  1274. */
  1275. function _unpad($text)
  1276. {
  1277. if (!$this->padding) {
  1278. return $text;
  1279. }
  1280. $length = ord($text[strlen($text) - 1]);
  1281. if (!$length || $length > $this->block_size) {
  1282. return false;
  1283. }
  1284. return substr($text, 0, -$length);
  1285. }
  1286. /**
  1287. * Treat consecutive "packets" as if they are a continuous buffer.
  1288. *
  1289. * Say you have a 32-byte plaintext $plaintext. Using the default behavior, the two following code snippets
  1290. * will yield different outputs:
  1291. *
  1292. * <code>
  1293. * echo $rijndael->encrypt(substr($plaintext, 0, 16));
  1294. * echo $rijndael->encrypt(substr($plaintext, 16, 16));
  1295. * </code>
  1296. * <code>
  1297. * echo $rijndael->encrypt($plaintext);
  1298. * </code>
  1299. *
  1300. * The solution is to enable the continuous buffer. Although this will resolve the above discrepancy, it creates
  1301. * another, as demonstrated with the following:
  1302. *
  1303. * <code>
  1304. * $rijndael->encrypt(substr($plaintext, 0, 16));
  1305. * echo $rijndael->decrypt($des->encrypt(substr($plaintext, 16, 16)));
  1306. * </code>
  1307. * <code>
  1308. * echo $rijndael->decrypt($des->encrypt(substr($plaintext, 16, 16)));
  1309. * </code>
  1310. *
  1311. * With the continuous buffer disabled, these would yield the same output. With it enabled, they yield different
  1312. * outputs. The reason is due to the fact that the initialization vector's change after every encryption /
  1313. * decryption round when the continuous buffer is enabled. When it's disabled, they remain constant.
  1314. *
  1315. * Put another way, when the continuous buffer is enabled, the state of the Crypt_Rijndael() object changes after each
  1316. * encryption / decryption round, whereas otherwise, it'd remain constant. For this reason, it's recommended that
  1317. * continuous buffers not be used. They do offer better security and are, in fact, sometimes required (SSH uses them),
  1318. * however, they are also less intuitive and more likely to cause you problems.
  1319. *
  1320. * @see Crypt_Rijndael::disableContinuousBuffer()
  1321. * @access public
  1322. */
  1323. function enableContinuousBuffer()
  1324. {
  1325. $this->continuousBuffer = true;
  1326. }
  1327. /**
  1328. * Treat consecutive packets as if they are a discontinuous buffer.
  1329. *
  1330. * The default behavior.
  1331. *
  1332. * @see Crypt_Rijndael::enableContinuousBuffer()
  1333. * @access public
  1334. */
  1335. function disableContinuousBuffer()
  1336. {
  1337. $this->continuousBuffer = false;
  1338. $this->encryptIV = $this->iv;
  1339. $this->decryptIV = $this->iv;
  1340. }
  1341. /**
  1342. * String Shift
  1343. *
  1344. * Inspired by array_shift
  1345. *
  1346. * @param String $string
  1347. * @param optional Integer $index
  1348. * @return String
  1349. * @access private
  1350. */
  1351. function _string_shift(&$string, $index = 1)
  1352. {
  1353. $substr = substr($string, 0, $index);
  1354. $string = substr($string, $index);
  1355. return $substr;
  1356. }
  1357. }
  1358. // vim: ts=4:sw=4:et:
  1359. // vim6: fdl=1:
  1360. ?>