blob: d49adfd725e943216de8d737235ebd39660adae1 [file] [log] [blame]
Darryl Greena40a1012018-01-05 15:33:17 +00001/**
2 * \file config-ccm-psk-tls1_2.h
Manuel Pégourié-Gonnard8119dad2015-08-06 10:59:26 +02003 *
Darryl Greena40a1012018-01-05 15:33:17 +00004 * \brief Minimal configuration for TLS 1.2 with PSK and AES-CCM ciphersuites
5 */
6/*
Bence Szépkúti1e148272020-08-07 13:07:28 +02007 * Copyright The Mbed TLS Contributors
Dave Rodgman16799db2023-11-02 19:47:20 +00008 * SPDX-License-Identifier: Apache-2.0 OR GPL-2.0-or-later
Manuel Pégourié-Gonnard8119dad2015-08-06 10:59:26 +02009 */
10/*
Manuel Pégourié-Gonnard1a74a262014-06-24 15:51:32 +020011 * Minimal configuration for TLS 1.2 with PSK and AES-CCM ciphersuites
Gilles Peskine7451e5a2022-02-25 19:20:36 +010012 *
Manuel Pégourié-Gonnard0ac844c2014-06-24 16:30:49 +020013 * Distinguishing features:
Gilles Peskined725bf72022-04-05 21:52:14 +020014 * - Optimized for small code size, low bandwidth (on a reliable transport),
Gilles Peskine7451e5a2022-02-25 19:20:36 +010015 * and low RAM usage.
16 * - No asymmetric cryptography (no certificates, no Diffie-Hellman key
17 * exchange).
18 * - Fully modern and secure (provided the pre-shared keys are generated and
19 * stored securely).
20 * - Very low record overhead with CCM-8.
Manuel Pégourié-Gonnard1a74a262014-06-24 15:51:32 +020021 *
22 * See README.txt for usage instructions.
23 */
Manuel Pégourié-Gonnard1a74a262014-06-24 15:51:32 +020024
25/* System support */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020026//#define MBEDTLS_HAVE_TIME /* Optionally used in Hello messages */
27/* Other MBEDTLS_HAVE_XXX flags irrelevant for this configuration */
Manuel Pégourié-Gonnard1a74a262014-06-24 15:51:32 +020028
Gilles Peskine7451e5a2022-02-25 19:20:36 +010029/* Mbed TLS modules */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020030#define MBEDTLS_AES_C
31#define MBEDTLS_CCM_C
32#define MBEDTLS_CIPHER_C
33#define MBEDTLS_CTR_DRBG_C
34#define MBEDTLS_ENTROPY_C
35#define MBEDTLS_MD_C
36#define MBEDTLS_NET_C
Mateusz Starzyk6326a8d2021-05-10 13:51:53 +020037#define MBEDTLS_SHA256_C
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020038#define MBEDTLS_SSL_CLI_C
39#define MBEDTLS_SSL_SRV_C
40#define MBEDTLS_SSL_TLS_C
Manuel Pégourié-Gonnard1a74a262014-06-24 15:51:32 +020041
Gilles Peskine7451e5a2022-02-25 19:20:36 +010042/* TLS protocol feature support */
43#define MBEDTLS_KEY_EXCHANGE_PSK_ENABLED
44#define MBEDTLS_SSL_PROTO_TLS1_2
Manuel Pégourié-Gonnard0ac844c2014-06-24 16:30:49 +020045
46/*
Manuel Pégourié-Gonnardcc10f4d2014-06-30 19:22:44 +020047 * Use only CCM_8 ciphersuites, and
48 * save ROM and a few bytes of RAM by specifying our own ciphersuite list
49 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020050#define MBEDTLS_SSL_CIPHERSUITES \
Gilles Peskine449bd832023-01-11 14:50:10 +010051 MBEDTLS_TLS_PSK_WITH_AES_256_CCM_8, \
52 MBEDTLS_TLS_PSK_WITH_AES_128_CCM_8
Manuel Pégourié-Gonnardac7dd332014-07-03 16:17:59 +020053
Manuel Pégourié-Gonnardcc10f4d2014-06-30 19:22:44 +020054/*
Manuel Pégourié-Gonnard0ac844c2014-06-24 16:30:49 +020055 * Save RAM at the expense of interoperability: do this only if you control
Manuel Pégourié-Gonnard7f809972015-03-09 17:05:11 +000056 * both ends of the connection! (See comments in "mbedtls/ssl.h".)
Manuel Pégourié-Gonnarde38eb0b2014-06-24 17:30:05 +020057 * The optimal size here depends on the typical size of records.
Manuel Pégourié-Gonnard0ac844c2014-06-24 16:30:49 +020058 */
Gilles Peskine7451e5a2022-02-25 19:20:36 +010059#define MBEDTLS_SSL_IN_CONTENT_LEN 1024
David Horstmann95d516f2021-05-04 18:36:56 +010060#define MBEDTLS_SSL_OUT_CONTENT_LEN 1024
Andrzej Kurek01005b92022-01-17 15:32:02 +010061
Gilles Peskine7451e5a2022-02-25 19:20:36 +010062/* Save RAM at the expense of ROM */
63#define MBEDTLS_AES_ROM_TABLES
64
65/* Save some RAM by adjusting to your exact needs */
66#define MBEDTLS_PSK_MAX_LEN 16 /* 128-bits keys are generally enough */
67
68/*
69 * You should adjust this to the exact number of sources you're using: default
70 * is the "platform_entropy_poll" source, but you may want to add other ones
71 * Minimum is 2 for the entropy test suite.
72 */
73#define MBEDTLS_ENTROPY_MAX_SOURCES 2
74
Andrzej Kurek01005b92022-01-17 15:32:02 +010075/* These defines are present so that the config modifying scripts can enable
76 * them during tests/scripts/test-ref-configs.pl */
77//#define MBEDTLS_USE_PSA_CRYPTO
78//#define MBEDTLS_PSA_CRYPTO_C
Gilles Peskinec6d197b2022-02-25 21:00:16 +010079
80/* Error messages and TLS debugging traces
81 * (huge code size increase, needed for tests/ssl-opt.sh) */
82//#define MBEDTLS_DEBUG_C
83//#define MBEDTLS_ERROR_C