blob: 07f2facef5a072971ebe05c21ffc3909efc9dd7d [file] [log] [blame]
Paul Bakker68884e32013-01-07 18:20:04 +01001/**
2 * \file ssl_ciphersuites.h
3 *
Gilles Peskinee820c0a2023-08-03 17:45:20 +02004 * \brief SSL Ciphersuites for Mbed TLS
Darryl Greena40a1012018-01-05 15:33:17 +00005 */
6/*
Bence Szépkúti1e148272020-08-07 13:07:28 +02007 * Copyright The Mbed TLS Contributors
Manuel Pégourié-Gonnard37ff1402015-09-04 14:21:07 +02008 * SPDX-License-Identifier: Apache-2.0
9 *
10 * Licensed under the Apache License, Version 2.0 (the "License"); you may
11 * not use this file except in compliance with the License.
12 * You may obtain a copy of the License at
13 *
14 * http://www.apache.org/licenses/LICENSE-2.0
15 *
16 * Unless required by applicable law or agreed to in writing, software
17 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
18 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
19 * See the License for the specific language governing permissions and
20 * limitations under the License.
Paul Bakker68884e32013-01-07 18:20:04 +010021 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020022#ifndef MBEDTLS_SSL_CIPHERSUITES_H
23#define MBEDTLS_SSL_CIPHERSUITES_H
Mateusz Starzyk846f0212021-05-19 19:44:07 +020024#include "mbedtls/private_access.h"
Paul Bakker68884e32013-01-07 18:20:04 +010025
Bence Szépkútic662b362021-05-27 11:25:03 +020026#include "mbedtls/build_info.h"
Ron Eldor8b0cf2e2018-02-14 16:02:41 +020027
Jaeden Amero6609aef2019-07-04 20:01:14 +010028#include "mbedtls/pk.h"
29#include "mbedtls/cipher.h"
30#include "mbedtls/md.h"
Paul Bakker68884e32013-01-07 18:20:04 +010031
32#ifdef __cplusplus
33extern "C" {
34#endif
35
Paul Bakker41c83d32013-03-20 14:39:14 +010036/*
37 * Supported ciphersuites (Official IANA names)
38 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020039#define MBEDTLS_TLS_RSA_WITH_NULL_MD5 0x01 /**< Weak! */
40#define MBEDTLS_TLS_RSA_WITH_NULL_SHA 0x02 /**< Weak! */
Paul Bakker41c83d32013-03-20 14:39:14 +010041
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020042#define MBEDTLS_TLS_PSK_WITH_NULL_SHA 0x2C /**< Weak! */
43#define MBEDTLS_TLS_DHE_PSK_WITH_NULL_SHA 0x2D /**< Weak! */
44#define MBEDTLS_TLS_RSA_PSK_WITH_NULL_SHA 0x2E /**< Weak! */
45#define MBEDTLS_TLS_RSA_WITH_AES_128_CBC_SHA 0x2F
Paul Bakker0c5fac22013-04-19 21:10:51 +020046
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020047#define MBEDTLS_TLS_DHE_RSA_WITH_AES_128_CBC_SHA 0x33
48#define MBEDTLS_TLS_RSA_WITH_AES_256_CBC_SHA 0x35
49#define MBEDTLS_TLS_DHE_RSA_WITH_AES_256_CBC_SHA 0x39
Paul Bakkerd4a56ec2013-04-16 18:05:29 +020050
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020051#define MBEDTLS_TLS_RSA_WITH_NULL_SHA256 0x3B /**< Weak! */
52#define MBEDTLS_TLS_RSA_WITH_AES_128_CBC_SHA256 0x3C /**< TLS 1.2 */
53#define MBEDTLS_TLS_RSA_WITH_AES_256_CBC_SHA256 0x3D /**< TLS 1.2 */
Paul Bakker41c83d32013-03-20 14:39:14 +010054
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020055#define MBEDTLS_TLS_RSA_WITH_CAMELLIA_128_CBC_SHA 0x41
56#define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_128_CBC_SHA 0x45
Paul Bakker0c5fac22013-04-19 21:10:51 +020057
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020058#define MBEDTLS_TLS_DHE_RSA_WITH_AES_128_CBC_SHA256 0x67 /**< TLS 1.2 */
59#define MBEDTLS_TLS_DHE_RSA_WITH_AES_256_CBC_SHA256 0x6B /**< TLS 1.2 */
Paul Bakker0c5fac22013-04-19 21:10:51 +020060
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020061#define MBEDTLS_TLS_RSA_WITH_CAMELLIA_256_CBC_SHA 0x84
62#define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_256_CBC_SHA 0x88
Paul Bakkerd4a56ec2013-04-16 18:05:29 +020063
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020064#define MBEDTLS_TLS_PSK_WITH_AES_128_CBC_SHA 0x8C
65#define MBEDTLS_TLS_PSK_WITH_AES_256_CBC_SHA 0x8D
Paul Bakkerd4a56ec2013-04-16 18:05:29 +020066
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020067#define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_CBC_SHA 0x90
68#define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_CBC_SHA 0x91
Paul Bakkerd4a56ec2013-04-16 18:05:29 +020069
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020070#define MBEDTLS_TLS_RSA_PSK_WITH_AES_128_CBC_SHA 0x94
71#define MBEDTLS_TLS_RSA_PSK_WITH_AES_256_CBC_SHA 0x95
Paul Bakkerd4a56ec2013-04-16 18:05:29 +020072
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020073#define MBEDTLS_TLS_RSA_WITH_AES_128_GCM_SHA256 0x9C /**< TLS 1.2 */
74#define MBEDTLS_TLS_RSA_WITH_AES_256_GCM_SHA384 0x9D /**< TLS 1.2 */
75#define MBEDTLS_TLS_DHE_RSA_WITH_AES_128_GCM_SHA256 0x9E /**< TLS 1.2 */
76#define MBEDTLS_TLS_DHE_RSA_WITH_AES_256_GCM_SHA384 0x9F /**< TLS 1.2 */
Paul Bakker41c83d32013-03-20 14:39:14 +010077
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020078#define MBEDTLS_TLS_PSK_WITH_AES_128_GCM_SHA256 0xA8 /**< TLS 1.2 */
79#define MBEDTLS_TLS_PSK_WITH_AES_256_GCM_SHA384 0xA9 /**< TLS 1.2 */
80#define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_GCM_SHA256 0xAA /**< TLS 1.2 */
81#define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_GCM_SHA384 0xAB /**< TLS 1.2 */
82#define MBEDTLS_TLS_RSA_PSK_WITH_AES_128_GCM_SHA256 0xAC /**< TLS 1.2 */
83#define MBEDTLS_TLS_RSA_PSK_WITH_AES_256_GCM_SHA384 0xAD /**< TLS 1.2 */
Paul Bakker40afb4b2013-04-19 22:03:30 +020084
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020085#define MBEDTLS_TLS_PSK_WITH_AES_128_CBC_SHA256 0xAE
86#define MBEDTLS_TLS_PSK_WITH_AES_256_CBC_SHA384 0xAF
87#define MBEDTLS_TLS_PSK_WITH_NULL_SHA256 0xB0 /**< Weak! */
88#define MBEDTLS_TLS_PSK_WITH_NULL_SHA384 0xB1 /**< Weak! */
Paul Bakker40afb4b2013-04-19 22:03:30 +020089
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020090#define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_CBC_SHA256 0xB2
91#define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_CBC_SHA384 0xB3
92#define MBEDTLS_TLS_DHE_PSK_WITH_NULL_SHA256 0xB4 /**< Weak! */
93#define MBEDTLS_TLS_DHE_PSK_WITH_NULL_SHA384 0xB5 /**< Weak! */
Paul Bakker40afb4b2013-04-19 22:03:30 +020094
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020095#define MBEDTLS_TLS_RSA_PSK_WITH_AES_128_CBC_SHA256 0xB6
96#define MBEDTLS_TLS_RSA_PSK_WITH_AES_256_CBC_SHA384 0xB7
97#define MBEDTLS_TLS_RSA_PSK_WITH_NULL_SHA256 0xB8 /**< Weak! */
98#define MBEDTLS_TLS_RSA_PSK_WITH_NULL_SHA384 0xB9 /**< Weak! */
Paul Bakker40afb4b2013-04-19 22:03:30 +020099
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200100#define MBEDTLS_TLS_RSA_WITH_CAMELLIA_128_CBC_SHA256 0xBA /**< TLS 1.2 */
101#define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_128_CBC_SHA256 0xBE /**< TLS 1.2 */
Paul Bakker0c5fac22013-04-19 21:10:51 +0200102
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200103#define MBEDTLS_TLS_RSA_WITH_CAMELLIA_256_CBC_SHA256 0xC0 /**< TLS 1.2 */
104#define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_256_CBC_SHA256 0xC4 /**< TLS 1.2 */
Paul Bakker0c5fac22013-04-19 21:10:51 +0200105
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200106#define MBEDTLS_TLS_ECDH_ECDSA_WITH_NULL_SHA 0xC001 /**< Weak! */
Mateusz Starzyk06b07fb2021-02-18 13:55:21 +0100107#define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA 0xC004
108#define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA 0xC005
Manuel Pégourié-Gonnard25781b22013-12-11 16:17:10 +0100109
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200110#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_NULL_SHA 0xC006 /**< Weak! */
Mateusz Starzyk06b07fb2021-02-18 13:55:21 +0100111#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA 0xC009
112#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA 0xC00A
Manuel Pégourié-Gonnard32ea60a2013-08-17 17:39:04 +0200113
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200114#define MBEDTLS_TLS_ECDH_RSA_WITH_NULL_SHA 0xC00B /**< Weak! */
Mateusz Starzyk06b07fb2021-02-18 13:55:21 +0100115#define MBEDTLS_TLS_ECDH_RSA_WITH_AES_128_CBC_SHA 0xC00E
116#define MBEDTLS_TLS_ECDH_RSA_WITH_AES_256_CBC_SHA 0xC00F
Manuel Pégourié-Gonnard25781b22013-12-11 16:17:10 +0100117
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200118#define MBEDTLS_TLS_ECDHE_RSA_WITH_NULL_SHA 0xC010 /**< Weak! */
Mateusz Starzyk06b07fb2021-02-18 13:55:21 +0100119#define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA 0xC013
120#define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA 0xC014
Paul Bakker41c83d32013-03-20 14:39:14 +0100121
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200122#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 0xC023 /**< TLS 1.2 */
123#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384 0xC024 /**< TLS 1.2 */
124#define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA256 0xC025 /**< TLS 1.2 */
125#define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA384 0xC026 /**< TLS 1.2 */
126#define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 0xC027 /**< TLS 1.2 */
127#define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 0xC028 /**< TLS 1.2 */
128#define MBEDTLS_TLS_ECDH_RSA_WITH_AES_128_CBC_SHA256 0xC029 /**< TLS 1.2 */
129#define MBEDTLS_TLS_ECDH_RSA_WITH_AES_256_CBC_SHA384 0xC02A /**< TLS 1.2 */
Paul Bakker0c5fac22013-04-19 21:10:51 +0200130
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200131#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 0xC02B /**< TLS 1.2 */
132#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 0xC02C /**< TLS 1.2 */
133#define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_128_GCM_SHA256 0xC02D /**< TLS 1.2 */
134#define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_256_GCM_SHA384 0xC02E /**< TLS 1.2 */
135#define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 0xC02F /**< TLS 1.2 */
136#define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 0xC030 /**< TLS 1.2 */
137#define MBEDTLS_TLS_ECDH_RSA_WITH_AES_128_GCM_SHA256 0xC031 /**< TLS 1.2 */
138#define MBEDTLS_TLS_ECDH_RSA_WITH_AES_256_GCM_SHA384 0xC032 /**< TLS 1.2 */
Paul Bakkera54e4932013-03-20 15:31:54 +0100139
Mateusz Starzyk06b07fb2021-02-18 13:55:21 +0100140#define MBEDTLS_TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA 0xC035
141#define MBEDTLS_TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA 0xC036
142#define MBEDTLS_TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA256 0xC037
143#define MBEDTLS_TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA384 0xC038
144#define MBEDTLS_TLS_ECDHE_PSK_WITH_NULL_SHA 0xC039
145#define MBEDTLS_TLS_ECDHE_PSK_WITH_NULL_SHA256 0xC03A
146#define MBEDTLS_TLS_ECDHE_PSK_WITH_NULL_SHA384 0xC03B
Manuel Pégourié-Gonnard225d6aa2013-10-11 19:07:56 +0200147
Manuel Pégourié-Gonnard4231e7f2018-02-28 10:54:31 +0100148#define MBEDTLS_TLS_RSA_WITH_ARIA_128_CBC_SHA256 0xC03C /**< TLS 1.2 */
149#define MBEDTLS_TLS_RSA_WITH_ARIA_256_CBC_SHA384 0xC03D /**< TLS 1.2 */
150#define MBEDTLS_TLS_DHE_RSA_WITH_ARIA_128_CBC_SHA256 0xC044 /**< TLS 1.2 */
151#define MBEDTLS_TLS_DHE_RSA_WITH_ARIA_256_CBC_SHA384 0xC045 /**< TLS 1.2 */
152#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_ARIA_128_CBC_SHA256 0xC048 /**< TLS 1.2 */
153#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_ARIA_256_CBC_SHA384 0xC049 /**< TLS 1.2 */
154#define MBEDTLS_TLS_ECDH_ECDSA_WITH_ARIA_128_CBC_SHA256 0xC04A /**< TLS 1.2 */
155#define MBEDTLS_TLS_ECDH_ECDSA_WITH_ARIA_256_CBC_SHA384 0xC04B /**< TLS 1.2 */
156#define MBEDTLS_TLS_ECDHE_RSA_WITH_ARIA_128_CBC_SHA256 0xC04C /**< TLS 1.2 */
157#define MBEDTLS_TLS_ECDHE_RSA_WITH_ARIA_256_CBC_SHA384 0xC04D /**< TLS 1.2 */
158#define MBEDTLS_TLS_ECDH_RSA_WITH_ARIA_128_CBC_SHA256 0xC04E /**< TLS 1.2 */
159#define MBEDTLS_TLS_ECDH_RSA_WITH_ARIA_256_CBC_SHA384 0xC04F /**< TLS 1.2 */
160#define MBEDTLS_TLS_RSA_WITH_ARIA_128_GCM_SHA256 0xC050 /**< TLS 1.2 */
161#define MBEDTLS_TLS_RSA_WITH_ARIA_256_GCM_SHA384 0xC051 /**< TLS 1.2 */
162#define MBEDTLS_TLS_DHE_RSA_WITH_ARIA_128_GCM_SHA256 0xC052 /**< TLS 1.2 */
163#define MBEDTLS_TLS_DHE_RSA_WITH_ARIA_256_GCM_SHA384 0xC053 /**< TLS 1.2 */
164#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_ARIA_128_GCM_SHA256 0xC05C /**< TLS 1.2 */
165#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_ARIA_256_GCM_SHA384 0xC05D /**< TLS 1.2 */
166#define MBEDTLS_TLS_ECDH_ECDSA_WITH_ARIA_128_GCM_SHA256 0xC05E /**< TLS 1.2 */
167#define MBEDTLS_TLS_ECDH_ECDSA_WITH_ARIA_256_GCM_SHA384 0xC05F /**< TLS 1.2 */
168#define MBEDTLS_TLS_ECDHE_RSA_WITH_ARIA_128_GCM_SHA256 0xC060 /**< TLS 1.2 */
169#define MBEDTLS_TLS_ECDHE_RSA_WITH_ARIA_256_GCM_SHA384 0xC061 /**< TLS 1.2 */
170#define MBEDTLS_TLS_ECDH_RSA_WITH_ARIA_128_GCM_SHA256 0xC062 /**< TLS 1.2 */
171#define MBEDTLS_TLS_ECDH_RSA_WITH_ARIA_256_GCM_SHA384 0xC063 /**< TLS 1.2 */
172#define MBEDTLS_TLS_PSK_WITH_ARIA_128_CBC_SHA256 0xC064 /**< TLS 1.2 */
173#define MBEDTLS_TLS_PSK_WITH_ARIA_256_CBC_SHA384 0xC065 /**< TLS 1.2 */
174#define MBEDTLS_TLS_DHE_PSK_WITH_ARIA_128_CBC_SHA256 0xC066 /**< TLS 1.2 */
175#define MBEDTLS_TLS_DHE_PSK_WITH_ARIA_256_CBC_SHA384 0xC067 /**< TLS 1.2 */
176#define MBEDTLS_TLS_RSA_PSK_WITH_ARIA_128_CBC_SHA256 0xC068 /**< TLS 1.2 */
177#define MBEDTLS_TLS_RSA_PSK_WITH_ARIA_256_CBC_SHA384 0xC069 /**< TLS 1.2 */
178#define MBEDTLS_TLS_PSK_WITH_ARIA_128_GCM_SHA256 0xC06A /**< TLS 1.2 */
179#define MBEDTLS_TLS_PSK_WITH_ARIA_256_GCM_SHA384 0xC06B /**< TLS 1.2 */
180#define MBEDTLS_TLS_DHE_PSK_WITH_ARIA_128_GCM_SHA256 0xC06C /**< TLS 1.2 */
181#define MBEDTLS_TLS_DHE_PSK_WITH_ARIA_256_GCM_SHA384 0xC06D /**< TLS 1.2 */
182#define MBEDTLS_TLS_RSA_PSK_WITH_ARIA_128_GCM_SHA256 0xC06E /**< TLS 1.2 */
183#define MBEDTLS_TLS_RSA_PSK_WITH_ARIA_256_GCM_SHA384 0xC06F /**< TLS 1.2 */
184#define MBEDTLS_TLS_ECDHE_PSK_WITH_ARIA_128_CBC_SHA256 0xC070 /**< TLS 1.2 */
185#define MBEDTLS_TLS_ECDHE_PSK_WITH_ARIA_256_CBC_SHA384 0xC071 /**< TLS 1.2 */
Markku-Juhani O. Saarinenc06e1012017-12-07 11:51:13 +0000186
Mateusz Starzyk06b07fb2021-02-18 13:55:21 +0100187#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_CAMELLIA_128_CBC_SHA256 0xC072
188#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_CAMELLIA_256_CBC_SHA384 0xC073
189#define MBEDTLS_TLS_ECDH_ECDSA_WITH_CAMELLIA_128_CBC_SHA256 0xC074
190#define MBEDTLS_TLS_ECDH_ECDSA_WITH_CAMELLIA_256_CBC_SHA384 0xC075
191#define MBEDTLS_TLS_ECDHE_RSA_WITH_CAMELLIA_128_CBC_SHA256 0xC076
192#define MBEDTLS_TLS_ECDHE_RSA_WITH_CAMELLIA_256_CBC_SHA384 0xC077
193#define MBEDTLS_TLS_ECDH_RSA_WITH_CAMELLIA_128_CBC_SHA256 0xC078
194#define MBEDTLS_TLS_ECDH_RSA_WITH_CAMELLIA_256_CBC_SHA384 0xC079
Paul Bakker27714b12013-04-07 23:07:12 +0200195
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200196#define MBEDTLS_TLS_RSA_WITH_CAMELLIA_128_GCM_SHA256 0xC07A /**< TLS 1.2 */
197#define MBEDTLS_TLS_RSA_WITH_CAMELLIA_256_GCM_SHA384 0xC07B /**< TLS 1.2 */
198#define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_128_GCM_SHA256 0xC07C /**< TLS 1.2 */
199#define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_256_GCM_SHA384 0xC07D /**< TLS 1.2 */
200#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_CAMELLIA_128_GCM_SHA256 0xC086 /**< TLS 1.2 */
201#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_CAMELLIA_256_GCM_SHA384 0xC087 /**< TLS 1.2 */
202#define MBEDTLS_TLS_ECDH_ECDSA_WITH_CAMELLIA_128_GCM_SHA256 0xC088 /**< TLS 1.2 */
203#define MBEDTLS_TLS_ECDH_ECDSA_WITH_CAMELLIA_256_GCM_SHA384 0xC089 /**< TLS 1.2 */
204#define MBEDTLS_TLS_ECDHE_RSA_WITH_CAMELLIA_128_GCM_SHA256 0xC08A /**< TLS 1.2 */
205#define MBEDTLS_TLS_ECDHE_RSA_WITH_CAMELLIA_256_GCM_SHA384 0xC08B /**< TLS 1.2 */
206#define MBEDTLS_TLS_ECDH_RSA_WITH_CAMELLIA_128_GCM_SHA256 0xC08C /**< TLS 1.2 */
207#define MBEDTLS_TLS_ECDH_RSA_WITH_CAMELLIA_256_GCM_SHA384 0xC08D /**< TLS 1.2 */
Manuel Pégourié-Gonnard8d01eea2013-10-24 19:49:07 +0200208
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200209#define MBEDTLS_TLS_PSK_WITH_CAMELLIA_128_GCM_SHA256 0xC08E /**< TLS 1.2 */
210#define MBEDTLS_TLS_PSK_WITH_CAMELLIA_256_GCM_SHA384 0xC08F /**< TLS 1.2 */
211#define MBEDTLS_TLS_DHE_PSK_WITH_CAMELLIA_128_GCM_SHA256 0xC090 /**< TLS 1.2 */
212#define MBEDTLS_TLS_DHE_PSK_WITH_CAMELLIA_256_GCM_SHA384 0xC091 /**< TLS 1.2 */
213#define MBEDTLS_TLS_RSA_PSK_WITH_CAMELLIA_128_GCM_SHA256 0xC092 /**< TLS 1.2 */
214#define MBEDTLS_TLS_RSA_PSK_WITH_CAMELLIA_256_GCM_SHA384 0xC093 /**< TLS 1.2 */
Manuel Pégourié-Gonnard8d01eea2013-10-24 19:49:07 +0200215
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200216#define MBEDTLS_TLS_PSK_WITH_CAMELLIA_128_CBC_SHA256 0xC094
217#define MBEDTLS_TLS_PSK_WITH_CAMELLIA_256_CBC_SHA384 0xC095
218#define MBEDTLS_TLS_DHE_PSK_WITH_CAMELLIA_128_CBC_SHA256 0xC096
219#define MBEDTLS_TLS_DHE_PSK_WITH_CAMELLIA_256_CBC_SHA384 0xC097
220#define MBEDTLS_TLS_RSA_PSK_WITH_CAMELLIA_128_CBC_SHA256 0xC098
221#define MBEDTLS_TLS_RSA_PSK_WITH_CAMELLIA_256_CBC_SHA384 0xC099
Mateusz Starzyk06b07fb2021-02-18 13:55:21 +0100222#define MBEDTLS_TLS_ECDHE_PSK_WITH_CAMELLIA_128_CBC_SHA256 0xC09A
223#define MBEDTLS_TLS_ECDHE_PSK_WITH_CAMELLIA_256_CBC_SHA384 0xC09B
Paul Bakker0f2f0bf2013-07-26 15:03:31 +0200224
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200225#define MBEDTLS_TLS_RSA_WITH_AES_128_CCM 0xC09C /**< TLS 1.2 */
226#define MBEDTLS_TLS_RSA_WITH_AES_256_CCM 0xC09D /**< TLS 1.2 */
227#define MBEDTLS_TLS_DHE_RSA_WITH_AES_128_CCM 0xC09E /**< TLS 1.2 */
228#define MBEDTLS_TLS_DHE_RSA_WITH_AES_256_CCM 0xC09F /**< TLS 1.2 */
229#define MBEDTLS_TLS_RSA_WITH_AES_128_CCM_8 0xC0A0 /**< TLS 1.2 */
230#define MBEDTLS_TLS_RSA_WITH_AES_256_CCM_8 0xC0A1 /**< TLS 1.2 */
231#define MBEDTLS_TLS_DHE_RSA_WITH_AES_128_CCM_8 0xC0A2 /**< TLS 1.2 */
232#define MBEDTLS_TLS_DHE_RSA_WITH_AES_256_CCM_8 0xC0A3 /**< TLS 1.2 */
233#define MBEDTLS_TLS_PSK_WITH_AES_128_CCM 0xC0A4 /**< TLS 1.2 */
234#define MBEDTLS_TLS_PSK_WITH_AES_256_CCM 0xC0A5 /**< TLS 1.2 */
235#define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_CCM 0xC0A6 /**< TLS 1.2 */
236#define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_CCM 0xC0A7 /**< TLS 1.2 */
237#define MBEDTLS_TLS_PSK_WITH_AES_128_CCM_8 0xC0A8 /**< TLS 1.2 */
238#define MBEDTLS_TLS_PSK_WITH_AES_256_CCM_8 0xC0A9 /**< TLS 1.2 */
239#define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_CCM_8 0xC0AA /**< TLS 1.2 */
240#define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_CCM_8 0xC0AB /**< TLS 1.2 */
Manuel Pégourié-Gonnard6768da92014-05-14 12:26:51 +0200241/* The last two are named with PSK_DHE in the RFC, which looks like a typo */
242
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200243#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_CCM 0xC0AC /**< TLS 1.2 */
244#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_CCM 0xC0AD /**< TLS 1.2 */
245#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_CCM_8 0xC0AE /**< TLS 1.2 */
246#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_CCM_8 0xC0AF /**< TLS 1.2 */
Manuel Pégourié-Gonnard6768da92014-05-14 12:26:51 +0200247
Manuel Pégourié-Gonnard538cb7b2015-09-15 18:03:28 +0200248#define MBEDTLS_TLS_ECJPAKE_WITH_AES_128_CCM_8 0xC0FF /**< experimental */
249
Manuel Pégourié-Gonnardce66d5e2018-06-14 11:11:15 +0200250/* RFC 7905 */
251#define MBEDTLS_TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256 0xCCA8 /**< TLS 1.2 */
252#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256 0xCCA9 /**< TLS 1.2 */
253#define MBEDTLS_TLS_DHE_RSA_WITH_CHACHA20_POLY1305_SHA256 0xCCAA /**< TLS 1.2 */
254#define MBEDTLS_TLS_PSK_WITH_CHACHA20_POLY1305_SHA256 0xCCAB /**< TLS 1.2 */
255#define MBEDTLS_TLS_ECDHE_PSK_WITH_CHACHA20_POLY1305_SHA256 0xCCAC /**< TLS 1.2 */
256#define MBEDTLS_TLS_DHE_PSK_WITH_CHACHA20_POLY1305_SHA256 0xCCAD /**< TLS 1.2 */
257#define MBEDTLS_TLS_RSA_PSK_WITH_CHACHA20_POLY1305_SHA256 0xCCAE /**< TLS 1.2 */
258
Hanno Becker8ca26922021-07-23 19:24:23 +0100259/* RFC 8446, Appendix B.4 */
260#define MBEDTLS_TLS1_3_AES_128_GCM_SHA256 0x1301 /**< TLS 1.3 */
261#define MBEDTLS_TLS1_3_AES_256_GCM_SHA384 0x1302 /**< TLS 1.3 */
262#define MBEDTLS_TLS1_3_CHACHA20_POLY1305_SHA256 0x1303 /**< TLS 1.3 */
263#define MBEDTLS_TLS1_3_AES_128_CCM_SHA256 0x1304 /**< TLS 1.3 */
264#define MBEDTLS_TLS1_3_AES_128_CCM_8_SHA256 0x1305 /**< TLS 1.3 */
265
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200266/* Reminder: update mbedtls_ssl_premaster_secret when adding a new key exchange.
Manuel Pégourié-Gonnardadeb7d82015-10-09 14:44:47 +0100267 * Reminder: update MBEDTLS_KEY_EXCHANGE__xxx below
Manuel Pégourié-Gonnardd9423232014-12-02 11:57:29 +0100268 */
Paul Bakker68884e32013-01-07 18:20:04 +0100269typedef enum {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200270 MBEDTLS_KEY_EXCHANGE_NONE = 0,
271 MBEDTLS_KEY_EXCHANGE_RSA,
272 MBEDTLS_KEY_EXCHANGE_DHE_RSA,
273 MBEDTLS_KEY_EXCHANGE_ECDHE_RSA,
274 MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA,
275 MBEDTLS_KEY_EXCHANGE_PSK,
276 MBEDTLS_KEY_EXCHANGE_DHE_PSK,
277 MBEDTLS_KEY_EXCHANGE_RSA_PSK,
278 MBEDTLS_KEY_EXCHANGE_ECDHE_PSK,
279 MBEDTLS_KEY_EXCHANGE_ECDH_RSA,
280 MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA,
Manuel Pégourié-Gonnard557535d2015-09-15 17:53:32 +0200281 MBEDTLS_KEY_EXCHANGE_ECJPAKE,
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200282} mbedtls_key_exchange_type_t;
Paul Bakker68884e32013-01-07 18:20:04 +0100283
Manuel Pégourié-Gonnarde5f30722015-10-22 17:01:15 +0200284/* Key exchanges using a certificate */
Manuel Pégourié-Gonnardadeb7d82015-10-09 14:44:47 +0100285#if defined(MBEDTLS_KEY_EXCHANGE_RSA_ENABLED) || \
286 defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED) || \
287 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
288 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED) || \
289 defined(MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED) || \
Manuel Pégourié-Gonnardadeb7d82015-10-09 14:44:47 +0100290 defined(MBEDTLS_KEY_EXCHANGE_ECDH_RSA_ENABLED) || \
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200291 defined(MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA_ENABLED)
Gilles Peskineeccd8882020-03-10 12:19:08 +0100292#define MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED
Manuel Pégourié-Gonnardd9423232014-12-02 11:57:29 +0100293#endif
294
Valerio Settic8ccc8f2023-08-02 20:00:13 +0200295/* Key exchanges in either TLS 1.2 or 1.3 which are using an ECDSA
296 * signature */
Valerio Setti2430a702023-07-13 17:22:51 +0200297#if defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED) || \
298 defined(MBEDTLS_SSL_TLS1_3_KEY_EXCHANGE_MODE_EPHEMERAL_ENABLED)
299#define MBEDTLS_KEY_EXCHANGE_WITH_ECDSA_ANY_ENABLED
300#endif
301
Ronald Crone68ab4f2022-10-05 12:46:29 +0200302#if defined(MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED) || \
303 defined(MBEDTLS_SSL_TLS1_3_KEY_EXCHANGE_MODE_EPHEMERAL_ENABLED)
304#define MBEDTLS_SSL_HANDSHAKE_WITH_CERT_ENABLED
305#endif
306
Manuel Pégourié-Gonnard97bb7262023-09-18 11:28:32 +0200307/* Key exchanges allowing client certificate requests.
308 *
309 * Note: that's almost the same as MBEDTLS_KEY_EXCHANGE_WITH_CERT_ENABLED
310 * above, except RSA-PSK uses a server certificate but no client cert.
311 *
312 * Note: this difference is specific to TLS 1.2, as with TLS 1.3, things are
313 * more symmetrical: client certs and server certs are either both allowed
314 * (Ephemeral mode) or both disallowed (PSK and PKS-Ephemeral modes).
315 */
Hanno Becker1aa267c2017-04-28 17:08:27 +0100316#if defined(MBEDTLS_KEY_EXCHANGE_RSA_ENABLED) || \
317 defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED) || \
Hanno Becker1aa267c2017-04-28 17:08:27 +0100318 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
Manuel Pégourié-Gonnard97bb7262023-09-18 11:28:32 +0200319 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED) || \
Hanno Becker1aa267c2017-04-28 17:08:27 +0100320 defined(MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA_ENABLED) || \
Manuel Pégourié-Gonnard97bb7262023-09-18 11:28:32 +0200321 defined(MBEDTLS_KEY_EXCHANGE_ECDH_RSA_ENABLED)
Gilles Peskineeccd8882020-03-10 12:19:08 +0100322#define MBEDTLS_KEY_EXCHANGE_CERT_REQ_ALLOWED_ENABLED
Hanno Becker1aa267c2017-04-28 17:08:27 +0100323#endif
324
Valerio Setti568799f2023-08-18 16:27:00 +0200325/* Helper to state that certificate-based client authentication through ECDSA
Valerio Setti2430a702023-07-13 17:22:51 +0200326 * is supported in TLS 1.2 */
327#if defined(MBEDTLS_KEY_EXCHANGE_CERT_REQ_ALLOWED_ENABLED) && \
328 defined(MBEDTLS_PK_CAN_ECDSA_SIGN) && defined(MBEDTLS_PK_CAN_ECDSA_VERIFY)
329#define MBEDTLS_KEY_EXCHANGE_ECDSA_CERT_REQ_ALLOWED_ENABLED
330#endif
331
Valerio Settic8ccc8f2023-08-02 20:00:13 +0200332/* ECDSA required for certificates in either TLS 1.2 or 1.3 */
333#if defined(MBEDTLS_KEY_EXCHANGE_ECDSA_CERT_REQ_ALLOWED_ENABLED) || \
334 defined(MBEDTLS_SSL_TLS1_3_KEY_EXCHANGE_MODE_EPHEMERAL_ENABLED)
335#define MBEDTLS_KEY_EXCHANGE_ECDSA_CERT_REQ_ANY_ALLOWED_ENABLED
336#endif
337
Hanno Becker1aa267c2017-04-28 17:08:27 +0100338/* Key exchanges involving server signature in ServerKeyExchange */
339#if defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED) || \
340 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
341 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED)
Gilles Peskineeccd8882020-03-10 12:19:08 +0100342#define MBEDTLS_KEY_EXCHANGE_WITH_SERVER_SIGNATURE_ENABLED
Hanno Becker1aa267c2017-04-28 17:08:27 +0100343#endif
344
345/* Key exchanges using ECDH */
346#if defined(MBEDTLS_KEY_EXCHANGE_ECDH_RSA_ENABLED) || \
347 defined(MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA_ENABLED)
Gilles Peskineeccd8882020-03-10 12:19:08 +0100348#define MBEDTLS_KEY_EXCHANGE_SOME_ECDH_ENABLED
Hanno Becker1aa267c2017-04-28 17:08:27 +0100349#endif
350
351/* Key exchanges that don't involve ephemeral keys */
352#if defined(MBEDTLS_KEY_EXCHANGE_RSA_ENABLED) || \
353 defined(MBEDTLS_KEY_EXCHANGE_PSK_ENABLED) || \
354 defined(MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED) || \
Gilles Peskineeccd8882020-03-10 12:19:08 +0100355 defined(MBEDTLS_KEY_EXCHANGE_SOME_ECDH_ENABLED)
356#define MBEDTLS_KEY_EXCHANGE_SOME_NON_PFS_ENABLED
Hanno Becker1aa267c2017-04-28 17:08:27 +0100357#endif
358
359/* Key exchanges that involve ephemeral keys */
360#if defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED) || \
361 defined(MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED) || \
362 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
363 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED) || \
364 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED) || \
365 defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
Gilles Peskineeccd8882020-03-10 12:19:08 +0100366#define MBEDTLS_KEY_EXCHANGE_SOME_PFS_ENABLED
Hanno Becker1aa267c2017-04-28 17:08:27 +0100367#endif
368
Manuel Pégourié-Gonnarde5f30722015-10-22 17:01:15 +0200369/* Key exchanges using a PSK */
Manuel Pégourié-Gonnardadeb7d82015-10-09 14:44:47 +0100370#if defined(MBEDTLS_KEY_EXCHANGE_PSK_ENABLED) || \
371 defined(MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED) || \
372 defined(MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED) || \
373 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED)
Gilles Peskineeccd8882020-03-10 12:19:08 +0100374#define MBEDTLS_KEY_EXCHANGE_SOME_PSK_ENABLED
Manuel Pégourié-Gonnardadeb7d82015-10-09 14:44:47 +0100375#endif
376
Hanno Becker1aa267c2017-04-28 17:08:27 +0100377/* Key exchanges using DHE */
378#if defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED) || \
379 defined(MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED)
Gilles Peskineeccd8882020-03-10 12:19:08 +0100380#define MBEDTLS_KEY_EXCHANGE_SOME_DHE_ENABLED
Hanno Becker1aa267c2017-04-28 17:08:27 +0100381#endif
382
383/* Key exchanges using ECDHE */
Manuel Pégourié-Gonnardadeb7d82015-10-09 14:44:47 +0100384#if defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
385 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED) || \
386 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED)
Gilles Peskineeccd8882020-03-10 12:19:08 +0100387#define MBEDTLS_KEY_EXCHANGE_SOME_ECDHE_ENABLED
Manuel Pégourié-Gonnardadeb7d82015-10-09 14:44:47 +0100388#endif
389
Valerio Settied365e62023-07-07 15:02:27 +0200390/* TLS 1.2 key exchanges using ECDH or ECDHE*/
Valerio Setti00dc4062023-07-05 18:48:43 +0200391#if defined(MBEDTLS_KEY_EXCHANGE_SOME_ECDH_ENABLED) || \
392 defined(MBEDTLS_KEY_EXCHANGE_SOME_ECDHE_ENABLED)
393#define MBEDTLS_KEY_EXCHANGE_SOME_ECDH_OR_ECDHE_1_2_ENABLED
394#endif
395
Valerio Setti0a0d0d52023-07-07 15:12:45 +0200396/* TLS 1.3 PSK key exchanges */
397#if defined(MBEDTLS_SSL_TLS1_3_KEY_EXCHANGE_MODE_PSK_ENABLED) || \
398 defined(MBEDTLS_SSL_TLS1_3_KEY_EXCHANGE_MODE_PSK_EPHEMERAL_ENABLED)
399#define MBEDTLS_SSL_TLS1_3_KEY_EXCHANGE_MODE_SOME_PSK_ENABLED
400#endif
401
402/* TLS 1.2 or 1.3 key exchanges with PSK */
403#if defined(MBEDTLS_KEY_EXCHANGE_SOME_PSK_ENABLED) || \
404 defined(MBEDTLS_SSL_TLS1_3_KEY_EXCHANGE_MODE_SOME_PSK_ENABLED)
405#define MBEDTLS_SSL_HANDSHAKE_WITH_PSK_ENABLED
406#endif
407
408/* TLS 1.3 ephemeral key exchanges */
409#if defined(MBEDTLS_SSL_TLS1_3_KEY_EXCHANGE_MODE_EPHEMERAL_ENABLED) || \
410 defined(MBEDTLS_SSL_TLS1_3_KEY_EXCHANGE_MODE_PSK_EPHEMERAL_ENABLED)
411#define MBEDTLS_SSL_TLS1_3_KEY_EXCHANGE_MODE_SOME_EPHEMERAL_ENABLED
412#endif
413
Valerio Settiea59c432023-07-25 11:14:03 +0200414/* TLS 1.3 key exchanges using ECDHE */
Valerio Settied365e62023-07-07 15:02:27 +0200415#if defined(MBEDTLS_SSL_TLS1_3_KEY_EXCHANGE_MODE_SOME_EPHEMERAL_ENABLED) && \
416 defined(PSA_WANT_ALG_ECDH)
417#define MBEDTLS_SSL_TLS1_3_KEY_EXCHANGE_MODE_SOME_ECDHE_ENABLED
418#endif
419
420/* TLS 1.2 or 1.3 key exchanges using ECDH or ECDHE */
Valerio Setti00dc4062023-07-05 18:48:43 +0200421#if defined(MBEDTLS_KEY_EXCHANGE_SOME_ECDH_OR_ECDHE_1_2_ENABLED) || \
Valerio Settied365e62023-07-07 15:02:27 +0200422 defined(MBEDTLS_SSL_TLS1_3_KEY_EXCHANGE_MODE_SOME_ECDHE_ENABLED)
Valerio Settie87915b2023-07-06 12:47:43 +0200423#define MBEDTLS_KEY_EXCHANGE_SOME_ECDH_OR_ECDHE_ANY_ENABLED
424#endif
425
Valerio Settied365e62023-07-07 15:02:27 +0200426/* TLS 1.2 XXDH key exchanges: ECDH or ECDHE or FFDH */
427#if (defined(MBEDTLS_KEY_EXCHANGE_SOME_ECDH_OR_ECDHE_1_2_ENABLED) || \
428 defined(MBEDTLS_KEY_EXCHANGE_SOME_DHE_ENABLED))
429#define MBEDTLS_KEY_EXCHANGE_SOME_XXDH_1_2_ENABLED
Valerio Setti00dc4062023-07-05 18:48:43 +0200430#endif
431
Valerio Setti9cd80112023-07-25 12:04:21 +0200432/* The handshake params structure has a set of fields called xxdh_psa which are used:
433 * - by TLS 1.2 with `USE_PSA` to do ECDH or ECDHE;
434 * - by TLS 1.3 to do ECDHE or FFDHE.
435 * The following macros can be used to guard their declaration and use.
436 */
437#if defined(MBEDTLS_KEY_EXCHANGE_SOME_ECDH_OR_ECDHE_1_2_ENABLED) && \
438 defined(MBEDTLS_USE_PSA_CRYPTO)
439#define MBEDTLS_KEY_EXCHANGE_SOME_XXDH_PSA_1_2_ENABLED
440#endif
441#if defined(MBEDTLS_KEY_EXCHANGE_SOME_XXDH_PSA_1_2_ENABLED) || \
Valerio Setti3d237b52023-07-07 16:00:20 +0200442 defined(MBEDTLS_SSL_TLS1_3_KEY_EXCHANGE_MODE_SOME_EPHEMERAL_ENABLED)
Valerio Settiea59c432023-07-25 11:14:03 +0200443#define MBEDTLS_KEY_EXCHANGE_SOME_XXDH_PSA_ANY_ENABLED
Valerio Setti3d237b52023-07-07 16:00:20 +0200444#endif
445
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200446typedef struct mbedtls_ssl_ciphersuite_t mbedtls_ssl_ciphersuite_t;
Paul Bakker68884e32013-01-07 18:20:04 +0100447
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200448#define MBEDTLS_CIPHERSUITE_WEAK 0x01 /**< Weak ciphersuite flag */
449#define MBEDTLS_CIPHERSUITE_SHORT_TAG 0x02 /**< Short authentication tag,
Manuel Pégourié-Gonnard6768da92014-05-14 12:26:51 +0200450 eg for CCM_8 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200451#define MBEDTLS_CIPHERSUITE_NODTLS 0x04 /**< Can't be used with DTLS */
Paul Bakker68884e32013-01-07 18:20:04 +0100452
453/**
454 * \brief This structure is used for storing ciphersuite information
Glenn Strauss60bfe602022-03-14 19:04:24 -0400455 *
456 * \note members are defined using integral types instead of enums
457 * in order to pack structure and reduce memory usage by internal
458 * \c ciphersuite_definitions[]
Paul Bakker68884e32013-01-07 18:20:04 +0100459 */
Gilles Peskine449bd832023-01-11 14:50:10 +0100460struct mbedtls_ssl_ciphersuite_t {
Mateusz Starzyk363eb292021-05-19 17:32:44 +0200461 int MBEDTLS_PRIVATE(id);
Gilles Peskine449bd832023-01-11 14:50:10 +0100462 const char *MBEDTLS_PRIVATE(name);
Paul Bakker68884e32013-01-07 18:20:04 +0100463
Glenn Strauss60bfe602022-03-14 19:04:24 -0400464 uint8_t MBEDTLS_PRIVATE(cipher); /* mbedtls_cipher_type_t */
465 uint8_t MBEDTLS_PRIVATE(mac); /* mbedtls_md_type_t */
466 uint8_t MBEDTLS_PRIVATE(key_exchange); /* mbedtls_key_exchange_type_t */
467 uint8_t MBEDTLS_PRIVATE(flags);
Paul Bakker68884e32013-01-07 18:20:04 +0100468
Glenn Strauss60bfe602022-03-14 19:04:24 -0400469 uint16_t MBEDTLS_PRIVATE(min_tls_version); /* mbedtls_ssl_protocol_version */
470 uint16_t MBEDTLS_PRIVATE(max_tls_version); /* mbedtls_ssl_protocol_version */
Paul Bakker68884e32013-01-07 18:20:04 +0100471};
472
Gilles Peskine449bd832023-01-11 14:50:10 +0100473const int *mbedtls_ssl_list_ciphersuites(void);
Paul Bakker68884e32013-01-07 18:20:04 +0100474
Gilles Peskine449bd832023-01-11 14:50:10 +0100475const mbedtls_ssl_ciphersuite_t *mbedtls_ssl_ciphersuite_from_string(const char *ciphersuite_name);
476const mbedtls_ssl_ciphersuite_t *mbedtls_ssl_ciphersuite_from_id(int ciphersuite_id);
Paul Bakker68884e32013-01-07 18:20:04 +0100477
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200478#if defined(MBEDTLS_PK_C)
Gilles Peskine449bd832023-01-11 14:50:10 +0100479mbedtls_pk_type_t mbedtls_ssl_get_ciphersuite_sig_pk_alg(const mbedtls_ssl_ciphersuite_t *info);
Neil Armstrong0c9c10a2022-05-12 14:15:06 +0200480#if defined(MBEDTLS_USE_PSA_CRYPTO)
Gilles Peskine449bd832023-01-11 14:50:10 +0100481psa_algorithm_t mbedtls_ssl_get_ciphersuite_sig_pk_psa_alg(const mbedtls_ssl_ciphersuite_t *info);
482psa_key_usage_t mbedtls_ssl_get_ciphersuite_sig_pk_psa_usage(const mbedtls_ssl_ciphersuite_t *info);
Neil Armstrong0c9c10a2022-05-12 14:15:06 +0200483#endif
Gilles Peskine449bd832023-01-11 14:50:10 +0100484mbedtls_pk_type_t mbedtls_ssl_get_ciphersuite_sig_alg(const mbedtls_ssl_ciphersuite_t *info);
Manuel Pégourié-Gonnard1a483832013-09-20 12:29:15 +0200485#endif
Manuel Pégourié-Gonnard09edda82013-08-19 13:50:33 +0200486
Gilles Peskine449bd832023-01-11 14:50:10 +0100487int mbedtls_ssl_ciphersuite_uses_ec(const mbedtls_ssl_ciphersuite_t *info);
488int mbedtls_ssl_ciphersuite_uses_psk(const mbedtls_ssl_ciphersuite_t *info);
Hanno Becker1aa267c2017-04-28 17:08:27 +0100489
Gilles Peskine449bd832023-01-11 14:50:10 +0100490static inline const char *mbedtls_ssl_ciphersuite_get_name(const mbedtls_ssl_ciphersuite_t *info)
Glenn Strauss8f526902022-01-13 00:04:49 -0500491{
492 return info->MBEDTLS_PRIVATE(name);
493}
494
Gilles Peskine449bd832023-01-11 14:50:10 +0100495size_t mbedtls_ssl_ciphersuite_get_cipher_key_bitlen(const mbedtls_ssl_ciphersuite_t *info);
Glenn Strauss8f526902022-01-13 00:04:49 -0500496
Gilles Peskineeccd8882020-03-10 12:19:08 +0100497#if defined(MBEDTLS_KEY_EXCHANGE_SOME_PFS_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +0100498static inline int mbedtls_ssl_ciphersuite_has_pfs(const mbedtls_ssl_ciphersuite_t *info)
Hanno Becker1aa267c2017-04-28 17:08:27 +0100499{
Gilles Peskine449bd832023-01-11 14:50:10 +0100500 switch (info->MBEDTLS_PRIVATE(key_exchange)) {
Hanno Becker1aa267c2017-04-28 17:08:27 +0100501 case MBEDTLS_KEY_EXCHANGE_DHE_RSA:
502 case MBEDTLS_KEY_EXCHANGE_DHE_PSK:
503 case MBEDTLS_KEY_EXCHANGE_ECDHE_RSA:
504 case MBEDTLS_KEY_EXCHANGE_ECDHE_PSK:
505 case MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA:
506 case MBEDTLS_KEY_EXCHANGE_ECJPAKE:
Gilles Peskine449bd832023-01-11 14:50:10 +0100507 return 1;
Hanno Becker1aa267c2017-04-28 17:08:27 +0100508
509 default:
Gilles Peskine449bd832023-01-11 14:50:10 +0100510 return 0;
Hanno Becker1aa267c2017-04-28 17:08:27 +0100511 }
512}
Gilles Peskineeccd8882020-03-10 12:19:08 +0100513#endif /* MBEDTLS_KEY_EXCHANGE_SOME_PFS_ENABLED */
Hanno Becker1aa267c2017-04-28 17:08:27 +0100514
Gilles Peskineeccd8882020-03-10 12:19:08 +0100515#if defined(MBEDTLS_KEY_EXCHANGE_SOME_NON_PFS_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +0100516static inline int mbedtls_ssl_ciphersuite_no_pfs(const mbedtls_ssl_ciphersuite_t *info)
Hanno Becker1aa267c2017-04-28 17:08:27 +0100517{
Gilles Peskine449bd832023-01-11 14:50:10 +0100518 switch (info->MBEDTLS_PRIVATE(key_exchange)) {
Hanno Becker1aa267c2017-04-28 17:08:27 +0100519 case MBEDTLS_KEY_EXCHANGE_ECDH_RSA:
520 case MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA:
521 case MBEDTLS_KEY_EXCHANGE_RSA:
522 case MBEDTLS_KEY_EXCHANGE_PSK:
523 case MBEDTLS_KEY_EXCHANGE_RSA_PSK:
Gilles Peskine449bd832023-01-11 14:50:10 +0100524 return 1;
Hanno Becker1aa267c2017-04-28 17:08:27 +0100525
526 default:
Gilles Peskine449bd832023-01-11 14:50:10 +0100527 return 0;
Hanno Becker1aa267c2017-04-28 17:08:27 +0100528 }
529}
Gilles Peskineeccd8882020-03-10 12:19:08 +0100530#endif /* MBEDTLS_KEY_EXCHANGE_SOME_NON_PFS_ENABLED */
Hanno Becker1aa267c2017-04-28 17:08:27 +0100531
Gilles Peskineeccd8882020-03-10 12:19:08 +0100532#if defined(MBEDTLS_KEY_EXCHANGE_SOME_ECDH_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +0100533static inline int mbedtls_ssl_ciphersuite_uses_ecdh(const mbedtls_ssl_ciphersuite_t *info)
Hanno Becker1aa267c2017-04-28 17:08:27 +0100534{
Gilles Peskine449bd832023-01-11 14:50:10 +0100535 switch (info->MBEDTLS_PRIVATE(key_exchange)) {
Hanno Becker1aa267c2017-04-28 17:08:27 +0100536 case MBEDTLS_KEY_EXCHANGE_ECDH_RSA:
537 case MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA:
Gilles Peskine449bd832023-01-11 14:50:10 +0100538 return 1;
Hanno Becker1aa267c2017-04-28 17:08:27 +0100539
540 default:
Gilles Peskine449bd832023-01-11 14:50:10 +0100541 return 0;
Hanno Becker1aa267c2017-04-28 17:08:27 +0100542 }
543}
Gilles Peskineeccd8882020-03-10 12:19:08 +0100544#endif /* MBEDTLS_KEY_EXCHANGE_SOME_ECDH_ENABLED */
Hanno Becker1aa267c2017-04-28 17:08:27 +0100545
Gilles Peskine449bd832023-01-11 14:50:10 +0100546static inline int mbedtls_ssl_ciphersuite_cert_req_allowed(const mbedtls_ssl_ciphersuite_t *info)
Hanno Becker1aa267c2017-04-28 17:08:27 +0100547{
Gilles Peskine449bd832023-01-11 14:50:10 +0100548 switch (info->MBEDTLS_PRIVATE(key_exchange)) {
Hanno Becker1aa267c2017-04-28 17:08:27 +0100549 case MBEDTLS_KEY_EXCHANGE_RSA:
550 case MBEDTLS_KEY_EXCHANGE_DHE_RSA:
551 case MBEDTLS_KEY_EXCHANGE_ECDH_RSA:
552 case MBEDTLS_KEY_EXCHANGE_ECDHE_RSA:
553 case MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA:
554 case MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA:
Gilles Peskine449bd832023-01-11 14:50:10 +0100555 return 1;
Hanno Becker1aa267c2017-04-28 17:08:27 +0100556
557 default:
Gilles Peskine449bd832023-01-11 14:50:10 +0100558 return 0;
Hanno Becker1aa267c2017-04-28 17:08:27 +0100559 }
560}
561
Gilles Peskine449bd832023-01-11 14:50:10 +0100562static inline int mbedtls_ssl_ciphersuite_uses_srv_cert(const mbedtls_ssl_ciphersuite_t *info)
Hanno Becker7177a882019-02-05 13:36:46 +0000563{
Gilles Peskine449bd832023-01-11 14:50:10 +0100564 switch (info->MBEDTLS_PRIVATE(key_exchange)) {
Hanno Becker7177a882019-02-05 13:36:46 +0000565 case MBEDTLS_KEY_EXCHANGE_RSA:
566 case MBEDTLS_KEY_EXCHANGE_RSA_PSK:
567 case MBEDTLS_KEY_EXCHANGE_DHE_RSA:
568 case MBEDTLS_KEY_EXCHANGE_ECDH_RSA:
569 case MBEDTLS_KEY_EXCHANGE_ECDHE_RSA:
570 case MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA:
571 case MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA:
Gilles Peskine449bd832023-01-11 14:50:10 +0100572 return 1;
Hanno Becker7177a882019-02-05 13:36:46 +0000573
574 default:
Gilles Peskine449bd832023-01-11 14:50:10 +0100575 return 0;
Hanno Becker7177a882019-02-05 13:36:46 +0000576 }
577}
578
Gilles Peskineeccd8882020-03-10 12:19:08 +0100579#if defined(MBEDTLS_KEY_EXCHANGE_SOME_DHE_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +0100580static inline int mbedtls_ssl_ciphersuite_uses_dhe(const mbedtls_ssl_ciphersuite_t *info)
Hanno Becker1aa267c2017-04-28 17:08:27 +0100581{
Gilles Peskine449bd832023-01-11 14:50:10 +0100582 switch (info->MBEDTLS_PRIVATE(key_exchange)) {
Hanno Becker1aa267c2017-04-28 17:08:27 +0100583 case MBEDTLS_KEY_EXCHANGE_DHE_RSA:
584 case MBEDTLS_KEY_EXCHANGE_DHE_PSK:
Gilles Peskine449bd832023-01-11 14:50:10 +0100585 return 1;
Hanno Becker1aa267c2017-04-28 17:08:27 +0100586
587 default:
Gilles Peskine449bd832023-01-11 14:50:10 +0100588 return 0;
Hanno Becker1aa267c2017-04-28 17:08:27 +0100589 }
590}
Gilles Peskineeccd8882020-03-10 12:19:08 +0100591#endif /* MBEDTLS_KEY_EXCHANGE_SOME_DHE_ENABLED) */
Hanno Becker1aa267c2017-04-28 17:08:27 +0100592
Gilles Peskineeccd8882020-03-10 12:19:08 +0100593#if defined(MBEDTLS_KEY_EXCHANGE_SOME_ECDHE_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +0100594static inline int mbedtls_ssl_ciphersuite_uses_ecdhe(const mbedtls_ssl_ciphersuite_t *info)
Hanno Becker1aa267c2017-04-28 17:08:27 +0100595{
Gilles Peskine449bd832023-01-11 14:50:10 +0100596 switch (info->MBEDTLS_PRIVATE(key_exchange)) {
Hanno Becker1aa267c2017-04-28 17:08:27 +0100597 case MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA:
598 case MBEDTLS_KEY_EXCHANGE_ECDHE_RSA:
599 case MBEDTLS_KEY_EXCHANGE_ECDHE_PSK:
Gilles Peskine449bd832023-01-11 14:50:10 +0100600 return 1;
Hanno Becker1aa267c2017-04-28 17:08:27 +0100601
602 default:
Gilles Peskine449bd832023-01-11 14:50:10 +0100603 return 0;
Hanno Becker1aa267c2017-04-28 17:08:27 +0100604 }
605}
Gilles Peskineeccd8882020-03-10 12:19:08 +0100606#endif /* MBEDTLS_KEY_EXCHANGE_SOME_ECDHE_ENABLED) */
Hanno Becker1aa267c2017-04-28 17:08:27 +0100607
Gilles Peskineeccd8882020-03-10 12:19:08 +0100608#if defined(MBEDTLS_KEY_EXCHANGE_WITH_SERVER_SIGNATURE_ENABLED)
Gilles Peskine449bd832023-01-11 14:50:10 +0100609static inline int mbedtls_ssl_ciphersuite_uses_server_signature(
610 const mbedtls_ssl_ciphersuite_t *info)
Hanno Becker1aa267c2017-04-28 17:08:27 +0100611{
Gilles Peskine449bd832023-01-11 14:50:10 +0100612 switch (info->MBEDTLS_PRIVATE(key_exchange)) {
Hanno Becker1aa267c2017-04-28 17:08:27 +0100613 case MBEDTLS_KEY_EXCHANGE_DHE_RSA:
614 case MBEDTLS_KEY_EXCHANGE_ECDHE_RSA:
615 case MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA:
Gilles Peskine449bd832023-01-11 14:50:10 +0100616 return 1;
Hanno Becker1aa267c2017-04-28 17:08:27 +0100617
618 default:
Gilles Peskine449bd832023-01-11 14:50:10 +0100619 return 0;
Hanno Becker1aa267c2017-04-28 17:08:27 +0100620 }
621}
Gilles Peskineeccd8882020-03-10 12:19:08 +0100622#endif /* MBEDTLS_KEY_EXCHANGE_WITH_SERVER_SIGNATURE_ENABLED */
Manuel Pégourié-Gonnard51451f82013-09-17 12:06:25 +0200623
Paul Bakker68884e32013-01-07 18:20:04 +0100624#ifdef __cplusplus
625}
626#endif
627
628#endif /* ssl_ciphersuites.h */