/*************************************************************************** * Copyright (c) 2024 Microsoft Corporation * Copyright (c) 2025-present Eclipse ThreadX Contributors * * This program and the accompanying materials are made available under the * terms of the MIT License which is available at * https://opensource.org/licenses/MIT. * * SPDX-License-Identifier: MIT **************************************************************************/ /**************************************************************************/ /**************************************************************************/ /** */ /** NetX Secure Component */ /** */ /** Datagram Transport Layer Security (DTLS) */ /** */ /**************************************************************************/ /**************************************************************************/ #define NX_SECURE_SOURCE_CODE #include "nx_secure_dtls.h" /**************************************************************************/ /* */ /* FUNCTION RELEASE */ /* */ /* _nx_secure_dtls_server_psk_add PORTABLE C */ /* 6.4.3 */ /* AUTHOR */ /* */ /* Timothy Stapko, Microsoft Corporation */ /* */ /* DESCRIPTION */ /* */ /* This function adds a Pre-Shared Key (PSK) to a DTLS server instance.*/ /* The PSK added is shared by all DTLS sessions. */ /* */ /* INPUT */ /* */ /* server_ptr DTLS server control block */ /* pre_shared_key Pointer to PSK data */ /* psk_length Length of PSK data */ /* psk_identity PSK id data */ /* identity_length Length of PSK id data */ /* hint PSK hint data */ /* hint_length Length of PSK hint data */ /* */ /* OUTPUT */ /* */ /* status Completion status */ /* */ /* CALLS */ /* */ /* _nx_secure_dtls_psk_add Add PSK to DTLS session */ /* */ /* CALLED BY */ /* */ /* Application Code */ /* */ /**************************************************************************/ #if defined(NX_SECURE_ENABLE_PSK_CIPHERSUITES) || defined(NX_SECURE_ENABLE_ECJPAKE_CIPHERSUITE) UINT _nx_secure_dtls_server_psk_add(NX_SECURE_DTLS_SERVER *server_ptr, UCHAR *pre_shared_key, UINT psk_length, UCHAR *psk_identity, UINT identity_length, UCHAR *hint, UINT hint_length) { #ifdef NX_SECURE_ENABLE_DTLS UINT status; UINT i; NX_SECURE_DTLS_SESSION *current_session; UINT num_sessions; /* Figure out number of sessions. */ num_sessions = server_ptr->nx_dtls_server_sessions_count; /* Add certificate to all sessions. */ for(i = 0; i < num_sessions; ++i) { /* Get the current session. */ current_session = &(server_ptr->nx_dtls_server_sessions[i]); /* Add the PSK with its ID and hint. */ status = _nx_secure_dtls_psk_add(current_session, pre_shared_key, psk_length, psk_identity, identity_length, hint, hint_length); if(status != NX_SUCCESS) { return(status); } } return(NX_SUCCESS); #else NX_PARAMETER_NOT_USED(server_ptr); NX_PARAMETER_NOT_USED(pre_shared_key); NX_PARAMETER_NOT_USED(psk_length); NX_PARAMETER_NOT_USED(psk_identity); NX_PARAMETER_NOT_USED(identity_length); NX_PARAMETER_NOT_USED(hint); NX_PARAMETER_NOT_USED(hint_length); return(NX_NOT_SUPPORTED); #endif /* NX_SECURE_ENABLE_DTLS */ } #endif