blob: 36641e18b6cf3ed9b1db76e2b5b495648d11f2f0 [file] [log] [blame]
Gilles Peskineedc23792023-09-04 17:53:11 +02001/**
2 * \file mbedtls/config_adjust_ssl.h
3 * \brief Adjust TLS configuration
4 *
Gilles Peskine975e74c2024-04-26 14:18:10 +02005 * This is an internal header. Do not include it directly.
6 *
Wenxing Houb4d03cc2024-06-19 11:04:13 +08007 * Automatically enable certain dependencies. Generally, MBEDTLS_xxx
Gilles Peskineedc23792023-09-04 17:53:11 +02008 * configurations need to be explicitly enabled by the user: enabling
9 * MBEDTLS_xxx_A but not MBEDTLS_xxx_B when A requires B results in a
10 * compilation error. However, we do automatically enable certain options
11 * in some circumstances. One case is if MBEDTLS_xxx_B is an internal option
12 * used to identify parts of a module that are used by other module, and we
13 * don't want to make the symbol MBEDTLS_xxx_B part of the public API.
14 * Another case is if A didn't depend on B in earlier versions, and we
15 * want to use B in A but we need to preserve backward compatibility with
16 * configurations that explicitly activate MBEDTLS_xxx_A but not
17 * MBEDTLS_xxx_B.
18 */
19/*
20 * Copyright The Mbed TLS Contributors
Dave Rodgman16799db2023-11-02 19:47:20 +000021 * SPDX-License-Identifier: Apache-2.0 OR GPL-2.0-or-later
Gilles Peskineedc23792023-09-04 17:53:11 +020022 */
23
24#ifndef MBEDTLS_CONFIG_ADJUST_SSL_H
25#define MBEDTLS_CONFIG_ADJUST_SSL_H
26
Gilles Peskine0b8ece62024-05-16 14:46:09 +020027#if !defined(MBEDTLS_CONFIG_FILES_READ)
28#error "Do not include mbedtls/config_adjust_*.h manually! This can lead to problems, " \
29 "up to and including runtime errors such as buffer overflows. " \
30 "If you're trying to fix a complaint from check_config.h, just remove " \
31 "it from your configuration file: since Mbed TLS 3.0, it is included " \
Gilles Peskine9df78062024-05-29 09:33:04 +020032 "automatically at the right point."
Gilles Peskine0b8ece62024-05-16 14:46:09 +020033#endif /* */
34
Gilles Peskineedc23792023-09-04 17:53:11 +020035/* The following blocks make it easier to disable all of TLS,
36 * or of TLS 1.2 or 1.3 or DTLS, without having to manually disable all
37 * key exchanges, options and extensions related to them. */
38
39#if !defined(MBEDTLS_SSL_TLS_C)
40#undef MBEDTLS_SSL_CLI_C
41#undef MBEDTLS_SSL_SRV_C
42#undef MBEDTLS_SSL_PROTO_TLS1_3
43#undef MBEDTLS_SSL_PROTO_TLS1_2
44#undef MBEDTLS_SSL_PROTO_DTLS
45#endif
46
Ronald Crond1100b02023-11-21 13:02:39 +010047#if !(defined(MBEDTLS_SSL_SRV_C) && defined(MBEDTLS_SSL_SESSION_TICKETS))
48#undef MBEDTLS_SSL_TICKET_C
49#endif
50
Gilles Peskineedc23792023-09-04 17:53:11 +020051#if !defined(MBEDTLS_SSL_PROTO_DTLS)
52#undef MBEDTLS_SSL_DTLS_ANTI_REPLAY
53#undef MBEDTLS_SSL_DTLS_CONNECTION_ID
Gilles Peskineedc23792023-09-04 17:53:11 +020054#undef MBEDTLS_SSL_DTLS_HELLO_VERIFY
55#undef MBEDTLS_SSL_DTLS_SRTP
56#undef MBEDTLS_SSL_DTLS_CLIENT_PORT_REUSE
57#endif
58
59#if !defined(MBEDTLS_SSL_PROTO_TLS1_2)
60#undef MBEDTLS_SSL_ENCRYPT_THEN_MAC
61#undef MBEDTLS_SSL_EXTENDED_MASTER_SECRET
62#undef MBEDTLS_SSL_RENEGOTIATION
Gilles Peskineedc23792023-09-04 17:53:11 +020063#undef MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED
64#undef MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED
65#undef MBEDTLS_KEY_EXCHANGE_PSK_ENABLED
Gilles Peskineedc23792023-09-04 17:53:11 +020066#undef MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED
67#undef MBEDTLS_KEY_EXCHANGE_ECDH_RSA_ENABLED
68#undef MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA_ENABLED
69#undef MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED
70#endif
71
72#if !defined(MBEDTLS_SSL_PROTO_TLS1_3)
73#undef MBEDTLS_SSL_TLS1_3_KEY_EXCHANGE_MODE_PSK_ENABLED
74#undef MBEDTLS_SSL_TLS1_3_KEY_EXCHANGE_MODE_EPHEMERAL_ENABLED
75#undef MBEDTLS_SSL_TLS1_3_KEY_EXCHANGE_MODE_PSK_EPHEMERAL_ENABLED
76#undef MBEDTLS_SSL_EARLY_DATA
Waleed Elmelegy09561a72024-01-10 16:13:53 +000077#undef MBEDTLS_SSL_RECORD_SIZE_LIMIT
Gilles Peskineedc23792023-09-04 17:53:11 +020078#endif
79
80#if defined(MBEDTLS_SSL_PROTO_TLS1_2) && \
81 (defined(MBEDTLS_ECDH_C) || defined(MBEDTLS_ECDSA_C) || \
82 defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED))
83#define MBEDTLS_SSL_TLS1_2_SOME_ECC
84#endif
85
86#endif /* MBEDTLS_CONFIG_ADJUST_SSL_H */