Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 1 | /* |
| 2 | * Implementation of NIST SP 800-38F key wrapping, supporting KW and KWP modes |
| 3 | * only |
| 4 | * |
Bence Szépkúti | 1e14827 | 2020-08-07 13:07:28 +0200 | [diff] [blame] | 5 | * Copyright The Mbed TLS Contributors |
Dave Rodgman | 16799db | 2023-11-02 19:47:20 +0000 | [diff] [blame] | 6 | * SPDX-License-Identifier: Apache-2.0 OR GPL-2.0-or-later |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 7 | */ |
| 8 | /* |
| 9 | * Definition of Key Wrapping: |
| 10 | * https://nvlpubs.nist.gov/nistpubs/SpecialPublications/NIST.SP.800-38F.pdf |
| 11 | * RFC 3394 "Advanced Encryption Standard (AES) Key Wrap Algorithm" |
| 12 | * RFC 5649 "Advanced Encryption Standard (AES) Key Wrap with Padding Algorithm" |
| 13 | * |
| 14 | * Note: RFC 3394 defines different methodology for intermediate operations for |
| 15 | * the wrapping and unwrapping operation than the definition in NIST SP 800-38F. |
| 16 | */ |
| 17 | |
Gilles Peskine | db09ef6 | 2020-06-03 01:43:33 +0200 | [diff] [blame] | 18 | #include "common.h" |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 19 | |
| 20 | #if defined(MBEDTLS_NIST_KW_C) |
| 21 | |
| 22 | #include "mbedtls/nist_kw.h" |
| 23 | #include "mbedtls/platform_util.h" |
Janos Follath | 24eed8d | 2019-11-22 13:21:35 +0000 | [diff] [blame] | 24 | #include "mbedtls/error.h" |
Gabor Mezei | 765862c | 2021-10-19 12:22:25 +0200 | [diff] [blame] | 25 | #include "mbedtls/constant_time.h" |
Dave Rodgman | d337bd9 | 2023-09-18 18:22:27 +0100 | [diff] [blame] | 26 | #include "constant_time_internal.h" |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 27 | |
| 28 | #include <stdint.h> |
| 29 | #include <string.h> |
| 30 | |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 31 | #include "mbedtls/platform.h" |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 32 | |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 33 | #define KW_SEMIBLOCK_LENGTH 8 |
| 34 | #define MIN_SEMIBLOCKS_COUNT 3 |
| 35 | |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 36 | /*! The 64-bit default integrity check value (ICV) for KW mode. */ |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 37 | static const unsigned char NIST_KW_ICV1[] = { 0xA6, 0xA6, 0xA6, 0xA6, 0xA6, 0xA6, 0xA6, 0xA6 }; |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 38 | /*! The 32-bit default integrity check value (ICV) for KWP mode. */ |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 39 | static const unsigned char NIST_KW_ICV2[] = { 0xA6, 0x59, 0x59, 0xA6 }; |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 40 | |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 41 | /* |
| 42 | * Initialize context |
| 43 | */ |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 44 | void mbedtls_nist_kw_init(mbedtls_nist_kw_context *ctx) |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 45 | { |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 46 | memset(ctx, 0, sizeof(mbedtls_nist_kw_context)); |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 47 | } |
| 48 | |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 49 | int mbedtls_nist_kw_setkey(mbedtls_nist_kw_context *ctx, |
| 50 | mbedtls_cipher_id_t cipher, |
| 51 | const unsigned char *key, |
| 52 | unsigned int keybits, |
| 53 | const int is_wrap) |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 54 | { |
Janos Follath | 24eed8d | 2019-11-22 13:21:35 +0000 | [diff] [blame] | 55 | int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED; |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 56 | const mbedtls_cipher_info_t *cipher_info; |
| 57 | |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 58 | cipher_info = mbedtls_cipher_info_from_values(cipher, |
| 59 | keybits, |
| 60 | MBEDTLS_MODE_ECB); |
| 61 | if (cipher_info == NULL) { |
| 62 | return MBEDTLS_ERR_CIPHER_BAD_INPUT_DATA; |
| 63 | } |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 64 | |
Dave Rodgman | 85a8813 | 2023-06-24 11:41:50 +0100 | [diff] [blame] | 65 | if (mbedtls_cipher_info_get_block_size(cipher_info) != 16) { |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 66 | return MBEDTLS_ERR_CIPHER_BAD_INPUT_DATA; |
| 67 | } |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 68 | |
| 69 | /* |
| 70 | * SP 800-38F currently defines AES cipher as the only block cipher allowed: |
| 71 | * "For KW and KWP, the underlying block cipher shall be approved, and the |
| 72 | * block size shall be 128 bits. Currently, the AES block cipher, with key |
| 73 | * lengths of 128, 192, or 256 bits, is the only block cipher that fits |
| 74 | * this profile." |
| 75 | * Currently we don't support other 128 bit block ciphers for key wrapping, |
| 76 | * such as Camellia and Aria. |
| 77 | */ |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 78 | if (cipher != MBEDTLS_CIPHER_ID_AES) { |
| 79 | return MBEDTLS_ERR_CIPHER_FEATURE_UNAVAILABLE; |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 80 | } |
| 81 | |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 82 | mbedtls_cipher_free(&ctx->cipher_ctx); |
| 83 | |
| 84 | if ((ret = mbedtls_cipher_setup(&ctx->cipher_ctx, cipher_info)) != 0) { |
| 85 | return ret; |
| 86 | } |
| 87 | |
| 88 | if ((ret = mbedtls_cipher_setkey(&ctx->cipher_ctx, key, keybits, |
| 89 | is_wrap ? MBEDTLS_ENCRYPT : |
| 90 | MBEDTLS_DECRYPT) |
| 91 | ) != 0) { |
| 92 | return ret; |
| 93 | } |
| 94 | |
| 95 | return 0; |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 96 | } |
| 97 | |
| 98 | /* |
| 99 | * Free context |
| 100 | */ |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 101 | void mbedtls_nist_kw_free(mbedtls_nist_kw_context *ctx) |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 102 | { |
Troy-Butler | 9ac3e23 | 2024-03-22 14:46:04 -0400 | [diff] [blame] | 103 | if (ctx == NULL) { |
| 104 | return; |
| 105 | } |
| 106 | |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 107 | mbedtls_cipher_free(&ctx->cipher_ctx); |
| 108 | mbedtls_platform_zeroize(ctx, sizeof(mbedtls_nist_kw_context)); |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 109 | } |
| 110 | |
| 111 | /* |
| 112 | * Helper function for Xoring the uint64_t "t" with the encrypted A. |
| 113 | * Defined in NIST SP 800-38F section 6.1 |
| 114 | */ |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 115 | static void calc_a_xor_t(unsigned char A[KW_SEMIBLOCK_LENGTH], uint64_t t) |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 116 | { |
| 117 | size_t i = 0; |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 118 | for (i = 0; i < sizeof(t); i++) { |
| 119 | A[i] ^= (t >> ((sizeof(t) - 1 - i) * 8)) & 0xff; |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 120 | } |
| 121 | } |
| 122 | |
| 123 | /* |
| 124 | * KW-AE as defined in SP 800-38F section 6.2 |
| 125 | * KWP-AE as defined in SP 800-38F section 6.3 |
| 126 | */ |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 127 | int mbedtls_nist_kw_wrap(mbedtls_nist_kw_context *ctx, |
| 128 | mbedtls_nist_kw_mode_t mode, |
| 129 | const unsigned char *input, size_t in_len, |
| 130 | unsigned char *output, size_t *out_len, size_t out_size) |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 131 | { |
| 132 | int ret = 0; |
| 133 | size_t semiblocks = 0; |
| 134 | size_t s; |
| 135 | size_t olen, padlen = 0; |
| 136 | uint64_t t = 0; |
| 137 | unsigned char outbuff[KW_SEMIBLOCK_LENGTH * 2]; |
| 138 | unsigned char inbuff[KW_SEMIBLOCK_LENGTH * 2]; |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 139 | |
| 140 | *out_len = 0; |
| 141 | /* |
| 142 | * Generate the String to work on |
| 143 | */ |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 144 | if (mode == MBEDTLS_KW_MODE_KW) { |
| 145 | if (out_size < in_len + KW_SEMIBLOCK_LENGTH) { |
| 146 | return MBEDTLS_ERR_CIPHER_BAD_INPUT_DATA; |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 147 | } |
| 148 | |
| 149 | /* |
| 150 | * According to SP 800-38F Table 1, the plaintext length for KW |
| 151 | * must be between 2 to 2^54-1 semiblocks inclusive. |
| 152 | */ |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 153 | if (in_len < 16 || |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 154 | #if SIZE_MAX > 0x1FFFFFFFFFFFFF8 |
| 155 | in_len > 0x1FFFFFFFFFFFFF8 || |
| 156 | #endif |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 157 | in_len % KW_SEMIBLOCK_LENGTH != 0) { |
| 158 | return MBEDTLS_ERR_CIPHER_BAD_INPUT_DATA; |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 159 | } |
| 160 | |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 161 | memcpy(output, NIST_KW_ICV1, KW_SEMIBLOCK_LENGTH); |
| 162 | memmove(output + KW_SEMIBLOCK_LENGTH, input, in_len); |
| 163 | } else { |
| 164 | if (in_len % 8 != 0) { |
| 165 | padlen = (8 - (in_len % 8)); |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 166 | } |
| 167 | |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 168 | if (out_size < in_len + KW_SEMIBLOCK_LENGTH + padlen) { |
| 169 | return MBEDTLS_ERR_CIPHER_BAD_INPUT_DATA; |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 170 | } |
| 171 | |
| 172 | /* |
| 173 | * According to SP 800-38F Table 1, the plaintext length for KWP |
| 174 | * must be between 1 and 2^32-1 octets inclusive. |
| 175 | */ |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 176 | if (in_len < 1 |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 177 | #if SIZE_MAX > 0xFFFFFFFF |
| 178 | || in_len > 0xFFFFFFFF |
| 179 | #endif |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 180 | ) { |
| 181 | return MBEDTLS_ERR_CIPHER_BAD_INPUT_DATA; |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 182 | } |
| 183 | |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 184 | memcpy(output, NIST_KW_ICV2, KW_SEMIBLOCK_LENGTH / 2); |
| 185 | MBEDTLS_PUT_UINT32_BE((in_len & 0xffffffff), output, |
| 186 | KW_SEMIBLOCK_LENGTH / 2); |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 187 | |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 188 | memcpy(output + KW_SEMIBLOCK_LENGTH, input, in_len); |
| 189 | memset(output + KW_SEMIBLOCK_LENGTH + in_len, 0, padlen); |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 190 | } |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 191 | semiblocks = ((in_len + padlen) / KW_SEMIBLOCK_LENGTH) + 1; |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 192 | |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 193 | s = 6 * (semiblocks - 1); |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 194 | |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 195 | if (mode == MBEDTLS_KW_MODE_KWP |
| 196 | && in_len <= KW_SEMIBLOCK_LENGTH) { |
| 197 | memcpy(inbuff, output, 16); |
| 198 | ret = mbedtls_cipher_update(&ctx->cipher_ctx, |
| 199 | inbuff, 16, output, &olen); |
| 200 | if (ret != 0) { |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 201 | goto cleanup; |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 202 | } |
| 203 | } else { |
Gilles Peskine | 89ee599 | 2021-06-01 11:22:56 +0200 | [diff] [blame] | 204 | unsigned char *R2 = output + KW_SEMIBLOCK_LENGTH; |
| 205 | unsigned char *A = output; |
| 206 | |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 207 | /* |
| 208 | * Do the wrapping function W, as defined in RFC 3394 section 2.2.1 |
| 209 | */ |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 210 | if (semiblocks < MIN_SEMIBLOCKS_COUNT) { |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 211 | ret = MBEDTLS_ERR_CIPHER_BAD_INPUT_DATA; |
| 212 | goto cleanup; |
| 213 | } |
| 214 | |
| 215 | /* Calculate intermediate values */ |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 216 | for (t = 1; t <= s; t++) { |
| 217 | memcpy(inbuff, A, KW_SEMIBLOCK_LENGTH); |
| 218 | memcpy(inbuff + KW_SEMIBLOCK_LENGTH, R2, KW_SEMIBLOCK_LENGTH); |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 219 | |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 220 | ret = mbedtls_cipher_update(&ctx->cipher_ctx, |
| 221 | inbuff, 16, outbuff, &olen); |
| 222 | if (ret != 0) { |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 223 | goto cleanup; |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 224 | } |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 225 | |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 226 | memcpy(A, outbuff, KW_SEMIBLOCK_LENGTH); |
| 227 | calc_a_xor_t(A, t); |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 228 | |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 229 | memcpy(R2, outbuff + KW_SEMIBLOCK_LENGTH, KW_SEMIBLOCK_LENGTH); |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 230 | R2 += KW_SEMIBLOCK_LENGTH; |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 231 | if (R2 >= output + (semiblocks * KW_SEMIBLOCK_LENGTH)) { |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 232 | R2 = output + KW_SEMIBLOCK_LENGTH; |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 233 | } |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 234 | } |
| 235 | } |
| 236 | |
| 237 | *out_len = semiblocks * KW_SEMIBLOCK_LENGTH; |
| 238 | |
| 239 | cleanup: |
| 240 | |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 241 | if (ret != 0) { |
| 242 | memset(output, 0, semiblocks * KW_SEMIBLOCK_LENGTH); |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 243 | } |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 244 | mbedtls_platform_zeroize(inbuff, KW_SEMIBLOCK_LENGTH * 2); |
| 245 | mbedtls_platform_zeroize(outbuff, KW_SEMIBLOCK_LENGTH * 2); |
Andrzej Kurek | c470b6b | 2019-01-31 08:20:20 -0500 | [diff] [blame] | 246 | |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 247 | return ret; |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 248 | } |
| 249 | |
| 250 | /* |
| 251 | * W-1 function as defined in RFC 3394 section 2.2.2 |
| 252 | * This function assumes the following: |
| 253 | * 1. Output buffer is at least of size ( semiblocks - 1 ) * KW_SEMIBLOCK_LENGTH. |
| 254 | * 2. The input buffer is of size semiblocks * KW_SEMIBLOCK_LENGTH. |
| 255 | * 3. Minimal number of semiblocks is 3. |
| 256 | * 4. A is a buffer to hold the first semiblock of the input buffer. |
| 257 | */ |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 258 | static int unwrap(mbedtls_nist_kw_context *ctx, |
| 259 | const unsigned char *input, size_t semiblocks, |
| 260 | unsigned char A[KW_SEMIBLOCK_LENGTH], |
| 261 | unsigned char *output, size_t *out_len) |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 262 | { |
| 263 | int ret = 0; |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 264 | const size_t s = 6 * (semiblocks - 1); |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 265 | size_t olen; |
| 266 | uint64_t t = 0; |
| 267 | unsigned char outbuff[KW_SEMIBLOCK_LENGTH * 2]; |
| 268 | unsigned char inbuff[KW_SEMIBLOCK_LENGTH * 2]; |
Gilles Peskine | 89ee599 | 2021-06-01 11:22:56 +0200 | [diff] [blame] | 269 | unsigned char *R = NULL; |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 270 | *out_len = 0; |
| 271 | |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 272 | if (semiblocks < MIN_SEMIBLOCKS_COUNT) { |
| 273 | return MBEDTLS_ERR_CIPHER_BAD_INPUT_DATA; |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 274 | } |
| 275 | |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 276 | memcpy(A, input, KW_SEMIBLOCK_LENGTH); |
| 277 | memmove(output, input + KW_SEMIBLOCK_LENGTH, (semiblocks - 1) * KW_SEMIBLOCK_LENGTH); |
| 278 | R = output + (semiblocks - 2) * KW_SEMIBLOCK_LENGTH; |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 279 | |
| 280 | /* Calculate intermediate values */ |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 281 | for (t = s; t >= 1; t--) { |
| 282 | calc_a_xor_t(A, t); |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 283 | |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 284 | memcpy(inbuff, A, KW_SEMIBLOCK_LENGTH); |
| 285 | memcpy(inbuff + KW_SEMIBLOCK_LENGTH, R, KW_SEMIBLOCK_LENGTH); |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 286 | |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 287 | ret = mbedtls_cipher_update(&ctx->cipher_ctx, |
| 288 | inbuff, 16, outbuff, &olen); |
| 289 | if (ret != 0) { |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 290 | goto cleanup; |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 291 | } |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 292 | |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 293 | memcpy(A, outbuff, KW_SEMIBLOCK_LENGTH); |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 294 | |
| 295 | /* Set R as LSB64 of outbuff */ |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 296 | memcpy(R, outbuff + KW_SEMIBLOCK_LENGTH, KW_SEMIBLOCK_LENGTH); |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 297 | |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 298 | if (R == output) { |
| 299 | R = output + (semiblocks - 2) * KW_SEMIBLOCK_LENGTH; |
| 300 | } else { |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 301 | R -= KW_SEMIBLOCK_LENGTH; |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 302 | } |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 303 | } |
| 304 | |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 305 | *out_len = (semiblocks - 1) * KW_SEMIBLOCK_LENGTH; |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 306 | |
| 307 | cleanup: |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 308 | if (ret != 0) { |
| 309 | memset(output, 0, (semiblocks - 1) * KW_SEMIBLOCK_LENGTH); |
| 310 | } |
| 311 | mbedtls_platform_zeroize(inbuff, sizeof(inbuff)); |
| 312 | mbedtls_platform_zeroize(outbuff, sizeof(outbuff)); |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 313 | |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 314 | return ret; |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 315 | } |
| 316 | |
| 317 | /* |
| 318 | * KW-AD as defined in SP 800-38F section 6.2 |
| 319 | * KWP-AD as defined in SP 800-38F section 6.3 |
| 320 | */ |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 321 | int mbedtls_nist_kw_unwrap(mbedtls_nist_kw_context *ctx, |
| 322 | mbedtls_nist_kw_mode_t mode, |
| 323 | const unsigned char *input, size_t in_len, |
| 324 | unsigned char *output, size_t *out_len, size_t out_size) |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 325 | { |
| 326 | int ret = 0; |
Dave Rodgman | d337bd9 | 2023-09-18 18:22:27 +0100 | [diff] [blame] | 327 | size_t olen; |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 328 | unsigned char A[KW_SEMIBLOCK_LENGTH]; |
Dave Rodgman | d337bd9 | 2023-09-18 18:22:27 +0100 | [diff] [blame] | 329 | int diff; |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 330 | |
| 331 | *out_len = 0; |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 332 | if (out_size < in_len - KW_SEMIBLOCK_LENGTH) { |
| 333 | return MBEDTLS_ERR_CIPHER_BAD_INPUT_DATA; |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 334 | } |
| 335 | |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 336 | if (mode == MBEDTLS_KW_MODE_KW) { |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 337 | /* |
| 338 | * According to SP 800-38F Table 1, the ciphertext length for KW |
| 339 | * must be between 3 to 2^54 semiblocks inclusive. |
| 340 | */ |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 341 | if (in_len < 24 || |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 342 | #if SIZE_MAX > 0x200000000000000 |
| 343 | in_len > 0x200000000000000 || |
| 344 | #endif |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 345 | in_len % KW_SEMIBLOCK_LENGTH != 0) { |
| 346 | return MBEDTLS_ERR_CIPHER_BAD_INPUT_DATA; |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 347 | } |
| 348 | |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 349 | ret = unwrap(ctx, input, in_len / KW_SEMIBLOCK_LENGTH, |
| 350 | A, output, out_len); |
| 351 | if (ret != 0) { |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 352 | goto cleanup; |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 353 | } |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 354 | |
| 355 | /* Check ICV in "constant-time" */ |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 356 | diff = mbedtls_ct_memcmp(NIST_KW_ICV1, A, KW_SEMIBLOCK_LENGTH); |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 357 | |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 358 | if (diff != 0) { |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 359 | ret = MBEDTLS_ERR_CIPHER_AUTH_FAILED; |
| 360 | goto cleanup; |
| 361 | } |
| 362 | |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 363 | } else if (mode == MBEDTLS_KW_MODE_KWP) { |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 364 | size_t padlen = 0; |
| 365 | uint32_t Plen; |
| 366 | /* |
| 367 | * According to SP 800-38F Table 1, the ciphertext length for KWP |
| 368 | * must be between 2 to 2^29 semiblocks inclusive. |
| 369 | */ |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 370 | if (in_len < KW_SEMIBLOCK_LENGTH * 2 || |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 371 | #if SIZE_MAX > 0x100000000 |
| 372 | in_len > 0x100000000 || |
| 373 | #endif |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 374 | in_len % KW_SEMIBLOCK_LENGTH != 0) { |
| 375 | return MBEDTLS_ERR_CIPHER_BAD_INPUT_DATA; |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 376 | } |
| 377 | |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 378 | if (in_len == KW_SEMIBLOCK_LENGTH * 2) { |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 379 | unsigned char outbuff[KW_SEMIBLOCK_LENGTH * 2]; |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 380 | ret = mbedtls_cipher_update(&ctx->cipher_ctx, |
| 381 | input, 16, outbuff, &olen); |
| 382 | if (ret != 0) { |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 383 | goto cleanup; |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 384 | } |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 385 | |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 386 | memcpy(A, outbuff, KW_SEMIBLOCK_LENGTH); |
| 387 | memcpy(output, outbuff + KW_SEMIBLOCK_LENGTH, KW_SEMIBLOCK_LENGTH); |
| 388 | mbedtls_platform_zeroize(outbuff, sizeof(outbuff)); |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 389 | *out_len = KW_SEMIBLOCK_LENGTH; |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 390 | } else { |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 391 | /* in_len >= KW_SEMIBLOCK_LENGTH * 3 */ |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 392 | ret = unwrap(ctx, input, in_len / KW_SEMIBLOCK_LENGTH, |
| 393 | A, output, out_len); |
| 394 | if (ret != 0) { |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 395 | goto cleanup; |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 396 | } |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 397 | } |
| 398 | |
| 399 | /* Check ICV in "constant-time" */ |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 400 | diff = mbedtls_ct_memcmp(NIST_KW_ICV2, A, KW_SEMIBLOCK_LENGTH / 2); |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 401 | |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 402 | if (diff != 0) { |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 403 | ret = MBEDTLS_ERR_CIPHER_AUTH_FAILED; |
| 404 | } |
| 405 | |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 406 | Plen = MBEDTLS_GET_UINT32_BE(A, KW_SEMIBLOCK_LENGTH / 2); |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 407 | |
| 408 | /* |
| 409 | * Plen is the length of the plaintext, when the input is valid. |
| 410 | * If Plen is larger than the plaintext and padding, padlen will be |
| 411 | * larger than 8, because of the type wrap around. |
| 412 | */ |
| 413 | padlen = in_len - KW_SEMIBLOCK_LENGTH - Plen; |
Dave Rodgman | d03f483 | 2023-09-22 09:52:15 +0100 | [diff] [blame] | 414 | ret = mbedtls_ct_error_if(mbedtls_ct_uint_gt(padlen, 7), |
| 415 | MBEDTLS_ERR_CIPHER_AUTH_FAILED, ret); |
Dave Rodgman | 51c1530 | 2023-09-19 17:09:13 +0100 | [diff] [blame] | 416 | padlen &= 7; |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 417 | |
| 418 | /* Check padding in "constant-time" */ |
Dave Rodgman | d337bd9 | 2023-09-18 18:22:27 +0100 | [diff] [blame] | 419 | const uint8_t zero[KW_SEMIBLOCK_LENGTH] = { 0 }; |
| 420 | diff = mbedtls_ct_memcmp_partial( |
| 421 | &output[*out_len - KW_SEMIBLOCK_LENGTH], zero, |
| 422 | KW_SEMIBLOCK_LENGTH, KW_SEMIBLOCK_LENGTH - padlen, 0); |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 423 | |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 424 | if (diff != 0) { |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 425 | ret = MBEDTLS_ERR_CIPHER_AUTH_FAILED; |
| 426 | } |
| 427 | |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 428 | if (ret != 0) { |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 429 | goto cleanup; |
| 430 | } |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 431 | memset(output + Plen, 0, padlen); |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 432 | *out_len = Plen; |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 433 | } else { |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 434 | ret = MBEDTLS_ERR_CIPHER_FEATURE_UNAVAILABLE; |
| 435 | goto cleanup; |
| 436 | } |
| 437 | |
| 438 | cleanup: |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 439 | if (ret != 0) { |
| 440 | memset(output, 0, *out_len); |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 441 | *out_len = 0; |
| 442 | } |
| 443 | |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 444 | mbedtls_platform_zeroize(&diff, sizeof(diff)); |
| 445 | mbedtls_platform_zeroize(A, sizeof(A)); |
Andrzej Kurek | c470b6b | 2019-01-31 08:20:20 -0500 | [diff] [blame] | 446 | |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 447 | return ret; |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 448 | } |
| 449 | |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 450 | #if defined(MBEDTLS_SELF_TEST) && defined(MBEDTLS_AES_C) |
| 451 | |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 452 | /* |
| 453 | * Test vectors taken from NIST |
| 454 | * https://csrc.nist.gov/Projects/Cryptographic-Algorithm-Validation-Program/CAVP-TESTING-BLOCK-CIPHER-MODES#KW |
| 455 | */ |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 456 | static const unsigned int key_len[] = { |
| 457 | 16, |
| 458 | #if !defined(MBEDTLS_AES_ONLY_128_BIT_KEY_LENGTH) |
| 459 | 24, |
| 460 | 32 |
| 461 | #endif |
| 462 | }; |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 463 | |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 464 | static const unsigned char kw_key[][32] = { |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 465 | { 0x75, 0x75, 0xda, 0x3a, 0x93, 0x60, 0x7c, 0xc2, |
| 466 | 0xbf, 0xd8, 0xce, 0xc7, 0xaa, 0xdf, 0xd9, 0xa6 }, |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 467 | #if !defined(MBEDTLS_AES_ONLY_128_BIT_KEY_LENGTH) |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 468 | { 0x2d, 0x85, 0x26, 0x08, 0x1d, 0x02, 0xfb, 0x5b, |
| 469 | 0x85, 0xf6, 0x9a, 0xc2, 0x86, 0xec, 0xd5, 0x7d, |
| 470 | 0x40, 0xdf, 0x5d, 0xf3, 0x49, 0x47, 0x44, 0xd3 }, |
| 471 | { 0x11, 0x2a, 0xd4, 0x1b, 0x48, 0x56, 0xc7, 0x25, |
| 472 | 0x4a, 0x98, 0x48, 0xd3, 0x0f, 0xdd, 0x78, 0x33, |
| 473 | 0x5b, 0x03, 0x9a, 0x48, 0xa8, 0x96, 0x2c, 0x4d, |
| 474 | 0x1c, 0xb7, 0x8e, 0xab, 0xd5, 0xda, 0xd7, 0x88 } |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 475 | #endif |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 476 | }; |
| 477 | |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 478 | static const unsigned char kw_msg[][40] = { |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 479 | { 0x42, 0x13, 0x6d, 0x3c, 0x38, 0x4a, 0x3e, 0xea, |
| 480 | 0xc9, 0x5a, 0x06, 0x6f, 0xd2, 0x8f, 0xed, 0x3f }, |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 481 | #if !defined(MBEDTLS_AES_ONLY_128_BIT_KEY_LENGTH) |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 482 | { 0x95, 0xc1, 0x1b, 0xf5, 0x35, 0x3a, 0xfe, 0xdb, |
| 483 | 0x98, 0xfd, 0xd6, 0xc8, 0xca, 0x6f, 0xdb, 0x6d, |
| 484 | 0xa5, 0x4b, 0x74, 0xb4, 0x99, 0x0f, 0xdc, 0x45, |
| 485 | 0xc0, 0x9d, 0x15, 0x8f, 0x51, 0xce, 0x62, 0x9d, |
| 486 | 0xe2, 0xaf, 0x26, 0xe3, 0x25, 0x0e, 0x6b, 0x4c }, |
| 487 | { 0x1b, 0x20, 0xbf, 0x19, 0x90, 0xb0, 0x65, 0xd7, |
| 488 | 0x98, 0xe1, 0xb3, 0x22, 0x64, 0xad, 0x50, 0xa8, |
| 489 | 0x74, 0x74, 0x92, 0xba, 0x09, 0xa0, 0x4d, 0xd1 } |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 490 | #endif |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 491 | }; |
| 492 | |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 493 | static const size_t kw_msg_len[] = { |
| 494 | 16, |
| 495 | #if !defined(MBEDTLS_AES_ONLY_128_BIT_KEY_LENGTH) |
| 496 | 40, |
| 497 | 24 |
| 498 | #endif |
| 499 | }; |
| 500 | static const size_t kw_out_len[] = { |
| 501 | 24, |
| 502 | #if !defined(MBEDTLS_AES_ONLY_128_BIT_KEY_LENGTH) |
| 503 | 48, |
| 504 | 32 |
| 505 | #endif |
| 506 | }; |
| 507 | static const unsigned char kw_res[][48] = { |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 508 | { 0x03, 0x1f, 0x6b, 0xd7, 0xe6, 0x1e, 0x64, 0x3d, |
| 509 | 0xf6, 0x85, 0x94, 0x81, 0x6f, 0x64, 0xca, 0xa3, |
| 510 | 0xf5, 0x6f, 0xab, 0xea, 0x25, 0x48, 0xf5, 0xfb }, |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 511 | #if !defined(MBEDTLS_AES_ONLY_128_BIT_KEY_LENGTH) |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 512 | { 0x44, 0x3c, 0x6f, 0x15, 0x09, 0x83, 0x71, 0x91, |
| 513 | 0x3e, 0x5c, 0x81, 0x4c, 0xa1, 0xa0, 0x42, 0xec, |
| 514 | 0x68, 0x2f, 0x7b, 0x13, 0x6d, 0x24, 0x3a, 0x4d, |
| 515 | 0x6c, 0x42, 0x6f, 0xc6, 0x97, 0x15, 0x63, 0xe8, |
| 516 | 0xa1, 0x4a, 0x55, 0x8e, 0x09, 0x64, 0x16, 0x19, |
| 517 | 0xbf, 0x03, 0xfc, 0xaf, 0x90, 0xb1, 0xfc, 0x2d }, |
| 518 | { 0xba, 0x8a, 0x25, 0x9a, 0x47, 0x1b, 0x78, 0x7d, |
| 519 | 0xd5, 0xd5, 0x40, 0xec, 0x25, 0xd4, 0x3d, 0x87, |
| 520 | 0x20, 0x0f, 0xda, 0xdc, 0x6d, 0x1f, 0x05, 0xd9, |
| 521 | 0x16, 0x58, 0x4f, 0xa9, 0xf6, 0xcb, 0xf5, 0x12 } |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 522 | #endif |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 523 | }; |
| 524 | |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 525 | static const unsigned char kwp_key[][32] = { |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 526 | { 0x78, 0x65, 0xe2, 0x0f, 0x3c, 0x21, 0x65, 0x9a, |
| 527 | 0xb4, 0x69, 0x0b, 0x62, 0x9c, 0xdf, 0x3c, 0xc4 }, |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 528 | #if !defined(MBEDTLS_AES_ONLY_128_BIT_KEY_LENGTH) |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 529 | { 0xf5, 0xf8, 0x96, 0xa3, 0xbd, 0x2f, 0x4a, 0x98, |
| 530 | 0x23, 0xef, 0x16, 0x2b, 0x00, 0xb8, 0x05, 0xd7, |
| 531 | 0xde, 0x1e, 0xa4, 0x66, 0x26, 0x96, 0xa2, 0x58 }, |
| 532 | { 0x95, 0xda, 0x27, 0x00, 0xca, 0x6f, 0xd9, 0xa5, |
| 533 | 0x25, 0x54, 0xee, 0x2a, 0x8d, 0xf1, 0x38, 0x6f, |
| 534 | 0x5b, 0x94, 0xa1, 0xa6, 0x0e, 0xd8, 0xa4, 0xae, |
| 535 | 0xf6, 0x0a, 0x8d, 0x61, 0xab, 0x5f, 0x22, 0x5a } |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 536 | #endif |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 537 | }; |
| 538 | |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 539 | static const unsigned char kwp_msg[][31] = { |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 540 | { 0xbd, 0x68, 0x43, 0xd4, 0x20, 0x37, 0x8d, 0xc8, |
| 541 | 0x96 }, |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 542 | #if !defined(MBEDTLS_AES_ONLY_128_BIT_KEY_LENGTH) |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 543 | { 0x6c, 0xcd, 0xd5, 0x85, 0x18, 0x40, 0x97, 0xeb, |
| 544 | 0xd5, 0xc3, 0xaf, 0x3e, 0x47, 0xd0, 0x2c, 0x19, |
| 545 | 0x14, 0x7b, 0x4d, 0x99, 0x5f, 0x96, 0x43, 0x66, |
| 546 | 0x91, 0x56, 0x75, 0x8c, 0x13, 0x16, 0x8f }, |
| 547 | { 0xd1 } |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 548 | #endif |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 549 | }; |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 550 | static const size_t kwp_msg_len[] = { |
| 551 | 9, |
| 552 | #if !defined(MBEDTLS_AES_ONLY_128_BIT_KEY_LENGTH) |
| 553 | 31, |
| 554 | 1 |
| 555 | #endif |
| 556 | }; |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 557 | |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 558 | static const unsigned char kwp_res[][48] = { |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 559 | { 0x41, 0xec, 0xa9, 0x56, 0xd4, 0xaa, 0x04, 0x7e, |
| 560 | 0xb5, 0xcf, 0x4e, 0xfe, 0x65, 0x96, 0x61, 0xe7, |
| 561 | 0x4d, 0xb6, 0xf8, 0xc5, 0x64, 0xe2, 0x35, 0x00 }, |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 562 | #if !defined(MBEDTLS_AES_ONLY_128_BIT_KEY_LENGTH) |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 563 | { 0x4e, 0x9b, 0xc2, 0xbc, 0xbc, 0x6c, 0x1e, 0x13, |
| 564 | 0xd3, 0x35, 0xbc, 0xc0, 0xf7, 0x73, 0x6a, 0x88, |
| 565 | 0xfa, 0x87, 0x53, 0x66, 0x15, 0xbb, 0x8e, 0x63, |
| 566 | 0x8b, 0xcc, 0x81, 0x66, 0x84, 0x68, 0x17, 0x90, |
| 567 | 0x67, 0xcf, 0xa9, 0x8a, 0x9d, 0x0e, 0x33, 0x26 }, |
| 568 | { 0x06, 0xba, 0x7a, 0xe6, 0xf3, 0x24, 0x8c, 0xfd, |
| 569 | 0xcf, 0x26, 0x75, 0x07, 0xfa, 0x00, 0x1b, 0xc4 } |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 570 | #endif |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 571 | }; |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 572 | static const size_t kwp_out_len[] = { |
| 573 | 24, |
| 574 | #if !defined(MBEDTLS_AES_ONLY_128_BIT_KEY_LENGTH) |
| 575 | 40, |
| 576 | 16 |
| 577 | #endif |
| 578 | }; |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 579 | |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 580 | int mbedtls_nist_kw_self_test(int verbose) |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 581 | { |
| 582 | mbedtls_nist_kw_context ctx; |
| 583 | unsigned char out[48]; |
| 584 | size_t olen; |
| 585 | int i; |
| 586 | int ret = 0; |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 587 | mbedtls_nist_kw_init(&ctx); |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 588 | |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 589 | /* |
| 590 | * KW mode |
| 591 | */ |
| 592 | { |
| 593 | static const int num_tests = sizeof(kw_key) / sizeof(*kw_key); |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 594 | |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 595 | for (i = 0; i < num_tests; i++) { |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 596 | if (verbose != 0) { |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 597 | mbedtls_printf(" KW-AES-%u ", (unsigned int) key_len[i] * 8); |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 598 | } |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 599 | |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 600 | ret = mbedtls_nist_kw_setkey(&ctx, MBEDTLS_CIPHER_ID_AES, |
| 601 | kw_key[i], key_len[i] * 8, 1); |
| 602 | if (ret != 0) { |
| 603 | if (verbose != 0) { |
| 604 | mbedtls_printf(" KW: setup failed "); |
| 605 | } |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 606 | |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 607 | goto end; |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 608 | } |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 609 | |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 610 | ret = mbedtls_nist_kw_wrap(&ctx, MBEDTLS_KW_MODE_KW, kw_msg[i], |
| 611 | kw_msg_len[i], out, &olen, sizeof(out)); |
| 612 | if (ret != 0 || kw_out_len[i] != olen || |
| 613 | memcmp(out, kw_res[i], kw_out_len[i]) != 0) { |
| 614 | if (verbose != 0) { |
| 615 | mbedtls_printf("failed. "); |
| 616 | } |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 617 | |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 618 | ret = 1; |
| 619 | goto end; |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 620 | } |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 621 | |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 622 | if ((ret = mbedtls_nist_kw_setkey(&ctx, MBEDTLS_CIPHER_ID_AES, |
| 623 | kw_key[i], key_len[i] * 8, 0)) |
| 624 | != 0) { |
| 625 | if (verbose != 0) { |
| 626 | mbedtls_printf(" KW: setup failed "); |
| 627 | } |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 628 | |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 629 | goto end; |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 630 | } |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 631 | |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 632 | ret = mbedtls_nist_kw_unwrap(&ctx, MBEDTLS_KW_MODE_KW, |
| 633 | out, olen, out, &olen, sizeof(out)); |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 634 | |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 635 | if (ret != 0 || olen != kw_msg_len[i] || |
| 636 | memcmp(out, kw_msg[i], kw_msg_len[i]) != 0) { |
| 637 | if (verbose != 0) { |
| 638 | mbedtls_printf("failed\n"); |
| 639 | } |
| 640 | |
| 641 | ret = 1; |
| 642 | goto end; |
| 643 | } |
| 644 | |
| 645 | if (verbose != 0) { |
| 646 | mbedtls_printf(" passed\n"); |
| 647 | } |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 648 | } |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 649 | } |
| 650 | |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 651 | /* |
| 652 | * KWP mode |
| 653 | */ |
| 654 | { |
| 655 | static const int num_tests = sizeof(kwp_key) / sizeof(*kwp_key); |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 656 | |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 657 | for (i = 0; i < num_tests; i++) { |
| 658 | olen = sizeof(out); |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 659 | if (verbose != 0) { |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 660 | mbedtls_printf(" KWP-AES-%u ", (unsigned int) key_len[i] * 8); |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 661 | } |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 662 | |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 663 | ret = mbedtls_nist_kw_setkey(&ctx, MBEDTLS_CIPHER_ID_AES, kwp_key[i], |
| 664 | key_len[i] * 8, 1); |
| 665 | if (ret != 0) { |
| 666 | if (verbose != 0) { |
| 667 | mbedtls_printf(" KWP: setup failed "); |
| 668 | } |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 669 | |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 670 | goto end; |
| 671 | } |
| 672 | ret = mbedtls_nist_kw_wrap(&ctx, MBEDTLS_KW_MODE_KWP, kwp_msg[i], |
| 673 | kwp_msg_len[i], out, &olen, sizeof(out)); |
| 674 | |
| 675 | if (ret != 0 || kwp_out_len[i] != olen || |
| 676 | memcmp(out, kwp_res[i], kwp_out_len[i]) != 0) { |
| 677 | if (verbose != 0) { |
| 678 | mbedtls_printf("failed. "); |
| 679 | } |
| 680 | |
| 681 | ret = 1; |
| 682 | goto end; |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 683 | } |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 684 | |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 685 | if ((ret = mbedtls_nist_kw_setkey(&ctx, MBEDTLS_CIPHER_ID_AES, |
| 686 | kwp_key[i], key_len[i] * 8, 0)) |
| 687 | != 0) { |
| 688 | if (verbose != 0) { |
| 689 | mbedtls_printf(" KWP: setup failed "); |
| 690 | } |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 691 | |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 692 | goto end; |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 693 | } |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 694 | |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 695 | ret = mbedtls_nist_kw_unwrap(&ctx, MBEDTLS_KW_MODE_KWP, out, |
| 696 | olen, out, &olen, sizeof(out)); |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 697 | |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 698 | if (ret != 0 || olen != kwp_msg_len[i] || |
| 699 | memcmp(out, kwp_msg[i], kwp_msg_len[i]) != 0) { |
| 700 | if (verbose != 0) { |
| 701 | mbedtls_printf("failed. "); |
| 702 | } |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 703 | |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 704 | ret = 1; |
| 705 | goto end; |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 706 | } |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 707 | |
Yanray Wang | d896fcb | 2023-05-11 17:24:41 +0800 | [diff] [blame] | 708 | if (verbose != 0) { |
| 709 | mbedtls_printf(" passed\n"); |
| 710 | } |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 711 | } |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 712 | } |
| 713 | end: |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 714 | mbedtls_nist_kw_free(&ctx); |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 715 | |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 716 | if (verbose != 0) { |
| 717 | mbedtls_printf("\n"); |
| 718 | } |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 719 | |
Gilles Peskine | 449bd83 | 2023-01-11 14:50:10 +0100 | [diff] [blame] | 720 | return ret; |
Ron Eldor | 9ab746c | 2018-07-15 09:33:07 +0300 | [diff] [blame] | 721 | } |
| 722 | |
| 723 | #endif /* MBEDTLS_SELF_TEST && MBEDTLS_AES_C */ |
| 724 | |
Ron Eldor | cb349ac | 2018-07-15 09:29:47 +0300 | [diff] [blame] | 725 | #endif /* MBEDTLS_NIST_KW_C */ |