2 * Written by Dr Stephen N Henson (steve@openssl.org) for the OpenSSL project
5 /* ====================================================================
6 * Copyright (c) 2015 The OpenSSL Project. All rights reserved.
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions
12 * 1. Redistributions of source code must retain the above copyright
13 * notice, this list of conditions and the following disclaimer.
15 * 2. Redistributions in binary form must reproduce the above copyright
16 * notice, this list of conditions and the following disclaimer in
17 * the documentation and/or other materials provided with the
20 * 3. All advertising materials mentioning features or use of this
21 * software must display the following acknowledgment:
22 * "This product includes software developed by the OpenSSL Project
23 * for use in the OpenSSL Toolkit. (http://www.OpenSSL.org/)"
25 * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
26 * endorse or promote products derived from this software without
27 * prior written permission. For written permission, please contact
28 * licensing@OpenSSL.org.
30 * 5. Products derived from this software may not be called "OpenSSL"
31 * nor may "OpenSSL" appear in their names without prior written
32 * permission of the OpenSSL Project.
34 * 6. Redistributions of any form whatsoever must retain the following
36 * "This product includes software developed by the OpenSSL Project
37 * for use in the OpenSSL Toolkit (http://www.OpenSSL.org/)"
39 * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
40 * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
41 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
42 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
43 * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
44 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
45 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
46 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
47 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
48 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
49 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
50 * OF THE POSSIBILITY OF SUCH DAMAGE.
51 * ====================================================================
53 * This product includes cryptographic software written by Eric Young
54 * (eay@cryptsoft.com). This product includes software written by Tim
55 * Hudson (tjh@cryptsoft.com).
62 #include <openssl/evp.h>
63 #include <openssl/err.h>
64 #include <internal/numbers.h>
66 #ifndef OPENSSL_NO_SCRYPT
68 #define R(a,b) (((a) << (b)) | ((a) >> (32 - (b))))
69 static void salsa208_word_specification(uint32_t inout
[16])
73 memcpy(x
, inout
, sizeof(x
));
74 for (i
= 8; i
> 0; i
-= 2) {
75 x
[4] ^= R(x
[0] + x
[12], 7);
76 x
[8] ^= R(x
[4] + x
[0], 9);
77 x
[12] ^= R(x
[8] + x
[4], 13);
78 x
[0] ^= R(x
[12] + x
[8], 18);
79 x
[9] ^= R(x
[5] + x
[1], 7);
80 x
[13] ^= R(x
[9] + x
[5], 9);
81 x
[1] ^= R(x
[13] + x
[9], 13);
82 x
[5] ^= R(x
[1] + x
[13], 18);
83 x
[14] ^= R(x
[10] + x
[6], 7);
84 x
[2] ^= R(x
[14] + x
[10], 9);
85 x
[6] ^= R(x
[2] + x
[14], 13);
86 x
[10] ^= R(x
[6] + x
[2], 18);
87 x
[3] ^= R(x
[15] + x
[11], 7);
88 x
[7] ^= R(x
[3] + x
[15], 9);
89 x
[11] ^= R(x
[7] + x
[3], 13);
90 x
[15] ^= R(x
[11] + x
[7], 18);
91 x
[1] ^= R(x
[0] + x
[3], 7);
92 x
[2] ^= R(x
[1] + x
[0], 9);
93 x
[3] ^= R(x
[2] + x
[1], 13);
94 x
[0] ^= R(x
[3] + x
[2], 18);
95 x
[6] ^= R(x
[5] + x
[4], 7);
96 x
[7] ^= R(x
[6] + x
[5], 9);
97 x
[4] ^= R(x
[7] + x
[6], 13);
98 x
[5] ^= R(x
[4] + x
[7], 18);
99 x
[11] ^= R(x
[10] + x
[9], 7);
100 x
[8] ^= R(x
[11] + x
[10], 9);
101 x
[9] ^= R(x
[8] + x
[11], 13);
102 x
[10] ^= R(x
[9] + x
[8], 18);
103 x
[12] ^= R(x
[15] + x
[14], 7);
104 x
[13] ^= R(x
[12] + x
[15], 9);
105 x
[14] ^= R(x
[13] + x
[12], 13);
106 x
[15] ^= R(x
[14] + x
[13], 18);
108 for (i
= 0; i
< 16; ++i
)
110 OPENSSL_cleanse(x
, sizeof(x
));
113 static void scryptBlockMix(uint32_t *B_
, uint32_t *B
, uint64_t r
)
118 memcpy(X
, B
+ (r
* 2 - 1) * 16, sizeof(X
));
120 for (i
= 0; i
< r
* 2; i
++) {
121 for (j
= 0; j
< 16; j
++)
123 salsa208_word_specification(X
);
124 memcpy(B_
+ (i
/ 2 + (i
& 1) * r
) * 16, X
, sizeof(X
));
126 OPENSSL_cleanse(X
, sizeof(X
));
129 static void scryptROMix(unsigned char *B
, uint64_t r
, uint64_t N
,
130 uint32_t *X
, uint32_t *T
, uint32_t *V
)
136 /* Convert from little endian input */
137 for (pV
= V
, i
= 0, pB
= B
; i
< 32 * r
; i
++, pV
++) {
141 *pV
|= (uint32_t)*pB
++ << 24;
144 for (i
= 1; i
< N
; i
++, pV
+= 32 * r
)
145 scryptBlockMix(pV
, pV
- 32 * r
, r
);
147 scryptBlockMix(X
, V
+ (N
- 1) * 32 * r
, r
);
149 for (i
= 0; i
< N
; i
++) {
151 j
= X
[16 * (2 * r
- 1)] % N
;
153 for (k
= 0; k
< 32 * r
; k
++)
155 scryptBlockMix(X
, T
, r
);
157 /* Convert output to little endian */
158 for (i
= 0, pB
= B
; i
< 32 * r
; i
++) {
159 uint32_t xtmp
= X
[i
];
161 *pB
++ = (xtmp
>> 8) & 0xff;
162 *pB
++ = (xtmp
>> 16) & 0xff;
163 *pB
++ = (xtmp
>> 24) & 0xff;
168 # define SIZE_MAX ((size_t)-1)
172 * Maximum power of two that will fit in uint64_t: this should work on
173 * most (all?) platforms.
176 #define LOG2_UINT64_MAX (sizeof(uint64_t) * 8 - 1)
179 * Maximum value of p * r:
180 * p <= ((2^32-1) * hLen) / MFLen =>
181 * p <= ((2^32-1) * 32) / (128 * r) =>
186 #define SCRYPT_PR_MAX ((1 << 30) - 1)
189 * Maximum permitted memory allow this to be overridden with Configuration
190 * option: e.g. -DSCRYPT_MAX_MEM=0 for maximum possible.
193 #ifdef SCRYPT_MAX_MEM
194 # if SCRYPT_MAX_MEM == 0
195 # undef SCRYPT_MAX_MEM
197 * Although we could theoretically allocate SIZE_MAX memory that would leave
198 * no memory available for anything else so set limit as half that.
200 # define SCRYPT_MAX_MEM (SIZE_MAX/2)
203 /* Default memory limit: 32 MB */
204 # define SCRYPT_MAX_MEM (1024 * 1024 * 32)
207 int EVP_PBE_scrypt(const char *pass
, size_t passlen
,
208 const unsigned char *salt
, size_t saltlen
,
209 uint64_t N
, uint64_t r
, uint64_t p
, uint64_t maxmem
,
210 unsigned char *key
, size_t keylen
)
215 uint64_t i
, Blen
, Vlen
;
217 /* Sanity check parameters */
218 /* initial check, r,p must be non zero, N >= 2 and a power of 2 */
219 if (r
== 0 || p
== 0 || N
< 2 || (N
& (N
- 1)))
221 /* Check p * r < SCRYPT_PR_MAX avoiding overflow */
222 if (p
> SCRYPT_PR_MAX
/ r
)
226 * Need to check N: if 2^(128 * r / 8) overflows limit this is
227 * automatically satisfied since N <= UINT64_MAX.
230 if (16 * r
<= LOG2_UINT64_MAX
) {
231 if (N
>= (1UL << (16 * r
)))
235 /* Memory checks: check total allocated buffer size fits in uint64_t */
238 * B size in section 5 step 1.S
239 * Note: we know p * 128 * r < UINT64_MAX because we already checked
240 * p * r < SCRYPT_PR_MAX
245 * Check 32 * r * (N + 2) * sizeof(uint32_t) fits in uint64_t.
246 * This is combined size V, X and T (section 4)
248 i
= UINT64_MAX
/ (32 * sizeof(uint32_t));
251 Vlen
= 32 * r
* (N
+ 2) * sizeof(uint32_t);
253 /* check total allocated size fits in uint64_t */
254 if (Blen
> UINT64_MAX
- Vlen
)
258 maxmem
= SCRYPT_MAX_MEM
;
260 if (Blen
+ Vlen
> maxmem
) {
261 EVPerr(EVP_F_EVP_PBE_SCRYPT
, EVP_R_MEMORY_LIMIT_EXCEEDED
);
265 /* If no key return to indicate parameters are OK */
269 B
= OPENSSL_malloc(Blen
+ Vlen
);
272 X
= (uint32_t *)(B
+ Blen
);
275 if (PKCS5_PBKDF2_HMAC(pass
, passlen
, salt
, saltlen
, 1, EVP_sha256(),
279 for (i
= 0; i
< p
; i
++)
280 scryptROMix(B
+ 128 * r
* i
, r
, N
, X
, T
, V
);
282 if (PKCS5_PBKDF2_HMAC(pass
, passlen
, B
, Blen
, 1, EVP_sha256(),
287 fprintf(stderr
, "scrypt parameters:\n");
288 fprintf(stderr
, "N=%lu, p=%lu, r=%lu\n", N
, p
, r
);
289 fprintf(stderr
, "Salt:\n");
290 BIO_dump_fp(stderr
, (char *)salt
, saltlen
);
291 fprintf(stderr
, "Password:\n");
292 BIO_dump_fp(stderr
, (char *)pass
, passlen
);
293 fprintf(stderr
, "Key:\n");
294 BIO_dump_fp(stderr
, (char *)key
, keylen
);
297 OPENSSL_clear_free(B
, Blen
+ Vlen
);