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