Visual Studio support for wolfPKCS11

.github/workflows/win-test.yml

@@ -0,0 +1,67 @@
+name: Windows Build Test
+
+on:
+  push:
+    branches: [ 'master', 'main', 'release/**' ]
+  pull_request:
+    branches: [ '*' ]
+
+jobs:
+  build:
+
+    runs-on: windows-latest
+
+    # This should be a safe limit for the tests to run.
+    timeout-minutes: 6
+
+    env:
+      # Path to the solution file relative to the root of the project.
+      SOLUTION_FILE_PATH: wolfpkcs11\IDE\VisualStudio\wolfpkcs11.sln
+
+      # Configuration type to build.
+      # You can convert this to a build matrix if you need coverage of multiple configuration types.
+      # https://docs.github.com/actions/learn-github-actions/managing-complex-workflows#using-a-build-matrix
+      BUILD_CONFIGURATION: Debug
+      BUILD_PLATFORM: x64
+
+    steps:
+        - name: Pull wolfPKCS11
+          uses: actions/checkout@master
+          with:
+            repository: wolfssl/wolfpkcs11
+            path: wolfpkcs11
+
+        - name: Pull wolfTPM
+          uses: actions/checkout@master
+          with:
+            repository: wolfssl/wolftpm
+            path: wolftpm
+
+        - name: Pull wolfSSL
+          uses: actions/checkout@master
+          with:
+            repository: wolfssl/wolfssl
+            path: wolfssl
+        - name: Create FIPS stub files (autogen)
+          working-directory: wolfssl
+          run: |
+            echo $null >> wolfcrypt\src\fips.c
+            echo $null >> wolfcrypt\src\fips_test.c
+            echo $null >> wolfcrypt\src\wolfcrypt_first.c
+            echo $null >> wolfcrypt\src\wolfcrypt_last.c
+
+        - name: Add MSBuild to PATH
+          uses: microsoft/setup-msbuild@v1
+
+        - name: Build
+          working-directory: ${{env.GITHUB_WORKSPACE}}
+          # Add additional options to the MSBuild command line here (like platform or verbosity level).
+          # See https://docs.microsoft.com/visualstudio/msbuild/msbuild-command-line-reference
+          run: msbuild /m /p:PlatformToolset=v142 /p:Platform=${{env.BUILD_PLATFORM}} /p:Configuration=${{env.BUILD_CONFIGURATION}} ${{env.SOLUTION_FILE_PATH}}
+
+        # The GitHub CI runners do not have a TPM.
+        # Failure 0x8028400f: unknown error number
+        # TBS_E_TPM_NOT_FOUND (0x8028400F) A compatible Trusted Platform Module (TPM) Security Device cannot be found on this computer.
+        #- name: Run Wrap Test
+        #  working-directory: ${{env.GITHUB_WORKSPACE}}
+        #  run: wolfpkcs11\IDE\VisualStudio\Debug\x64\pkcs11test.exe

.gitignore

@@ -43,3 +43,5 @@ tests/wp11_ecckey_*
 tests/wp11_symmkey_*
 tests/wp11_token_*
 tests/wp11_obj_*
+
+IDE/VisualStudio/.vs

IDE/VisualStudio/README.md

@@ -0,0 +1,9 @@
+# Visual Studio Solution for wolfPKCS11
+
+This includes projects for building wolfSSL, wolfTPM, wolfPKCS11 and some examples.
+
+The solution and project are based on older VS 2015, but can be re-targeted / updated to newer when opened.
+
+All build settings are contained in IDE/VisualStudio/user_settings.h. This module supports using the FIPS ready bundle from the website. Just enable the `#if 0` FIPS section in user_settings.h. See wolfssl/IDE/WIN10/README.txt for details on setting the FIPS integrity check in fips_test.c at run-time.
+
+These projects assume `wolftpm`, `wolfssl` and `wolfpkcs11` directories reside next to each other.

IDE/VisualStudio/include.am

@@ -0,0 +1,13 @@
+# vim:ft=automake
+# included from Top Level Makefile.am
+# All paths should be given relative to the root
+
+EXTRA_DIST+= IDE/VisualStudio/README.md
+EXTRA_DIST+= IDE/VisualStudio/wolfpkcs11.sln
+EXTRA_DIST+= IDE/VisualStudio/wolftpm.vcxproj
+EXTRA_DIST+= IDE/VisualStudio/wolfssl.vcxproj
+EXTRA_DIST+= IDE/VisualStudio/wolfcrypt_test.vcxproj
+EXTRA_DIST+= IDE/VisualStudio/pkcs11str.vcxproj
+EXTRA_DIST+= IDE/VisualStudio/pkcs11test.vcxproj
+EXTRA_DIST+= IDE/VisualStudio/wrap_test.vcxproj
+EXTRA_DIST+= IDE/VisualStudio/user_settings.h

IDE/VisualStudio/user_settings.h

