blob: 545468a51024634dd62ff99e034b07b034173c75 [file] [log] [blame]
Paul Bakker68884e32013-01-07 18:20:04 +01001/**
2 * \file ssl_ciphersuites.h
3 *
Manuel Pégourié-Gonnardb4fe3cb2015-01-22 16:11:05 +00004 * \brief SSL Ciphersuites for mbed TLS
Darryl Greena40a1012018-01-05 15:33:17 +00005 */
6/*
Manuel Pégourié-Gonnard6fb81872015-07-27 11:11:48 +02007 * Copyright (C) 2006-2015, ARM Limited, All Rights Reserved
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é-Gonnardfe446432015-03-06 13:17:10 +000022 * This file is part of mbed TLS (https://tls.mbed.org)
Paul Bakker68884e32013-01-07 18:20:04 +010023 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020024#ifndef MBEDTLS_SSL_CIPHERSUITES_H
25#define MBEDTLS_SSL_CIPHERSUITES_H
Paul Bakker68884e32013-01-07 18:20:04 +010026
Manuel Pégourié-Gonnard09edda82013-08-19 13:50:33 +020027#include "pk.h"
Paul Bakker68884e32013-01-07 18:20:04 +010028#include "cipher.h"
29#include "md.h"
30
31#ifdef __cplusplus
32extern "C" {
33#endif
34
Paul Bakker41c83d32013-03-20 14:39:14 +010035/*
36 * Supported ciphersuites (Official IANA names)
37 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020038#define MBEDTLS_TLS_RSA_WITH_NULL_MD5 0x01 /**< Weak! */
39#define MBEDTLS_TLS_RSA_WITH_NULL_SHA 0x02 /**< Weak! */
Paul Bakker41c83d32013-03-20 14:39:14 +010040
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020041#define MBEDTLS_TLS_RSA_WITH_RC4_128_MD5 0x04
42#define MBEDTLS_TLS_RSA_WITH_RC4_128_SHA 0x05
43#define MBEDTLS_TLS_RSA_WITH_DES_CBC_SHA 0x09 /**< Weak! Not in TLS 1.2 */
Paul Bakker41c83d32013-03-20 14:39:14 +010044
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020045#define MBEDTLS_TLS_RSA_WITH_3DES_EDE_CBC_SHA 0x0A
Paul Bakker0c5fac22013-04-19 21:10:51 +020046
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020047#define MBEDTLS_TLS_DHE_RSA_WITH_DES_CBC_SHA 0x15 /**< Weak! Not in TLS 1.2 */
48#define MBEDTLS_TLS_DHE_RSA_WITH_3DES_EDE_CBC_SHA 0x16
Paul Bakker41c83d32013-03-20 14:39:14 +010049
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020050#define MBEDTLS_TLS_PSK_WITH_NULL_SHA 0x2C /**< Weak! */
51#define MBEDTLS_TLS_DHE_PSK_WITH_NULL_SHA 0x2D /**< Weak! */
52#define MBEDTLS_TLS_RSA_PSK_WITH_NULL_SHA 0x2E /**< Weak! */
53#define MBEDTLS_TLS_RSA_WITH_AES_128_CBC_SHA 0x2F
Paul Bakker0c5fac22013-04-19 21:10:51 +020054
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020055#define MBEDTLS_TLS_DHE_RSA_WITH_AES_128_CBC_SHA 0x33
56#define MBEDTLS_TLS_RSA_WITH_AES_256_CBC_SHA 0x35
57#define MBEDTLS_TLS_DHE_RSA_WITH_AES_256_CBC_SHA 0x39
Paul Bakkerd4a56ec2013-04-16 18:05:29 +020058
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020059#define MBEDTLS_TLS_RSA_WITH_NULL_SHA256 0x3B /**< Weak! */
60#define MBEDTLS_TLS_RSA_WITH_AES_128_CBC_SHA256 0x3C /**< TLS 1.2 */
61#define MBEDTLS_TLS_RSA_WITH_AES_256_CBC_SHA256 0x3D /**< TLS 1.2 */
Paul Bakker41c83d32013-03-20 14:39:14 +010062
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020063#define MBEDTLS_TLS_RSA_WITH_CAMELLIA_128_CBC_SHA 0x41
64#define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_128_CBC_SHA 0x45
Paul Bakker0c5fac22013-04-19 21:10:51 +020065
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020066#define MBEDTLS_TLS_DHE_RSA_WITH_AES_128_CBC_SHA256 0x67 /**< TLS 1.2 */
67#define MBEDTLS_TLS_DHE_RSA_WITH_AES_256_CBC_SHA256 0x6B /**< TLS 1.2 */
Paul Bakker0c5fac22013-04-19 21:10:51 +020068
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020069#define MBEDTLS_TLS_RSA_WITH_CAMELLIA_256_CBC_SHA 0x84
70#define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_256_CBC_SHA 0x88
Paul Bakkerd4a56ec2013-04-16 18:05:29 +020071
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020072#define MBEDTLS_TLS_PSK_WITH_RC4_128_SHA 0x8A
73#define MBEDTLS_TLS_PSK_WITH_3DES_EDE_CBC_SHA 0x8B
74#define MBEDTLS_TLS_PSK_WITH_AES_128_CBC_SHA 0x8C
75#define MBEDTLS_TLS_PSK_WITH_AES_256_CBC_SHA 0x8D
Paul Bakkerd4a56ec2013-04-16 18:05:29 +020076
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020077#define MBEDTLS_TLS_DHE_PSK_WITH_RC4_128_SHA 0x8E
78#define MBEDTLS_TLS_DHE_PSK_WITH_3DES_EDE_CBC_SHA 0x8F
79#define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_CBC_SHA 0x90
80#define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_CBC_SHA 0x91
Paul Bakkerd4a56ec2013-04-16 18:05:29 +020081
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020082#define MBEDTLS_TLS_RSA_PSK_WITH_RC4_128_SHA 0x92
83#define MBEDTLS_TLS_RSA_PSK_WITH_3DES_EDE_CBC_SHA 0x93
84#define MBEDTLS_TLS_RSA_PSK_WITH_AES_128_CBC_SHA 0x94
85#define MBEDTLS_TLS_RSA_PSK_WITH_AES_256_CBC_SHA 0x95
Paul Bakkerd4a56ec2013-04-16 18:05:29 +020086
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020087#define MBEDTLS_TLS_RSA_WITH_AES_128_GCM_SHA256 0x9C /**< TLS 1.2 */
88#define MBEDTLS_TLS_RSA_WITH_AES_256_GCM_SHA384 0x9D /**< TLS 1.2 */
89#define MBEDTLS_TLS_DHE_RSA_WITH_AES_128_GCM_SHA256 0x9E /**< TLS 1.2 */
90#define MBEDTLS_TLS_DHE_RSA_WITH_AES_256_GCM_SHA384 0x9F /**< TLS 1.2 */
Paul Bakker41c83d32013-03-20 14:39:14 +010091
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020092#define MBEDTLS_TLS_PSK_WITH_AES_128_GCM_SHA256 0xA8 /**< TLS 1.2 */
93#define MBEDTLS_TLS_PSK_WITH_AES_256_GCM_SHA384 0xA9 /**< TLS 1.2 */
94#define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_GCM_SHA256 0xAA /**< TLS 1.2 */
95#define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_GCM_SHA384 0xAB /**< TLS 1.2 */
96#define MBEDTLS_TLS_RSA_PSK_WITH_AES_128_GCM_SHA256 0xAC /**< TLS 1.2 */
97#define MBEDTLS_TLS_RSA_PSK_WITH_AES_256_GCM_SHA384 0xAD /**< TLS 1.2 */
Paul Bakker40afb4b2013-04-19 22:03:30 +020098
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020099#define MBEDTLS_TLS_PSK_WITH_AES_128_CBC_SHA256 0xAE
100#define MBEDTLS_TLS_PSK_WITH_AES_256_CBC_SHA384 0xAF
101#define MBEDTLS_TLS_PSK_WITH_NULL_SHA256 0xB0 /**< Weak! */
102#define MBEDTLS_TLS_PSK_WITH_NULL_SHA384 0xB1 /**< Weak! */
Paul Bakker40afb4b2013-04-19 22:03:30 +0200103
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200104#define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_CBC_SHA256 0xB2
105#define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_CBC_SHA384 0xB3
106#define MBEDTLS_TLS_DHE_PSK_WITH_NULL_SHA256 0xB4 /**< Weak! */
107#define MBEDTLS_TLS_DHE_PSK_WITH_NULL_SHA384 0xB5 /**< Weak! */
Paul Bakker40afb4b2013-04-19 22:03:30 +0200108
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200109#define MBEDTLS_TLS_RSA_PSK_WITH_AES_128_CBC_SHA256 0xB6
110#define MBEDTLS_TLS_RSA_PSK_WITH_AES_256_CBC_SHA384 0xB7
111#define MBEDTLS_TLS_RSA_PSK_WITH_NULL_SHA256 0xB8 /**< Weak! */
112#define MBEDTLS_TLS_RSA_PSK_WITH_NULL_SHA384 0xB9 /**< Weak! */
Paul Bakker40afb4b2013-04-19 22:03:30 +0200113
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200114#define MBEDTLS_TLS_RSA_WITH_CAMELLIA_128_CBC_SHA256 0xBA /**< TLS 1.2 */
115#define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_128_CBC_SHA256 0xBE /**< TLS 1.2 */
Paul Bakker0c5fac22013-04-19 21:10:51 +0200116
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200117#define MBEDTLS_TLS_RSA_WITH_CAMELLIA_256_CBC_SHA256 0xC0 /**< TLS 1.2 */
118#define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_256_CBC_SHA256 0xC4 /**< TLS 1.2 */
Paul Bakker0c5fac22013-04-19 21:10:51 +0200119
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200120#define MBEDTLS_TLS_ECDH_ECDSA_WITH_NULL_SHA 0xC001 /**< Weak! */
121#define MBEDTLS_TLS_ECDH_ECDSA_WITH_RC4_128_SHA 0xC002 /**< Not in SSL3! */
122#define MBEDTLS_TLS_ECDH_ECDSA_WITH_3DES_EDE_CBC_SHA 0xC003 /**< Not in SSL3! */
123#define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA 0xC004 /**< Not in SSL3! */
124#define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA 0xC005 /**< Not in SSL3! */
Manuel Pégourié-Gonnard25781b22013-12-11 16:17:10 +0100125
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200126#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_NULL_SHA 0xC006 /**< Weak! */
127#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_RC4_128_SHA 0xC007 /**< Not in SSL3! */
128#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_3DES_EDE_CBC_SHA 0xC008 /**< Not in SSL3! */
129#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA 0xC009 /**< Not in SSL3! */
130#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA 0xC00A /**< Not in SSL3! */
Manuel Pégourié-Gonnard32ea60a2013-08-17 17:39:04 +0200131
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200132#define MBEDTLS_TLS_ECDH_RSA_WITH_NULL_SHA 0xC00B /**< Weak! */
133#define MBEDTLS_TLS_ECDH_RSA_WITH_RC4_128_SHA 0xC00C /**< Not in SSL3! */
134#define MBEDTLS_TLS_ECDH_RSA_WITH_3DES_EDE_CBC_SHA 0xC00D /**< Not in SSL3! */
135#define MBEDTLS_TLS_ECDH_RSA_WITH_AES_128_CBC_SHA 0xC00E /**< Not in SSL3! */
136#define MBEDTLS_TLS_ECDH_RSA_WITH_AES_256_CBC_SHA 0xC00F /**< Not in SSL3! */
Manuel Pégourié-Gonnard25781b22013-12-11 16:17:10 +0100137
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200138#define MBEDTLS_TLS_ECDHE_RSA_WITH_NULL_SHA 0xC010 /**< Weak! */
139#define MBEDTLS_TLS_ECDHE_RSA_WITH_RC4_128_SHA 0xC011 /**< Not in SSL3! */
140#define MBEDTLS_TLS_ECDHE_RSA_WITH_3DES_EDE_CBC_SHA 0xC012 /**< Not in SSL3! */
141#define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA 0xC013 /**< Not in SSL3! */
142#define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA 0xC014 /**< Not in SSL3! */
Paul Bakker41c83d32013-03-20 14:39:14 +0100143
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200144#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 0xC023 /**< TLS 1.2 */
145#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384 0xC024 /**< TLS 1.2 */
146#define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA256 0xC025 /**< TLS 1.2 */
147#define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA384 0xC026 /**< TLS 1.2 */
148#define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 0xC027 /**< TLS 1.2 */
149#define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 0xC028 /**< TLS 1.2 */
150#define MBEDTLS_TLS_ECDH_RSA_WITH_AES_128_CBC_SHA256 0xC029 /**< TLS 1.2 */
151#define MBEDTLS_TLS_ECDH_RSA_WITH_AES_256_CBC_SHA384 0xC02A /**< TLS 1.2 */
Paul Bakker0c5fac22013-04-19 21:10:51 +0200152
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200153#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 0xC02B /**< TLS 1.2 */
154#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 0xC02C /**< TLS 1.2 */
155#define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_128_GCM_SHA256 0xC02D /**< TLS 1.2 */
156#define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_256_GCM_SHA384 0xC02E /**< TLS 1.2 */
157#define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 0xC02F /**< TLS 1.2 */
158#define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 0xC030 /**< TLS 1.2 */
159#define MBEDTLS_TLS_ECDH_RSA_WITH_AES_128_GCM_SHA256 0xC031 /**< TLS 1.2 */
160#define MBEDTLS_TLS_ECDH_RSA_WITH_AES_256_GCM_SHA384 0xC032 /**< TLS 1.2 */
Paul Bakkera54e4932013-03-20 15:31:54 +0100161
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200162#define MBEDTLS_TLS_ECDHE_PSK_WITH_RC4_128_SHA 0xC033 /**< Not in SSL3! */
163#define MBEDTLS_TLS_ECDHE_PSK_WITH_3DES_EDE_CBC_SHA 0xC034 /**< Not in SSL3! */
164#define MBEDTLS_TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA 0xC035 /**< Not in SSL3! */
165#define MBEDTLS_TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA 0xC036 /**< Not in SSL3! */
166#define MBEDTLS_TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA256 0xC037 /**< Not in SSL3! */
167#define MBEDTLS_TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA384 0xC038 /**< Not in SSL3! */
168#define MBEDTLS_TLS_ECDHE_PSK_WITH_NULL_SHA 0xC039 /**< Weak! No SSL3! */
169#define MBEDTLS_TLS_ECDHE_PSK_WITH_NULL_SHA256 0xC03A /**< Weak! No SSL3! */
170#define MBEDTLS_TLS_ECDHE_PSK_WITH_NULL_SHA384 0xC03B /**< Weak! No SSL3! */
Manuel Pégourié-Gonnard225d6aa2013-10-11 19:07:56 +0200171
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200172#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_CAMELLIA_128_CBC_SHA256 0xC072 /**< Not in SSL3! */
173#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_CAMELLIA_256_CBC_SHA384 0xC073 /**< Not in SSL3! */
174#define MBEDTLS_TLS_ECDH_ECDSA_WITH_CAMELLIA_128_CBC_SHA256 0xC074 /**< Not in SSL3! */
175#define MBEDTLS_TLS_ECDH_ECDSA_WITH_CAMELLIA_256_CBC_SHA384 0xC075 /**< Not in SSL3! */
176#define MBEDTLS_TLS_ECDHE_RSA_WITH_CAMELLIA_128_CBC_SHA256 0xC076 /**< Not in SSL3! */
177#define MBEDTLS_TLS_ECDHE_RSA_WITH_CAMELLIA_256_CBC_SHA384 0xC077 /**< Not in SSL3! */
178#define MBEDTLS_TLS_ECDH_RSA_WITH_CAMELLIA_128_CBC_SHA256 0xC078 /**< Not in SSL3! */
179#define MBEDTLS_TLS_ECDH_RSA_WITH_CAMELLIA_256_CBC_SHA384 0xC079 /**< Not in SSL3! */
Paul Bakker27714b12013-04-07 23:07:12 +0200180
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200181#define MBEDTLS_TLS_RSA_WITH_CAMELLIA_128_GCM_SHA256 0xC07A /**< TLS 1.2 */
182#define MBEDTLS_TLS_RSA_WITH_CAMELLIA_256_GCM_SHA384 0xC07B /**< TLS 1.2 */
183#define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_128_GCM_SHA256 0xC07C /**< TLS 1.2 */
184#define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_256_GCM_SHA384 0xC07D /**< TLS 1.2 */
185#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_CAMELLIA_128_GCM_SHA256 0xC086 /**< TLS 1.2 */
186#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_CAMELLIA_256_GCM_SHA384 0xC087 /**< TLS 1.2 */
187#define MBEDTLS_TLS_ECDH_ECDSA_WITH_CAMELLIA_128_GCM_SHA256 0xC088 /**< TLS 1.2 */
188#define MBEDTLS_TLS_ECDH_ECDSA_WITH_CAMELLIA_256_GCM_SHA384 0xC089 /**< TLS 1.2 */
189#define MBEDTLS_TLS_ECDHE_RSA_WITH_CAMELLIA_128_GCM_SHA256 0xC08A /**< TLS 1.2 */
190#define MBEDTLS_TLS_ECDHE_RSA_WITH_CAMELLIA_256_GCM_SHA384 0xC08B /**< TLS 1.2 */
191#define MBEDTLS_TLS_ECDH_RSA_WITH_CAMELLIA_128_GCM_SHA256 0xC08C /**< TLS 1.2 */
192#define MBEDTLS_TLS_ECDH_RSA_WITH_CAMELLIA_256_GCM_SHA384 0xC08D /**< TLS 1.2 */
Manuel Pégourié-Gonnard8d01eea2013-10-24 19:49:07 +0200193
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200194#define MBEDTLS_TLS_PSK_WITH_CAMELLIA_128_GCM_SHA256 0xC08E /**< TLS 1.2 */
195#define MBEDTLS_TLS_PSK_WITH_CAMELLIA_256_GCM_SHA384 0xC08F /**< TLS 1.2 */
196#define MBEDTLS_TLS_DHE_PSK_WITH_CAMELLIA_128_GCM_SHA256 0xC090 /**< TLS 1.2 */
197#define MBEDTLS_TLS_DHE_PSK_WITH_CAMELLIA_256_GCM_SHA384 0xC091 /**< TLS 1.2 */
198#define MBEDTLS_TLS_RSA_PSK_WITH_CAMELLIA_128_GCM_SHA256 0xC092 /**< TLS 1.2 */
199#define MBEDTLS_TLS_RSA_PSK_WITH_CAMELLIA_256_GCM_SHA384 0xC093 /**< TLS 1.2 */
Manuel Pégourié-Gonnard8d01eea2013-10-24 19:49:07 +0200200
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200201#define MBEDTLS_TLS_PSK_WITH_CAMELLIA_128_CBC_SHA256 0xC094
202#define MBEDTLS_TLS_PSK_WITH_CAMELLIA_256_CBC_SHA384 0xC095
203#define MBEDTLS_TLS_DHE_PSK_WITH_CAMELLIA_128_CBC_SHA256 0xC096
204#define MBEDTLS_TLS_DHE_PSK_WITH_CAMELLIA_256_CBC_SHA384 0xC097
205#define MBEDTLS_TLS_RSA_PSK_WITH_CAMELLIA_128_CBC_SHA256 0xC098
206#define MBEDTLS_TLS_RSA_PSK_WITH_CAMELLIA_256_CBC_SHA384 0xC099
207#define MBEDTLS_TLS_ECDHE_PSK_WITH_CAMELLIA_128_CBC_SHA256 0xC09A /**< Not in SSL3! */
208#define MBEDTLS_TLS_ECDHE_PSK_WITH_CAMELLIA_256_CBC_SHA384 0xC09B /**< Not in SSL3! */
Paul Bakker0f2f0bf2013-07-26 15:03:31 +0200209
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200210#define MBEDTLS_TLS_RSA_WITH_AES_128_CCM 0xC09C /**< TLS 1.2 */
211#define MBEDTLS_TLS_RSA_WITH_AES_256_CCM 0xC09D /**< TLS 1.2 */
212#define MBEDTLS_TLS_DHE_RSA_WITH_AES_128_CCM 0xC09E /**< TLS 1.2 */
213#define MBEDTLS_TLS_DHE_RSA_WITH_AES_256_CCM 0xC09F /**< TLS 1.2 */
214#define MBEDTLS_TLS_RSA_WITH_AES_128_CCM_8 0xC0A0 /**< TLS 1.2 */
215#define MBEDTLS_TLS_RSA_WITH_AES_256_CCM_8 0xC0A1 /**< TLS 1.2 */
216#define MBEDTLS_TLS_DHE_RSA_WITH_AES_128_CCM_8 0xC0A2 /**< TLS 1.2 */
217#define MBEDTLS_TLS_DHE_RSA_WITH_AES_256_CCM_8 0xC0A3 /**< TLS 1.2 */
218#define MBEDTLS_TLS_PSK_WITH_AES_128_CCM 0xC0A4 /**< TLS 1.2 */
219#define MBEDTLS_TLS_PSK_WITH_AES_256_CCM 0xC0A5 /**< TLS 1.2 */
220#define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_CCM 0xC0A6 /**< TLS 1.2 */
221#define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_CCM 0xC0A7 /**< TLS 1.2 */
222#define MBEDTLS_TLS_PSK_WITH_AES_128_CCM_8 0xC0A8 /**< TLS 1.2 */
223#define MBEDTLS_TLS_PSK_WITH_AES_256_CCM_8 0xC0A9 /**< TLS 1.2 */
224#define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_CCM_8 0xC0AA /**< TLS 1.2 */
225#define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_CCM_8 0xC0AB /**< TLS 1.2 */
Manuel Pégourié-Gonnard6768da92014-05-14 12:26:51 +0200226/* The last two are named with PSK_DHE in the RFC, which looks like a typo */
227
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200228#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_CCM 0xC0AC /**< TLS 1.2 */
229#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_CCM 0xC0AD /**< TLS 1.2 */
230#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_CCM_8 0xC0AE /**< TLS 1.2 */
231#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_CCM_8 0xC0AF /**< TLS 1.2 */
Manuel Pégourié-Gonnard6768da92014-05-14 12:26:51 +0200232
Manuel Pégourié-Gonnard538cb7b2015-09-15 18:03:28 +0200233#define MBEDTLS_TLS_ECJPAKE_WITH_AES_128_CCM_8 0xC0FF /**< experimental */
234
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200235/* Reminder: update mbedtls_ssl_premaster_secret when adding a new key exchange.
Manuel Pégourié-Gonnardadeb7d82015-10-09 14:44:47 +0100236 * Reminder: update MBEDTLS_KEY_EXCHANGE__xxx below
Manuel Pégourié-Gonnardd9423232014-12-02 11:57:29 +0100237 */
Paul Bakker68884e32013-01-07 18:20:04 +0100238typedef enum {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200239 MBEDTLS_KEY_EXCHANGE_NONE = 0,
240 MBEDTLS_KEY_EXCHANGE_RSA,
241 MBEDTLS_KEY_EXCHANGE_DHE_RSA,
242 MBEDTLS_KEY_EXCHANGE_ECDHE_RSA,
243 MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA,
244 MBEDTLS_KEY_EXCHANGE_PSK,
245 MBEDTLS_KEY_EXCHANGE_DHE_PSK,
246 MBEDTLS_KEY_EXCHANGE_RSA_PSK,
247 MBEDTLS_KEY_EXCHANGE_ECDHE_PSK,
248 MBEDTLS_KEY_EXCHANGE_ECDH_RSA,
249 MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA,
Manuel Pégourié-Gonnard557535d2015-09-15 17:53:32 +0200250 MBEDTLS_KEY_EXCHANGE_ECJPAKE,
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200251} mbedtls_key_exchange_type_t;
Paul Bakker68884e32013-01-07 18:20:04 +0100252
Manuel Pégourié-Gonnarde5f30722015-10-22 17:01:15 +0200253/* Key exchanges using a certificate */
Manuel Pégourié-Gonnardadeb7d82015-10-09 14:44:47 +0100254#if defined(MBEDTLS_KEY_EXCHANGE_RSA_ENABLED) || \
255 defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED) || \
256 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
257 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED) || \
258 defined(MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED) || \
Manuel Pégourié-Gonnardadeb7d82015-10-09 14:44:47 +0100259 defined(MBEDTLS_KEY_EXCHANGE_ECDH_RSA_ENABLED) || \
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200260 defined(MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA_ENABLED)
261#define MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED
Manuel Pégourié-Gonnardd9423232014-12-02 11:57:29 +0100262#endif
263
Hanno Becker1aa267c2017-04-28 17:08:27 +0100264/* Key exchanges allowing client certificate requests */
265#if defined(MBEDTLS_KEY_EXCHANGE_RSA_ENABLED) || \
266 defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED) || \
267 defined(MBEDTLS_KEY_EXCHANGE_ECDH_RSA_ENABLED) || \
268 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
269 defined(MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA_ENABLED) || \
270 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED)
271#define MBEDTLS_KEY_EXCHANGE__CERT_REQ_ALLOWED__ENABLED
272#endif
273
274/* Key exchanges involving server signature in ServerKeyExchange */
275#if defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED) || \
276 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
277 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED)
278#define MBEDTLS_KEY_EXCHANGE__WITH_SERVER_SIGNATURE__ENABLED
279#endif
280
281/* Key exchanges using ECDH */
282#if defined(MBEDTLS_KEY_EXCHANGE_ECDH_RSA_ENABLED) || \
283 defined(MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA_ENABLED)
284#define MBEDTLS_KEY_EXCHANGE__SOME__ECDH_ENABLED
285#endif
286
287/* Key exchanges that don't involve ephemeral keys */
288#if defined(MBEDTLS_KEY_EXCHANGE_RSA_ENABLED) || \
289 defined(MBEDTLS_KEY_EXCHANGE_PSK_ENABLED) || \
290 defined(MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED) || \
291 defined(MBEDTLS_KEY_EXCHANGE__SOME__ECDH_ENABLED)
292#define MBEDTLS_KEY_EXCHANGE__SOME_NON_PFS__ENABLED
293#endif
294
295/* Key exchanges that involve ephemeral keys */
296#if defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED) || \
297 defined(MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED) || \
298 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
299 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED) || \
300 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED) || \
301 defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
302#define MBEDTLS_KEY_EXCHANGE__SOME_PFS__ENABLED
303#endif
304
Manuel Pégourié-Gonnarde5f30722015-10-22 17:01:15 +0200305/* Key exchanges using a PSK */
Manuel Pégourié-Gonnardadeb7d82015-10-09 14:44:47 +0100306#if defined(MBEDTLS_KEY_EXCHANGE_PSK_ENABLED) || \
307 defined(MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED) || \
308 defined(MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED) || \
309 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED)
310#define MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED
311#endif
312
Hanno Becker1aa267c2017-04-28 17:08:27 +0100313/* Key exchanges using DHE */
314#if defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED) || \
315 defined(MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED)
316#define MBEDTLS_KEY_EXCHANGE__SOME__DHE_ENABLED
317#endif
318
319/* Key exchanges using ECDHE */
Manuel Pégourié-Gonnardadeb7d82015-10-09 14:44:47 +0100320#if defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
321 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED) || \
322 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED)
323#define MBEDTLS_KEY_EXCHANGE__SOME__ECDHE_ENABLED
324#endif
325
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200326typedef struct mbedtls_ssl_ciphersuite_t mbedtls_ssl_ciphersuite_t;
Paul Bakker68884e32013-01-07 18:20:04 +0100327
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200328#define MBEDTLS_CIPHERSUITE_WEAK 0x01 /**< Weak ciphersuite flag */
329#define MBEDTLS_CIPHERSUITE_SHORT_TAG 0x02 /**< Short authentication tag,
Manuel Pégourié-Gonnard6768da92014-05-14 12:26:51 +0200330 eg for CCM_8 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200331#define MBEDTLS_CIPHERSUITE_NODTLS 0x04 /**< Can't be used with DTLS */
Paul Bakker68884e32013-01-07 18:20:04 +0100332
333/**
334 * \brief This structure is used for storing ciphersuite information
335 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200336struct mbedtls_ssl_ciphersuite_t
Paul Bakker68884e32013-01-07 18:20:04 +0100337{
338 int id;
339 const char * name;
340
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200341 mbedtls_cipher_type_t cipher;
342 mbedtls_md_type_t mac;
343 mbedtls_key_exchange_type_t key_exchange;
Paul Bakker68884e32013-01-07 18:20:04 +0100344
345 int min_major_ver;
346 int min_minor_ver;
347 int max_major_ver;
348 int max_minor_ver;
349
350 unsigned char flags;
351};
352
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200353const int *mbedtls_ssl_list_ciphersuites( void );
Paul Bakker68884e32013-01-07 18:20:04 +0100354
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200355const mbedtls_ssl_ciphersuite_t *mbedtls_ssl_ciphersuite_from_string( const char *ciphersuite_name );
356const mbedtls_ssl_ciphersuite_t *mbedtls_ssl_ciphersuite_from_id( int ciphersuite_id );
Paul Bakker68884e32013-01-07 18:20:04 +0100357
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200358#if defined(MBEDTLS_PK_C)
359mbedtls_pk_type_t mbedtls_ssl_get_ciphersuite_sig_pk_alg( const mbedtls_ssl_ciphersuite_t *info );
Hanno Becker7e5437a2017-04-28 17:15:26 +0100360mbedtls_pk_type_t mbedtls_ssl_get_ciphersuite_sig_alg( const mbedtls_ssl_ciphersuite_t *info );
Manuel Pégourié-Gonnard1a483832013-09-20 12:29:15 +0200361#endif
Manuel Pégourié-Gonnard09edda82013-08-19 13:50:33 +0200362
Hanno Beckerd300a572017-06-20 14:31:29 +0100363int mbedtls_ssl_ciphersuite_uses_ec( const mbedtls_ssl_ciphersuite_t *info );
364int mbedtls_ssl_ciphersuite_uses_psk( const mbedtls_ssl_ciphersuite_t *info );
Hanno Becker1aa267c2017-04-28 17:08:27 +0100365
366#if defined(MBEDTLS_KEY_EXCHANGE__SOME_PFS__ENABLED)
367static inline int mbedtls_ssl_ciphersuite_has_pfs( const mbedtls_ssl_ciphersuite_t *info )
368{
369 switch( info->key_exchange )
370 {
371 case MBEDTLS_KEY_EXCHANGE_DHE_RSA:
372 case MBEDTLS_KEY_EXCHANGE_DHE_PSK:
373 case MBEDTLS_KEY_EXCHANGE_ECDHE_RSA:
374 case MBEDTLS_KEY_EXCHANGE_ECDHE_PSK:
375 case MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA:
376 case MBEDTLS_KEY_EXCHANGE_ECJPAKE:
377 return( 1 );
378
379 default:
380 return( 0 );
381 }
382}
383#endif /* MBEDTLS_KEY_EXCHANGE__SOME_PFS__ENABLED */
384
385#if defined(MBEDTLS_KEY_EXCHANGE__SOME_NON_PFS__ENABLED)
386static inline int mbedtls_ssl_ciphersuite_no_pfs( const mbedtls_ssl_ciphersuite_t *info )
387{
388 switch( info->key_exchange )
389 {
390 case MBEDTLS_KEY_EXCHANGE_ECDH_RSA:
391 case MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA:
392 case MBEDTLS_KEY_EXCHANGE_RSA:
393 case MBEDTLS_KEY_EXCHANGE_PSK:
394 case MBEDTLS_KEY_EXCHANGE_RSA_PSK:
395 return( 1 );
396
397 default:
398 return( 0 );
399 }
400}
401#endif /* MBEDTLS_KEY_EXCHANGE__SOME_NON_PFS__ENABLED */
402
403#if defined(MBEDTLS_KEY_EXCHANGE__SOME__ECDH_ENABLED)
404static inline int mbedtls_ssl_ciphersuite_uses_ecdh( const mbedtls_ssl_ciphersuite_t *info )
405{
406 switch( info->key_exchange )
407 {
408 case MBEDTLS_KEY_EXCHANGE_ECDH_RSA:
409 case MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA:
410 return( 1 );
411
412 default:
413 return( 0 );
414 }
415}
416#endif /* MBEDTLS_KEY_EXCHANGE__SOME__ECDH_ENABLED */
417
Hanno Becker1aa267c2017-04-28 17:08:27 +0100418static inline int mbedtls_ssl_ciphersuite_cert_req_allowed( const mbedtls_ssl_ciphersuite_t *info )
419{
420 switch( info->key_exchange )
421 {
422 case MBEDTLS_KEY_EXCHANGE_RSA:
423 case MBEDTLS_KEY_EXCHANGE_DHE_RSA:
424 case MBEDTLS_KEY_EXCHANGE_ECDH_RSA:
425 case MBEDTLS_KEY_EXCHANGE_ECDHE_RSA:
426 case MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA:
427 case MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA:
428 return( 1 );
429
430 default:
431 return( 0 );
432 }
433}
434
435#if defined(MBEDTLS_KEY_EXCHANGE__SOME__DHE_ENABLED)
436static inline int mbedtls_ssl_ciphersuite_uses_dhe( const mbedtls_ssl_ciphersuite_t *info )
437{
438 switch( info->key_exchange )
439 {
440 case MBEDTLS_KEY_EXCHANGE_DHE_RSA:
441 case MBEDTLS_KEY_EXCHANGE_DHE_PSK:
442 return( 1 );
443
444 default:
445 return( 0 );
446 }
447}
448#endif /* MBEDTLS_KEY_EXCHANGE__SOME__DHE_ENABLED) */
449
450#if defined(MBEDTLS_KEY_EXCHANGE__SOME__ECDHE_ENABLED)
451static inline int mbedtls_ssl_ciphersuite_uses_ecdhe( const mbedtls_ssl_ciphersuite_t *info )
452{
453 switch( info->key_exchange )
454 {
455 case MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA:
456 case MBEDTLS_KEY_EXCHANGE_ECDHE_RSA:
457 case MBEDTLS_KEY_EXCHANGE_ECDHE_PSK:
458 return( 1 );
459
460 default:
461 return( 0 );
462 }
463}
464#endif /* MBEDTLS_KEY_EXCHANGE__SOME__ECDHE_ENABLED) */
465
466#if defined(MBEDTLS_KEY_EXCHANGE__WITH_SERVER_SIGNATURE__ENABLED)
467static inline int mbedtls_ssl_ciphersuite_uses_server_signature( const mbedtls_ssl_ciphersuite_t *info )
468{
469 switch( info->key_exchange )
470 {
471 case MBEDTLS_KEY_EXCHANGE_DHE_RSA:
472 case MBEDTLS_KEY_EXCHANGE_ECDHE_RSA:
473 case MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA:
474 return( 1 );
475
476 default:
477 return( 0 );
478 }
479}
480#endif /* MBEDTLS_KEY_EXCHANGE__WITH_SERVER_SIGNATURE__ENABLED */
Manuel Pégourié-Gonnard51451f82013-09-17 12:06:25 +0200481
Paul Bakker68884e32013-01-07 18:20:04 +0100482#ifdef __cplusplus
483}
484#endif
485
486#endif /* ssl_ciphersuites.h */