Skip to content

Add WISeKey/SealSQ VaultIC secure element port#10974

Open
dgarske wants to merge 3 commits into
wolfSSL:masterfrom
dgarske:sealsq_vaultic
Open

Add WISeKey/SealSQ VaultIC secure element port#10974
dgarske wants to merge 3 commits into
wolfSSL:masterfrom
dgarske:sealsq_vaultic

Conversation

@dgarske

@dgarske dgarske commented Jul 22, 2026

Copy link
Copy Markdown
Member

Summary

Adds an in-tree wolfSSL port for the WISeKey/SealSQ VaultIC secure element (for example the VaultIC 408). It offloads TLS ECC P-256 sign, verify, keygen, and ECDH to the chip through wolfSSL's PK callbacks and loads the device and CA certificates stored on the chip, so the TLS private key never leaves the secure element. Only the glue is in-tree; it calls the external SealSQ VaultIC-TLS SDK.

What it adds

  • wolfcrypt/src/port/sealsq/vaultic.c + wolfssl/wolfcrypt/port/sealsq/vaultic.h:
    • WOLFSSL_VAULTIC_EccSignCb / EccVerifyCb / EccKeyGenCb / EccSharedSecretCb - P-256 ops on the device
    • WOLFSSL_VAULTIC_LoadCertificates - read device + CA certs off the chip
    • WOLFSSL_VAULTIC_SetupPkCallbacks / SetupPkCallbackCtx - register the callbacks
  • wolfcrypt/src/port/sealsq/README.md - build, usage, and provisioning notes.
  • Gated behind --enable-vaultic (defines WOLFSSL_VAULTIC, auto-enables PK callbacks); wiring mirrors the iotsafe port. Compiles to nothing when off.
./configure --enable-vaultic \
    CFLAGS="-I/path/to/VaultIC-TLS/vaultic_tls-4xx/src" LIBS="-lvaultic_tls_408"

Testing

  • Option-off full build unchanged (port guarded out); --enable-vaultic configures and compiles cleanly against the vendor SDK header.
  • Validated on hardware (Raspberry Pi 5 + VaultIC 408): full TLS 1.2 (ECDHE_ECDSA / SECP256R1) and TLS 1.3 (SecP256r1MLKEM768) handshakes complete, with sign, verify, keygen, and ECDH dispatched to the chip and certificates loaded off the device.

@dgarske dgarske self-assigned this Jul 22, 2026
Copilot AI review requested due to automatic review settings July 22, 2026 18:05

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Note

Copilot couldn't run its full agentic review because it didn't start before the timeout. Make sure your repository has a runner available, or add a copilot-code-review.yml file specifying one with the runs-on attribute. See the docs for more details.

Adds an in-tree wolfSSL port that offloads P-256 ECC operations and certificate loading to the WISeKey/SealSQ VaultIC secure element via PK callbacks, with build-system wiring for autotools/CMake.

Changes:

  • Added VaultIC PK callback implementations (sign/verify/keygen/ECDH) and certificate-loading helper.
  • Exposed a public header and port README with build/usage/provisioning notes.
  • Added --enable-vaultic autotools option and a corresponding CMake option; wired sources/headers into build.

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 8 comments.

Show a summary per file
File Description
wolfssl/wolfcrypt/port/sealsq/vaultic.h Declares the VaultIC PK callback + certificate-loading API exported by the port.
wolfssl/wolfcrypt/include.am Installs the new public VaultIC header when BUILD_VAULTIC is enabled.
wolfcrypt/src/port/sealsq/vaultic.c Implements ECC callbacks and certificate loading using the external VaultIC-TLS SDK.
wolfcrypt/src/port/sealsq/README.md Documents dependencies, build flags, usage, and devkit/provisioning notes.
wolfcrypt/src/include.am Adds the VaultIC port source to libwolfssl when BUILD_VAULTIC is enabled and distributes the README.
configure.ac Adds --enable-vaultic, defines WOLFSSL_VAULTIC, and enables PK callbacks for autotools builds.
CMakeLists.txt Adds a WOLFSSL_VAULTIC option and excludes the sealsq port directory from header processing.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread wolfcrypt/src/port/sealsq/vaultic.c
Comment thread wolfcrypt/src/port/sealsq/vaultic.c Outdated
Comment thread wolfcrypt/src/port/sealsq/vaultic.c
Comment thread wolfcrypt/src/port/sealsq/vaultic.c
Comment thread wolfcrypt/src/port/sealsq/vaultic.c
Comment thread CMakeLists.txt
Comment thread wolfssl/wolfcrypt/port/sealsq/vaultic.h Outdated
Comment thread wolfssl/wolfcrypt/port/sealsq/vaultic.h Outdated
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants