37#if COAP_WITH_LIBMBEDTLS
53#include <mbedtls/version.h>
56#if (MBEDTLS_VERSION_NUMBER < 0x03000000)
57#define MBEDTLS_2_X_COMPAT
60#ifndef MBEDTLS_ALLOW_PRIVATE_ACCESS
61#define MBEDTLS_ALLOW_PRIVATE_ACCESS
65#include <mbedtls/platform.h>
66#include <mbedtls/net_sockets.h>
67#include <mbedtls/ssl.h>
68#include <mbedtls/version.h>
71#if MBEDTLS_VERSION_NUMBER >= 0x04000000
72#define COAP_USE_PSA_CRYPTO 1
74#define COAP_USE_PSA_CRYPTO 0
77#if COAP_USE_PSA_CRYPTO
78#include <psa/crypto.h>
80#include <mbedtls/entropy.h>
81#include <mbedtls/ctr_drbg.h>
82#include <mbedtls/sha256.h>
83#include <mbedtls/md.h>
84#include <mbedtls/cipher.h>
86#include <mbedtls/error.h>
87#include <mbedtls/timing.h>
88#include <mbedtls/ssl_cookie.h>
89#include <mbedtls/oid.h>
90#include <mbedtls/debug.h>
91#if defined(ESPIDF_VERSION) && defined(CONFIG_MBEDTLS_DEBUG)
92#include <mbedtls/esp_debug.h>
94#if !COAP_USE_PSA_CRYPTO && defined(MBEDTLS_PSA_CRYPTO_C)
95#include <psa/crypto.h>
101#if COAP_USE_PSA_CRYPTO
102typedef psa_hash_operation_t coap_crypto_sha256_ctx_t;
103typedef psa_algorithm_t coap_crypto_md_type_t;
105#define COAP_CRYPTO_MD_SHA1 PSA_ALG_SHA_1
106#define COAP_CRYPTO_MD_SHA256 PSA_ALG_SHA_256
107#define COAP_CRYPTO_MD_SHA384 PSA_ALG_SHA_384
108#define COAP_CRYPTO_MD_SHA512 PSA_ALG_SHA_512
109#define COAP_CRYPTO_MD_NONE PSA_ALG_NONE
112typedef mbedtls_sha256_context coap_crypto_sha256_ctx_t;
113typedef mbedtls_md_type_t coap_crypto_md_type_t;
115#define COAP_CRYPTO_MD_SHA1 MBEDTLS_MD_SHA1
116#define COAP_CRYPTO_MD_SHA256 MBEDTLS_MD_SHA256
117#define COAP_CRYPTO_MD_SHA384 MBEDTLS_MD_SHA384
118#define COAP_CRYPTO_MD_SHA512 MBEDTLS_MD_SHA512
119#define COAP_CRYPTO_MD_NONE MBEDTLS_MD_NONE
122#define mbedtls_malloc(a) malloc(a)
123#define mbedtls_realloc(a,b) realloc(a,b)
124#define mbedtls_strdup(a) strdup(a)
125#define mbedtls_strndup(a,b) strndup(a,b)
127#ifndef MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED
129#ifdef MBEDTLS_KEY_EXCHANGE_SOME_PSK_ENABLED
130#define MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED
134#if ! COAP_SERVER_SUPPORT
135#undef MBEDTLS_SSL_SRV_C
137#if ! COAP_CLIENT_SUPPORT
138#undef MBEDTLS_SSL_CLI_C
142#define strcasecmp _stricmp
145#define IS_PSK (1 << 0)
146#define IS_PKI (1 << 1)
147#define IS_CLIENT (1 << 6)
148#define IS_SERVER (1 << 7)
150typedef struct coap_ssl_t {
161typedef struct coap_mbedtls_env_t {
162 mbedtls_ssl_context ssl;
163#if !COAP_USE_PSA_CRYPTO
164 mbedtls_entropy_context entropy;
165 mbedtls_ctr_drbg_context ctr_drbg;
167 mbedtls_ssl_config conf;
168 mbedtls_timing_delay_context timer;
169 mbedtls_x509_crt cacert;
170 mbedtls_x509_crt public_cert;
171 mbedtls_pk_context private_key;
172 mbedtls_ssl_cookie_ctx cookie_ctx;
176 int seen_client_hello;
179 unsigned int retry_scalar;
180 coap_ssl_t coap_ssl_data;
181 uint32_t server_hello_cnt;
184typedef struct pki_sni_entry {
187 mbedtls_x509_crt cacert;
188 mbedtls_x509_crt public_cert;
189 mbedtls_pk_context private_key;
192typedef struct psk_sni_entry {
197typedef struct coap_mbedtls_context_t {
199 size_t pki_sni_count;
200 pki_sni_entry *pki_sni_entry_list;
201 size_t psk_sni_count;
202 psk_sni_entry *psk_sni_entry_list;
206} coap_mbedtls_context_t;
208typedef enum coap_enc_method_t {
220} zephyr_timing_delay_context;
223zephyr_timing_set_delay(
void *data, uint32_t int_ms, uint32_t fin_ms) {
224 zephyr_timing_delay_context *ctx = (zephyr_timing_delay_context *)data;
230 ctx->start_time = k_uptime_get_32();
233 ctx->int_time = ctx->start_time + int_ms;
234 ctx->fin_time = ctx->start_time + fin_ms;
242zephyr_timing_get_delay(
void *data) {
243 zephyr_timing_delay_context *ctx = (zephyr_timing_delay_context *)data;
246 if (ctx == NULL || ctx->fin_time == 0) {
250 now = k_uptime_get_32();
252 if (now >= ctx->fin_time) {
256 if (now >= ctx->int_time) {
270#if COAP_SERVER_SUPPORT
274coap_crypto_sha256_init(coap_crypto_sha256_ctx_t *ctx) {
275#if COAP_USE_PSA_CRYPTO
276 *ctx = psa_hash_operation_init();
277 return (psa_hash_setup(ctx, PSA_ALG_SHA_256) == PSA_SUCCESS) ? 0 : -1;
279 mbedtls_sha256_init(ctx);
280#if (MBEDTLS_VERSION_NUMBER < 0x03000000)
281 return mbedtls_sha256_starts_ret(ctx, 0);
283 return mbedtls_sha256_starts(ctx, 0);
289coap_crypto_sha256_update(coap_crypto_sha256_ctx_t *ctx,
290 const uint8_t *data,
size_t len) {
291#if COAP_USE_PSA_CRYPTO
292 return (psa_hash_update(ctx, data, len) == PSA_SUCCESS) ? 0 : -1;
294#if (MBEDTLS_VERSION_NUMBER < 0x03000000)
295 return mbedtls_sha256_update_ret(ctx, data, len);
297 return mbedtls_sha256_update(ctx, data, len);
303coap_crypto_sha256_finish(coap_crypto_sha256_ctx_t *ctx, uint8_t *output) {
304#if COAP_USE_PSA_CRYPTO
306 return (psa_hash_finish(ctx, output, 32, &hash_len) == PSA_SUCCESS) ? 0 : -1;
308#if (MBEDTLS_VERSION_NUMBER < 0x03000000)
309 return mbedtls_sha256_finish_ret(ctx, output);
311 return mbedtls_sha256_finish(ctx, output);
317coap_crypto_sha256_free(coap_crypto_sha256_ctx_t *ctx) {
318#if COAP_USE_PSA_CRYPTO
321 mbedtls_sha256_free(ctx);
329coap_crypto_hash_size(coap_crypto_md_type_t md_type) {
330#if COAP_USE_PSA_CRYPTO
331 switch ((
int)md_type) {
334 case PSA_ALG_SHA_256:
336 case PSA_ALG_SHA_384:
338 case PSA_ALG_SHA_512:
344 const mbedtls_md_info_t *md_info = mbedtls_md_info_from_type(md_type);
345 return md_info ? mbedtls_md_get_size(md_info) : 0;
350coap_crypto_hash_compute(coap_crypto_md_type_t md_type,
351 const uint8_t *input,
size_t ilen,
352 uint8_t *output,
size_t output_size,
353 size_t *output_len) {
354#if COAP_USE_PSA_CRYPTO
356 psa_status_t status = psa_hash_compute(md_type, input, ilen,
357 output, output_size, &actual_len);
359 *output_len = actual_len;
360 return (status == PSA_SUCCESS) ? 0 : -1;
362 const mbedtls_md_info_t *md_info = mbedtls_md_info_from_type(md_type);
365 size_t hash_len = mbedtls_md_get_size(md_info);
366 if (hash_len > output_size)
369 *output_len = hash_len;
370 return mbedtls_md(md_info, input, ilen, output);
377#if COAP_OSCORE_SUPPORT
379coap_crypto_hmac_compute(coap_crypto_md_type_t md_type,
380 const uint8_t *key,
size_t key_len,
381 const uint8_t *input,
size_t ilen,
382 uint8_t *output,
size_t output_size,
383 size_t *output_len) {
384#if COAP_USE_PSA_CRYPTO
385 psa_key_attributes_t attributes = PSA_KEY_ATTRIBUTES_INIT;
387 psa_algorithm_t psa_alg = PSA_ALG_HMAC(md_type);
391 psa_set_key_type(&attributes, PSA_KEY_TYPE_HMAC);
392 psa_set_key_usage_flags(&attributes, PSA_KEY_USAGE_SIGN_MESSAGE);
393 psa_set_key_algorithm(&attributes, psa_alg);
395 if (psa_import_key(&attributes, key, key_len, &key_id) != PSA_SUCCESS) {
399 status = psa_mac_compute(key_id, psa_alg, input, ilen,
400 output, output_size, &mac_len);
401 psa_destroy_key(key_id);
404 *output_len = mac_len;
405 return (status == PSA_SUCCESS) ? 0 : -1;
407 const mbedtls_md_info_t *md_info = mbedtls_md_info_from_type(md_type);
410 size_t mac_size = mbedtls_md_get_size(md_info);
411 if (mac_size > output_size)
414 *output_len = mac_size;
415 return mbedtls_md_hmac(md_info, key, key_len, input, ilen, output);
422coap_crypto_aead_encrypt_ccm(
const uint8_t *key,
size_t key_len,
423 const uint8_t *nonce,
size_t nonce_len,
424 const uint8_t *aad,
size_t aad_len,
425 const uint8_t *plaintext,
size_t plaintext_len,
426 uint8_t *ciphertext,
size_t ciphertext_size,
427 size_t *ciphertext_len,
size_t tag_len) {
428#if COAP_USE_PSA_CRYPTO
429 psa_key_attributes_t attributes = PSA_KEY_ATTRIBUTES_INIT;
431 psa_algorithm_t psa_alg = PSA_ALG_AEAD_WITH_SHORTENED_TAG(PSA_ALG_CCM, tag_len);
435 psa_set_key_type(&attributes, PSA_KEY_TYPE_AES);
436 psa_set_key_usage_flags(&attributes, PSA_KEY_USAGE_ENCRYPT);
437 psa_set_key_algorithm(&attributes, psa_alg);
438 psa_set_key_bits(&attributes, key_len * 8);
440 if (psa_import_key(&attributes, key, key_len, &key_id) != PSA_SUCCESS) {
444 status = psa_aead_encrypt(key_id, psa_alg,
447 plaintext, plaintext_len,
448 ciphertext, ciphertext_size, &output_len);
449 psa_destroy_key(key_id);
452 *ciphertext_len = output_len;
453 return (status == PSA_SUCCESS) ? 0 : -1;
455 mbedtls_cipher_context_t ctx;
456 const mbedtls_cipher_info_t *cipher_info;
457 mbedtls_cipher_type_t cipher_type;
459 size_t result_len = ciphertext_size;
462 cipher_type = MBEDTLS_CIPHER_AES_128_CCM;
463 }
else if (key_len == 32) {
464 cipher_type = MBEDTLS_CIPHER_AES_256_CCM;
469 cipher_info = mbedtls_cipher_info_from_type(cipher_type);
473 mbedtls_cipher_init(&ctx);
474 if (mbedtls_cipher_setup(&ctx, cipher_info) != 0)
476 if (mbedtls_cipher_setkey(&ctx, key, key_len * 8, MBEDTLS_ENCRYPT) != 0)
479#if (MBEDTLS_VERSION_NUMBER < 0x02150000)
481 unsigned char tag[16];
482 if (mbedtls_cipher_auth_encrypt(&ctx,
485 plaintext, plaintext_len,
486 ciphertext, &result_len,
487 tag, tag_len) != 0) {
490 if ((result_len + tag_len) > ciphertext_size)
492 memcpy(ciphertext + result_len, tag, tag_len);
493 result_len += tag_len;
496 if (mbedtls_cipher_auth_encrypt_ext(&ctx,
499 plaintext, plaintext_len,
500 ciphertext, ciphertext_size,
501 &result_len, tag_len) != 0) {
507 *ciphertext_len = result_len;
511 mbedtls_cipher_free(&ctx);
517coap_crypto_aead_decrypt_ccm(
const uint8_t *key,
size_t key_len,
518 const uint8_t *nonce,
size_t nonce_len,
519 const uint8_t *aad,
size_t aad_len,
520 const uint8_t *ciphertext,
size_t ciphertext_len,
521 uint8_t *plaintext,
size_t plaintext_size,
522 size_t *plaintext_len,
size_t tag_len) {
523#if COAP_USE_PSA_CRYPTO
524 psa_key_attributes_t attributes = PSA_KEY_ATTRIBUTES_INIT;
526 psa_algorithm_t psa_alg = PSA_ALG_AEAD_WITH_SHORTENED_TAG(PSA_ALG_CCM, tag_len);
530 psa_set_key_type(&attributes, PSA_KEY_TYPE_AES);
531 psa_set_key_usage_flags(&attributes, PSA_KEY_USAGE_DECRYPT);
532 psa_set_key_algorithm(&attributes, psa_alg);
533 psa_set_key_bits(&attributes, key_len * 8);
535 if (psa_import_key(&attributes, key, key_len, &key_id) != PSA_SUCCESS) {
539 status = psa_aead_decrypt(key_id, psa_alg,
542 ciphertext, ciphertext_len,
543 plaintext, plaintext_size, &output_len);
544 psa_destroy_key(key_id);
547 *plaintext_len = output_len;
548 return (status == PSA_SUCCESS) ? 0 : -1;
550 mbedtls_cipher_context_t ctx;
551 const mbedtls_cipher_info_t *cipher_info;
552 mbedtls_cipher_type_t cipher_type;
554 size_t result_len = plaintext_size;
557 cipher_type = MBEDTLS_CIPHER_AES_128_CCM;
558 }
else if (key_len == 32) {
559 cipher_type = MBEDTLS_CIPHER_AES_256_CCM;
564 cipher_info = mbedtls_cipher_info_from_type(cipher_type);
568 mbedtls_cipher_init(&ctx);
569 if (mbedtls_cipher_setup(&ctx, cipher_info) != 0)
571 if (mbedtls_cipher_setkey(&ctx, key, key_len * 8, MBEDTLS_DECRYPT) != 0)
574#if (MBEDTLS_VERSION_NUMBER < 0x02150000)
576 const unsigned char *tag = ciphertext + ciphertext_len - tag_len;
577 if (mbedtls_cipher_auth_decrypt(&ctx,
580 ciphertext, ciphertext_len - tag_len,
581 plaintext, &result_len,
582 tag, tag_len) != 0) {
587 if (mbedtls_cipher_auth_decrypt_ext(&ctx,
590 ciphertext, ciphertext_len,
591 plaintext, plaintext_size,
592 &result_len, tag_len) != 0) {
598 *plaintext_len = result_len;
602 mbedtls_cipher_free(&ctx);
610#if !COAP_USE_PSA_CRYPTO
611#ifndef MBEDTLS_2_X_COMPAT
616coap_rng(
void *ctx
COAP_UNUSED,
unsigned char *buf,
size_t len) {
617 return coap_prng_lkd(buf, len) ? 0 : MBEDTLS_ERR_CTR_DRBG_ENTROPY_SOURCE_FAILED;
623coap_dgram_read(
void *ctx,
unsigned char *out,
size_t outl) {
628 if (!c_session->
tls) {
630 return MBEDTLS_ERR_SSL_WANT_READ;
632 data = &((coap_mbedtls_env_t *)c_session->
tls)->coap_ssl_data;
635 if (data->pdu_len > 0) {
636 if (outl < data->pdu_len) {
637 memcpy(out, data->pdu, outl);
640 data->pdu_len -= outl;
642 memcpy(out, data->pdu, data->pdu_len);
644 if (!data->peekmode) {
650 ret = MBEDTLS_ERR_SSL_WANT_READ;
664coap_dgram_write(
void *ctx,
const unsigned char *send_buffer,
665 size_t send_buffer_length) {
670 coap_mbedtls_env_t *m_env = (coap_mbedtls_env_t *)c_session->
tls;
682 send_buffer, send_buffer_length);
683 if (result != (ssize_t)send_buffer_length) {
684 int keep_errno = errno;
687 result, send_buffer_length);
690 if (errno == ENOTCONN || errno == ECONNREFUSED)
699 m_env->last_timeout = now;
707#if defined(MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED) && defined(MBEDTLS_SSL_SRV_C)
712psk_server_callback(
void *p_info, mbedtls_ssl_context *ssl,
713 const unsigned char *identity,
size_t identity_len) {
716 coap_mbedtls_env_t *m_env;
720 if (c_session == NULL)
724 lidentity.
s = identity ? (
const uint8_t *)identity : (const uint8_t *)
"";
725 lidentity.
length = identity ? identity_len : 0;
729 (
int)lidentity.
length, (
const char *)lidentity.
s);
731 m_env = (coap_mbedtls_env_t *)c_session->
tls;
746 mbedtls_ssl_set_hs_psk(ssl, psk_key->
s, psk_key->
length);
747 m_env->seen_client_hello = 1;
753get_san_or_cn_from_cert(mbedtls_x509_crt *crt) {
755 const mbedtls_asn1_named_data *cn_data;
757 if (crt->ext_types & MBEDTLS_X509_EXT_SUBJECT_ALT_NAME) {
758 mbedtls_asn1_sequence *seq = &crt->subject_alt_names;
759 while (seq && seq->buf.p == NULL) {
764 return mbedtls_strndup((
const char *)seq->buf.p,
769 cn_data = mbedtls_asn1_find_named_data(&crt->subject,
771 MBEDTLS_OID_SIZE(MBEDTLS_OID_AT_CN));
774 return mbedtls_strndup((
const char *)cn_data->val.p,
781#if COAP_MAX_LOGGING_LEVEL > 0
783get_error_string(
int ret) {
784 static char buf[128] = {0};
785 mbedtls_strerror(ret, buf,
sizeof(buf)-1);
791self_signed_cert_verify_callback_mbedtls(
void *data,
796 const coap_mbedtls_context_t *m_context =
800 if (*flags & MBEDTLS_X509_BADCERT_EXPIRED) {
802 *flags &= ~MBEDTLS_X509_BADCERT_EXPIRED;
813cert_verify_callback_mbedtls(
void *data, mbedtls_x509_crt *crt,
814 int depth, uint32_t *flags) {
816 coap_mbedtls_context_t *m_context =
824 cn = get_san_or_cn_from_cert(crt);
826 if (*flags & MBEDTLS_X509_BADCERT_EXPIRED) {
828 *flags &= ~MBEDTLS_X509_BADCERT_EXPIRED;
831 "The certificate has expired", cn ? cn :
"?", depth);
834 if (*flags & MBEDTLS_X509_BADCERT_FUTURE) {
836 *flags &= ~MBEDTLS_X509_BADCERT_FUTURE;
839 "The certificate has a future date", cn ? cn :
"?", depth);
842 if (*flags & MBEDTLS_X509_BADCERT_BAD_MD) {
844 *flags &= ~MBEDTLS_X509_BADCERT_BAD_MD;
847 "The certificate has a bad MD hash", cn ? cn :
"?", depth);
850 if (*flags & MBEDTLS_X509_BADCERT_BAD_KEY) {
852 *flags &= ~MBEDTLS_X509_BADCERT_BAD_KEY;
855 "The certificate has a short RSA length", cn ? cn :
"?", depth);
858 if (*flags & MBEDTLS_X509_BADCERT_NOT_TRUSTED) {
860 int self_signed = !mbedtls_x509_crt_verify(crt, crt, NULL, NULL, &lflags,
861 self_signed_cert_verify_callback_mbedtls,
863 if (self_signed && depth == 0) {
866 *flags &= ~MBEDTLS_X509_BADCERT_NOT_TRUSTED;
870 cn ? cn :
"?", depth);
872 }
else if (self_signed) {
874 *flags &= ~MBEDTLS_X509_BADCERT_NOT_TRUSTED;
877 "Self-signed", cn ? cn :
"?", depth);
881 *flags &= ~MBEDTLS_X509_BADCERT_NOT_TRUSTED;
884 "The certificate's CA is not trusted", cn ? cn :
"?", depth);
888 if (*flags & MBEDTLS_X509_BADCRL_EXPIRED) {
890 *flags &= ~MBEDTLS_X509_BADCRL_EXPIRED;
893 "The certificate's CRL has expired", cn ? cn :
"?", depth);
895 *flags &= ~MBEDTLS_X509_BADCRL_EXPIRED;
898 if (*flags & MBEDTLS_X509_BADCRL_FUTURE) {
900 *flags &= ~MBEDTLS_X509_BADCRL_FUTURE;
903 "The certificate's CRL has a future date", cn ? cn :
"?", depth);
905 *flags &= ~MBEDTLS_X509_BADCRL_FUTURE;
910 *flags |= MBEDTLS_X509_BADCERT_OTHER;
913 "The certificate's verify depth is too long",
914 cn ? cn :
"?", depth);
917 if (*flags & MBEDTLS_X509_BADCERT_CN_MISMATCH) {
918 *flags &= ~MBEDTLS_X509_BADCERT_CN_MISMATCH;
932 *flags |= MBEDTLS_X509_BADCERT_CN_MISMATCH;
938 int ret = mbedtls_x509_crt_verify_info(buf,
sizeof(buf),
"", *flags);
941 tcp = strchr(buf,
'\n');
946 buf, *flags, cn ? cn :
"?", depth);
947 tcp = strchr(tcp+1,
'\n');
950 coap_log_err(
"mbedtls_x509_crt_verify_info returned -0x%x: '%s'\n",
951 -ret, get_error_string(ret));
962setup_pki_credentials(mbedtls_x509_crt *cacert,
963 mbedtls_x509_crt *public_cert,
964 mbedtls_pk_context *private_key,
965 coap_mbedtls_env_t *m_env,
966 coap_mbedtls_context_t *m_context,
972 int done_private_key = 0;
973 int done_public_cert = 0;
991#if defined(MBEDTLS_FS_IO)
992 mbedtls_pk_init(private_key);
993#if COAP_USE_PSA_CRYPTO
994 ret = mbedtls_pk_parse_keyfile(private_key,
996#elif defined(MBEDTLS_2_X_COMPAT)
997 ret = mbedtls_pk_parse_keyfile(private_key,
1000 ret = mbedtls_pk_parse_keyfile(private_key,
1002 NULL, coap_rng, (
void *)&m_env->ctr_drbg);
1009 done_private_key = 1;
1017 mbedtls_pk_init(private_key);
1021 buffer = mbedtls_malloc(length + 1);
1027 buffer[length] =
'\000';
1029#if COAP_USE_PSA_CRYPTO
1030 ret = mbedtls_pk_parse_key(private_key, buffer, length, NULL, 0);
1031#elif defined(MBEDTLS_2_X_COMPAT)
1032 ret = mbedtls_pk_parse_key(private_key, buffer, length, NULL, 0);
1034 ret = mbedtls_pk_parse_key(private_key, buffer, length,
1035 NULL, 0, coap_rng, (
void *)&m_env->ctr_drbg);
1037 mbedtls_free(buffer);
1039#if COAP_USE_PSA_CRYPTO
1040 ret = mbedtls_pk_parse_key(private_key,
1043#elif defined(MBEDTLS_2_X_COMPAT)
1044 ret = mbedtls_pk_parse_key(private_key,
1048 ret = mbedtls_pk_parse_key(private_key,
1051 NULL, 0, coap_rng, (
void *)&m_env->ctr_drbg);
1059 done_private_key = 1;
1062 mbedtls_pk_init(private_key);
1063#if COAP_USE_PSA_CRYPTO
1064 ret = mbedtls_pk_parse_key(private_key,
1067#elif defined(MBEDTLS_2_X_COMPAT)
1068 ret = mbedtls_pk_parse_key(private_key,
1072 ret = mbedtls_pk_parse_key(private_key,
1075 (
void *)&m_env->ctr_drbg);
1082 done_private_key = 1;
1110#if defined(MBEDTLS_FS_IO)
1111 mbedtls_x509_crt_init(public_cert);
1112 ret = mbedtls_x509_crt_parse_file(public_cert,
1119 done_public_cert = 1;
1127 mbedtls_x509_crt_init(public_cert);
1132 buffer = mbedtls_malloc(length + 1);
1138 buffer[length] =
'\000';
1140 ret = mbedtls_x509_crt_parse(public_cert, buffer, length);
1141 mbedtls_free(buffer);
1143 ret = mbedtls_x509_crt_parse(public_cert,
1152 done_public_cert = 1;
1159 mbedtls_x509_crt_init(public_cert);
1160 ret = mbedtls_x509_crt_parse(public_cert,
1168 done_public_cert = 1;
1186 if (done_private_key && done_public_cert) {
1187 ret = mbedtls_ssl_conf_own_cert(&m_env->conf, public_cert, private_key);
1189 coap_log_err(
"mbedtls_ssl_conf_own_cert returned -0x%x: '%s'\n",
1190 -ret, get_error_string(ret));
1199#
if MBEDTLS_VERSION_NUMBER < 0x03060000
1208#if defined(MBEDTLS_FS_IO)
1209 mbedtls_x509_crt_init(cacert);
1210 ret = mbedtls_x509_crt_parse_file(cacert,
1217 mbedtls_ssl_conf_ca_chain(&m_env->conf, cacert, NULL);
1225 mbedtls_x509_crt_init(cacert);
1229 buffer = mbedtls_malloc(length + 1);
1235 buffer[length] =
'\000';
1237 ret = mbedtls_x509_crt_parse(cacert, buffer, length);
1238 mbedtls_free(buffer);
1240 ret = mbedtls_x509_crt_parse(cacert,
1249 mbedtls_ssl_conf_ca_chain(&m_env->conf, cacert, NULL);
1256 mbedtls_x509_crt_init(cacert);
1257 ret = mbedtls_x509_crt_parse(cacert,
1265 mbedtls_ssl_conf_ca_chain(&m_env->conf, cacert, NULL);
1279#if defined(MBEDTLS_FS_IO)
1280 if (m_context->root_ca_file) {
1281 ret = mbedtls_x509_crt_parse_file(cacert, m_context->root_ca_file);
1288 mbedtls_ssl_conf_ca_chain(&m_env->conf, cacert, NULL);
1290 if (m_context->root_ca_path) {
1291 ret = mbedtls_x509_crt_parse_path(cacert, m_context->root_ca_path);
1298 mbedtls_ssl_conf_ca_chain(&m_env->conf, cacert, NULL);
1307#if defined(MBEDTLS_SSL_SRV_C)
1308 mbedtls_ssl_conf_cert_req_ca_list(&m_env->conf,
1310 MBEDTLS_SSL_CERT_REQ_CA_LIST_ENABLED :
1311 MBEDTLS_SSL_CERT_REQ_CA_LIST_DISABLED);
1314 MBEDTLS_SSL_VERIFY_REQUIRED :
1315 MBEDTLS_SSL_VERIFY_NONE);
1320 mbedtls_ssl_conf_verify(&m_env->conf,
1321 cert_verify_callback_mbedtls, c_session);
1326#if defined(MBEDTLS_SSL_SRV_C)
1331pki_sni_callback(
void *p_info, mbedtls_ssl_context *ssl,
1332 const unsigned char *uname,
size_t name_len) {
1336 coap_mbedtls_env_t *m_env = (coap_mbedtls_env_t *)c_session->
tls;
1337 coap_mbedtls_context_t *m_context =
1341 name = mbedtls_malloc(name_len+1);
1345 memcpy(name, uname, name_len);
1346 name[name_len] =
'\000';
1349 for (i = 0; i < m_context->pki_sni_count; i++) {
1350 if (strcasecmp(name, m_context->pki_sni_entry_list[i].sni) == 0) {
1354 if (i == m_context->pki_sni_count) {
1359 pki_sni_entry *pki_sni_entry_list;
1362 m_context->setup_data.validate_sni_call_back(name,
1363 m_context->setup_data.sni_call_back_arg));
1369 pki_sni_entry_list = mbedtls_realloc(m_context->pki_sni_entry_list,
1370 (i+1)*
sizeof(pki_sni_entry));
1372 if (pki_sni_entry_list == NULL) {
1376 m_context->pki_sni_entry_list = pki_sni_entry_list;
1377 memset(&m_context->pki_sni_entry_list[i], 0,
1378 sizeof(m_context->pki_sni_entry_list[i]));
1379 m_context->pki_sni_entry_list[i].sni = name;
1380 m_context->pki_sni_entry_list[i].pki_key = *new_entry;
1381 sni_setup_data = m_context->setup_data;
1382 sni_setup_data.pki_key = *new_entry;
1383 if (setup_pki_credentials(&m_context->pki_sni_entry_list[i].cacert,
1384 &m_context->pki_sni_entry_list[i].public_cert,
1385 &m_context->pki_sni_entry_list[i].private_key,
1394 m_context->pki_sni_count++;
1399 mbedtls_ssl_set_hs_ca_chain(ssl, &m_context->pki_sni_entry_list[i].cacert,
1401 return mbedtls_ssl_set_hs_own_cert(ssl,
1402 &m_context->pki_sni_entry_list[i].public_cert,
1403 &m_context->pki_sni_entry_list[i].private_key);
1406#if defined(MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED)
1411psk_sni_callback(
void *p_info, mbedtls_ssl_context *ssl,
1412 const unsigned char *uname,
size_t name_len) {
1415 coap_mbedtls_context_t *m_context =
1419 name = mbedtls_malloc(name_len+1);
1423 memcpy(name, uname, name_len);
1424 name[name_len] =
'\000';
1427 for (i = 0; i < m_context->psk_sni_count; i++) {
1428 if (strcasecmp(name, m_context->psk_sni_entry_list[i].sni) == 0) {
1432 if (i == m_context->psk_sni_count) {
1437 psk_sni_entry *psk_sni_entry_list;
1448 psk_sni_entry_list = mbedtls_realloc(m_context->psk_sni_entry_list,
1449 (i+1)*
sizeof(psk_sni_entry));
1451 if (psk_sni_entry_list == NULL) {
1455 m_context->psk_sni_entry_list = psk_sni_entry_list;
1456 m_context->psk_sni_entry_list[i].sni = name;
1457 m_context->psk_sni_entry_list[i].psk_info = *new_entry;
1459 m_context->psk_sni_count++;
1465 &m_context->psk_sni_entry_list[i].psk_info.hint);
1467 &m_context->psk_sni_entry_list[i].psk_info.key);
1468#if MBEDTLS_VERSION_NUMBER >= 0x04000000
1472 return mbedtls_ssl_set_hs_psk(ssl,
1473 m_context->psk_sni_entry_list[i].psk_info.key.s,
1474 m_context->psk_sni_entry_list[i].psk_info.key.length);
1481 coap_mbedtls_env_t *m_env) {
1482 coap_mbedtls_context_t *m_context =
1485 m_context->psk_pki_enabled |= IS_SERVER;
1487 mbedtls_ssl_cookie_init(&m_env->cookie_ctx);
1488 if ((ret = mbedtls_ssl_config_defaults(&m_env->conf,
1489 MBEDTLS_SSL_IS_SERVER,
1491 MBEDTLS_SSL_TRANSPORT_DATAGRAM :
1492 MBEDTLS_SSL_TRANSPORT_STREAM,
1493 MBEDTLS_SSL_PRESET_DEFAULT)) != 0) {
1494 coap_log_err(
"mbedtls_ssl_config_defaults returned -0x%x: '%s'\n",
1495 -ret, get_error_string(ret));
1499#if !COAP_USE_PSA_CRYPTO
1500 mbedtls_ssl_conf_rng(&m_env->conf, mbedtls_ctr_drbg_random, &m_env->ctr_drbg);
1503#if defined(MBEDTLS_SSL_PROTO_DTLS)
1504 mbedtls_ssl_conf_handshake_timeout(&m_env->conf, COAP_DTLS_RETRANSMIT_MS,
1505 COAP_DTLS_RETRANSMIT_TOTAL_MS);
1508 if (m_context->psk_pki_enabled & IS_PSK) {
1509#if defined(MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED)
1510 mbedtls_ssl_conf_psk_cb(&m_env->conf, psk_server_callback, c_session);
1512 mbedtls_ssl_conf_sni(&m_env->conf, psk_sni_callback, c_session);
1514#ifdef MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED
1522 if (m_context->psk_pki_enabled & IS_PKI) {
1523 ret = setup_pki_credentials(&m_env->cacert, &m_env->public_cert,
1524 &m_env->private_key, m_env, m_context,
1525 c_session, &m_context->setup_data,
1531 if (m_context->setup_data.validate_sni_call_back) {
1532 mbedtls_ssl_conf_sni(&m_env->conf, pki_sni_callback, c_session);
1536#if COAP_USE_PSA_CRYPTO
1537 if ((ret = mbedtls_ssl_cookie_setup(&m_env->cookie_ctx)) != 0) {
1539 if ((ret = mbedtls_ssl_cookie_setup(&m_env->cookie_ctx,
1540 mbedtls_ctr_drbg_random,
1541 &m_env->ctr_drbg)) != 0) {
1543 coap_log_err(
"mbedtls_ssl_cookie_setup: returned -0x%x: '%s'\n",
1544 -ret, get_error_string(ret));
1548#if defined(MBEDTLS_SSL_PROTO_DTLS)
1549 mbedtls_ssl_conf_dtls_cookies(&m_env->conf, mbedtls_ssl_cookie_write,
1550 mbedtls_ssl_cookie_check,
1551 &m_env->cookie_ctx);
1552#if MBEDTLS_VERSION_NUMBER >= 0x02100100
1553 mbedtls_ssl_set_mtu(&m_env->ssl, (uint16_t)c_session->
mtu);
1556#ifdef MBEDTLS_SSL_DTLS_CONNECTION_ID
1564 mbedtls_ssl_conf_cid(&m_env->conf, COAP_DTLS_CID_LENGTH, MBEDTLS_SSL_UNEXPECTED_CID_IGNORE);
1571#if COAP_CLIENT_SUPPORT
1572static int *psk_ciphers = NULL;
1573static int *pki_ciphers = NULL;
1574static int *ecjpake_ciphers = NULL;
1575static int processed_ciphers = 0;
1577#if defined(MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED)
1579coap_ssl_ciphersuite_uses_psk(
const mbedtls_ssl_ciphersuite_t *info) {
1580#if COAP_USE_PSA_CRYPTO
1581 switch (info->key_exchange) {
1582 case MBEDTLS_KEY_EXCHANGE_PSK:
1583 case MBEDTLS_KEY_EXCHANGE_ECDHE_PSK:
1585 case MBEDTLS_KEY_EXCHANGE_NONE:
1586 case MBEDTLS_KEY_EXCHANGE_ECDHE_RSA:
1587 case MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA:
1588 case MBEDTLS_KEY_EXCHANGE_ECJPAKE:
1592#elif MBEDTLS_VERSION_NUMBER >= 0x03060000
1593 switch (info->key_exchange) {
1594 case MBEDTLS_KEY_EXCHANGE_PSK:
1595 case MBEDTLS_KEY_EXCHANGE_RSA_PSK:
1596 case MBEDTLS_KEY_EXCHANGE_DHE_PSK:
1597 case MBEDTLS_KEY_EXCHANGE_ECDHE_PSK:
1599 case MBEDTLS_KEY_EXCHANGE_NONE:
1600 case MBEDTLS_KEY_EXCHANGE_RSA:
1601 case MBEDTLS_KEY_EXCHANGE_DHE_RSA:
1602 case MBEDTLS_KEY_EXCHANGE_ECDHE_RSA:
1603 case MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA:
1604 case MBEDTLS_KEY_EXCHANGE_ECDH_RSA:
1605 case MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA:
1606 case MBEDTLS_KEY_EXCHANGE_ECJPAKE:
1611 return mbedtls_ssl_ciphersuite_uses_psk(info);
1617set_ciphersuites(mbedtls_ssl_config *conf, coap_enc_method_t method) {
1618 if (!processed_ciphers) {
1619 const int *list = mbedtls_ssl_list_ciphersuites();
1620 const int *base = list;
1623#if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
1625 int ecjpake_count = 1;
1631 const mbedtls_ssl_ciphersuite_t *cur =
1632 mbedtls_ssl_ciphersuite_from_id(*list);
1635#if MBEDTLS_VERSION_NUMBER >= 0x03020000
1636 if (cur->max_tls_version < MBEDTLS_SSL_VERSION_TLS1_2) {
1640 if (cur->max_minor_ver < MBEDTLS_SSL_MINOR_VERSION_3) {
1644#if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
1645 else if (cur->key_exchange == MBEDTLS_KEY_EXCHANGE_ECJPAKE) {
1649#if MBEDTLS_VERSION_NUMBER >= 0x03060000
1650 else if (cur->min_tls_version >= MBEDTLS_SSL_VERSION_TLS1_3) {
1655#if defined(MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED)
1656 else if (coap_ssl_ciphersuite_uses_psk(cur)) {
1668 psk_ciphers = mbedtls_malloc(psk_count *
sizeof(psk_ciphers[0]));
1669 if (psk_ciphers == NULL) {
1670 coap_log_err(
"set_ciphers: mbedtls_malloc with count %d failed\n", psk_count);
1673 pki_ciphers = mbedtls_malloc(pki_count *
sizeof(pki_ciphers[0]));
1674 if (pki_ciphers == NULL) {
1675 coap_log_err(
"set_ciphers: mbedtls_malloc with count %d failed\n", pki_count);
1676 mbedtls_free(psk_ciphers);
1680#if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
1681 ecjpake_ciphers = mbedtls_malloc(ecjpake_count *
sizeof(ecjpake_ciphers[0]));
1682 if (ecjpake_ciphers == NULL) {
1683 coap_log_err(
"set_ciphers: mbedtls_malloc with count %d failed\n", pki_count);
1684 mbedtls_free(psk_ciphers);
1685 mbedtls_free(pki_ciphers);
1692 psk_list = psk_ciphers;
1693 pki_list = pki_ciphers;
1694#if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
1695 ecjpake_list = ecjpake_ciphers;
1699 const mbedtls_ssl_ciphersuite_t *cur =
1700 mbedtls_ssl_ciphersuite_from_id(*list);
1702#if MBEDTLS_VERSION_NUMBER >= 0x03020000
1703 if (cur->max_tls_version < MBEDTLS_SSL_VERSION_TLS1_2) {
1707 if (cur->max_minor_ver < MBEDTLS_SSL_MINOR_VERSION_3) {
1711#if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
1712 else if (cur->key_exchange == MBEDTLS_KEY_EXCHANGE_ECJPAKE) {
1713 *ecjpake_list = *list;
1717#if MBEDTLS_VERSION_NUMBER >= 0x03060000
1718 else if (cur->min_tls_version >= MBEDTLS_SSL_VERSION_TLS1_3) {
1725#if defined(MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED)
1726 else if (coap_ssl_ciphersuite_uses_psk(cur)) {
1741 processed_ciphers = 1;
1745 mbedtls_ssl_conf_ciphersuites(conf, psk_ciphers);
1748 mbedtls_ssl_conf_ciphersuites(conf, pki_ciphers);
1750 case COAP_ENC_ECJPAKE:
1751 mbedtls_ssl_conf_ciphersuites(conf, ecjpake_ciphers);
1761 coap_mbedtls_env_t *m_env) {
1764 coap_mbedtls_context_t *m_context =
1767 m_context->psk_pki_enabled |= IS_CLIENT;
1769 if ((ret = mbedtls_ssl_config_defaults(&m_env->conf,
1770 MBEDTLS_SSL_IS_CLIENT,
1772 MBEDTLS_SSL_TRANSPORT_DATAGRAM :
1773 MBEDTLS_SSL_TRANSPORT_STREAM,
1774 MBEDTLS_SSL_PRESET_DEFAULT)) != 0) {
1775 coap_log_err(
"mbedtls_ssl_config_defaults returned -0x%x: '%s'\n",
1776 -ret, get_error_string(ret));
1780#if defined(MBEDTLS_SSL_PROTO_DTLS)
1781 mbedtls_ssl_conf_handshake_timeout(&m_env->conf, COAP_DTLS_RETRANSMIT_MS,
1782 COAP_DTLS_RETRANSMIT_TOTAL_MS);
1785 mbedtls_ssl_conf_authmode(&m_env->conf, MBEDTLS_SSL_VERIFY_REQUIRED);
1786#if !COAP_USE_PSA_CRYPTO
1787 mbedtls_ssl_conf_rng(&m_env->conf, mbedtls_ctr_drbg_random, &m_env->ctr_drbg);
1790 if (m_context->psk_pki_enabled & IS_PSK) {
1791#if defined(MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED)
1799 if (psk_key == NULL || psk_identity == NULL) {
1800 ret = MBEDTLS_ERR_SSL_ALLOC_FAILED;
1804 if ((ret = mbedtls_ssl_conf_psk(&m_env->conf, psk_key->
s,
1805 psk_key->
length, psk_identity->
s,
1806 psk_identity->
length)) != 0) {
1807 coap_log_err(
"mbedtls_ssl_conf_psk returned -0x%x: '%s'\n",
1808 -ret, get_error_string(ret));
1812 if ((ret = mbedtls_ssl_set_hostname(&m_env->ssl,
1814 coap_log_err(
"mbedtls_ssl_set_hostname returned -0x%x: '%s'\n",
1815 -ret, get_error_string(ret));
1821#ifdef MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED
1823 m_env->ec_jpake = 1;
1824 set_ciphersuites(&m_env->conf, COAP_ENC_ECJPAKE);
1825#if MBEDTLS_VERSION_NUMBER >= 0x03020000
1826 mbedtls_ssl_conf_max_tls_version(&m_env->conf, MBEDTLS_SSL_VERSION_TLS1_2);
1829 set_ciphersuites(&m_env->conf, COAP_ENC_PSK);
1832 set_ciphersuites(&m_env->conf, COAP_ENC_PSK);
1837 }
else if ((m_context->psk_pki_enabled & IS_PKI) ||
1838 (m_context->psk_pki_enabled & (IS_PSK | IS_PKI)) == 0) {
1843 mbedtls_ssl_conf_authmode(&m_env->conf, MBEDTLS_SSL_VERIFY_OPTIONAL);
1844 ret = setup_pki_credentials(&m_env->cacert, &m_env->public_cert,
1845 &m_env->private_key, m_env, m_context,
1846 c_session, &m_context->setup_data,
1852#if defined(MBEDTLS_SSL_SRV_C) && defined(MBEDTLS_SSL_ALPN)
1855 static const char *alpn_list[] = {
"coap", NULL };
1857 ret = mbedtls_ssl_conf_alpn_protocols(&m_env->conf, alpn_list);
1863 mbedtls_ssl_set_hostname(&m_env->ssl, m_context->setup_data.client_sni);
1864#if defined(MBEDTLS_SSL_PROTO_DTLS)
1865#if MBEDTLS_VERSION_NUMBER >= 0x02100100
1866 mbedtls_ssl_set_mtu(&m_env->ssl, (uint16_t)c_session->
mtu);
1869 set_ciphersuites(&m_env->conf, COAP_ENC_PKI);
1879mbedtls_cleanup(coap_mbedtls_env_t *m_env) {
1884 mbedtls_x509_crt_free(&m_env->cacert);
1885 mbedtls_x509_crt_free(&m_env->public_cert);
1886 mbedtls_pk_free(&m_env->private_key);
1887#if !COAP_USE_PSA_CRYPTO
1888 mbedtls_entropy_free(&m_env->entropy);
1889 mbedtls_ctr_drbg_free(&m_env->ctr_drbg);
1891 mbedtls_ssl_config_free(&m_env->conf);
1892 mbedtls_ssl_free(&m_env->ssl);
1893 mbedtls_ssl_cookie_free(&m_env->cookie_ctx);
1897coap_dtls_free_mbedtls_env(coap_mbedtls_env_t *m_env) {
1899 if (!m_env->sent_alert)
1900 mbedtls_ssl_close_notify(&m_env->ssl);
1901 mbedtls_cleanup(m_env);
1902 mbedtls_free(m_env);
1906#if COAP_MAX_LOGGING_LEVEL > 0
1908report_mbedtls_alert(
unsigned char alert) {
1910 case MBEDTLS_SSL_ALERT_MSG_BAD_RECORD_MAC:
1911 return ": Bad Record MAC";
1912 case MBEDTLS_SSL_ALERT_MSG_HANDSHAKE_FAILURE:
1913 return ": Handshake failure";
1914 case MBEDTLS_SSL_ALERT_MSG_NO_CERT:
1915 return ": No Certificate provided";
1916 case MBEDTLS_SSL_ALERT_MSG_BAD_CERT:
1917 return ": Certificate is bad";
1918 case MBEDTLS_SSL_ALERT_MSG_CERT_UNKNOWN:
1919 return ": Certificate is unknown";
1920 case MBEDTLS_SSL_ALERT_MSG_UNKNOWN_CA:
1921 return ": CA is unknown";
1922 case MBEDTLS_SSL_ALERT_MSG_ACCESS_DENIED:
1923 return ": Access was denied";
1924 case MBEDTLS_SSL_ALERT_MSG_DECRYPT_ERROR:
1925 return ": Decrypt error";
1939 coap_mbedtls_env_t *m_env) {
1943 ret = mbedtls_ssl_handshake(&m_env->ssl);
1946 m_env->established = 1;
1950#ifdef MBEDTLS_SSL_DTLS_CONNECTION_ID
1951#if COAP_CLIENT_SUPPORT
1954 coap_mbedtls_context_t *m_context;
1958 m_context->setup_data.use_cid) {
1959 unsigned char peer_cid[MBEDTLS_SSL_CID_OUT_LEN_MAX];
1961 size_t peer_cid_len;
1964 if (mbedtls_ssl_get_peer_cid(&m_env->ssl, &enabled, peer_cid, &peer_cid_len) == 0 &&
1965 enabled == MBEDTLS_SSL_CID_ENABLED) {
1976 case MBEDTLS_ERR_SSL_WANT_READ:
1977 case MBEDTLS_ERR_SSL_WANT_WRITE:
1978 if (m_env->ssl.state == MBEDTLS_SSL_SERVER_HELLO
1979#
if MBEDTLS_VERSION_NUMBER >= 0x03030000
1980 || m_env->ssl.state == MBEDTLS_SSL_NEW_SESSION_TICKET
1983 if (++m_env->server_hello_cnt > 10) {
1991 case MBEDTLS_ERR_SSL_HELLO_VERIFY_REQUIRED:
1994 case MBEDTLS_ERR_SSL_INVALID_MAC:
1996#ifdef MBEDTLS_2_X_COMPAT
1997 case MBEDTLS_ERR_SSL_UNKNOWN_CIPHER:
1999 case MBEDTLS_ERR_SSL_DECODE_ERROR:
2002 case MBEDTLS_ERR_SSL_NO_CLIENT_CERTIFICATE:
2003 alert = MBEDTLS_SSL_ALERT_MSG_NO_CERT;
2005#ifdef MBEDTLS_2_X_COMPAT
2006 case MBEDTLS_ERR_SSL_BAD_HS_CLIENT_HELLO:
2007 case MBEDTLS_ERR_SSL_BAD_HS_SERVER_HELLO:
2008 alert = MBEDTLS_SSL_ALERT_MSG_HANDSHAKE_FAILURE;
2011 case MBEDTLS_ERR_X509_CERT_VERIFY_FAILED:
2013 case MBEDTLS_ERR_SSL_FATAL_ALERT_MESSAGE:
2014 if (m_env->ssl.in_msg[1] != MBEDTLS_SSL_ALERT_MSG_CLOSE_NOTIFY)
2017 report_mbedtls_alert(m_env->ssl.in_msg[1]));
2019 case MBEDTLS_ERR_SSL_PEER_CLOSE_NOTIFY:
2020 case MBEDTLS_ERR_SSL_CONN_EOF:
2021 case MBEDTLS_ERR_NET_CONN_RESET:
2027 "returned -0x%x: '%s'\n",
2028 -ret, get_error_string(ret));
2035 mbedtls_ssl_send_alert_message(&m_env->ssl,
2036 MBEDTLS_SSL_ALERT_LEVEL_FATAL,
2038 m_env->sent_alert = 1;
2043 get_error_string(ret));
2045 mbedtls_ssl_session_reset(&m_env->ssl);
2046#ifdef MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED
2047 if (m_env->ec_jpake) {
2050#if COAP_CLIENT_SUPPORT && COAP_SERVER_SUPPORT
2056#elif COAP_CLIENT_SUPPORT
2062 mbedtls_ssl_set_hs_ecjpake_password(&m_env->ssl, psk_key->
s, psk_key->
length);
2070mbedtls_debug_out(
void *ctx
COAP_UNUSED,
int level,
2103#if !COAP_DISABLE_TCP
2111coap_sock_read(
void *ctx,
unsigned char *out,
size_t outl) {
2112 int ret = MBEDTLS_ERR_SSL_CONN_EOF;
2119 if (errno == ECONNRESET) {
2121 ret = MBEDTLS_ERR_SSL_CONN_EOF;
2123 ret = MBEDTLS_ERR_NET_RECV_FAILED;
2125 }
else if (ret == 0) {
2127 ret = MBEDTLS_ERR_SSL_WANT_READ;
2140coap_sock_write(
void *context,
const unsigned char *in,
size_t inl) {
2145 (
const uint8_t *)in,
2151 (errno == EPIPE || errno == ECONNRESET)) {
2166 int lasterror = WSAGetLastError();
2168 if (lasterror == WSAEWOULDBLOCK) {
2169 ret = MBEDTLS_ERR_SSL_WANT_WRITE;
2170 }
else if (lasterror == WSAECONNRESET) {
2171 ret = MBEDTLS_ERR_NET_CONN_RESET;
2174 if (errno == EAGAIN || errno == EINTR) {
2175 ret = MBEDTLS_ERR_SSL_WANT_WRITE;
2176 }
else if (errno == EPIPE || errno == ECONNRESET) {
2177 ret = MBEDTLS_ERR_NET_CONN_RESET;
2181 ret = MBEDTLS_ERR_NET_SEND_FAILED;
2190 ret = MBEDTLS_ERR_SSL_WANT_WRITE;
2196static coap_mbedtls_env_t *
2200#if !COAP_USE_PSA_CRYPTO
2203 coap_mbedtls_env_t *m_env = (coap_mbedtls_env_t *)c_session->
tls;
2208 m_env = (coap_mbedtls_env_t *)mbedtls_malloc(
sizeof(coap_mbedtls_env_t));
2212 memset(m_env, 0,
sizeof(coap_mbedtls_env_t));
2214 mbedtls_ssl_init(&m_env->ssl);
2215#if !COAP_USE_PSA_CRYPTO
2216 mbedtls_ctr_drbg_init(&m_env->ctr_drbg);
2217 mbedtls_entropy_init(&m_env->entropy);
2219 mbedtls_ssl_config_init(&m_env->conf);
2221#if defined(ESPIDF_VERSION) && defined(CONFIG_MBEDTLS_DEBUG)
2222 mbedtls_esp_enable_debug_log(&m_env->conf, CONFIG_MBEDTLS_DEBUG_LEVEL);
2225#if !COAP_USE_PSA_CRYPTO
2226 if ((ret = mbedtls_ctr_drbg_seed(&m_env->ctr_drbg,
2227 mbedtls_entropy_func, &m_env->entropy, NULL, 0)) != 0) {
2228 if (ret != MBEDTLS_ERR_CTR_DRBG_ENTROPY_SOURCE_FAILED) {
2229 coap_log_info(
"mbedtls_ctr_drbg_seed returned -0x%x: '%s'\n",
2230 -ret, get_error_string(ret));
2233 coap_log_err(
"mbedtls_ctr_drbg_seed returned -0x%x: '%s'\n",
2234 -ret, get_error_string(ret));
2239#if COAP_CLIENT_SUPPORT
2240 if (setup_client_ssl_session(c_session, m_env) != 0) {
2247#if defined(MBEDTLS_SSL_SRV_C)
2248 if (setup_server_ssl_session(c_session, m_env) != 0) {
2258#if MBEDTLS_VERSION_NUMBER >= 0x03020000
2259 mbedtls_ssl_conf_min_tls_version(&m_env->conf, MBEDTLS_SSL_VERSION_TLS1_2);
2261 mbedtls_ssl_conf_min_version(&m_env->conf, MBEDTLS_SSL_MAJOR_VERSION_3,
2262 MBEDTLS_SSL_MINOR_VERSION_3);
2265 if (mbedtls_ssl_setup(&m_env->ssl, &m_env->conf) != 0) {
2269 mbedtls_ssl_set_bio(&m_env->ssl, c_session, coap_dgram_write,
2270 coap_dgram_read, NULL);
2271#ifdef MBEDTLS_SSL_DTLS_CONNECTION_ID
2274#if COAP_CLIENT_SUPPORT
2275 coap_mbedtls_context_t *m_context =
2279 m_context->setup_data.use_cid) {
2287 mbedtls_ssl_set_cid(&m_env->ssl, MBEDTLS_SSL_CID_ENABLED, NULL, 0);
2291#if COAP_SERVER_SUPPORT
2292 u_char cid[COAP_DTLS_CID_LENGTH];
2301 mbedtls_ssl_set_cid(&m_env->ssl, MBEDTLS_SSL_CID_ENABLED, cid,
2309#if !COAP_DISABLE_TCP
2312 mbedtls_ssl_set_bio(&m_env->ssl, c_session, coap_sock_write,
2313 coap_sock_read, NULL);
2316#ifdef MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED
2317 coap_mbedtls_context_t *m_context =
2319 if ((m_context->psk_pki_enabled & IS_PSK) &&
2323#if COAP_CLIENT_SUPPORT && COAP_SERVER_SUPPORT
2329#elif COAP_CLIENT_SUPPORT
2334 mbedtls_ssl_set_hs_ecjpake_password(&m_env->ssl, psk_key->
s, psk_key->
length);
2337 mbedtls_ssl_set_timer_cb(&m_env->ssl, &m_env->timer,
2338 mbedtls_timing_set_delay,
2339 mbedtls_timing_get_delay);
2341 mbedtls_ssl_conf_dbg(&m_env->conf, mbedtls_debug_out, stdout);
2346 mbedtls_free(m_env);
2353#if defined(MBEDTLS_SSL_PROTO_DTLS)
2356 static int reported = 0;
2360 " - update Mbed TLS to include DTLS\n");
2368#if !COAP_DISABLE_TCP
2417#ifdef MBEDTLS_SSL_DTLS_CONNECTION_ID
2424#if COAP_CLIENT_SUPPORT
2427#ifdef MBEDTLS_SSL_DTLS_CONNECTION_ID
2440 coap_mbedtls_context_t *m_context;
2443 m_context = (coap_mbedtls_context_t *)mbedtls_malloc(
sizeof(coap_mbedtls_context_t));
2445 memset(m_context, 0,
sizeof(coap_mbedtls_context_t));
2450#if COAP_SERVER_SUPPORT
2459 coap_mbedtls_context_t *m_context =
2462#if !defined(MBEDTLS_SSL_SRV_C)
2464 " libcoap not compiled for Server Mode for Mbed TLS"
2465 " - update Mbed TLS to include Server Mode\n");
2468 if (!m_context || !setup_data)
2472#ifndef MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED
2473 coap_log_warn(
"Mbed TLS not compiled for EC-JPAKE support\n");
2476 m_context->psk_pki_enabled |= IS_PSK;
2481#if COAP_CLIENT_SUPPORT
2490#if !defined(MBEDTLS_SSL_CLI_C)
2495 " libcoap not compiled for Client Mode for Mbed TLS"
2496 " - update Mbed TLS to include Client Mode\n");
2499 coap_mbedtls_context_t *m_context =
2502 if (!m_context || !setup_data)
2506 coap_log_warn(
"CoAP Client with Mbed TLS does not support Identity Hint selection\n");
2509#ifndef MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED
2510 coap_log_warn(
"Mbed TLS not compiled for EC-JPAKE support\n");
2514#ifndef MBEDTLS_SSL_DTLS_CONNECTION_ID
2515 coap_log_warn(
"Mbed TLS not compiled for Connection-ID support\n");
2518 m_context->psk_pki_enabled |= IS_PSK;
2528 coap_mbedtls_context_t *m_context =
2531 m_context->setup_data = *setup_data;
2532 if (!m_context->setup_data.verify_peer_cert) {
2534 m_context->setup_data.check_common_ca = 0;
2536 m_context->setup_data.allow_self_signed = 1;
2537 m_context->setup_data.allow_expired_certs = 1;
2538 m_context->setup_data.cert_chain_validation = 1;
2539 m_context->setup_data.cert_chain_verify_depth = 10;
2540 m_context->setup_data.check_cert_revocation = 1;
2541 m_context->setup_data.allow_no_crl = 1;
2542 m_context->setup_data.allow_expired_crl = 1;
2543 m_context->setup_data.allow_bad_md_hash = 1;
2544 m_context->setup_data.allow_short_rsa_length = 1;
2546 m_context->psk_pki_enabled |= IS_PKI;
2548#ifndef MBEDTLS_SSL_DTLS_CONNECTION_ID
2549 coap_log_warn(
"Mbed TLS not compiled for Connection-ID support\n");
2557 const char *ca_file,
2558 const char *ca_path) {
2559 coap_mbedtls_context_t *m_context =
2563 coap_log_warn(
"coap_context_set_pki_root_cas: (D)TLS environment "
2568 if (ca_file == NULL && ca_path == NULL) {
2569 coap_log_warn(
"coap_context_set_pki_root_cas: ca_file and/or ca_path "
2573 if (m_context->root_ca_file) {
2574 mbedtls_free(m_context->root_ca_file);
2575 m_context->root_ca_file = NULL;
2579 m_context->root_ca_file = mbedtls_strdup(ca_file);
2582 if (m_context->root_ca_path) {
2583 mbedtls_free(m_context->root_ca_path);
2584 m_context->root_ca_path = NULL;
2588 m_context->root_ca_path = mbedtls_strdup(ca_path);
2595 coap_mbedtls_context_t *m_context =
2597 return m_context->psk_pki_enabled ? 1 : 0;
2602 coap_mbedtls_context_t *m_context = (coap_mbedtls_context_t *)dtls_context;
2605 for (i = 0; i < m_context->pki_sni_count; i++) {
2606 mbedtls_free(m_context->pki_sni_entry_list[i].sni);
2608 mbedtls_x509_crt_free(&m_context->pki_sni_entry_list[i].public_cert);
2610 mbedtls_pk_free(&m_context->pki_sni_entry_list[i].private_key);
2612 mbedtls_x509_crt_free(&m_context->pki_sni_entry_list[i].cacert);
2614 if (m_context->pki_sni_entry_list)
2615 mbedtls_free(m_context->pki_sni_entry_list);
2617 for (i = 0; i < m_context->psk_sni_count; i++) {
2618 mbedtls_free(m_context->psk_sni_entry_list[i].sni);
2620 if (m_context->psk_sni_entry_list)
2621 mbedtls_free(m_context->psk_sni_entry_list);
2623 if (m_context->root_ca_path)
2624 mbedtls_free(m_context->root_ca_path);
2625 if (m_context->root_ca_file)
2626 mbedtls_free(m_context->root_ca_file);
2628 mbedtls_free(m_context);
2631#if COAP_CLIENT_SUPPORT
2634#if !defined(MBEDTLS_SSL_CLI_C)
2637 " libcoap not compiled for Client Mode for Mbed TLS"
2638 " - update Mbed TLS to include Client Mode\n");
2641 coap_mbedtls_env_t *m_env = coap_dtls_new_mbedtls_env(c_session,
2650 m_env->last_timeout = now;
2651 ret = do_mbedtls_handshake(c_session, m_env);
2653 coap_dtls_free_mbedtls_env(m_env);
2662#if COAP_SERVER_SUPPORT
2665#if !defined(MBEDTLS_SSL_SRV_C)
2668 " libcoap not compiled for Server Mode for Mbed TLS"
2669 " - update Mbed TLS to include Server Mode\n");
2672 coap_mbedtls_env_t *m_env =
2673 (coap_mbedtls_env_t *)c_session->
tls;
2675#if defined(MBEDTLS_SSL_PROTO_DTLS)
2676#if MBEDTLS_VERSION_NUMBER >= 0x02100100
2677 mbedtls_ssl_set_mtu(&m_env->ssl, (uint16_t)c_session->
mtu);
2688 if (c_session && c_session->
context && c_session->
tls) {
2689 coap_dtls_free_mbedtls_env(c_session->
tls);
2690 c_session->
tls = NULL;
2698#if defined(MBEDTLS_SSL_PROTO_DTLS)
2699 coap_mbedtls_env_t *m_env =
2700 (coap_mbedtls_env_t *)c_session->
tls;
2702#if MBEDTLS_VERSION_NUMBER >= 0x02100100
2703 mbedtls_ssl_set_mtu(&m_env->ssl, (uint16_t)c_session->
mtu);
2713 const uint8_t *data,
size_t data_len) {
2715 coap_mbedtls_env_t *m_env = (coap_mbedtls_env_t *)c_session->
tls;
2717 assert(m_env != NULL);
2725 if (m_env->established) {
2726 ret = mbedtls_ssl_write(&m_env->ssl, (
const unsigned char *) data, data_len);
2729 case MBEDTLS_ERR_SSL_WANT_READ:
2730 case MBEDTLS_ERR_SSL_WANT_WRITE:
2733 case MBEDTLS_ERR_SSL_FATAL_ALERT_MESSAGE:
2739 "returned -0x%x: '%s'\n",
2740 -ret, get_error_string(ret));
2749 ret = do_mbedtls_handshake(c_session, m_env);
2779 coap_mbedtls_env_t *m_env = (coap_mbedtls_env_t *)c_session->
tls;
2780 int ret = mbedtls_timing_get_delay(&m_env->timer);
2781 unsigned int scalar = 1 << m_env->retry_scalar;
2791 m_env->last_timeout = now;
2804 m_env->last_timeout = now;
2822 coap_mbedtls_env_t *m_env = (coap_mbedtls_env_t *)c_session->
tls;
2825 m_env->retry_scalar++;
2827 (do_mbedtls_handshake(c_session, m_env) < 0)) {
2842 const uint8_t *data,
2847 coap_mbedtls_env_t *m_env = (coap_mbedtls_env_t *)c_session->
tls;
2848 coap_ssl_t *ssl_data;
2850 assert(m_env != NULL);
2852 ssl_data = &m_env->coap_ssl_data;
2853 if (ssl_data->pdu_len) {
2854 coap_log_err(
"** %s: Previous data not read %u bytes\n",
2857 ssl_data->pdu = data;
2858 ssl_data->pdu_len = (unsigned)data_len;
2860 if (m_env->established) {
2861#if COAP_CONSTRAINED_STACK
2874 ret = mbedtls_ssl_read(&m_env->ssl, pdu,
sizeof(pdu));
2879 if (!c_session->
tls) {
2887 case MBEDTLS_ERR_SSL_PEER_CLOSE_NOTIFY:
2888 case MBEDTLS_ERR_SSL_FATAL_ALERT_MESSAGE:
2891 case MBEDTLS_ERR_SSL_WANT_READ:
2895 "returned -0x%x: '%s' (length %zd)\n",
2896 -ret, get_error_string(ret), data_len);
2901 ret = do_mbedtls_handshake(c_session, m_env);
2906 if (ssl_data->pdu_len) {
2908 ret = do_mbedtls_handshake(c_session, m_env);
2927 if (ssl_data && ssl_data->pdu_len) {
2929 coap_log_debug(
"coap_dtls_receive: ret %d: remaining data %u\n", ret, ssl_data->pdu_len);
2930 ssl_data->pdu_len = 0;
2931 ssl_data->pdu = NULL;
2936#if COAP_SERVER_SUPPORT
2944 const uint8_t *data,
2946#if !defined(MBEDTLS_SSL_PROTO_DTLS) || !defined(MBEDTLS_SSL_SRV_C)
2951 " libcoap not compiled for DTLS or Server Mode for Mbed TLS"
2952 " - update Mbed TLS to include DTLS and Server Mode\n");
2955 coap_mbedtls_env_t *m_env = (coap_mbedtls_env_t *)c_session->
tls;
2956 coap_ssl_t *ssl_data;
2963 c_session->
tls = m_env;
2970 if ((ret = mbedtls_ssl_set_client_transport_id(&m_env->ssl,
2973 coap_log_err(
"mbedtls_ssl_set_client_transport_id() returned -0x%x: '%s'\n",
2974 -ret, get_error_string(ret));
2978 ssl_data = &m_env->coap_ssl_data;
2979 if (ssl_data->pdu_len) {
2980 coap_log_err(
"** %s: Previous data not read %u bytes\n",
2983 ssl_data->pdu = data;
2984 ssl_data->pdu_len = (unsigned)data_len;
2986 ret = do_mbedtls_handshake(c_session, m_env);
2987 if (ret == 0 || m_env->seen_client_hello) {
2993 m_env->seen_client_hello = 0;
2999 if (ssl_data->pdu_len) {
3001 coap_log_debug(
"coap_dtls_hello: ret %d: remaining data %u\n", ret, ssl_data->pdu_len);
3002 ssl_data->pdu_len = 0;
3003 ssl_data->pdu = NULL;
3012 coap_mbedtls_env_t *m_env = (coap_mbedtls_env_t *)c_session->
tls;
3013 int expansion = mbedtls_ssl_get_record_expansion(&m_env->ssl);
3015 if (expansion == MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE) {
3021#if !COAP_DISABLE_TCP
3022#if COAP_CLIENT_SUPPORT
3025#if !defined(MBEDTLS_SSL_CLI_C)
3029 " libcoap not compiled for Client Mode for Mbed TLS"
3030 " - update Mbed TLS to include Client Mode\n");
3033 coap_mbedtls_env_t *m_env = coap_dtls_new_mbedtls_env(c_session,
3043 m_env->last_timeout = now;
3044 c_session->
tls = m_env;
3045 ret = do_mbedtls_handshake(c_session, m_env);
3055#if COAP_SERVER_SUPPORT
3058#if !defined(MBEDTLS_SSL_SRV_C)
3063 " libcoap not compiled for Server Mode for Mbed TLS"
3064 " - update Mbed TLS to include Server Mode\n");
3067 coap_mbedtls_env_t *m_env = coap_dtls_new_mbedtls_env(c_session,
3075 c_session->
tls = m_env;
3076 ret = do_mbedtls_handshake(c_session, m_env);
3101 coap_mbedtls_env_t *m_env = (coap_mbedtls_env_t *)c_session->
tls;
3102 size_t amount_sent = 0;
3104 assert(m_env != NULL);
3111 if (m_env->established) {
3112 while (amount_sent < data_len) {
3113 ret = mbedtls_ssl_write(&m_env->ssl, &data[amount_sent],
3114 data_len - amount_sent);
3117 case MBEDTLS_ERR_SSL_WANT_READ:
3118 case MBEDTLS_ERR_SSL_WANT_WRITE:
3125 case MBEDTLS_ERR_NET_CONN_RESET:
3126 case MBEDTLS_ERR_SSL_FATAL_ALERT_MESSAGE:
3131 "returned -0x%x: '%s'\n",
3132 -ret, get_error_string(ret));
3144 ret = do_mbedtls_handshake(c_session, m_env);
3162 if (ret == (ssize_t)data_len)
3181 coap_mbedtls_env_t *m_env = (coap_mbedtls_env_t *)c_session->
tls;
3190 if (!m_env->established && !m_env->sent_alert) {
3191 ret = do_mbedtls_handshake(c_session, m_env);
3200 ret = mbedtls_ssl_read(&m_env->ssl, data, data_len);
3204 case MBEDTLS_ERR_SSL_PEER_CLOSE_NOTIFY:
3208 case MBEDTLS_ERR_SSL_FATAL_ALERT_MESSAGE:
3210 m_env->sent_alert = 1;
3213#if MBEDTLS_VERSION_NUMBER >= 0x03060000
3214 case MBEDTLS_ERR_SSL_RECEIVED_NEW_SESSION_TICKET:
3216 case MBEDTLS_ERR_SSL_WANT_READ:
3222 "returned -0x%x: '%s' (length %zd)\n",
3223 -ret, get_error_string(ret), data_len);
3227 }
else if (ret < (
int)data_len) {
3250#if COAP_USE_PSA_CRYPTO || defined(MBEDTLS_PSA_CRYPTO_C)
3257#if COAP_CLIENT_SUPPORT
3258 mbedtls_free(psk_ciphers);
3259 mbedtls_free(pki_ciphers);
3260 mbedtls_free(ecjpake_ciphers);
3263 ecjpake_ciphers = NULL;
3264 processed_ciphers = 0;
3267#if COAP_USE_PSA_CRYPTO || defined(MBEDTLS_PSA_CRYPTO_C)
3268 mbedtls_psa_crypto_free();
3281 if (c_session && c_session->
tls) {
3282 coap_mbedtls_env_t *m_env;
3285 memcpy(&m_env, &c_session->
tls,
sizeof(m_env));
3287 return (
void *)&m_env->ssl;
3296#if !defined(ESPIDF_VERSION)
3306 switch ((
int)level) {
3327 mbedtls_debug_set_threshold(use_level);
3329 keep_log_level = level;
3334 return keep_log_level;
3340 version.
version = mbedtls_version_get_number();
3346#if COAP_SERVER_SUPPORT
3349 coap_crypto_sha256_ctx_t *digest_ctx = mbedtls_malloc(
sizeof(coap_crypto_sha256_ctx_t));
3352 if (coap_crypto_sha256_init(digest_ctx) != 0) {
3363 coap_crypto_sha256_free(digest_ctx);
3364 mbedtls_free(digest_ctx);
3370 const uint8_t *data,
3372 return coap_crypto_sha256_update(digest_ctx, data, data_len) == 0;
3378 int ret = coap_crypto_sha256_finish(digest_ctx, (uint8_t *)digest_buffer) == 0;
3389 coap_crypto_md_type_t md_type;
3394 md_type = COAP_CRYPTO_MD_SHA1;
3397 md_type = COAP_CRYPTO_MD_SHA256;
3400 md_type = COAP_CRYPTO_MD_SHA512;
3403 coap_log_debug(
"coap_crypto_hash: algorithm %d not supported\n", alg);
3407 hash_len = coap_crypto_hash_size(md_type);
3415 if (coap_crypto_hash_compute(md_type, data->
s, data->
length,
3416 dummy->s, hash_len, NULL) != 0) {
3426#if COAP_OSCORE_SUPPORT
3436get_cipher_key_size(
cose_alg_t alg,
size_t *key_size) {
3447 coap_log_debug(
"get_cipher_key_size: COSE cipher %d not supported\n", alg);
3457 coap_crypto_md_type_t *md_type,
3459 switch ((
int)hmac_alg) {
3462 *md_type = COAP_CRYPTO_MD_SHA256;
3468 *md_type = COAP_CRYPTO_MD_SHA384;
3474 *md_type = COAP_CRYPTO_MD_SHA512;
3479 coap_log_debug(
"get_hmac_params: COSE HMAC %d not supported\n", hmac_alg);
3486 return get_cipher_key_size(alg, NULL);
3495 return get_hmac_params(hmac_alg, NULL, NULL);
3503 size_t *max_result_len) {
3509 assert(params != NULL);
3515 if (!get_cipher_key_size(params->
alg, NULL)) {
3516 coap_log_debug(
"coap_crypto_aead_encrypt: algorithm %d not supported\n",
3523 if (coap_crypto_aead_encrypt_ccm(ccm->
key.
s, ccm->
key.
length,
3525 aad ? aad->
s : NULL, aad ? aad->
length : 0,
3527 result, *max_result_len, max_result_len,
3541 size_t *max_result_len) {
3547 assert(params != NULL);
3553 if (!get_cipher_key_size(params->
alg, NULL)) {
3554 coap_log_debug(
"coap_crypto_aead_decrypt: algorithm %d not supported\n",
3566 if (coap_crypto_aead_decrypt_ccm(ccm->
key.
s, ccm->
key.
length,
3568 aad ? aad->
s : NULL, aad ? aad->
length : 0,
3570 result, *max_result_len, max_result_len,
3584 coap_crypto_md_type_t md_type;
3592 if (!get_hmac_params(hmac_alg, &md_type, &mac_len)) {
3593 coap_log_debug(
"coap_crypto_hmac: algorithm %d not supported\n", hmac_alg);
3601 if (coap_crypto_hmac_compute(md_type, key->
s, key->
length,
3603 dummy->s, mac_len, NULL) != 0) {
3621#pragma GCC diagnostic ignored "-Wunused-function"
#define COAP_SERVER_SUPPORT
const char * coap_socket_strerror(void)
#define COAP_RXBUFFER_SIZE
#define COAP_SOCKET_WANT_WRITE
non blocking socket is waiting for writing
#define COAP_SOCKET_CAN_READ
non blocking socket can now read without blocking
Library specific build wrapper for coap_internal.h.
int coap_dtls_context_set_pki(coap_context_t *ctx COAP_UNUSED, const coap_dtls_pki_t *setup_data COAP_UNUSED, const coap_dtls_role_t role COAP_UNUSED)
coap_tick_t coap_dtls_get_timeout(coap_session_t *session COAP_UNUSED, coap_tick_t now COAP_UNUSED)
ssize_t coap_tls_read(coap_session_t *session COAP_UNUSED, uint8_t *data COAP_UNUSED, size_t data_len COAP_UNUSED)
coap_tick_t coap_dtls_get_context_timeout(void *dtls_context COAP_UNUSED)
int coap_dtls_receive(coap_session_t *session COAP_UNUSED, const uint8_t *data COAP_UNUSED, size_t data_len COAP_UNUSED)
void * coap_dtls_get_tls(const coap_session_t *c_session COAP_UNUSED, coap_tls_library_t *tls_lib)
unsigned int coap_dtls_get_overhead(coap_session_t *session COAP_UNUSED)
int coap_dtls_context_check_keys_enabled(coap_context_t *ctx COAP_UNUSED)
ssize_t coap_dtls_send(coap_session_t *session COAP_UNUSED, const uint8_t *data COAP_UNUSED, size_t data_len COAP_UNUSED)
ssize_t coap_tls_write(coap_session_t *session COAP_UNUSED, const uint8_t *data COAP_UNUSED, size_t data_len COAP_UNUSED)
void coap_dtls_session_update_mtu(coap_session_t *session COAP_UNUSED)
int coap_dtls_context_set_pki_root_cas(coap_context_t *ctx COAP_UNUSED, const char *ca_file COAP_UNUSED, const char *ca_path COAP_UNUSED)
int coap_dtls_handle_timeout(coap_session_t *session COAP_UNUSED)
void coap_dtls_free_context(void *handle COAP_UNUSED)
void coap_dtls_free_session(coap_session_t *coap_session COAP_UNUSED)
void * coap_dtls_new_context(coap_context_t *coap_context COAP_UNUSED)
void coap_tls_free_session(coap_session_t *coap_session COAP_UNUSED)
void coap_digest_free(coap_digest_ctx_t *digest_ctx)
Free off coap_digest_ctx_t.
int coap_digest_final(coap_digest_ctx_t *digest_ctx, coap_digest_t *digest_buffer)
Finalize the coap_digest information into the provided digest_buffer.
int coap_digest_update(coap_digest_ctx_t *digest_ctx, const uint8_t *data, size_t data_len)
Update the coap_digest information with the next chunk of data.
coap_digest_ctx_t * coap_digest_setup(void)
Initialize a coap_digest.
uint64_t coap_tick_t
This data type represents internal timer ticks with COAP_TICKS_PER_SECOND resolution.
int coap_prng_lkd(void *buf, size_t len)
Fills buf with len random bytes using the default pseudo random number generator.
int coap_handle_event_lkd(coap_context_t *context, coap_event_t event, coap_session_t *session)
Invokes the event handler of context for the given event and data.
int coap_handle_dgram(coap_context_t *ctx, coap_session_t *session, uint8_t *msg, size_t msg_len)
Parses and interprets a CoAP datagram with context ctx.
void coap_ticks(coap_tick_t *)
Returns the current value of an internal tick counter.
int coap_crypto_hmac(cose_hmac_alg_t hmac_alg, coap_bin_const_t *key, coap_bin_const_t *data, coap_bin_const_t **hmac)
Create a HMAC hash of the provided data.
int coap_crypto_aead_decrypt(const coap_crypto_param_t *params, coap_bin_const_t *data, coap_bin_const_t *aad, uint8_t *result, size_t *max_result_len)
Decrypt the provided encrypted data into plaintext.
int coap_crypto_aead_encrypt(const coap_crypto_param_t *params, coap_bin_const_t *data, coap_bin_const_t *aad, uint8_t *result, size_t *max_result_len)
Encrypt the provided plaintext data.
int coap_crypto_hash(cose_alg_t alg, const coap_bin_const_t *data, coap_bin_const_t **hash)
Create a hash of the provided data.
int coap_crypto_check_hkdf_alg(cose_hkdf_alg_t hkdf_alg)
Check whether the defined hkdf algorithm is supported by the underlying crypto library.
int coap_crypto_check_cipher_alg(cose_alg_t alg)
Check whether the defined cipher algorithm is supported by the underlying crypto library.
void * coap_tls_new_server_session(coap_session_t *coap_session)
Create a TLS new server-side session.
const coap_bin_const_t * coap_get_session_client_psk_identity(const coap_session_t *coap_session)
Get the current client's PSK identity.
void coap_dtls_startup(void)
Initialize the underlying (D)TLS Library layer.
int coap_dtls_define_issue(coap_define_issue_key_t type, coap_define_issue_fail_t fail, coap_dtls_key_t *key, const coap_dtls_role_t role, int ret)
Report PKI DEFINE type issue.
void * coap_dtls_new_client_session(coap_session_t *coap_session)
Create a new client-side session.
void coap_dtls_thread_shutdown(void)
Close down the underlying (D)TLS Library layer.
void * coap_dtls_new_server_session(coap_session_t *coap_session)
Create a new DTLS server-side session.
int coap_dtls_hello(coap_session_t *coap_session, const uint8_t *data, size_t data_len)
Handling client HELLO messages from a new candiate peer.
int coap_dtls_set_cid_tuple_change(coap_context_t *context, uint8_t every)
Set the Connection ID client tuple frequency change for testing CIDs.
int coap_dtls_is_context_timeout(void)
Check if timeout is handled per CoAP session or per CoAP context.
int coap_dtls_context_set_cpsk(coap_context_t *coap_context, coap_dtls_cpsk_t *setup_data)
Set the DTLS context's default client PSK information.
int coap_dtls_context_set_spsk(coap_context_t *coap_context, coap_dtls_spsk_t *setup_data)
Set the DTLS context's default server PSK information.
void coap_dtls_shutdown(void)
Close down the underlying (D)TLS Library layer.
const coap_bin_const_t * coap_get_session_client_psk_key(const coap_session_t *coap_session)
Get the current client's PSK key.
void * coap_tls_new_client_session(coap_session_t *coap_session)
Create a new TLS client-side session.
#define COAP_DTLS_RETRANSMIT_COAP_TICKS
void coap_dtls_map_key_type_to_define(const coap_dtls_pki_t *setup_data, coap_dtls_key_t *key)
Map the PKI key definitions to the new DEFINE format.
const coap_bin_const_t * coap_get_session_server_psk_key(const coap_session_t *coap_session)
Get the current server's PSK key.
@ COAP_DEFINE_KEY_PRIVATE
@ COAP_DEFINE_KEY_ROOT_CA
@ COAP_DEFINE_FAIL_NOT_SUPPORTED
coap_tls_version_t * coap_get_tls_library_version(void)
Determine the type and version of the underlying (D)TLS library.
struct coap_dtls_key_t coap_dtls_key_t
The structure that holds the PKI key information.
struct coap_dtls_spsk_info_t coap_dtls_spsk_info_t
The structure that holds the Server Pre-Shared Key and Identity Hint information.
struct coap_dtls_pki_t coap_dtls_pki_t
@ COAP_PKI_KEY_DEF_PKCS11
The PKI key type is PKCS11 (pkcs11:...).
@ COAP_PKI_KEY_DEF_DER_BUF
The PKI key type is DER buffer (ASN.1).
@ COAP_PKI_KEY_DEF_PEM_BUF
The PKI key type is PEM buffer.
@ COAP_PKI_KEY_DEF_PEM
The PKI key type is PEM file.
@ COAP_PKI_KEY_DEF_ENGINE
The PKI key type is to be passed to ENGINE.
@ COAP_PKI_KEY_DEF_RPK_BUF
The PKI key type is RPK in buffer.
@ COAP_PKI_KEY_DEF_DER
The PKI key type is DER file.
@ COAP_PKI_KEY_DEF_PKCS11_RPK
The PKI key type is PKCS11 w/ RPK (pkcs11:...).
@ COAP_DTLS_ROLE_SERVER
Internal function invoked for server.
@ COAP_DTLS_ROLE_CLIENT
Internal function invoked for client.
@ COAP_PKI_KEY_DEFINE
The individual PKI key types are Definable.
@ COAP_TLS_LIBRARY_MBEDTLS
Using Mbed TLS library.
@ COAP_EVENT_DTLS_CLOSED
Triggerred when (D)TLS session closed.
@ COAP_EVENT_DTLS_CONNECTED
Triggered when (D)TLS session connected.
@ COAP_EVENT_DTLS_ERROR
Triggered when (D)TLS error occurs.
#define coap_lock_callback_ret(r, c, func)
Dummy for no thread-safe code.
#define coap_log_debug(...)
#define coap_log_emerg(...)
coap_log_t coap_dtls_get_log_level(void)
Get the current (D)TLS logging.
#define coap_dtls_log(level,...)
Logging function.
void coap_dtls_set_log_level(coap_log_t level)
Sets the (D)TLS logging level to the specified level.
const char * coap_session_str(const coap_session_t *session)
Get session description.
#define coap_log_info(...)
#define coap_log_warn(...)
#define coap_log_err(...)
int coap_netif_available(coap_session_t *session)
Function interface to check whether netif for session is still available.
int cose_get_hmac_alg_for_hkdf(cose_hkdf_alg_t hkdf_alg, cose_hmac_alg_t *hmac_alg)
@ COSE_HMAC_ALG_HMAC384_384
@ COSE_HMAC_ALG_HMAC256_256
@ COSE_HMAC_ALG_HMAC512_512
@ COSE_ALGORITHM_SHA_256_256
@ COSE_ALGORITHM_AES_CCM_16_64_128
@ COSE_ALGORITHM_AES_CCM_16_64_256
coap_proto_t
CoAP protocol types Note: coap_layers_coap[] needs updating if extended.
int coap_session_refresh_psk_hint(coap_session_t *session, const coap_bin_const_t *psk_hint)
Refresh the session's current Identity Hint (PSK).
int coap_session_refresh_psk_key(coap_session_t *session, const coap_bin_const_t *psk_key)
Refresh the session's current pre-shared key (PSK).
void coap_session_connected(coap_session_t *session)
Notify session that it has just connected or reconnected.
int coap_session_refresh_psk_identity(coap_session_t *session, const coap_bin_const_t *psk_identity)
Refresh the session's current pre-shared identity (PSK).
void coap_session_disconnected_lkd(coap_session_t *session, coap_nack_reason_t reason)
Notify session that it has failed.
#define COAP_PROTO_NOT_RELIABLE(p)
@ COAP_SESSION_TYPE_CLIENT
client-side
@ COAP_SESSION_STATE_HANDSHAKE
@ COAP_SESSION_STATE_NONE
coap_binary_t * coap_new_binary(size_t size)
Returns a new binary object with at least size bytes storage allocated.
coap_bin_const_t * coap_new_bin_const(const uint8_t *data, size_t size)
Take the specified byte array (text) and create a coap_bin_const_t * Returns a new const binary objec...
void coap_delete_binary(coap_binary_t *s)
Deletes the given coap_binary_t object and releases any memory allocated.
int coap_dtls_cid_is_supported(void)
Check whether (D)TLS CID is available.
int coap_dtls_psk_is_supported(void)
Check whether (D)TLS PSK is available.
int coap_tls_is_supported(void)
Check whether TLS is available.
int coap_oscore_is_supported(void)
Check whether OSCORE is available.
int coap_dtls_is_supported(void)
Check whether DTLS is available.
int coap_dtls_pki_is_supported(void)
Check whether (D)TLS PKI is available.
int coap_dtls_rpk_is_supported(void)
Check whether (D)TLS RPK is available.
int coap_dtls_pkcs11_is_supported(void)
Check whether (D)TLS PKCS11 is available.
coap_address_t remote
remote address and port
CoAP binary data definition with const data.
size_t length
length of binary data
const uint8_t * s
read-only binary data
CoAP binary data definition.
The CoAP stack's global state is stored in a coap_context_t object.
uint8_t testing_cids
Change client's source port every testing_cids.
coap_dtls_spsk_t spsk_setup_data
Contains the initial PSK server setup data.
The structure that holds the AES Crypto information.
size_t l
The number of bytes in the length field.
const uint8_t * nonce
must be exactly 15 - l bytes
coap_crypto_key_t key
The Key to use.
size_t tag_len
The size of the Tag.
The common structure that holds the Crypto information.
union coap_crypto_param_t::@242136240037311335022001367112102231100333222137 params
coap_crypto_aes_ccm_t aes
Used if AES type encryption.
cose_alg_t alg
The COSE algorith to use.
The structure used for defining the Client PSK setup data to be used.
uint8_t use_cid
Set to 1 if DTLS Connection ID is to be used.
char * client_sni
If not NULL, SNI to use in client TLS setup.
coap_dtls_ih_callback_t validate_ih_call_back
Identity Hint check callback function.
uint8_t ec_jpake
Set to COAP_DTLS_CPSK_SETUP_VERSION to support this version of the struct.
The structure that holds the PKI key information.
union coap_dtls_key_t::@067104111220140054257241314117327310146344167156 key
coap_pki_key_define_t define
for definable type keys
coap_pki_key_t key_type
key format type
The structure used for defining the PKI setup data to be used.
void * cn_call_back_arg
Passed in to the CN callback function.
uint8_t allow_short_rsa_length
1 if small RSA keysizes are allowed
uint8_t cert_chain_validation
1 if to check cert_chain_verify_depth
uint8_t allow_bad_md_hash
1 if unsupported MD hashes are allowed
uint8_t use_cid
1 if DTLS Connection ID is to be used (Client only, server always enabled) if supported
uint8_t check_cert_revocation
1 if revocation checks wanted
uint8_t cert_chain_verify_depth
recommended depth is 3
uint8_t allow_expired_certs
1 if expired certs are allowed
uint8_t verify_peer_cert
Set to COAP_DTLS_PKI_SETUP_VERSION to support this version of the struct.
uint8_t allow_self_signed
1 if self-signed certs are allowed.
coap_dtls_cn_callback_t validate_cn_call_back
CN check callback function.
uint8_t allow_expired_crl
1 if expired crl is allowed
uint8_t check_common_ca
1 if peer cert is to be signed by the same CA as the local cert
The structure that holds the Server Pre-Shared Key and Identity Hint information.
The structure used for defining the Server PSK setup data to be used.
coap_dtls_psk_sni_callback_t validate_sni_call_back
SNI check callback function.
coap_dtls_id_callback_t validate_id_call_back
Identity check callback function.
void * id_call_back_arg
Passed in to the Identity callback function.
uint8_t ec_jpake
Set to COAP_DTLS_SPSK_SETUP_VERSION to support this version of the struct.
void * sni_call_back_arg
Passed in to the SNI callback function.
coap_layer_write_t l_write
coap_layer_establish_t l_establish
coap_const_char_ptr_t public_cert
define: Public Cert
coap_const_char_ptr_t private_key
define: Private Key
coap_const_char_ptr_t ca
define: Common CA Certificate
size_t public_cert_len
define Public Cert length (if needed)
size_t ca_len
define CA Cert length (if needed)
coap_pki_define_t private_key_def
define: Private Key type definition
size_t private_key_len
define Private Key length (if needed)
coap_pki_define_t ca_def
define: Common CA type definition
coap_pki_define_t public_cert_def
define: Public Cert type definition
Abstraction of virtual session that can be attached to coap_context_t (client) or coap_endpoint_t (se...
unsigned int dtls_timeout_count
dtls setup retry counter
coap_endpoint_t * endpoint
session's endpoint
coap_socket_t sock
socket object for the session, if any
coap_session_state_t state
current state of relationship with peer
coap_bin_const_t * client_cid
Contains client CID or NULL.
coap_addr_tuple_t addr_info
remote/local address info
coap_proto_t proto
protocol used
coap_dtls_cpsk_t cpsk_setup_data
client provided PSK initial setup data
size_t mtu
path or CSM mtu (xmt)
uint8_t negotiated_cid
Set for a client if CID negotiated.
int dtls_event
Tracking any (D)TLS events on this session.
void * tls
security parameters
uint16_t max_retransmit
maximum re-transmit count (default 4)
coap_session_type_t type
client or server side socket
coap_context_t * context
session's context
coap_layer_func_t lfunc[COAP_LAYER_LAST]
Layer functions to use.
coap_socket_flags_t flags
1 or more of COAP_SOCKET* flag values
The structure used for returning the underlying (D)TLS library information.
uint64_t built_version
(D)TLS Built against Library Version
coap_tls_library_t type
Library type.
uint64_t version
(D)TLS runtime Library Version
const char * s_byte
signed char ptr
const uint8_t * u_byte
unsigned char ptr