| Manuel Pégourié-Gonnard | 490bdf3 | 2014-01-27 14:03:10 +0100 | [diff] [blame] | 1 | /* | 
|  | 2 | *  HMAC_DRBG implementation (NIST SP 800-90) | 
|  | 3 | * | 
| Bence Szépkúti | 1e14827 | 2020-08-07 13:07:28 +0200 | [diff] [blame] | 4 | *  Copyright The Mbed TLS Contributors | 
| Manuel Pégourié-Gonnard | 37ff140 | 2015-09-04 14:21:07 +0200 | [diff] [blame] | 5 | *  SPDX-License-Identifier: Apache-2.0 | 
|  | 6 | * | 
|  | 7 | *  Licensed under the Apache License, Version 2.0 (the "License"); you may | 
|  | 8 | *  not use this file except in compliance with the License. | 
|  | 9 | *  You may obtain a copy of the License at | 
|  | 10 | * | 
|  | 11 | *  http://www.apache.org/licenses/LICENSE-2.0 | 
|  | 12 | * | 
|  | 13 | *  Unless required by applicable law or agreed to in writing, software | 
|  | 14 | *  distributed under the License is distributed on an "AS IS" BASIS, WITHOUT | 
|  | 15 | *  WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | 
|  | 16 | *  See the License for the specific language governing permissions and | 
|  | 17 | *  limitations under the License. | 
| Manuel Pégourié-Gonnard | 490bdf3 | 2014-01-27 14:03:10 +0100 | [diff] [blame] | 18 | */ | 
|  | 19 |  | 
|  | 20 | /* | 
| Manuel Pégourié-Gonnard | 8208d16 | 2014-01-30 12:19:26 +0100 | [diff] [blame] | 21 | *  The NIST SP 800-90A DRBGs are described in the following publication. | 
| Manuel Pégourié-Gonnard | 490bdf3 | 2014-01-27 14:03:10 +0100 | [diff] [blame] | 22 | *  http://csrc.nist.gov/publications/nistpubs/800-90A/SP800-90A.pdf | 
| Manuel Pégourié-Gonnard | 8208d16 | 2014-01-30 12:19:26 +0100 | [diff] [blame] | 23 | *  References below are based on rev. 1 (January 2012). | 
| Manuel Pégourié-Gonnard | 490bdf3 | 2014-01-27 14:03:10 +0100 | [diff] [blame] | 24 | */ | 
|  | 25 |  | 
| Gilles Peskine | db09ef6 | 2020-06-03 01:43:33 +0200 | [diff] [blame] | 26 | #include "common.h" | 
| Manuel Pégourié-Gonnard | 490bdf3 | 2014-01-27 14:03:10 +0100 | [diff] [blame] | 27 |  | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 28 | #if defined(MBEDTLS_HMAC_DRBG_C) | 
| Manuel Pégourié-Gonnard | 490bdf3 | 2014-01-27 14:03:10 +0100 | [diff] [blame] | 29 |  | 
| Manuel Pégourié-Gonnard | 7f80997 | 2015-03-09 17:05:11 +0000 | [diff] [blame] | 30 | #include "mbedtls/hmac_drbg.h" | 
| Andres Amaya Garcia | 1f6301b | 2018-04-17 09:51:09 -0500 | [diff] [blame] | 31 | #include "mbedtls/platform_util.h" | 
| Janos Follath | 24eed8d | 2019-11-22 13:21:35 +0000 | [diff] [blame] | 32 | #include "mbedtls/error.h" | 
| Manuel Pégourié-Gonnard | 490bdf3 | 2014-01-27 14:03:10 +0100 | [diff] [blame] | 33 |  | 
| Rich Evans | 00ab470 | 2015-02-06 13:43:58 +0000 | [diff] [blame] | 34 | #include <string.h> | 
|  | 35 |  | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 36 | #if defined(MBEDTLS_FS_IO) | 
| Manuel Pégourié-Gonnard | 48bc3e8 | 2014-01-30 21:11:16 +0100 | [diff] [blame] | 37 | #include <stdio.h> | 
|  | 38 | #endif | 
|  | 39 |  | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 40 | #if defined(MBEDTLS_SELF_TEST) | 
|  | 41 | #if defined(MBEDTLS_PLATFORM_C) | 
| Manuel Pégourié-Gonnard | 7f80997 | 2015-03-09 17:05:11 +0000 | [diff] [blame] | 42 | #include "mbedtls/platform.h" | 
| Paul Bakker | 7dc4c44 | 2014-02-01 22:50:26 +0100 | [diff] [blame] | 43 | #else | 
| Rich Evans | 00ab470 | 2015-02-06 13:43:58 +0000 | [diff] [blame] | 44 | #include <stdio.h> | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 45 | #define mbedtls_printf printf | 
|  | 46 | #endif /* MBEDTLS_SELF_TEST */ | 
|  | 47 | #endif /* MBEDTLS_PLATFORM_C */ | 
| Paul Bakker | 7dc4c44 | 2014-02-01 22:50:26 +0100 | [diff] [blame] | 48 |  | 
| Manuel Pégourié-Gonnard | 490bdf3 | 2014-01-27 14:03:10 +0100 | [diff] [blame] | 49 | /* | 
| Manuel Pégourié-Gonnard | f9e9481 | 2015-04-28 22:07:14 +0200 | [diff] [blame] | 50 | * HMAC_DRBG context initialization | 
|  | 51 | */ | 
|  | 52 | void mbedtls_hmac_drbg_init( mbedtls_hmac_drbg_context *ctx ) | 
|  | 53 | { | 
|  | 54 | memset( ctx, 0, sizeof( mbedtls_hmac_drbg_context ) ); | 
| Manuel Pégourié-Gonnard | 0a4fb09 | 2015-05-07 12:50:31 +0100 | [diff] [blame] | 55 |  | 
| Gavin Acquroff | 6aceb51 | 2020-03-01 17:06:11 -0800 | [diff] [blame] | 56 | ctx->reseed_interval = MBEDTLS_HMAC_DRBG_RESEED_INTERVAL; | 
| Manuel Pégourié-Gonnard | f9e9481 | 2015-04-28 22:07:14 +0200 | [diff] [blame] | 57 | } | 
|  | 58 |  | 
|  | 59 | /* | 
| Manuel Pégourié-Gonnard | 8208d16 | 2014-01-30 12:19:26 +0100 | [diff] [blame] | 60 | * HMAC_DRBG update, using optional additional data (10.1.2.2) | 
| Manuel Pégourié-Gonnard | 490bdf3 | 2014-01-27 14:03:10 +0100 | [diff] [blame] | 61 | */ | 
| TRodziewicz | 26371e4 | 2021-06-08 16:45:41 +0200 | [diff] [blame] | 62 | int mbedtls_hmac_drbg_update( mbedtls_hmac_drbg_context *ctx, | 
| Gilles Peskine | e0e9c57 | 2018-09-11 16:47:16 +0200 | [diff] [blame] | 63 | const unsigned char *additional, | 
|  | 64 | size_t add_len ) | 
| Manuel Pégourié-Gonnard | 490bdf3 | 2014-01-27 14:03:10 +0100 | [diff] [blame] | 65 | { | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 66 | size_t md_len = mbedtls_md_get_size( ctx->md_ctx.md_info ); | 
| Manuel Pégourié-Gonnard | 490bdf3 | 2014-01-27 14:03:10 +0100 | [diff] [blame] | 67 | unsigned char rounds = ( additional != NULL && add_len != 0 ) ? 2 : 1; | 
|  | 68 | unsigned char sep[1]; | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 69 | unsigned char K[MBEDTLS_MD_MAX_SIZE]; | 
| Gilles Peskine | 006c1b5 | 2019-09-30 17:29:54 +0200 | [diff] [blame] | 70 | int ret = MBEDTLS_ERR_MD_BAD_INPUT_DATA; | 
| Manuel Pégourié-Gonnard | 490bdf3 | 2014-01-27 14:03:10 +0100 | [diff] [blame] | 71 |  | 
|  | 72 | for( sep[0] = 0; sep[0] < rounds; sep[0]++ ) | 
|  | 73 | { | 
| Manuel Pégourié-Gonnard | 8208d16 | 2014-01-30 12:19:26 +0100 | [diff] [blame] | 74 | /* Step 1 or 4 */ | 
| Gilles Peskine | e0e9c57 | 2018-09-11 16:47:16 +0200 | [diff] [blame] | 75 | if( ( ret = mbedtls_md_hmac_reset( &ctx->md_ctx ) ) != 0 ) | 
|  | 76 | goto exit; | 
|  | 77 | if( ( ret = mbedtls_md_hmac_update( &ctx->md_ctx, | 
|  | 78 | ctx->V, md_len ) ) != 0 ) | 
|  | 79 | goto exit; | 
|  | 80 | if( ( ret = mbedtls_md_hmac_update( &ctx->md_ctx, | 
|  | 81 | sep, 1 ) ) != 0 ) | 
|  | 82 | goto exit; | 
| Manuel Pégourié-Gonnard | 490bdf3 | 2014-01-27 14:03:10 +0100 | [diff] [blame] | 83 | if( rounds == 2 ) | 
| Gilles Peskine | e0e9c57 | 2018-09-11 16:47:16 +0200 | [diff] [blame] | 84 | { | 
|  | 85 | if( ( ret = mbedtls_md_hmac_update( &ctx->md_ctx, | 
|  | 86 | additional, add_len ) ) != 0 ) | 
|  | 87 | goto exit; | 
|  | 88 | } | 
|  | 89 | if( ( ret = mbedtls_md_hmac_finish( &ctx->md_ctx, K ) ) != 0 ) | 
|  | 90 | goto exit; | 
| Manuel Pégourié-Gonnard | 490bdf3 | 2014-01-27 14:03:10 +0100 | [diff] [blame] | 91 |  | 
| Manuel Pégourié-Gonnard | 8208d16 | 2014-01-30 12:19:26 +0100 | [diff] [blame] | 92 | /* Step 2 or 5 */ | 
| Gilles Peskine | e0e9c57 | 2018-09-11 16:47:16 +0200 | [diff] [blame] | 93 | if( ( ret = mbedtls_md_hmac_starts( &ctx->md_ctx, K, md_len ) ) != 0 ) | 
|  | 94 | goto exit; | 
|  | 95 | if( ( ret = mbedtls_md_hmac_update( &ctx->md_ctx, | 
|  | 96 | ctx->V, md_len ) ) != 0 ) | 
|  | 97 | goto exit; | 
|  | 98 | if( ( ret = mbedtls_md_hmac_finish( &ctx->md_ctx, ctx->V ) ) != 0 ) | 
|  | 99 | goto exit; | 
| Manuel Pégourié-Gonnard | 490bdf3 | 2014-01-27 14:03:10 +0100 | [diff] [blame] | 100 | } | 
| Gilles Peskine | afa8037 | 2018-09-11 15:35:41 +0200 | [diff] [blame] | 101 |  | 
| Gilles Peskine | e0e9c57 | 2018-09-11 16:47:16 +0200 | [diff] [blame] | 102 | exit: | 
| Gilles Peskine | afa8037 | 2018-09-11 15:35:41 +0200 | [diff] [blame] | 103 | mbedtls_platform_zeroize( K, sizeof( K ) ); | 
| Gilles Peskine | e0e9c57 | 2018-09-11 16:47:16 +0200 | [diff] [blame] | 104 | return( ret ); | 
| Manuel Pégourié-Gonnard | 490bdf3 | 2014-01-27 14:03:10 +0100 | [diff] [blame] | 105 | } | 
|  | 106 |  | 
|  | 107 | /* | 
| Manuel Pégourié-Gonnard | fe34a5f | 2014-01-30 15:06:40 +0100 | [diff] [blame] | 108 | * Simplified HMAC_DRBG initialisation (for use with deterministic ECDSA) | 
| Manuel Pégourié-Gonnard | 490bdf3 | 2014-01-27 14:03:10 +0100 | [diff] [blame] | 109 | */ | 
| Manuel Pégourié-Gonnard | f9e9481 | 2015-04-28 22:07:14 +0200 | [diff] [blame] | 110 | int mbedtls_hmac_drbg_seed_buf( mbedtls_hmac_drbg_context *ctx, | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 111 | const mbedtls_md_info_t * md_info, | 
| Manuel Pégourié-Gonnard | fe34a5f | 2014-01-30 15:06:40 +0100 | [diff] [blame] | 112 | const unsigned char *data, size_t data_len ) | 
| Manuel Pégourié-Gonnard | 490bdf3 | 2014-01-27 14:03:10 +0100 | [diff] [blame] | 113 | { | 
| Janos Follath | 24eed8d | 2019-11-22 13:21:35 +0000 | [diff] [blame] | 114 | int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED; | 
| Manuel Pégourié-Gonnard | 490bdf3 | 2014-01-27 14:03:10 +0100 | [diff] [blame] | 115 |  | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 116 | if( ( ret = mbedtls_md_setup( &ctx->md_ctx, md_info, 1 ) ) != 0 ) | 
| Manuel Pégourié-Gonnard | 490bdf3 | 2014-01-27 14:03:10 +0100 | [diff] [blame] | 117 | return( ret ); | 
|  | 118 |  | 
| Gilles Peskine | b791dc6 | 2021-01-31 00:06:51 +0100 | [diff] [blame] | 119 | #if defined(MBEDTLS_THREADING_C) | 
|  | 120 | mbedtls_mutex_init( &ctx->mutex ); | 
|  | 121 | #endif | 
|  | 122 |  | 
| Manuel Pégourié-Gonnard | b05db2a | 2014-02-01 11:38:05 +0100 | [diff] [blame] | 123 | /* | 
|  | 124 | * Set initial working state. | 
|  | 125 | * Use the V memory location, which is currently all 0, to initialize the | 
|  | 126 | * MD context with an all-zero key. Then set V to its initial value. | 
|  | 127 | */ | 
| Gilles Peskine | b7f71c8 | 2018-09-11 16:54:57 +0200 | [diff] [blame] | 128 | if( ( ret = mbedtls_md_hmac_starts( &ctx->md_ctx, ctx->V, | 
|  | 129 | mbedtls_md_get_size( md_info ) ) ) != 0 ) | 
|  | 130 | return( ret ); | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 131 | memset( ctx->V, 0x01, mbedtls_md_get_size( md_info ) ); | 
| Manuel Pégourié-Gonnard | 490bdf3 | 2014-01-27 14:03:10 +0100 | [diff] [blame] | 132 |  | 
| TRodziewicz | 26371e4 | 2021-06-08 16:45:41 +0200 | [diff] [blame] | 133 | if( ( ret = mbedtls_hmac_drbg_update( ctx, data, data_len ) ) != 0 ) | 
| Gilles Peskine | e0e9c57 | 2018-09-11 16:47:16 +0200 | [diff] [blame] | 134 | return( ret ); | 
| Manuel Pégourié-Gonnard | 490bdf3 | 2014-01-27 14:03:10 +0100 | [diff] [blame] | 135 |  | 
|  | 136 | return( 0 ); | 
|  | 137 | } | 
|  | 138 |  | 
|  | 139 | /* | 
| Hanno Becker | a823d4c | 2019-08-27 06:47:18 +0100 | [diff] [blame] | 140 | * Internal function used both for seeding and reseeding the DRBG. | 
|  | 141 | * Comments starting with arabic numbers refer to section 10.1.2.4 | 
|  | 142 | * of SP800-90A, while roman numbers refer to section 9.2. | 
| Manuel Pégourié-Gonnard | 8fc484d | 2014-01-30 18:28:09 +0100 | [diff] [blame] | 143 | */ | 
| Hanno Becker | a823d4c | 2019-08-27 06:47:18 +0100 | [diff] [blame] | 144 | static int hmac_drbg_reseed_core( mbedtls_hmac_drbg_context *ctx, | 
|  | 145 | const unsigned char *additional, size_t len, | 
|  | 146 | int use_nonce ) | 
| Manuel Pégourié-Gonnard | 8fc484d | 2014-01-30 18:28:09 +0100 | [diff] [blame] | 147 | { | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 148 | unsigned char seed[MBEDTLS_HMAC_DRBG_MAX_SEED_INPUT]; | 
| Hanno Becker | a823d4c | 2019-08-27 06:47:18 +0100 | [diff] [blame] | 149 | size_t seedlen = 0; | 
| Janos Follath | 24eed8d | 2019-11-22 13:21:35 +0000 | [diff] [blame] | 150 | int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED; | 
| Manuel Pégourié-Gonnard | 8fc484d | 2014-01-30 18:28:09 +0100 | [diff] [blame] | 151 |  | 
| Manuel Pégourié-Gonnard | 6e897c2 | 2014-01-30 19:29:04 +0100 | [diff] [blame] | 152 | { | 
| Hanno Becker | a823d4c | 2019-08-27 06:47:18 +0100 | [diff] [blame] | 153 | size_t total_entropy_len; | 
|  | 154 |  | 
|  | 155 | if( use_nonce == 0 ) | 
|  | 156 | total_entropy_len = ctx->entropy_len; | 
|  | 157 | else | 
|  | 158 | total_entropy_len = ctx->entropy_len * 3 / 2; | 
|  | 159 |  | 
|  | 160 | /* III. Check input length */ | 
|  | 161 | if( len > MBEDTLS_HMAC_DRBG_MAX_INPUT || | 
|  | 162 | total_entropy_len + len > MBEDTLS_HMAC_DRBG_MAX_SEED_INPUT ) | 
|  | 163 | { | 
|  | 164 | return( MBEDTLS_ERR_HMAC_DRBG_INPUT_TOO_BIG ); | 
|  | 165 | } | 
| Manuel Pégourié-Gonnard | 6e897c2 | 2014-01-30 19:29:04 +0100 | [diff] [blame] | 166 | } | 
| Manuel Pégourié-Gonnard | 8fc484d | 2014-01-30 18:28:09 +0100 | [diff] [blame] | 167 |  | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 168 | memset( seed, 0, MBEDTLS_HMAC_DRBG_MAX_SEED_INPUT ); | 
| Manuel Pégourié-Gonnard | 8fc484d | 2014-01-30 18:28:09 +0100 | [diff] [blame] | 169 |  | 
| Manuel Pégourié-Gonnard | 6e897c2 | 2014-01-30 19:29:04 +0100 | [diff] [blame] | 170 | /* IV. Gather entropy_len bytes of entropy for the seed */ | 
| Gilles Peskine | b7f71c8 | 2018-09-11 16:54:57 +0200 | [diff] [blame] | 171 | if( ( ret = ctx->f_entropy( ctx->p_entropy, | 
|  | 172 | seed, ctx->entropy_len ) ) != 0 ) | 
| Hanno Becker | a823d4c | 2019-08-27 06:47:18 +0100 | [diff] [blame] | 173 | { | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 174 | return( MBEDTLS_ERR_HMAC_DRBG_ENTROPY_SOURCE_FAILED ); | 
| Hanno Becker | a823d4c | 2019-08-27 06:47:18 +0100 | [diff] [blame] | 175 | } | 
|  | 176 | seedlen += ctx->entropy_len; | 
| Manuel Pégourié-Gonnard | 8fc484d | 2014-01-30 18:28:09 +0100 | [diff] [blame] | 177 |  | 
| Hanno Becker | a823d4c | 2019-08-27 06:47:18 +0100 | [diff] [blame] | 178 | /* For initial seeding, allow adding of nonce generated | 
|  | 179 | * from the entropy source. See Sect 8.6.7 in SP800-90A. */ | 
|  | 180 | if( use_nonce ) | 
|  | 181 | { | 
|  | 182 | /* Note: We don't merge the two calls to f_entropy() in order | 
|  | 183 | *       to avoid requesting too much entropy from f_entropy() | 
|  | 184 | *       at once. Specifically, if the underlying digest is not | 
|  | 185 | *       SHA-1, 3 / 2 * entropy_len is at least 36 Bytes, which | 
|  | 186 | *       is larger than the maximum of 32 Bytes that our own | 
|  | 187 | *       entropy source implementation can emit in a single | 
|  | 188 | *       call in configurations disabling SHA-512. */ | 
|  | 189 | if( ( ret = ctx->f_entropy( ctx->p_entropy, | 
|  | 190 | seed + seedlen, | 
|  | 191 | ctx->entropy_len / 2 ) ) != 0 ) | 
|  | 192 | { | 
|  | 193 | return( MBEDTLS_ERR_HMAC_DRBG_ENTROPY_SOURCE_FAILED ); | 
|  | 194 | } | 
|  | 195 |  | 
|  | 196 | seedlen += ctx->entropy_len / 2; | 
|  | 197 | } | 
|  | 198 |  | 
| Manuel Pégourié-Gonnard | 8fc484d | 2014-01-30 18:28:09 +0100 | [diff] [blame] | 199 |  | 
| Manuel Pégourié-Gonnard | 6e897c2 | 2014-01-30 19:29:04 +0100 | [diff] [blame] | 200 | /* 1. Concatenate entropy and additional data if any */ | 
| Manuel Pégourié-Gonnard | 8fc484d | 2014-01-30 18:28:09 +0100 | [diff] [blame] | 201 | if( additional != NULL && len != 0 ) | 
|  | 202 | { | 
|  | 203 | memcpy( seed + seedlen, additional, len ); | 
|  | 204 | seedlen += len; | 
|  | 205 | } | 
|  | 206 |  | 
|  | 207 | /* 2. Update state */ | 
| TRodziewicz | 26371e4 | 2021-06-08 16:45:41 +0200 | [diff] [blame] | 208 | if( ( ret = mbedtls_hmac_drbg_update( ctx, seed, seedlen ) ) != 0 ) | 
| Gilles Peskine | e0e9c57 | 2018-09-11 16:47:16 +0200 | [diff] [blame] | 209 | goto exit; | 
| Manuel Pégourié-Gonnard | 8fc484d | 2014-01-30 18:28:09 +0100 | [diff] [blame] | 210 |  | 
| Manuel Pégourié-Gonnard | 658dbed | 2014-01-30 19:03:45 +0100 | [diff] [blame] | 211 | /* 3. Reset reseed_counter */ | 
|  | 212 | ctx->reseed_counter = 1; | 
| Manuel Pégourié-Gonnard | 8fc484d | 2014-01-30 18:28:09 +0100 | [diff] [blame] | 213 |  | 
| Gilles Peskine | e0e9c57 | 2018-09-11 16:47:16 +0200 | [diff] [blame] | 214 | exit: | 
| Manuel Pégourié-Gonnard | 8fc484d | 2014-01-30 18:28:09 +0100 | [diff] [blame] | 215 | /* 4. Done */ | 
| Gilles Peskine | afa8037 | 2018-09-11 15:35:41 +0200 | [diff] [blame] | 216 | mbedtls_platform_zeroize( seed, seedlen ); | 
| Gilles Peskine | e0e9c57 | 2018-09-11 16:47:16 +0200 | [diff] [blame] | 217 | return( ret ); | 
| Manuel Pégourié-Gonnard | 8fc484d | 2014-01-30 18:28:09 +0100 | [diff] [blame] | 218 | } | 
|  | 219 |  | 
|  | 220 | /* | 
| Hanno Becker | a823d4c | 2019-08-27 06:47:18 +0100 | [diff] [blame] | 221 | * HMAC_DRBG reseeding: 10.1.2.4 + 9.2 | 
|  | 222 | */ | 
|  | 223 | int mbedtls_hmac_drbg_reseed( mbedtls_hmac_drbg_context *ctx, | 
|  | 224 | const unsigned char *additional, size_t len ) | 
|  | 225 | { | 
|  | 226 | return( hmac_drbg_reseed_core( ctx, additional, len, 0 ) ); | 
|  | 227 | } | 
|  | 228 |  | 
|  | 229 | /* | 
| Manuel Pégourié-Gonnard | 6e897c2 | 2014-01-30 19:29:04 +0100 | [diff] [blame] | 230 | * HMAC_DRBG initialisation (10.1.2.3 + 9.1) | 
| Hanno Becker | a823d4c | 2019-08-27 06:47:18 +0100 | [diff] [blame] | 231 | * | 
|  | 232 | * The nonce is not passed as a separate parameter but extracted | 
|  | 233 | * from the entropy source as suggested in 8.6.7. | 
| Manuel Pégourié-Gonnard | fe34a5f | 2014-01-30 15:06:40 +0100 | [diff] [blame] | 234 | */ | 
| Manuel Pégourié-Gonnard | f9e9481 | 2015-04-28 22:07:14 +0200 | [diff] [blame] | 235 | int mbedtls_hmac_drbg_seed( mbedtls_hmac_drbg_context *ctx, | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 236 | const mbedtls_md_info_t * md_info, | 
| Manuel Pégourié-Gonnard | fe34a5f | 2014-01-30 15:06:40 +0100 | [diff] [blame] | 237 | int (*f_entropy)(void *, unsigned char *, size_t), | 
|  | 238 | void *p_entropy, | 
|  | 239 | const unsigned char *custom, | 
|  | 240 | size_t len ) | 
|  | 241 | { | 
| Janos Follath | 24eed8d | 2019-11-22 13:21:35 +0000 | [diff] [blame] | 242 | int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED; | 
| Hanno Becker | a823d4c | 2019-08-27 06:47:18 +0100 | [diff] [blame] | 243 | size_t md_size; | 
| Manuel Pégourié-Gonnard | fe34a5f | 2014-01-30 15:06:40 +0100 | [diff] [blame] | 244 |  | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 245 | if( ( ret = mbedtls_md_setup( &ctx->md_ctx, md_info, 1 ) ) != 0 ) | 
| Manuel Pégourié-Gonnard | fe34a5f | 2014-01-30 15:06:40 +0100 | [diff] [blame] | 246 | return( ret ); | 
|  | 247 |  | 
| Gilles Peskine | e39b219 | 2021-02-09 18:43:33 +0100 | [diff] [blame] | 248 | /* The mutex is initialized iff the md context is set up. */ | 
| Gilles Peskine | b791dc6 | 2021-01-31 00:06:51 +0100 | [diff] [blame] | 249 | #if defined(MBEDTLS_THREADING_C) | 
|  | 250 | mbedtls_mutex_init( &ctx->mutex ); | 
|  | 251 | #endif | 
|  | 252 |  | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 253 | md_size = mbedtls_md_get_size( md_info ); | 
| Manuel Pégourié-Gonnard | ca878db | 2015-03-24 12:13:30 +0100 | [diff] [blame] | 254 |  | 
| Manuel Pégourié-Gonnard | b05db2a | 2014-02-01 11:38:05 +0100 | [diff] [blame] | 255 | /* | 
|  | 256 | * Set initial working state. | 
|  | 257 | * Use the V memory location, which is currently all 0, to initialize the | 
|  | 258 | * MD context with an all-zero key. Then set V to its initial value. | 
|  | 259 | */ | 
| Gilles Peskine | b7f71c8 | 2018-09-11 16:54:57 +0200 | [diff] [blame] | 260 | if( ( ret = mbedtls_md_hmac_starts( &ctx->md_ctx, ctx->V, md_size ) ) != 0 ) | 
|  | 261 | return( ret ); | 
| Manuel Pégourié-Gonnard | ca878db | 2015-03-24 12:13:30 +0100 | [diff] [blame] | 262 | memset( ctx->V, 0x01, md_size ); | 
| Manuel Pégourié-Gonnard | fe34a5f | 2014-01-30 15:06:40 +0100 | [diff] [blame] | 263 |  | 
|  | 264 | ctx->f_entropy = f_entropy; | 
|  | 265 | ctx->p_entropy = p_entropy; | 
|  | 266 |  | 
| Gilles Peskine | 8f7921e | 2019-10-04 11:47:35 +0200 | [diff] [blame] | 267 | if( ctx->entropy_len == 0 ) | 
|  | 268 | { | 
|  | 269 | /* | 
|  | 270 | * See SP800-57 5.6.1 (p. 65-66) for the security strength provided by | 
|  | 271 | * each hash function, then according to SP800-90A rev1 10.1 table 2, | 
|  | 272 | * min_entropy_len (in bits) is security_strength. | 
|  | 273 | * | 
|  | 274 | * (This also matches the sizes used in the NIST test vectors.) | 
|  | 275 | */ | 
|  | 276 | ctx->entropy_len = md_size <= 20 ? 16 : /* 160-bits hash -> 128 bits */ | 
|  | 277 | md_size <= 28 ? 24 : /* 224-bits hash -> 192 bits */ | 
|  | 278 | 32;  /* better (256+) -> 256 bits */ | 
|  | 279 | } | 
| Manuel Pégourié-Gonnard | 8fc484d | 2014-01-30 18:28:09 +0100 | [diff] [blame] | 280 |  | 
| Hanno Becker | a823d4c | 2019-08-27 06:47:18 +0100 | [diff] [blame] | 281 | if( ( ret = hmac_drbg_reseed_core( ctx, custom, len, | 
|  | 282 | 1 /* add nonce */ ) ) != 0 ) | 
|  | 283 | { | 
| Manuel Pégourié-Gonnard | 8fc484d | 2014-01-30 18:28:09 +0100 | [diff] [blame] | 284 | return( ret ); | 
| Hanno Becker | a823d4c | 2019-08-27 06:47:18 +0100 | [diff] [blame] | 285 | } | 
| Manuel Pégourié-Gonnard | fe34a5f | 2014-01-30 15:06:40 +0100 | [diff] [blame] | 286 |  | 
|  | 287 | return( 0 ); | 
|  | 288 | } | 
|  | 289 |  | 
|  | 290 | /* | 
| Manuel Pégourié-Gonnard | af786ff | 2014-01-30 18:44:18 +0100 | [diff] [blame] | 291 | * Set prediction resistance | 
|  | 292 | */ | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 293 | void mbedtls_hmac_drbg_set_prediction_resistance( mbedtls_hmac_drbg_context *ctx, | 
| Manuel Pégourié-Gonnard | af786ff | 2014-01-30 18:44:18 +0100 | [diff] [blame] | 294 | int resistance ) | 
|  | 295 | { | 
|  | 296 | ctx->prediction_resistance = resistance; | 
|  | 297 | } | 
|  | 298 |  | 
|  | 299 | /* | 
| Gilles Peskine | 8f7921e | 2019-10-04 11:47:35 +0200 | [diff] [blame] | 300 | * Set entropy length grabbed for seeding | 
| Manuel Pégourié-Gonnard | 4e669c6 | 2014-01-30 18:06:08 +0100 | [diff] [blame] | 301 | */ | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 302 | void mbedtls_hmac_drbg_set_entropy_len( mbedtls_hmac_drbg_context *ctx, size_t len ) | 
| Manuel Pégourié-Gonnard | 4e669c6 | 2014-01-30 18:06:08 +0100 | [diff] [blame] | 303 | { | 
|  | 304 | ctx->entropy_len = len; | 
|  | 305 | } | 
|  | 306 |  | 
|  | 307 | /* | 
| Manuel Pégourié-Gonnard | 658dbed | 2014-01-30 19:03:45 +0100 | [diff] [blame] | 308 | * Set reseed interval | 
|  | 309 | */ | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 310 | void mbedtls_hmac_drbg_set_reseed_interval( mbedtls_hmac_drbg_context *ctx, int interval ) | 
| Manuel Pégourié-Gonnard | 658dbed | 2014-01-30 19:03:45 +0100 | [diff] [blame] | 311 | { | 
|  | 312 | ctx->reseed_interval = interval; | 
|  | 313 | } | 
|  | 314 |  | 
|  | 315 | /* | 
| Manuel Pégourié-Gonnard | 6e897c2 | 2014-01-30 19:29:04 +0100 | [diff] [blame] | 316 | * HMAC_DRBG random function with optional additional data: | 
|  | 317 | * 10.1.2.5 (arabic) + 9.3 (Roman) | 
| Manuel Pégourié-Gonnard | 490bdf3 | 2014-01-27 14:03:10 +0100 | [diff] [blame] | 318 | */ | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 319 | int mbedtls_hmac_drbg_random_with_add( void *p_rng, | 
| Manuel Pégourié-Gonnard | 8208d16 | 2014-01-30 12:19:26 +0100 | [diff] [blame] | 320 | unsigned char *output, size_t out_len, | 
|  | 321 | const unsigned char *additional, size_t add_len ) | 
| Manuel Pégourié-Gonnard | 490bdf3 | 2014-01-27 14:03:10 +0100 | [diff] [blame] | 322 | { | 
| Janos Follath | 24eed8d | 2019-11-22 13:21:35 +0000 | [diff] [blame] | 323 | int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED; | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 324 | mbedtls_hmac_drbg_context *ctx = (mbedtls_hmac_drbg_context *) p_rng; | 
|  | 325 | size_t md_len = mbedtls_md_get_size( ctx->md_ctx.md_info ); | 
| Manuel Pégourié-Gonnard | 490bdf3 | 2014-01-27 14:03:10 +0100 | [diff] [blame] | 326 | size_t left = out_len; | 
|  | 327 | unsigned char *out = output; | 
|  | 328 |  | 
| Manuel Pégourié-Gonnard | 6e897c2 | 2014-01-30 19:29:04 +0100 | [diff] [blame] | 329 | /* II. Check request length */ | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 330 | if( out_len > MBEDTLS_HMAC_DRBG_MAX_REQUEST ) | 
|  | 331 | return( MBEDTLS_ERR_HMAC_DRBG_REQUEST_TOO_BIG ); | 
| Manuel Pégourié-Gonnard | 6e897c2 | 2014-01-30 19:29:04 +0100 | [diff] [blame] | 332 |  | 
|  | 333 | /* III. Check input length */ | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 334 | if( add_len > MBEDTLS_HMAC_DRBG_MAX_INPUT ) | 
|  | 335 | return( MBEDTLS_ERR_HMAC_DRBG_INPUT_TOO_BIG ); | 
| Manuel Pégourié-Gonnard | 6e897c2 | 2014-01-30 19:29:04 +0100 | [diff] [blame] | 336 |  | 
|  | 337 | /* 1. (aka VII and IX) Check reseed counter and PR */ | 
| Manuel Pégourié-Gonnard | efc8d80 | 2014-01-30 19:36:22 +0100 | [diff] [blame] | 338 | if( ctx->f_entropy != NULL && /* For no-reseeding instances */ | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 339 | ( ctx->prediction_resistance == MBEDTLS_HMAC_DRBG_PR_ON || | 
| Manuel Pégourié-Gonnard | 658dbed | 2014-01-30 19:03:45 +0100 | [diff] [blame] | 340 | ctx->reseed_counter > ctx->reseed_interval ) ) | 
| Manuel Pégourié-Gonnard | af786ff | 2014-01-30 18:44:18 +0100 | [diff] [blame] | 341 | { | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 342 | if( ( ret = mbedtls_hmac_drbg_reseed( ctx, additional, add_len ) ) != 0 ) | 
| Manuel Pégourié-Gonnard | af786ff | 2014-01-30 18:44:18 +0100 | [diff] [blame] | 343 | return( ret ); | 
| Manuel Pégourié-Gonnard | 6e897c2 | 2014-01-30 19:29:04 +0100 | [diff] [blame] | 344 |  | 
|  | 345 | add_len = 0; /* VII.4 */ | 
| Manuel Pégourié-Gonnard | af786ff | 2014-01-30 18:44:18 +0100 | [diff] [blame] | 346 | } | 
| Manuel Pégourié-Gonnard | 8208d16 | 2014-01-30 12:19:26 +0100 | [diff] [blame] | 347 |  | 
|  | 348 | /* 2. Use additional data if any */ | 
|  | 349 | if( additional != NULL && add_len != 0 ) | 
| Gilles Peskine | e0e9c57 | 2018-09-11 16:47:16 +0200 | [diff] [blame] | 350 | { | 
| TRodziewicz | 26371e4 | 2021-06-08 16:45:41 +0200 | [diff] [blame] | 351 | if( ( ret = mbedtls_hmac_drbg_update( ctx, | 
| Gilles Peskine | e0e9c57 | 2018-09-11 16:47:16 +0200 | [diff] [blame] | 352 | additional, add_len ) ) != 0 ) | 
|  | 353 | goto exit; | 
|  | 354 | } | 
| Manuel Pégourié-Gonnard | 8208d16 | 2014-01-30 12:19:26 +0100 | [diff] [blame] | 355 |  | 
|  | 356 | /* 3, 4, 5. Generate bytes */ | 
| Manuel Pégourié-Gonnard | 490bdf3 | 2014-01-27 14:03:10 +0100 | [diff] [blame] | 357 | while( left != 0 ) | 
|  | 358 | { | 
|  | 359 | size_t use_len = left > md_len ? md_len : left; | 
|  | 360 |  | 
| Gilles Peskine | b7f71c8 | 2018-09-11 16:54:57 +0200 | [diff] [blame] | 361 | if( ( ret = mbedtls_md_hmac_reset( &ctx->md_ctx ) ) != 0 ) | 
|  | 362 | goto exit; | 
|  | 363 | if( ( ret = mbedtls_md_hmac_update( &ctx->md_ctx, | 
|  | 364 | ctx->V, md_len ) ) != 0 ) | 
|  | 365 | goto exit; | 
|  | 366 | if( ( ret = mbedtls_md_hmac_finish( &ctx->md_ctx, ctx->V ) ) != 0 ) | 
|  | 367 | goto exit; | 
| Manuel Pégourié-Gonnard | 490bdf3 | 2014-01-27 14:03:10 +0100 | [diff] [blame] | 368 |  | 
|  | 369 | memcpy( out, ctx->V, use_len ); | 
|  | 370 | out += use_len; | 
|  | 371 | left -= use_len; | 
|  | 372 | } | 
|  | 373 |  | 
| Manuel Pégourié-Gonnard | 8208d16 | 2014-01-30 12:19:26 +0100 | [diff] [blame] | 374 | /* 6. Update */ | 
| TRodziewicz | 26371e4 | 2021-06-08 16:45:41 +0200 | [diff] [blame] | 375 | if( ( ret = mbedtls_hmac_drbg_update( ctx, | 
| Gilles Peskine | e0e9c57 | 2018-09-11 16:47:16 +0200 | [diff] [blame] | 376 | additional, add_len ) ) != 0 ) | 
|  | 377 | goto exit; | 
| Manuel Pégourié-Gonnard | 490bdf3 | 2014-01-27 14:03:10 +0100 | [diff] [blame] | 378 |  | 
| Manuel Pégourié-Gonnard | 658dbed | 2014-01-30 19:03:45 +0100 | [diff] [blame] | 379 | /* 7. Update reseed counter */ | 
|  | 380 | ctx->reseed_counter++; | 
| Manuel Pégourié-Gonnard | 8208d16 | 2014-01-30 12:19:26 +0100 | [diff] [blame] | 381 |  | 
| Gilles Peskine | e0e9c57 | 2018-09-11 16:47:16 +0200 | [diff] [blame] | 382 | exit: | 
| Manuel Pégourié-Gonnard | 8208d16 | 2014-01-30 12:19:26 +0100 | [diff] [blame] | 383 | /* 8. Done */ | 
| Gilles Peskine | e0e9c57 | 2018-09-11 16:47:16 +0200 | [diff] [blame] | 384 | return( ret ); | 
| Manuel Pégourié-Gonnard | 490bdf3 | 2014-01-27 14:03:10 +0100 | [diff] [blame] | 385 | } | 
|  | 386 |  | 
|  | 387 | /* | 
| Manuel Pégourié-Gonnard | 8208d16 | 2014-01-30 12:19:26 +0100 | [diff] [blame] | 388 | * HMAC_DRBG random function | 
|  | 389 | */ | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 390 | int mbedtls_hmac_drbg_random( void *p_rng, unsigned char *output, size_t out_len ) | 
| Manuel Pégourié-Gonnard | 8208d16 | 2014-01-30 12:19:26 +0100 | [diff] [blame] | 391 | { | 
| Janos Follath | 24eed8d | 2019-11-22 13:21:35 +0000 | [diff] [blame] | 392 | int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED; | 
| Manuel Pégourié-Gonnard | 0a4fb09 | 2015-05-07 12:50:31 +0100 | [diff] [blame] | 393 | mbedtls_hmac_drbg_context *ctx = (mbedtls_hmac_drbg_context *) p_rng; | 
|  | 394 |  | 
|  | 395 | #if defined(MBEDTLS_THREADING_C) | 
|  | 396 | if( ( ret = mbedtls_mutex_lock( &ctx->mutex ) ) != 0 ) | 
|  | 397 | return( ret ); | 
|  | 398 | #endif | 
|  | 399 |  | 
|  | 400 | ret = mbedtls_hmac_drbg_random_with_add( ctx, output, out_len, NULL, 0 ); | 
|  | 401 |  | 
|  | 402 | #if defined(MBEDTLS_THREADING_C) | 
|  | 403 | if( mbedtls_mutex_unlock( &ctx->mutex ) != 0 ) | 
|  | 404 | return( MBEDTLS_ERR_THREADING_MUTEX_ERROR ); | 
|  | 405 | #endif | 
|  | 406 |  | 
|  | 407 | return( ret ); | 
| Manuel Pégourié-Gonnard | 8208d16 | 2014-01-30 12:19:26 +0100 | [diff] [blame] | 408 | } | 
|  | 409 |  | 
|  | 410 | /* | 
| Gavin Acquroff | 6aceb51 | 2020-03-01 17:06:11 -0800 | [diff] [blame] | 411 | *  This function resets HMAC_DRBG context to the state immediately | 
|  | 412 | *  after initial call of mbedtls_hmac_drbg_init(). | 
| Manuel Pégourié-Gonnard | 490bdf3 | 2014-01-27 14:03:10 +0100 | [diff] [blame] | 413 | */ | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 414 | void mbedtls_hmac_drbg_free( mbedtls_hmac_drbg_context *ctx ) | 
| Manuel Pégourié-Gonnard | 490bdf3 | 2014-01-27 14:03:10 +0100 | [diff] [blame] | 415 | { | 
|  | 416 | if( ctx == NULL ) | 
|  | 417 | return; | 
|  | 418 |  | 
| Manuel Pégourié-Gonnard | 0a4fb09 | 2015-05-07 12:50:31 +0100 | [diff] [blame] | 419 | #if defined(MBEDTLS_THREADING_C) | 
| Gilles Peskine | e39b219 | 2021-02-09 18:43:33 +0100 | [diff] [blame] | 420 | /* The mutex is initialized iff the md context is set up. */ | 
| Gilles Peskine | b791dc6 | 2021-01-31 00:06:51 +0100 | [diff] [blame] | 421 | if( ctx->md_ctx.md_info != NULL ) | 
|  | 422 | mbedtls_mutex_free( &ctx->mutex ); | 
| Manuel Pégourié-Gonnard | 0a4fb09 | 2015-05-07 12:50:31 +0100 | [diff] [blame] | 423 | #endif | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 424 | mbedtls_md_free( &ctx->md_ctx ); | 
| Andres Amaya Garcia | 1f6301b | 2018-04-17 09:51:09 -0500 | [diff] [blame] | 425 | mbedtls_platform_zeroize( ctx, sizeof( mbedtls_hmac_drbg_context ) ); | 
| Gavin Acquroff | 6aceb51 | 2020-03-01 17:06:11 -0800 | [diff] [blame] | 426 | ctx->reseed_interval = MBEDTLS_HMAC_DRBG_RESEED_INTERVAL; | 
| Manuel Pégourié-Gonnard | 490bdf3 | 2014-01-27 14:03:10 +0100 | [diff] [blame] | 427 | } | 
|  | 428 |  | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 429 | #if defined(MBEDTLS_FS_IO) | 
|  | 430 | int mbedtls_hmac_drbg_write_seed_file( mbedtls_hmac_drbg_context *ctx, const char *path ) | 
| Manuel Pégourié-Gonnard | 48bc3e8 | 2014-01-30 21:11:16 +0100 | [diff] [blame] | 431 | { | 
| Janos Follath | 24eed8d | 2019-11-22 13:21:35 +0000 | [diff] [blame] | 432 | int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED; | 
| Manuel Pégourié-Gonnard | 48bc3e8 | 2014-01-30 21:11:16 +0100 | [diff] [blame] | 433 | FILE *f; | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 434 | unsigned char buf[ MBEDTLS_HMAC_DRBG_MAX_INPUT ]; | 
| Manuel Pégourié-Gonnard | 48bc3e8 | 2014-01-30 21:11:16 +0100 | [diff] [blame] | 435 |  | 
|  | 436 | if( ( f = fopen( path, "wb" ) ) == NULL ) | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 437 | return( MBEDTLS_ERR_HMAC_DRBG_FILE_IO_ERROR ); | 
| Manuel Pégourié-Gonnard | 48bc3e8 | 2014-01-30 21:11:16 +0100 | [diff] [blame] | 438 |  | 
| Gilles Peskine | da0913b | 2022-06-30 17:03:40 +0200 | [diff] [blame] | 439 | /* Ensure no stdio buffering of secrets, as such buffers cannot be wiped. */ | 
|  | 440 | mbedtls_setbuf( f, NULL ); | 
|  | 441 |  | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 442 | if( ( ret = mbedtls_hmac_drbg_random( ctx, buf, sizeof( buf ) ) ) != 0 ) | 
| Manuel Pégourié-Gonnard | 48bc3e8 | 2014-01-30 21:11:16 +0100 | [diff] [blame] | 443 | goto exit; | 
|  | 444 |  | 
|  | 445 | if( fwrite( buf, 1, sizeof( buf ), f ) != sizeof( buf ) ) | 
|  | 446 | { | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 447 | ret = MBEDTLS_ERR_HMAC_DRBG_FILE_IO_ERROR; | 
| Paul Bakker | 4c284c9 | 2014-03-26 15:33:05 +0100 | [diff] [blame] | 448 | goto exit; | 
| Manuel Pégourié-Gonnard | 48bc3e8 | 2014-01-30 21:11:16 +0100 | [diff] [blame] | 449 | } | 
|  | 450 |  | 
|  | 451 | ret = 0; | 
|  | 452 |  | 
|  | 453 | exit: | 
|  | 454 | fclose( f ); | 
| Andres Amaya Garcia | 1f6301b | 2018-04-17 09:51:09 -0500 | [diff] [blame] | 455 | mbedtls_platform_zeroize( buf, sizeof( buf ) ); | 
| Andres Amaya Garcia | 3fee759 | 2017-06-26 10:22:24 +0100 | [diff] [blame] | 456 |  | 
| Manuel Pégourié-Gonnard | 48bc3e8 | 2014-01-30 21:11:16 +0100 | [diff] [blame] | 457 | return( ret ); | 
|  | 458 | } | 
|  | 459 |  | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 460 | int mbedtls_hmac_drbg_update_seed_file( mbedtls_hmac_drbg_context *ctx, const char *path ) | 
| Manuel Pégourié-Gonnard | 48bc3e8 | 2014-01-30 21:11:16 +0100 | [diff] [blame] | 461 | { | 
| Andres Amaya Garcia | 3fee759 | 2017-06-26 10:22:24 +0100 | [diff] [blame] | 462 | int ret = 0; | 
| Gilles Peskine | 8220466 | 2018-09-11 18:43:09 +0200 | [diff] [blame] | 463 | FILE *f = NULL; | 
| Manuel Pégourié-Gonnard | 48bc3e8 | 2014-01-30 21:11:16 +0100 | [diff] [blame] | 464 | size_t n; | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 465 | unsigned char buf[ MBEDTLS_HMAC_DRBG_MAX_INPUT ]; | 
| Gilles Peskine | 8220466 | 2018-09-11 18:43:09 +0200 | [diff] [blame] | 466 | unsigned char c; | 
| Manuel Pégourié-Gonnard | 48bc3e8 | 2014-01-30 21:11:16 +0100 | [diff] [blame] | 467 |  | 
|  | 468 | if( ( f = fopen( path, "rb" ) ) == NULL ) | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 469 | return( MBEDTLS_ERR_HMAC_DRBG_FILE_IO_ERROR ); | 
| Manuel Pégourié-Gonnard | 48bc3e8 | 2014-01-30 21:11:16 +0100 | [diff] [blame] | 470 |  | 
| Gilles Peskine | da0913b | 2022-06-30 17:03:40 +0200 | [diff] [blame] | 471 | /* Ensure no stdio buffering of secrets, as such buffers cannot be wiped. */ | 
|  | 472 | mbedtls_setbuf( f, NULL ); | 
|  | 473 |  | 
| Gilles Peskine | 8220466 | 2018-09-11 18:43:09 +0200 | [diff] [blame] | 474 | n = fread( buf, 1, sizeof( buf ), f ); | 
|  | 475 | if( fread( &c, 1, 1, f ) != 0 ) | 
| Manuel Pégourié-Gonnard | 48bc3e8 | 2014-01-30 21:11:16 +0100 | [diff] [blame] | 476 | { | 
| Gilles Peskine | 8220466 | 2018-09-11 18:43:09 +0200 | [diff] [blame] | 477 | ret = MBEDTLS_ERR_HMAC_DRBG_INPUT_TOO_BIG; | 
|  | 478 | goto exit; | 
| Manuel Pégourié-Gonnard | 48bc3e8 | 2014-01-30 21:11:16 +0100 | [diff] [blame] | 479 | } | 
| Gilles Peskine | 8220466 | 2018-09-11 18:43:09 +0200 | [diff] [blame] | 480 | if( n == 0 || ferror( f ) ) | 
|  | 481 | { | 
| Andres Amaya Garcia | 3fee759 | 2017-06-26 10:22:24 +0100 | [diff] [blame] | 482 | ret = MBEDTLS_ERR_HMAC_DRBG_FILE_IO_ERROR; | 
| Gilles Peskine | 8220466 | 2018-09-11 18:43:09 +0200 | [diff] [blame] | 483 | goto exit; | 
|  | 484 | } | 
| Manuel Pégourié-Gonnard | 48bc3e8 | 2014-01-30 21:11:16 +0100 | [diff] [blame] | 485 | fclose( f ); | 
| Gilles Peskine | 8220466 | 2018-09-11 18:43:09 +0200 | [diff] [blame] | 486 | f = NULL; | 
| Manuel Pégourié-Gonnard | 48bc3e8 | 2014-01-30 21:11:16 +0100 | [diff] [blame] | 487 |  | 
| TRodziewicz | 26371e4 | 2021-06-08 16:45:41 +0200 | [diff] [blame] | 488 | ret = mbedtls_hmac_drbg_update( ctx, buf, n ); | 
| Gilles Peskine | 8220466 | 2018-09-11 18:43:09 +0200 | [diff] [blame] | 489 |  | 
|  | 490 | exit: | 
| Andres Amaya Garcia | 1f6301b | 2018-04-17 09:51:09 -0500 | [diff] [blame] | 491 | mbedtls_platform_zeroize( buf, sizeof( buf ) ); | 
| Gilles Peskine | 8220466 | 2018-09-11 18:43:09 +0200 | [diff] [blame] | 492 | if( f != NULL ) | 
|  | 493 | fclose( f ); | 
| Andres Amaya Garcia | 3fee759 | 2017-06-26 10:22:24 +0100 | [diff] [blame] | 494 | if( ret != 0 ) | 
|  | 495 | return( ret ); | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 496 | return( mbedtls_hmac_drbg_write_seed_file( ctx, path ) ); | 
| Manuel Pégourié-Gonnard | 48bc3e8 | 2014-01-30 21:11:16 +0100 | [diff] [blame] | 497 | } | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 498 | #endif /* MBEDTLS_FS_IO */ | 
| Manuel Pégourié-Gonnard | 48bc3e8 | 2014-01-30 21:11:16 +0100 | [diff] [blame] | 499 |  | 
| Manuel Pégourié-Gonnard | 490bdf3 | 2014-01-27 14:03:10 +0100 | [diff] [blame] | 500 |  | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 501 | #if defined(MBEDTLS_SELF_TEST) | 
| Manuel Pégourié-Gonnard | 490bdf3 | 2014-01-27 14:03:10 +0100 | [diff] [blame] | 502 |  | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 503 | #if !defined(MBEDTLS_SHA1_C) | 
| Manuel Pégourié-Gonnard | 79afaa0 | 2014-01-31 11:12:09 +0100 | [diff] [blame] | 504 | /* Dummy checkup routine */ | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 505 | int mbedtls_hmac_drbg_self_test( int verbose ) | 
| Manuel Pégourié-Gonnard | 490bdf3 | 2014-01-27 14:03:10 +0100 | [diff] [blame] | 506 | { | 
| Manuel Pégourié-Gonnard | d1004f0 | 2015-08-07 10:46:54 +0200 | [diff] [blame] | 507 | (void) verbose; | 
| Manuel Pégourié-Gonnard | 490bdf3 | 2014-01-27 14:03:10 +0100 | [diff] [blame] | 508 | return( 0 ); | 
|  | 509 | } | 
| Manuel Pégourié-Gonnard | 79afaa0 | 2014-01-31 11:12:09 +0100 | [diff] [blame] | 510 | #else | 
|  | 511 |  | 
|  | 512 | #define OUTPUT_LEN  80 | 
|  | 513 |  | 
|  | 514 | /* From a NIST PR=true test vector */ | 
| Manuel Pégourié-Gonnard | 28122e4 | 2015-03-11 09:13:42 +0000 | [diff] [blame] | 515 | static const unsigned char entropy_pr[] = { | 
| Manuel Pégourié-Gonnard | 79afaa0 | 2014-01-31 11:12:09 +0100 | [diff] [blame] | 516 | 0xa0, 0xc9, 0xab, 0x58, 0xf1, 0xe2, 0xe5, 0xa4, 0xde, 0x3e, 0xbd, 0x4f, | 
|  | 517 | 0xf7, 0x3e, 0x9c, 0x5b, 0x64, 0xef, 0xd8, 0xca, 0x02, 0x8c, 0xf8, 0x11, | 
|  | 518 | 0x48, 0xa5, 0x84, 0xfe, 0x69, 0xab, 0x5a, 0xee, 0x42, 0xaa, 0x4d, 0x42, | 
|  | 519 | 0x17, 0x60, 0x99, 0xd4, 0x5e, 0x13, 0x97, 0xdc, 0x40, 0x4d, 0x86, 0xa3, | 
|  | 520 | 0x7b, 0xf5, 0x59, 0x54, 0x75, 0x69, 0x51, 0xe4 }; | 
|  | 521 | static const unsigned char result_pr[OUTPUT_LEN] = { | 
|  | 522 | 0x9a, 0x00, 0xa2, 0xd0, 0x0e, 0xd5, 0x9b, 0xfe, 0x31, 0xec, 0xb1, 0x39, | 
|  | 523 | 0x9b, 0x60, 0x81, 0x48, 0xd1, 0x96, 0x9d, 0x25, 0x0d, 0x3c, 0x1e, 0x94, | 
|  | 524 | 0x10, 0x10, 0x98, 0x12, 0x93, 0x25, 0xca, 0xb8, 0xfc, 0xcc, 0x2d, 0x54, | 
|  | 525 | 0x73, 0x19, 0x70, 0xc0, 0x10, 0x7a, 0xa4, 0x89, 0x25, 0x19, 0x95, 0x5e, | 
|  | 526 | 0x4b, 0xc6, 0x00, 0x1d, 0x7f, 0x4e, 0x6a, 0x2b, 0xf8, 0xa3, 0x01, 0xab, | 
|  | 527 | 0x46, 0x05, 0x5c, 0x09, 0xa6, 0x71, 0x88, 0xf1, 0xa7, 0x40, 0xee, 0xf3, | 
|  | 528 | 0xe1, 0x5c, 0x02, 0x9b, 0x44, 0xaf, 0x03, 0x44 }; | 
|  | 529 |  | 
|  | 530 | /* From a NIST PR=false test vector */ | 
| Manuel Pégourié-Gonnard | 28122e4 | 2015-03-11 09:13:42 +0000 | [diff] [blame] | 531 | static const unsigned char entropy_nopr[] = { | 
| Manuel Pégourié-Gonnard | 79afaa0 | 2014-01-31 11:12:09 +0100 | [diff] [blame] | 532 | 0x79, 0x34, 0x9b, 0xbf, 0x7c, 0xdd, 0xa5, 0x79, 0x95, 0x57, 0x86, 0x66, | 
|  | 533 | 0x21, 0xc9, 0x13, 0x83, 0x11, 0x46, 0x73, 0x3a, 0xbf, 0x8c, 0x35, 0xc8, | 
|  | 534 | 0xc7, 0x21, 0x5b, 0x5b, 0x96, 0xc4, 0x8e, 0x9b, 0x33, 0x8c, 0x74, 0xe3, | 
|  | 535 | 0xe9, 0x9d, 0xfe, 0xdf }; | 
|  | 536 | static const unsigned char result_nopr[OUTPUT_LEN] = { | 
|  | 537 | 0xc6, 0xa1, 0x6a, 0xb8, 0xd4, 0x20, 0x70, 0x6f, 0x0f, 0x34, 0xab, 0x7f, | 
|  | 538 | 0xec, 0x5a, 0xdc, 0xa9, 0xd8, 0xca, 0x3a, 0x13, 0x3e, 0x15, 0x9c, 0xa6, | 
|  | 539 | 0xac, 0x43, 0xc6, 0xf8, 0xa2, 0xbe, 0x22, 0x83, 0x4a, 0x4c, 0x0a, 0x0a, | 
|  | 540 | 0xff, 0xb1, 0x0d, 0x71, 0x94, 0xf1, 0xc1, 0xa5, 0xcf, 0x73, 0x22, 0xec, | 
|  | 541 | 0x1a, 0xe0, 0x96, 0x4e, 0xd4, 0xbf, 0x12, 0x27, 0x46, 0xe0, 0x87, 0xfd, | 
|  | 542 | 0xb5, 0xb3, 0xe9, 0x1b, 0x34, 0x93, 0xd5, 0xbb, 0x98, 0xfa, 0xed, 0x49, | 
|  | 543 | 0xe8, 0x5f, 0x13, 0x0f, 0xc8, 0xa4, 0x59, 0xb7 }; | 
|  | 544 |  | 
|  | 545 | /* "Entropy" from buffer */ | 
| Manuel Pégourié-Gonnard | 9592485 | 2014-03-21 10:54:55 +0100 | [diff] [blame] | 546 | static size_t test_offset; | 
| Manuel Pégourié-Gonnard | 79afaa0 | 2014-01-31 11:12:09 +0100 | [diff] [blame] | 547 | static int hmac_drbg_self_test_entropy( void *data, | 
|  | 548 | unsigned char *buf, size_t len ) | 
|  | 549 | { | 
|  | 550 | const unsigned char *p = data; | 
|  | 551 | memcpy( buf, p + test_offset, len ); | 
|  | 552 | test_offset += len; | 
|  | 553 | return( 0 ); | 
|  | 554 | } | 
|  | 555 |  | 
| Paul Bakker | 7dc4c44 | 2014-02-01 22:50:26 +0100 | [diff] [blame] | 556 | #define CHK( c )    if( (c) != 0 )                          \ | 
|  | 557 | {                                       \ | 
|  | 558 | if( verbose != 0 )                  \ | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 559 | mbedtls_printf( "failed\n" );  \ | 
| Paul Bakker | 7dc4c44 | 2014-02-01 22:50:26 +0100 | [diff] [blame] | 560 | return( 1 );                        \ | 
| Manuel Pégourié-Gonnard | 79afaa0 | 2014-01-31 11:12:09 +0100 | [diff] [blame] | 561 | } | 
|  | 562 |  | 
|  | 563 | /* | 
|  | 564 | * Checkup routine for HMAC_DRBG with SHA-1 | 
|  | 565 | */ | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 566 | int mbedtls_hmac_drbg_self_test( int verbose ) | 
| Manuel Pégourié-Gonnard | 79afaa0 | 2014-01-31 11:12:09 +0100 | [diff] [blame] | 567 | { | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 568 | mbedtls_hmac_drbg_context ctx; | 
| Manuel Pégourié-Gonnard | 79afaa0 | 2014-01-31 11:12:09 +0100 | [diff] [blame] | 569 | unsigned char buf[OUTPUT_LEN]; | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 570 | const mbedtls_md_info_t *md_info = mbedtls_md_info_from_type( MBEDTLS_MD_SHA1 ); | 
| Manuel Pégourié-Gonnard | 79afaa0 | 2014-01-31 11:12:09 +0100 | [diff] [blame] | 571 |  | 
| Manuel Pégourié-Gonnard | f9e9481 | 2015-04-28 22:07:14 +0200 | [diff] [blame] | 572 | mbedtls_hmac_drbg_init( &ctx ); | 
|  | 573 |  | 
| Manuel Pégourié-Gonnard | 79afaa0 | 2014-01-31 11:12:09 +0100 | [diff] [blame] | 574 | /* | 
|  | 575 | * PR = True | 
|  | 576 | */ | 
|  | 577 | if( verbose != 0 ) | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 578 | mbedtls_printf( "  HMAC_DRBG (PR = True) : " ); | 
| Manuel Pégourié-Gonnard | 79afaa0 | 2014-01-31 11:12:09 +0100 | [diff] [blame] | 579 |  | 
|  | 580 | test_offset = 0; | 
| Manuel Pégourié-Gonnard | f9e9481 | 2015-04-28 22:07:14 +0200 | [diff] [blame] | 581 | CHK( mbedtls_hmac_drbg_seed( &ctx, md_info, | 
| Manuel Pégourié-Gonnard | 28122e4 | 2015-03-11 09:13:42 +0000 | [diff] [blame] | 582 | hmac_drbg_self_test_entropy, (void *) entropy_pr, | 
| Manuel Pégourié-Gonnard | 79afaa0 | 2014-01-31 11:12:09 +0100 | [diff] [blame] | 583 | NULL, 0 ) ); | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 584 | mbedtls_hmac_drbg_set_prediction_resistance( &ctx, MBEDTLS_HMAC_DRBG_PR_ON ); | 
|  | 585 | CHK( mbedtls_hmac_drbg_random( &ctx, buf, OUTPUT_LEN ) ); | 
|  | 586 | CHK( mbedtls_hmac_drbg_random( &ctx, buf, OUTPUT_LEN ) ); | 
| Manuel Pégourié-Gonnard | 79afaa0 | 2014-01-31 11:12:09 +0100 | [diff] [blame] | 587 | CHK( memcmp( buf, result_pr, OUTPUT_LEN ) ); | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 588 | mbedtls_hmac_drbg_free( &ctx ); | 
| Manuel Pégourié-Gonnard | 79afaa0 | 2014-01-31 11:12:09 +0100 | [diff] [blame] | 589 |  | 
| Manuel Pégourié-Gonnard | 0a4fb09 | 2015-05-07 12:50:31 +0100 | [diff] [blame] | 590 | mbedtls_hmac_drbg_free( &ctx ); | 
|  | 591 |  | 
| Manuel Pégourié-Gonnard | 79afaa0 | 2014-01-31 11:12:09 +0100 | [diff] [blame] | 592 | if( verbose != 0 ) | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 593 | mbedtls_printf( "passed\n" ); | 
| Manuel Pégourié-Gonnard | 79afaa0 | 2014-01-31 11:12:09 +0100 | [diff] [blame] | 594 |  | 
|  | 595 | /* | 
|  | 596 | * PR = False | 
|  | 597 | */ | 
|  | 598 | if( verbose != 0 ) | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 599 | mbedtls_printf( "  HMAC_DRBG (PR = False) : " ); | 
| Manuel Pégourié-Gonnard | 79afaa0 | 2014-01-31 11:12:09 +0100 | [diff] [blame] | 600 |  | 
| Manuel Pégourié-Gonnard | 0a4fb09 | 2015-05-07 12:50:31 +0100 | [diff] [blame] | 601 | mbedtls_hmac_drbg_init( &ctx ); | 
|  | 602 |  | 
| Manuel Pégourié-Gonnard | 79afaa0 | 2014-01-31 11:12:09 +0100 | [diff] [blame] | 603 | test_offset = 0; | 
| Manuel Pégourié-Gonnard | f9e9481 | 2015-04-28 22:07:14 +0200 | [diff] [blame] | 604 | CHK( mbedtls_hmac_drbg_seed( &ctx, md_info, | 
| Manuel Pégourié-Gonnard | 28122e4 | 2015-03-11 09:13:42 +0000 | [diff] [blame] | 605 | hmac_drbg_self_test_entropy, (void *) entropy_nopr, | 
| Manuel Pégourié-Gonnard | 79afaa0 | 2014-01-31 11:12:09 +0100 | [diff] [blame] | 606 | NULL, 0 ) ); | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 607 | CHK( mbedtls_hmac_drbg_reseed( &ctx, NULL, 0 ) ); | 
|  | 608 | CHK( mbedtls_hmac_drbg_random( &ctx, buf, OUTPUT_LEN ) ); | 
|  | 609 | CHK( mbedtls_hmac_drbg_random( &ctx, buf, OUTPUT_LEN ) ); | 
| Manuel Pégourié-Gonnard | 79afaa0 | 2014-01-31 11:12:09 +0100 | [diff] [blame] | 610 | CHK( memcmp( buf, result_nopr, OUTPUT_LEN ) ); | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 611 | mbedtls_hmac_drbg_free( &ctx ); | 
| Manuel Pégourié-Gonnard | 79afaa0 | 2014-01-31 11:12:09 +0100 | [diff] [blame] | 612 |  | 
| Manuel Pégourié-Gonnard | 0a4fb09 | 2015-05-07 12:50:31 +0100 | [diff] [blame] | 613 | mbedtls_hmac_drbg_free( &ctx ); | 
|  | 614 |  | 
| Manuel Pégourié-Gonnard | 79afaa0 | 2014-01-31 11:12:09 +0100 | [diff] [blame] | 615 | if( verbose != 0 ) | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 616 | mbedtls_printf( "passed\n" ); | 
| Manuel Pégourié-Gonnard | 79afaa0 | 2014-01-31 11:12:09 +0100 | [diff] [blame] | 617 |  | 
|  | 618 | if( verbose != 0 ) | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 619 | mbedtls_printf( "\n" ); | 
| Manuel Pégourié-Gonnard | 79afaa0 | 2014-01-31 11:12:09 +0100 | [diff] [blame] | 620 |  | 
|  | 621 | return( 0 ); | 
|  | 622 | } | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 623 | #endif /* MBEDTLS_SHA1_C */ | 
|  | 624 | #endif /* MBEDTLS_SELF_TEST */ | 
| Manuel Pégourié-Gonnard | 490bdf3 | 2014-01-27 14:03:10 +0100 | [diff] [blame] | 625 |  | 
| Manuel Pégourié-Gonnard | 2cf5a7c | 2015-04-08 12:49:31 +0200 | [diff] [blame] | 626 | #endif /* MBEDTLS_HMAC_DRBG_C */ |