Integration: Code Examples
AES-256-GCM Encryption
Encrypt
#include "wvds_crypto.h" #include <string.h> int encrypt_message( const uint8_t* plaintext, size_t pt_len, const char* aad, size_t aad_len, uint8_t* ciphertext, size_t* ct_len, uint8_t nonce[12], uint8_t tag[16] ) { uint8_t request[65536]; size_t request_len = sizeof(request); // 1. Build request int rc = wvds_build_aes_encrypt_request( request, &request_len, 1, // Key-ID (must exist) aad, aad_len, // Additional Authenticated Data plaintext, pt_len // Data to encrypt ); if (rc != 0) return rc; // 2. Send request to Crypto Service memcpy(g_shared_memory, request, request_len); l4_ipc_send(g_crypto_ep, L4_TIMEOUT_NEVER); l4_ipc_receive(g_crypto_ep, L4_TIMEOUT_NEVER); // 3. Parse response rc = wvds_parse_aes_encrypt_response( g_shared_memory, g_response_len, nonce, tag, // Will be filled ciphertext, ct_len // Ciphertext + length ); return rc; }
Decrypt
int decrypt_message( const uint8_t* ciphertext, size_t ct_len, const uint8_t nonce[12], const uint8_t tag[16], const char* aad, size_t aad_len, uint8_t* plaintext, size_t* pt_len ) { uint8_t request[65536]; size_t request_len = sizeof(request); // 1. Build request int rc = wvds_build_aes_decrypt_request( request, &request_len, 1, // Key-ID nonce, tag, // Received from Encrypt aad, aad_len, // Must be identical! ciphertext, ct_len ); if (rc != 0) return rc; // 2. Send request memcpy(g_shared_memory, request, request_len); l4_ipc_send(g_crypto_ep, L4_TIMEOUT_NEVER); l4_ipc_receive(g_crypto_ep, L4_TIMEOUT_NEVER); // 3. Parse response rc = wvds_parse_aes_decrypt_response( g_shared_memory, g_response_len, plaintext, pt_len ); // rc == 6 means: Tag verification failed! return rc; }
ML-DSA Signatures
Sign
int sign_message( const uint8_t* message, size_t msg_len, uint8_t* signature, size_t* sig_len ) { uint8_t request[65536]; size_t request_len = sizeof(request); int rc = wvds_build_mldsa_sign_request( request, &request_len, 1, // Private Key-ID message, msg_len ); if (rc != 0) return rc; memcpy(g_shared_memory, request, request_len); l4_ipc_send(g_crypto_ep, L4_TIMEOUT_NEVER); l4_ipc_receive(g_crypto_ep, L4_TIMEOUT_NEVER); rc = wvds_parse_mldsa_sign_response( g_shared_memory, g_response_len, signature, sig_len // ML-DSA-65: 3293 bytes ); return rc; }
Verify
int verify_signature( const uint8_t* message, size_t msg_len, const uint8_t* signature, size_t sig_len, int* valid // 1 = valid, 0 = invalid ) { uint8_t request[65536]; size_t request_len = sizeof(request); int rc = wvds_build_mldsa_verify_request( request, &request_len, 2, // Public Key-ID message, msg_len, signature, sig_len ); if (rc != 0) return rc; memcpy(g_shared_memory, request, request_len); l4_ipc_send(g_crypto_ep, L4_TIMEOUT_NEVER); l4_ipc_receive(g_crypto_ep, L4_TIMEOUT_NEVER); rc = wvds_parse_mldsa_verify_response( g_shared_memory, g_response_len, valid ); return rc; }
ML-KEM Key Exchange
Complete Key Exchange
// Server side: KeyGen + Decaps int server_key_exchange( uint8_t public_key[1184], // ML-KEM-768 Public Key size_t* pk_len ) { uint8_t request[256]; size_t request_len = sizeof(request); // KeyGen Request int rc = wvds_build_mlkem_keygen_request( request, &request_len, 3 // Key-ID for new key pair ); if (rc != 0) return rc; memcpy(g_shared_memory, request, request_len); l4_ipc_send(g_crypto_ep, L4_TIMEOUT_NEVER); l4_ipc_receive(g_crypto_ep, L4_TIMEOUT_NEVER); // Extract public key rc = wvds_parse_mlkem_keygen_response( g_shared_memory, g_response_len, public_key, pk_len // Private Key remains in service ); return rc; } int server_decaps( const uint8_t* ciphertext, size_t ct_len, uint8_t shared_secret[32] ) { uint8_t request[2048]; size_t request_len = sizeof(request); int rc = wvds_build_mlkem_decaps_request( request, &request_len, 3, // Key-ID from KeyGen ciphertext, ct_len ); if (rc != 0) return rc; memcpy(g_shared_memory, request, request_len); l4_ipc_send(g_crypto_ep, L4_TIMEOUT_NEVER); l4_ipc_receive(g_crypto_ep, L4_TIMEOUT_NEVER); rc = wvds_parse_mlkem_decaps_response( g_shared_memory, g_response_len, shared_secret // 32-byte Shared Secret ); return rc; } // Client side: Encaps int client_encaps( const uint8_t* public_key, size_t pk_len, uint8_t* ciphertext, size_t* ct_len, uint8_t shared_secret[32] ) { uint8_t request[2048]; size_t request_len = sizeof(request); int rc = wvds_build_mlkem_encaps_request( request, &request_len, public_key, pk_len ); if (rc != 0) return rc; memcpy(g_shared_memory, request, request_len); l4_ipc_send(g_crypto_ep, L4_TIMEOUT_NEVER); l4_ipc_receive(g_crypto_ep, L4_TIMEOUT_NEVER); rc = wvds_parse_mlkem_encaps_response( g_shared_memory, g_response_len, ciphertext, ct_len, // For server shared_secret // Identical to server after Decaps ); return rc; }
Practical Example: Sending Sensor Data
typedef struct { uint32_t sensor_id; uint32_t timestamp; float temperature; float humidity; } SensorData; int send_sensor_data(const SensorData* data) { // 1. Serialize uint8_t plaintext[sizeof(SensorData)]; memcpy(plaintext, data, sizeof(SensorData)); // 2. AAD: Sensor-ID + Timestamp (authenticated, not encrypted) char aad[64]; snprintf(aad, sizeof(aad), "sensor:%u:ts:%u", data->sensor_id, data->timestamp); // 3. Encrypt uint8_t ciphertext[1024], nonce[12], tag[16]; size_t ct_len; int rc = encrypt_message( plaintext, sizeof(plaintext), aad, strlen(aad), ciphertext, &ct_len, nonce, tag ); if (rc != 0) return rc; // 4. Sign uint8_t to_sign[2048]; size_t to_sign_len = 0; memcpy(to_sign + to_sign_len, nonce, 12); to_sign_len += 12; memcpy(to_sign + to_sign_len, tag, 16); to_sign_len += 16; memcpy(to_sign + to_sign_len, ciphertext, ct_len); to_sign_len += ct_len; uint8_t signature[4096]; size_t sig_len; rc = sign_message(to_sign, to_sign_len, signature, &sig_len); if (rc != 0) return rc; // 5. Build packet and send // ... (network code) ... return 0; }
Zuletzt geändert: on 2026/01/29 at 09:53 PM