@@ -0,0 +1,200 @@
+/* user_settings.h
+ *
+ * Copyright (C) 2006-2024 wolfSSL Inc.
+ *
+ * This file is part of wolfPKCS11.
+ *
+ * wolfPKCS11 is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * wolfPKCS11 is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1335, USA
+ */
+
+/* Template for wolfPKCS11, wolfTPM and wolfCrypt (FIPS optional) */
+
+#ifndef _USER_SETTINGS_H_
+#define _USER_SETTINGS_H_
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#if 0 /* enable for FIPS ready */
+    /* FIPS v5-ready 140-3 */
+    #define HAVE_FIPS
+    #define HAVE_FIPS_VERSION 5
+    #define HAVE_FIPS_VERSION_MINOR 3
+#endif
+
+/* Platform */
+#define HAVE_THREAD_LS /* thread local storage */
+#ifdef _WIN32
+    #define WOLFTPM_WINAPI
+    #define _WINSOCK_DEPRECATED_NO_WARNINGS
+    #define _CRT_SECURE_NO_WARNINGS
+#endif
+
+/* Debugging */
+#if 1
+    #define DEBUG_WOLFSSL
+    #define ERROR_QUEUE_PER_THREAD
+
+    #define DEBUG_WOLFTPM
+	//#define WOLFTPM_DEBUG_TIMEOUT
+    //#define WOLFTPM_DEBUG_VERBOSE
+    //#define WOLFTPM_DEBUG_IO
+
+    #define DEBUG_WOLFPKCS11
+	#define WOLFPKCS11_DEBUG_STORE
+#else
+    //#define NO_ERROR_STRINGS
+#endif
+
+
+/* TPM */
+#define WOLFSSL_AES_CFB /* required for parameter encryption */
+#define WOLFSSL_PUBLIC_MP /* expose mp_ math functions - required for tpm ECC secret encrypt */
+
+/* PKCS11 */
+#define HAVE_PKCS11_STATIC
+#define WOLF_CRYPTO_CB
+#define WOLFSSL_KEY_GEN
+#define WC_RSA_DIRECT
+#define WOLFSSL_PUBLIC_MP
+#define WOLFSSL_KEY_GEN
+ //#define HAVE_SCRYPT /* For PKCS11 Pin. Scrypt uses massive memory */
+//#define WOLFPKCS11_USER_ENV
+
+/* PKCS11 TPM */
+#define WOLFPKCS11_TPM
+#define WOLFPKCS11_TPM_STORE
+
+/* TLS */
+#if 0
+    /* TLS Versions v1.2 and v1.3 */
+    #define WOLFSSL_TLS13
+    #define NO_OLD_TLS
+#else
+    #define WOLFCRYPT_ONLY
+#endif
+
+/* TLS Extensions */
+#define HAVE_TLS_EXTENSIONS
+#define HAVE_SUPPORTED_CURVES
+#define HAVE_EXTENDED_MASTER
+#define HAVE_SERVER_RENEGOTIATION_INFO
+#define HAVE_ENCRYPT_THEN_MAC
+#define HAVE_SNI
+
+/* Math Option */
+#ifdef HAVE_FIPS
+    #define USE_FAST_MATH /* tfm.c */
+    #define FP_MAX_BITS 16384
+#else
+    #define WOLFSSL_SP_MATH_ALL /* sp_int.c */
+    #define SP_INT_BITS 8192
+#endif
+#define WOLFSSL_USE_ALIGN
+#define TFM_TIMING_RESISTANT
+#define ECC_TIMING_RESISTANT
+#define WC_RSA_BLINDING
+
+/* No ASM (optional) */
+#if 0
+    #define TFM_NO_ASM
+    #define WOLFSSL_NO_ASM
+    #define NO_CHACHA_ASM
+#endif
+
+/* Certificate */
+#define WOLFSSL_ASN_TEMPLATE
+#define WOLFSSL_BASE64_ENCODE
+#define WOLFSSL_CERT_GEN
+#define WOLFSSL_CERT_REQ
+#define WOLFSSL_CERT_EXT
+
+/* RNG */
+#define HAVE_HASHDRBG
+#define WC_RNG_SEED_CB
+
+/* Asymmetric */
+#define HAVE_ECC
+#define ECC_SHAMIR
+#define ECC_USER_CURVES
+#define HAVE_ECC192
+#define HAVE_ECC224
+#define HAVE_ECC256
+#define HAVE_ECC384
+#define HAVE_ECC521
+#define WOLFSSL_ECDSA_SET_K
+#define HAVE_ECC_CDH
+#define WOLFSSL_VALIDATE_ECC_IMPORT
+#define WOLFSSL_VALIDATE_ECC_KEYGEN
+
+#define WC_RSA_PSS
+#define WOLFSSL_PSS_LONG_SALT
+#define WC_RSA_NO_PADDING
+#define WOLFSSL_KEY_GEN
+
+#if 1
+    #define NO_DH /* PKCS11 w/TPM does not support DH */
+#else
+    #define HAVE_DH_DEFAULT_PARAMS
+    #define HAVE_FFDHE_Q
+    #define HAVE_FFDHE_2048
+    #define HAVE_FFDHE_3072
+    #define HAVE_FFDHE_4096
+    #define HAVE_FFDHE_6144
+    #define HAVE_FFDHE_8192
+    #define WOLFSSL_VALIDATE_FFC_IMPORT
+#endif
+
+#define WOLFSSL_SHA224
+#define WOLFSSL_SHA384
+#define WOLFSSL_SHA512
+#define WOLFSSL_NOSHA512_224
+#define WOLFSSL_NOSHA512_256
+
+#define WOLFSSL_SHA3
+#define WOLFSSL_NO_SHAKE128
+#define WOLFSSL_NO_SHAKE256
+
+#define HAVE_HKDF
+
+#define WOLFSSL_AES_DIRECT
+#define HAVE_AES_ECB
+#define WOLFSSL_AES_COUNTER
+#define WOLFSSL_AES_OFB
+#define HAVE_AESCCM
+#define HAVE_AESGCM
+#define GCM_TABLE_4BIT
+#define HAVE_AES_KEYWRAP
+#define WOLFSSL_AES_DIRECT
+#define HAVE_PKCS7
+#define WOLFSSL_CMAC
+
+#define HAVE_X963_KDF
+
+/* Disabled features */
+#undef  NO_RC4
+#define NO_RC4
+#define NO_PSK
+#define NO_MD4
+#define NO_DES3
+#define NO_DSA
+
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* _USER_SETTINGS_H_ */