Add AES key wrap with padding (RFC 5649) and crypto callback support

Adds wc_AesKeyWrap_Pad/wc_AesKeyUnWrap_Pad and their _ex variants plus crypto
callback dispatch, routing blocks through wc_AesEcb* so an ECB only callback works.

Author: night1rider

.github/workflows/cryptocb-only.yml

@@ -69,7 +69,7 @@ jobs:
             "--enable-swdev", "--enable-cryptocb", "--enable-ecc",
             "--enable-rsa", "--enable-dh", "--enable-aesgcm",
             "--enable-aesccm", "--enable-aesctr", "--enable-aescfb",
-            "--enable-aeskeywrap", "--enable-aessiv", "--enable-aesofb",
+            "--enable-aeskeywrap=padding", "--enable-aessiv", "--enable-aesofb",
             "--enable-aesxts", "--enable-camellia", "--enable-chacha",
             "--enable-poly1305", "--enable-sha", "--enable-sha3",
             "--enable-shake128", "--enable-shake256", "--enable-blake2",
@@ -100,7 +100,7 @@ jobs:
            "comment": "Same as sha512 but tells swdev to refuse the SHA-384 / SHA-512/224 / SHA-512/256 variant callbacks (WOLFSSL_SWDEV_SHA512_GENERAL_ONLY). That forces the cryptocb dispatcher's fallback-to-plain-SHA-512-with-truncation path. The sha512 entry above instead has swdev handle every variant end-to-end, so the dispatcher fallback is otherwise uncovered.",
            "configure": ["CPPFLAGS=-DWOLF_CRYPTO_CB_ONLY_SHA512 -DWOLFSSL_SWDEV_SHA512_GENERAL_ONLY"]},
           {"name": "aes",
-           "comment": "WOLF_CRYPTO_CB_ONLY_AES: strips software AES; swdev provides the software path via cryptocb.",
+           "comment": "WOLF_CRYPTO_CB_ONLY_AES: strips software AES; swdev provides the software path via cryptocb. aeskeywrap=padding covers RFC 3394 + RFC 5649 key wrap via swdev_aes_keywrap.",
            "configure": ["CPPFLAGS=-DWOLF_CRYPTO_CB_ONLY_AES"]},
           {"name": "aes-gcm-via-ecb",
            "comment": "Same as aes but tells swdev to refuse AES-GCM (SWDEV_AES_ONLYECB). That forces the parent's CB_ONLY_AES host-side GCM software path: GHASH runs on the host while AES-CTR blocks dispatch back through cryptocb ECB. The aes entry instead has swdev handle GCM end-to-end, so the host-side GCM path is otherwise uncovered.",

.github/workflows/os-check.yml

@@ -299,6 +299,15 @@ jobs:
            "configure": ["--disable-sni", "--disable-ecc", "--disable-tls13",
             "--disable-secure-renegotiation-info"]},
           {"name": "default", "minutes": 1.6},
+          {"name": "aeskeywrap-padding", "minutes": 1.6,
+           "comment": "RFC 5649 AES key wrap with padding; exercises the =padding sub-option (not pulled in by --enable-all).",
+           "configure": ["--enable-aeskeywrap=padding"]},
+          {"name": "aeskeywrap-padding-cryptocb", "minutes": 1.6,
+           "comment": "Key wrap (RFC 3394 + RFC 5649) over WOLF_CRYPTO_CB device offload; runs test_wc_CryptoCb_AesKeyWrap.",
+           "configure": ["--enable-cryptocb", "--enable-aeskeywrap=padding"]},
+          {"name": "aeskeywrap-padding-cryptocb-ecb", "minutes": 1.6,
+           "comment": "Key wrap with HAVE_AES_ECB so the RFC 3394 loops route each block through wc_AesEcb*; runs test_wc_CryptoCb_AesKeyWrapEcbCompose (key wrap composed from an ECB-only crypto callback).",
+           "configure": ["--enable-cryptocb", "--enable-aeskeywrap=padding", "--enable-aesecb"]},
           {"name": "no-client-no-client-auth", "minutes": 1.6,
            "configure": ["CPPFLAGS=-DNO_WOLFSSL_CLIENT -DWOLFSSL_NO_CLIENT_AUTH"]},
           {"name": "ascon-experimental", "minutes": 1.6,

configure.ac

@@ -6715,12 +6715,31 @@ AC_ARG_ENABLE([entropy-memuse],
     )
 
 # AES key wrap
+# Accepts a comma-separated value list; "padding" adds RFC 5649 key wrap with
+# padding on top of the base RFC 3394 key wrap.
 AC_ARG_ENABLE([aeskeywrap],
-    [AS_HELP_STRING([--enable-aeskeywrap],[Enable AES key wrap support (default: disabled)])],
+    [AS_HELP_STRING([--enable-aeskeywrap],[Enable AES key wrap support, optionally with RFC 5649 padding via "=padding" (default: disabled)])],
     [ ENABLED_AESKEYWRAP=$enableval ],
     [ ENABLED_AESKEYWRAP=no ]
     )
 
+ENABLED_AESKEYWRAP_PADDING=no
+for v in `echo $ENABLED_AESKEYWRAP | tr "," " "`
+do
+    case $v in
+    yes | no)
+        ;;
+    padding)
+        # padding (RFC 5649) builds on the base key wrap support
+        ENABLED_AESKEYWRAP_PADDING=yes
+        ENABLED_AESKEYWRAP=yes
+        ;;
+    *)
+        AC_MSG_ERROR([Invalid aeskeywrap option. Valid are: yes, no, padding. Seen: $ENABLED_AESKEYWRAP.])
+        ;;
+    esac
+done
+
 # FIPS feature and macro setup
 
 AS_CASE([$FIPS_VERSION],
@@ -11363,6 +11382,11 @@ then
     AM_CFLAGS="$AM_CFLAGS -DHAVE_AES_KEYWRAP -DWOLFSSL_AES_DIRECT"
 fi
 
+if test "$ENABLED_AESKEYWRAP_PADDING" = "yes"
+then
+    AM_CFLAGS="$AM_CFLAGS -DWOLFSSL_AES_KEYWRAP_PADDING"
+fi
+
 
 # Old name support for backwards compatibility
 AC_ARG_ENABLE([oldnames],
@@ -13343,6 +13367,7 @@ echo "   * AES-GCM-SIV:                $ENABLED_AESGCMSIV"
 echo "   * AES-EAX:                    $ENABLED_AESEAX"
 echo "   * AES Bitspliced:             $ENABLED_AESBS"
 echo "   * AES Key Wrap:               $ENABLED_AESKEYWRAP"
+echo "   * AES Key Wrap Padding:       $ENABLED_AESKEYWRAP_PADDING"
 echo "   * ARIA:                       $ENABLED_ARIA"
 echo "   * ASCON:                      $ENABLED_ASCON"
 echo "   * DES3:                       $ENABLED_DES3"

tests/api.c

@@ -37045,6 +37045,9 @@ TEST_CASE testCases[] = {
 #if defined(WOLFSSL_AES_SIV) && defined(WOLFSSL_AES_128)
     TEST_AES_SIV_DECLS,
 #endif /* WOLFSSL_AES_SIV && WOLFSSL_AES_128 */
+#if defined(HAVE_AES_KEYWRAP) && defined(WOLFSSL_AES_KEYWRAP_PADDING)
+    TEST_AES_KEYWRAP_DECLS,
+#endif /* HAVE_AES_KEYWRAP && WOLFSSL_AES_KEYWRAP_PADDING */
     TEST_GMAC_DECLS,
     /* Ascon */
     TEST_ASCON_DECLS,