2 * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved.
4 * Licensed under the Apache License 2.0 (the "License"). You may not use
5 * this file except in compliance with the License. You can obtain a copy
6 * in the file LICENSE in the source distribution or at
7 * https://www.openssl.org/source/license.html
12 #include "internal/cryptlib.h"
13 #include "internal/rand_int.h"
15 #include <openssl/rand.h>
16 #include <openssl/sha.h>
17 #include <openssl/evp.h>
19 typedef enum bnrand_flag_e
{
20 NORMAL
, TESTING
, PRIVATE
23 static int bnrand(BNRAND_FLAG flag
, BIGNUM
*rnd
, int bits
, int top
, int bottom
,
26 unsigned char *buf
= NULL
;
27 int b
, ret
= 0, bit
, bytes
, mask
;
28 OPENSSL_CTX
*libctx
= bn_get_lib_ctx(ctx
);
31 if (top
!= BN_RAND_TOP_ANY
|| bottom
!= BN_RAND_BOTTOM_ANY
)
36 if (bits
< 0 || (bits
== 1 && top
> 0))
39 bytes
= (bits
+ 7) / 8;
41 mask
= 0xff << (bit
+ 1);
43 buf
= OPENSSL_malloc(bytes
);
45 BNerr(BN_F_BNRAND
, ERR_R_MALLOC_FAILURE
);
49 /* make a random number and set the top and bottom bits */
50 b
= flag
== NORMAL
? rand_bytes_ex(libctx
, buf
, bytes
)
51 : rand_priv_bytes_ex(libctx
, buf
, bytes
);
55 if (flag
== TESTING
) {
57 * generate patterns that are more likely to trigger BN library bugs
62 for (i
= 0; i
< bytes
; i
++) {
63 if (rand_bytes_ex(libctx
, &c
, 1) <= 0)
65 if (c
>= 128 && i
> 0)
80 buf
[0] |= (3 << (bit
- 1));
87 if (bottom
) /* set bottom bit if requested */
89 if (!BN_bin2bn(buf
, bytes
, rnd
))
93 OPENSSL_clear_free(buf
, bytes
);
98 BNerr(BN_F_BNRAND
, BN_R_BITS_TOO_SMALL
);
102 int BN_rand_ex(BIGNUM
*rnd
, int bits
, int top
, int bottom
, BN_CTX
*ctx
)
104 return bnrand(NORMAL
, rnd
, bits
, top
, bottom
, ctx
);
106 int BN_rand(BIGNUM
*rnd
, int bits
, int top
, int bottom
)
108 return bnrand(NORMAL
, rnd
, bits
, top
, bottom
, NULL
);
111 int BN_bntest_rand(BIGNUM
*rnd
, int bits
, int top
, int bottom
)
113 return bnrand(TESTING
, rnd
, bits
, top
, bottom
, NULL
);
116 int BN_priv_rand_ex(BIGNUM
*rnd
, int bits
, int top
, int bottom
, BN_CTX
*ctx
)
118 return bnrand(PRIVATE
, rnd
, bits
, top
, bottom
, ctx
);
121 int BN_priv_rand(BIGNUM
*rnd
, int bits
, int top
, int bottom
)
123 return bnrand(PRIVATE
, rnd
, bits
, top
, bottom
, NULL
);
126 /* random number r: 0 <= r < range */
127 static int bnrand_range(BNRAND_FLAG flag
, BIGNUM
*r
, const BIGNUM
*range
,
133 if (range
->neg
|| BN_is_zero(range
)) {
134 BNerr(BN_F_BNRAND_RANGE
, BN_R_INVALID_RANGE
);
138 n
= BN_num_bits(range
); /* n > 0 */
140 /* BN_is_bit_set(range, n - 1) always holds */
144 else if (!BN_is_bit_set(range
, n
- 2) && !BN_is_bit_set(range
, n
- 3)) {
146 * range = 100..._2, so 3*range (= 11..._2) is exactly one bit longer
150 if (!bnrand(flag
, r
, n
+ 1, BN_RAND_TOP_ANY
, BN_RAND_BOTTOM_ANY
,
155 * If r < 3*range, use r := r MOD range (which is either r, r -
156 * range, or r - 2*range). Otherwise, iterate once more. Since
157 * 3*range = 11..._2, each iteration succeeds with probability >=
160 if (BN_cmp(r
, range
) >= 0) {
161 if (!BN_sub(r
, r
, range
))
163 if (BN_cmp(r
, range
) >= 0)
164 if (!BN_sub(r
, r
, range
))
169 BNerr(BN_F_BNRAND_RANGE
, BN_R_TOO_MANY_ITERATIONS
);
174 while (BN_cmp(r
, range
) >= 0);
177 /* range = 11..._2 or range = 101..._2 */
178 if (!bnrand(flag
, r
, n
, BN_RAND_TOP_ANY
, BN_RAND_BOTTOM_ANY
, ctx
))
182 BNerr(BN_F_BNRAND_RANGE
, BN_R_TOO_MANY_ITERATIONS
);
186 while (BN_cmp(r
, range
) >= 0);
193 int BN_rand_range_ex(BIGNUM
*r
, const BIGNUM
*range
, BN_CTX
*ctx
)
195 return bnrand_range(NORMAL
, r
, range
, ctx
);
198 int BN_rand_range(BIGNUM
*r
, const BIGNUM
*range
)
200 return bnrand_range(NORMAL
, r
, range
, NULL
);
203 int BN_priv_rand_range_ex(BIGNUM
*r
, const BIGNUM
*range
, BN_CTX
*ctx
)
205 return bnrand_range(PRIVATE
, r
, range
, ctx
);
208 int BN_priv_rand_range(BIGNUM
*r
, const BIGNUM
*range
)
210 return bnrand_range(PRIVATE
, r
, range
, NULL
);
213 int BN_pseudo_rand(BIGNUM
*rnd
, int bits
, int top
, int bottom
)
215 return BN_rand(rnd
, bits
, top
, bottom
);
218 int BN_pseudo_rand_range(BIGNUM
*r
, const BIGNUM
*range
)
220 return BN_rand_range(r
, range
);
224 * BN_generate_dsa_nonce generates a random number 0 <= out < range. Unlike
225 * BN_rand_range, it also includes the contents of |priv| and |message| in
226 * the generation so that an RNG failure isn't fatal as long as |priv|
227 * remains secret. This is intended for use in DSA and ECDSA where an RNG
228 * weakness leads directly to private key exposure unless this function is
231 int BN_generate_dsa_nonce(BIGNUM
*out
, const BIGNUM
*range
,
232 const BIGNUM
*priv
, const unsigned char *message
,
233 size_t message_len
, BN_CTX
*ctx
)
235 EVP_MD_CTX
*mdctx
= EVP_MD_CTX_new();
237 * We use 512 bits of random data per iteration to ensure that we have at
238 * least |range| bits of randomness.
240 unsigned char random_bytes
[64];
241 unsigned char digest
[SHA512_DIGEST_LENGTH
];
243 /* We generate |range|+8 bytes of random output. */
244 const unsigned num_k_bytes
= BN_num_bytes(range
) + 8;
245 unsigned char private_bytes
[96];
246 unsigned char *k_bytes
= NULL
;
249 OPENSSL_CTX
*libctx
= bn_get_lib_ctx(ctx
);
254 k_bytes
= OPENSSL_malloc(num_k_bytes
);
258 /* We copy |priv| into a local buffer to avoid exposing its length. */
259 todo
= sizeof(priv
->d
[0]) * priv
->top
;
260 if (todo
> sizeof(private_bytes
)) {
262 * No reasonable DSA or ECDSA key should have a private key this
263 * large and we don't handle this case in order to avoid leaking the
264 * length of the private key.
266 BNerr(BN_F_BN_GENERATE_DSA_NONCE
, BN_R_PRIVATE_KEY_TOO_LARGE
);
269 memcpy(private_bytes
, priv
->d
, todo
);
270 memset(private_bytes
+ todo
, 0, sizeof(private_bytes
) - todo
);
272 md
= EVP_MD_fetch(libctx
, "SHA512", NULL
);
274 BNerr(BN_F_BN_GENERATE_DSA_NONCE
, BN_R_NO_SUITABLE_DIGEST
);
277 for (done
= 0; done
< num_k_bytes
;) {
278 if (!rand_priv_bytes_ex(libctx
, random_bytes
, sizeof(random_bytes
)))
281 if (!EVP_DigestInit_ex(mdctx
, md
, NULL
)
282 || !EVP_DigestUpdate(mdctx
, &done
, sizeof(done
))
283 || !EVP_DigestUpdate(mdctx
, private_bytes
,
284 sizeof(private_bytes
))
285 || !EVP_DigestUpdate(mdctx
, message
, message_len
)
286 || !EVP_DigestUpdate(mdctx
, random_bytes
, sizeof(random_bytes
))
287 || !EVP_DigestFinal_ex(mdctx
, digest
, NULL
))
290 todo
= num_k_bytes
- done
;
291 if (todo
> SHA512_DIGEST_LENGTH
)
292 todo
= SHA512_DIGEST_LENGTH
;
293 memcpy(k_bytes
+ done
, digest
, todo
);
297 if (!BN_bin2bn(k_bytes
, num_k_bytes
, out
))
299 if (BN_mod(out
, out
, range
, ctx
) != 1)
304 EVP_MD_CTX_free(mdctx
);
305 EVP_MD_meth_free(md
);
306 OPENSSL_free(k_bytes
);
307 OPENSSL_cleanse(private_bytes
, sizeof(private_bytes
));