Skip to content

wolfHSM: add DTLS client example that uses HSM as cryptographic back end#555

Open
rizlik wants to merge 1 commit into
wolfSSL:masterfrom
rizlik:dtls_wolfhsm_client_example
Open

wolfHSM: add DTLS client example that uses HSM as cryptographic back end#555
rizlik wants to merge 1 commit into
wolfSSL:masterfrom
rizlik:dtls_wolfhsm_client_example

Conversation

@rizlik

@rizlik rizlik commented Jan 30, 2026

Copy link
Copy Markdown
Contributor

No description provided.

bigbrett
bigbrett previously approved these changes Mar 18, 2026
@bigbrett

Copy link
Copy Markdown
Contributor

@rizlik sorry for delay on this. Pls resolve merge conflict

@bigbrett bigbrett assigned rizlik and unassigned bigbrett Jul 2, 2026
@padelsbach

Copy link
Copy Markdown
Contributor

@rizlik, can you please resolve the conflicts?

Copilot AI review requested due to automatic review settings July 14, 2026 13:06
@rizlik
rizlik force-pushed the dtls_wolfhsm_client_example branch from 71c3a4a to 93063e8 Compare July 14, 2026 13:06

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

This PR introduces a new hsm/ area to the examples repository, adding a DTLS client example that demonstrates using wolfHSM as the cryptographic backend (keeping private key operations on the HSM), and wires the new area into the top-level documentation.

Changes:

  • Added a new hsm/ documentation entry and an hsm/README.md landing page for wolfHSM-related examples.
  • Added a DTLS client example (hsm/dtls_client/) including build/run tooling (Makefile) and required wolfSSL/wolfHSM configuration headers.
  • Implemented a DTLS client that offloads ECC signing to wolfHSM via PK callbacks.

Reviewed changes

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

Show a summary per file
File Description
README.md Adds a new “HSM” section to the top-level directory listing.
hsm/README.md Introduces wolfHSM examples landing documentation and a quick-start.
hsm/dtls_client/Makefile Provides build/run automation, including cloning wolfSSL/wolfHSM and building the DTLS client + servers.
hsm/dtls_client/README.md Documents build/run steps and architecture for the DTLS client example.
hsm/dtls_client/user_settings.h Supplies wolfSSL user settings needed for DTLS + crypto-callback/HSM integration.
hsm/dtls_client/wolfhsm_cfg.h Sets wolfHSM compile-time configuration for the DTLS client example.
hsm/dtls_client/wh_dtls_client.c Implements the DTLS client using wolfHSM for ECC signing operations.

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

Comment thread README.md Outdated
Comment thread hsm/dtls_client/wh_dtls_client.c
Comment thread hsm/README.md Outdated
@rizlik rizlik assigned rizlik and unassigned wolfSSL-Bot Jul 14, 2026
@rizlik
rizlik force-pushed the dtls_wolfhsm_client_example branch from 93063e8 to 113482e Compare July 14, 2026 13:23
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.

5 participants