blob: 8e7b7943c77a63bf2ccf4d827560d72e2e6eac8e [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
Paul Bakker68884e32013-01-07 18:20:04 +01005 *
Manuel Pégourié-Gonnard6fb81872015-07-27 11:11:48 +02006 * Copyright (C) 2006-2015, ARM Limited, All Rights Reserved
Manuel Pégourié-Gonnard37ff1402015-09-04 14:21:07 +02007 * SPDX-License-Identifier: Apache-2.0
8 *
9 * Licensed under the Apache License, Version 2.0 (the "License"); you may
10 * not use this file except in compliance with the License.
11 * You may obtain a copy of the License at
12 *
13 * http://www.apache.org/licenses/LICENSE-2.0
14 *
15 * Unless required by applicable law or agreed to in writing, software
16 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
17 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
18 * See the License for the specific language governing permissions and
19 * limitations under the License.
Paul Bakker68884e32013-01-07 18:20:04 +010020 *
Manuel Pégourié-Gonnardfe446432015-03-06 13:17:10 +000021 * This file is part of mbed TLS (https://tls.mbed.org)
Paul Bakker68884e32013-01-07 18:20:04 +010022 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020023#ifndef MBEDTLS_SSL_CIPHERSUITES_H
24#define MBEDTLS_SSL_CIPHERSUITES_H
Paul Bakker68884e32013-01-07 18:20:04 +010025
Manuel Pégourié-Gonnard09edda82013-08-19 13:50:33 +020026#include "pk.h"
Paul Bakker68884e32013-01-07 18:20:04 +010027#include "cipher.h"
28#include "md.h"
29
30#ifdef __cplusplus
31extern "C" {
32#endif
33
Paul Bakker41c83d32013-03-20 14:39:14 +010034/*
35 * Supported ciphersuites (Official IANA names)
36 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020037#define MBEDTLS_TLS_RSA_WITH_NULL_MD5 0x01 /**< Weak! */
38#define MBEDTLS_TLS_RSA_WITH_NULL_SHA 0x02 /**< Weak! */
Paul Bakker41c83d32013-03-20 14:39:14 +010039
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020040#define MBEDTLS_TLS_RSA_WITH_RC4_128_MD5 0x04
41#define MBEDTLS_TLS_RSA_WITH_RC4_128_SHA 0x05
42#define MBEDTLS_TLS_RSA_WITH_DES_CBC_SHA 0x09 /**< Weak! Not in TLS 1.2 */
Paul Bakker41c83d32013-03-20 14:39:14 +010043
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020044#define MBEDTLS_TLS_RSA_WITH_3DES_EDE_CBC_SHA 0x0A
Paul Bakker0c5fac22013-04-19 21:10:51 +020045
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020046#define MBEDTLS_TLS_DHE_RSA_WITH_DES_CBC_SHA 0x15 /**< Weak! Not in TLS 1.2 */
47#define MBEDTLS_TLS_DHE_RSA_WITH_3DES_EDE_CBC_SHA 0x16
Paul Bakker41c83d32013-03-20 14:39:14 +010048
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020049#define MBEDTLS_TLS_PSK_WITH_NULL_SHA 0x2C /**< Weak! */
50#define MBEDTLS_TLS_DHE_PSK_WITH_NULL_SHA 0x2D /**< Weak! */
51#define MBEDTLS_TLS_RSA_PSK_WITH_NULL_SHA 0x2E /**< Weak! */
52#define MBEDTLS_TLS_RSA_WITH_AES_128_CBC_SHA 0x2F
Paul Bakker0c5fac22013-04-19 21:10:51 +020053
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020054#define MBEDTLS_TLS_DHE_RSA_WITH_AES_128_CBC_SHA 0x33
55#define MBEDTLS_TLS_RSA_WITH_AES_256_CBC_SHA 0x35
56#define MBEDTLS_TLS_DHE_RSA_WITH_AES_256_CBC_SHA 0x39
Paul Bakkerd4a56ec2013-04-16 18:05:29 +020057
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020058#define MBEDTLS_TLS_RSA_WITH_NULL_SHA256 0x3B /**< Weak! */
59#define MBEDTLS_TLS_RSA_WITH_AES_128_CBC_SHA256 0x3C /**< TLS 1.2 */
60#define MBEDTLS_TLS_RSA_WITH_AES_256_CBC_SHA256 0x3D /**< TLS 1.2 */
Paul Bakker41c83d32013-03-20 14:39:14 +010061
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020062#define MBEDTLS_TLS_RSA_WITH_CAMELLIA_128_CBC_SHA 0x41
63#define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_128_CBC_SHA 0x45
Paul Bakker0c5fac22013-04-19 21:10:51 +020064
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020065#define MBEDTLS_TLS_DHE_RSA_WITH_AES_128_CBC_SHA256 0x67 /**< TLS 1.2 */
66#define MBEDTLS_TLS_DHE_RSA_WITH_AES_256_CBC_SHA256 0x6B /**< TLS 1.2 */
Paul Bakker0c5fac22013-04-19 21:10:51 +020067
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020068#define MBEDTLS_TLS_RSA_WITH_CAMELLIA_256_CBC_SHA 0x84
69#define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_256_CBC_SHA 0x88
Paul Bakkerd4a56ec2013-04-16 18:05:29 +020070
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020071#define MBEDTLS_TLS_PSK_WITH_RC4_128_SHA 0x8A
72#define MBEDTLS_TLS_PSK_WITH_3DES_EDE_CBC_SHA 0x8B
73#define MBEDTLS_TLS_PSK_WITH_AES_128_CBC_SHA 0x8C
74#define MBEDTLS_TLS_PSK_WITH_AES_256_CBC_SHA 0x8D
Paul Bakkerd4a56ec2013-04-16 18:05:29 +020075
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020076#define MBEDTLS_TLS_DHE_PSK_WITH_RC4_128_SHA 0x8E
77#define MBEDTLS_TLS_DHE_PSK_WITH_3DES_EDE_CBC_SHA 0x8F
78#define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_CBC_SHA 0x90
79#define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_CBC_SHA 0x91
Paul Bakkerd4a56ec2013-04-16 18:05:29 +020080
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020081#define MBEDTLS_TLS_RSA_PSK_WITH_RC4_128_SHA 0x92
82#define MBEDTLS_TLS_RSA_PSK_WITH_3DES_EDE_CBC_SHA 0x93
83#define MBEDTLS_TLS_RSA_PSK_WITH_AES_128_CBC_SHA 0x94
84#define MBEDTLS_TLS_RSA_PSK_WITH_AES_256_CBC_SHA 0x95
Paul Bakkerd4a56ec2013-04-16 18:05:29 +020085
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020086#define MBEDTLS_TLS_RSA_WITH_AES_128_GCM_SHA256 0x9C /**< TLS 1.2 */
87#define MBEDTLS_TLS_RSA_WITH_AES_256_GCM_SHA384 0x9D /**< TLS 1.2 */
88#define MBEDTLS_TLS_DHE_RSA_WITH_AES_128_GCM_SHA256 0x9E /**< TLS 1.2 */
89#define MBEDTLS_TLS_DHE_RSA_WITH_AES_256_GCM_SHA384 0x9F /**< TLS 1.2 */
Paul Bakker41c83d32013-03-20 14:39:14 +010090
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020091#define MBEDTLS_TLS_PSK_WITH_AES_128_GCM_SHA256 0xA8 /**< TLS 1.2 */
92#define MBEDTLS_TLS_PSK_WITH_AES_256_GCM_SHA384 0xA9 /**< TLS 1.2 */
93#define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_GCM_SHA256 0xAA /**< TLS 1.2 */
94#define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_GCM_SHA384 0xAB /**< TLS 1.2 */
95#define MBEDTLS_TLS_RSA_PSK_WITH_AES_128_GCM_SHA256 0xAC /**< TLS 1.2 */
96#define MBEDTLS_TLS_RSA_PSK_WITH_AES_256_GCM_SHA384 0xAD /**< TLS 1.2 */
Paul Bakker40afb4b2013-04-19 22:03:30 +020097
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +020098#define MBEDTLS_TLS_PSK_WITH_AES_128_CBC_SHA256 0xAE
99#define MBEDTLS_TLS_PSK_WITH_AES_256_CBC_SHA384 0xAF
100#define MBEDTLS_TLS_PSK_WITH_NULL_SHA256 0xB0 /**< Weak! */
101#define MBEDTLS_TLS_PSK_WITH_NULL_SHA384 0xB1 /**< Weak! */
Paul Bakker40afb4b2013-04-19 22:03:30 +0200102
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200103#define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_CBC_SHA256 0xB2
104#define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_CBC_SHA384 0xB3
105#define MBEDTLS_TLS_DHE_PSK_WITH_NULL_SHA256 0xB4 /**< Weak! */
106#define MBEDTLS_TLS_DHE_PSK_WITH_NULL_SHA384 0xB5 /**< Weak! */
Paul Bakker40afb4b2013-04-19 22:03:30 +0200107
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200108#define MBEDTLS_TLS_RSA_PSK_WITH_AES_128_CBC_SHA256 0xB6
109#define MBEDTLS_TLS_RSA_PSK_WITH_AES_256_CBC_SHA384 0xB7
110#define MBEDTLS_TLS_RSA_PSK_WITH_NULL_SHA256 0xB8 /**< Weak! */
111#define MBEDTLS_TLS_RSA_PSK_WITH_NULL_SHA384 0xB9 /**< Weak! */
Paul Bakker40afb4b2013-04-19 22:03:30 +0200112
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200113#define MBEDTLS_TLS_RSA_WITH_CAMELLIA_128_CBC_SHA256 0xBA /**< TLS 1.2 */
114#define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_128_CBC_SHA256 0xBE /**< TLS 1.2 */
Paul Bakker0c5fac22013-04-19 21:10:51 +0200115
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200116#define MBEDTLS_TLS_RSA_WITH_CAMELLIA_256_CBC_SHA256 0xC0 /**< TLS 1.2 */
117#define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_256_CBC_SHA256 0xC4 /**< TLS 1.2 */
Paul Bakker0c5fac22013-04-19 21:10:51 +0200118
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200119#define MBEDTLS_TLS_ECDH_ECDSA_WITH_NULL_SHA 0xC001 /**< Weak! */
120#define MBEDTLS_TLS_ECDH_ECDSA_WITH_RC4_128_SHA 0xC002 /**< Not in SSL3! */
121#define MBEDTLS_TLS_ECDH_ECDSA_WITH_3DES_EDE_CBC_SHA 0xC003 /**< Not in SSL3! */
122#define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA 0xC004 /**< Not in SSL3! */
123#define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA 0xC005 /**< Not in SSL3! */
Manuel Pégourié-Gonnard25781b22013-12-11 16:17:10 +0100124
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200125#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_NULL_SHA 0xC006 /**< Weak! */
126#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_RC4_128_SHA 0xC007 /**< Not in SSL3! */
127#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_3DES_EDE_CBC_SHA 0xC008 /**< Not in SSL3! */
128#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA 0xC009 /**< Not in SSL3! */
129#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA 0xC00A /**< Not in SSL3! */
Manuel Pégourié-Gonnard32ea60a2013-08-17 17:39:04 +0200130
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200131#define MBEDTLS_TLS_ECDH_RSA_WITH_NULL_SHA 0xC00B /**< Weak! */
132#define MBEDTLS_TLS_ECDH_RSA_WITH_RC4_128_SHA 0xC00C /**< Not in SSL3! */
133#define MBEDTLS_TLS_ECDH_RSA_WITH_3DES_EDE_CBC_SHA 0xC00D /**< Not in SSL3! */
134#define MBEDTLS_TLS_ECDH_RSA_WITH_AES_128_CBC_SHA 0xC00E /**< Not in SSL3! */
135#define MBEDTLS_TLS_ECDH_RSA_WITH_AES_256_CBC_SHA 0xC00F /**< Not in SSL3! */
Manuel Pégourié-Gonnard25781b22013-12-11 16:17:10 +0100136
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200137#define MBEDTLS_TLS_ECDHE_RSA_WITH_NULL_SHA 0xC010 /**< Weak! */
138#define MBEDTLS_TLS_ECDHE_RSA_WITH_RC4_128_SHA 0xC011 /**< Not in SSL3! */
139#define MBEDTLS_TLS_ECDHE_RSA_WITH_3DES_EDE_CBC_SHA 0xC012 /**< Not in SSL3! */
140#define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA 0xC013 /**< Not in SSL3! */
141#define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA 0xC014 /**< Not in SSL3! */
Paul Bakker41c83d32013-03-20 14:39:14 +0100142
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200143#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 0xC023 /**< TLS 1.2 */
144#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384 0xC024 /**< TLS 1.2 */
145#define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA256 0xC025 /**< TLS 1.2 */
146#define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA384 0xC026 /**< TLS 1.2 */
147#define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 0xC027 /**< TLS 1.2 */
148#define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 0xC028 /**< TLS 1.2 */
149#define MBEDTLS_TLS_ECDH_RSA_WITH_AES_128_CBC_SHA256 0xC029 /**< TLS 1.2 */
150#define MBEDTLS_TLS_ECDH_RSA_WITH_AES_256_CBC_SHA384 0xC02A /**< TLS 1.2 */
Paul Bakker0c5fac22013-04-19 21:10:51 +0200151
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200152#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 0xC02B /**< TLS 1.2 */
153#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 0xC02C /**< TLS 1.2 */
154#define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_128_GCM_SHA256 0xC02D /**< TLS 1.2 */
155#define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_256_GCM_SHA384 0xC02E /**< TLS 1.2 */
156#define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 0xC02F /**< TLS 1.2 */
157#define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 0xC030 /**< TLS 1.2 */
158#define MBEDTLS_TLS_ECDH_RSA_WITH_AES_128_GCM_SHA256 0xC031 /**< TLS 1.2 */
159#define MBEDTLS_TLS_ECDH_RSA_WITH_AES_256_GCM_SHA384 0xC032 /**< TLS 1.2 */
Paul Bakkera54e4932013-03-20 15:31:54 +0100160
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200161#define MBEDTLS_TLS_ECDHE_PSK_WITH_RC4_128_SHA 0xC033 /**< Not in SSL3! */
162#define MBEDTLS_TLS_ECDHE_PSK_WITH_3DES_EDE_CBC_SHA 0xC034 /**< Not in SSL3! */
163#define MBEDTLS_TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA 0xC035 /**< Not in SSL3! */
164#define MBEDTLS_TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA 0xC036 /**< Not in SSL3! */
165#define MBEDTLS_TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA256 0xC037 /**< Not in SSL3! */
166#define MBEDTLS_TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA384 0xC038 /**< Not in SSL3! */
167#define MBEDTLS_TLS_ECDHE_PSK_WITH_NULL_SHA 0xC039 /**< Weak! No SSL3! */
168#define MBEDTLS_TLS_ECDHE_PSK_WITH_NULL_SHA256 0xC03A /**< Weak! No SSL3! */
169#define MBEDTLS_TLS_ECDHE_PSK_WITH_NULL_SHA384 0xC03B /**< Weak! No SSL3! */
Manuel Pégourié-Gonnard225d6aa2013-10-11 19:07:56 +0200170
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200171#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_CAMELLIA_128_CBC_SHA256 0xC072 /**< Not in SSL3! */
172#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_CAMELLIA_256_CBC_SHA384 0xC073 /**< Not in SSL3! */
173#define MBEDTLS_TLS_ECDH_ECDSA_WITH_CAMELLIA_128_CBC_SHA256 0xC074 /**< Not in SSL3! */
174#define MBEDTLS_TLS_ECDH_ECDSA_WITH_CAMELLIA_256_CBC_SHA384 0xC075 /**< Not in SSL3! */
175#define MBEDTLS_TLS_ECDHE_RSA_WITH_CAMELLIA_128_CBC_SHA256 0xC076 /**< Not in SSL3! */
176#define MBEDTLS_TLS_ECDHE_RSA_WITH_CAMELLIA_256_CBC_SHA384 0xC077 /**< Not in SSL3! */
177#define MBEDTLS_TLS_ECDH_RSA_WITH_CAMELLIA_128_CBC_SHA256 0xC078 /**< Not in SSL3! */
178#define MBEDTLS_TLS_ECDH_RSA_WITH_CAMELLIA_256_CBC_SHA384 0xC079 /**< Not in SSL3! */
Paul Bakker27714b12013-04-07 23:07:12 +0200179
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200180#define MBEDTLS_TLS_RSA_WITH_CAMELLIA_128_GCM_SHA256 0xC07A /**< TLS 1.2 */
181#define MBEDTLS_TLS_RSA_WITH_CAMELLIA_256_GCM_SHA384 0xC07B /**< TLS 1.2 */
182#define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_128_GCM_SHA256 0xC07C /**< TLS 1.2 */
183#define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_256_GCM_SHA384 0xC07D /**< TLS 1.2 */
184#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_CAMELLIA_128_GCM_SHA256 0xC086 /**< TLS 1.2 */
185#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_CAMELLIA_256_GCM_SHA384 0xC087 /**< TLS 1.2 */
186#define MBEDTLS_TLS_ECDH_ECDSA_WITH_CAMELLIA_128_GCM_SHA256 0xC088 /**< TLS 1.2 */
187#define MBEDTLS_TLS_ECDH_ECDSA_WITH_CAMELLIA_256_GCM_SHA384 0xC089 /**< TLS 1.2 */
188#define MBEDTLS_TLS_ECDHE_RSA_WITH_CAMELLIA_128_GCM_SHA256 0xC08A /**< TLS 1.2 */
189#define MBEDTLS_TLS_ECDHE_RSA_WITH_CAMELLIA_256_GCM_SHA384 0xC08B /**< TLS 1.2 */
190#define MBEDTLS_TLS_ECDH_RSA_WITH_CAMELLIA_128_GCM_SHA256 0xC08C /**< TLS 1.2 */
191#define MBEDTLS_TLS_ECDH_RSA_WITH_CAMELLIA_256_GCM_SHA384 0xC08D /**< TLS 1.2 */
Manuel Pégourié-Gonnard8d01eea2013-10-24 19:49:07 +0200192
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200193#define MBEDTLS_TLS_PSK_WITH_CAMELLIA_128_GCM_SHA256 0xC08E /**< TLS 1.2 */
194#define MBEDTLS_TLS_PSK_WITH_CAMELLIA_256_GCM_SHA384 0xC08F /**< TLS 1.2 */
195#define MBEDTLS_TLS_DHE_PSK_WITH_CAMELLIA_128_GCM_SHA256 0xC090 /**< TLS 1.2 */
196#define MBEDTLS_TLS_DHE_PSK_WITH_CAMELLIA_256_GCM_SHA384 0xC091 /**< TLS 1.2 */
197#define MBEDTLS_TLS_RSA_PSK_WITH_CAMELLIA_128_GCM_SHA256 0xC092 /**< TLS 1.2 */
198#define MBEDTLS_TLS_RSA_PSK_WITH_CAMELLIA_256_GCM_SHA384 0xC093 /**< TLS 1.2 */
Manuel Pégourié-Gonnard8d01eea2013-10-24 19:49:07 +0200199
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200200#define MBEDTLS_TLS_PSK_WITH_CAMELLIA_128_CBC_SHA256 0xC094
201#define MBEDTLS_TLS_PSK_WITH_CAMELLIA_256_CBC_SHA384 0xC095
202#define MBEDTLS_TLS_DHE_PSK_WITH_CAMELLIA_128_CBC_SHA256 0xC096
203#define MBEDTLS_TLS_DHE_PSK_WITH_CAMELLIA_256_CBC_SHA384 0xC097
204#define MBEDTLS_TLS_RSA_PSK_WITH_CAMELLIA_128_CBC_SHA256 0xC098
205#define MBEDTLS_TLS_RSA_PSK_WITH_CAMELLIA_256_CBC_SHA384 0xC099
206#define MBEDTLS_TLS_ECDHE_PSK_WITH_CAMELLIA_128_CBC_SHA256 0xC09A /**< Not in SSL3! */
207#define MBEDTLS_TLS_ECDHE_PSK_WITH_CAMELLIA_256_CBC_SHA384 0xC09B /**< Not in SSL3! */
Paul Bakker0f2f0bf2013-07-26 15:03:31 +0200208
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200209#define MBEDTLS_TLS_RSA_WITH_AES_128_CCM 0xC09C /**< TLS 1.2 */
210#define MBEDTLS_TLS_RSA_WITH_AES_256_CCM 0xC09D /**< TLS 1.2 */
211#define MBEDTLS_TLS_DHE_RSA_WITH_AES_128_CCM 0xC09E /**< TLS 1.2 */
212#define MBEDTLS_TLS_DHE_RSA_WITH_AES_256_CCM 0xC09F /**< TLS 1.2 */
213#define MBEDTLS_TLS_RSA_WITH_AES_128_CCM_8 0xC0A0 /**< TLS 1.2 */
214#define MBEDTLS_TLS_RSA_WITH_AES_256_CCM_8 0xC0A1 /**< TLS 1.2 */
215#define MBEDTLS_TLS_DHE_RSA_WITH_AES_128_CCM_8 0xC0A2 /**< TLS 1.2 */
216#define MBEDTLS_TLS_DHE_RSA_WITH_AES_256_CCM_8 0xC0A3 /**< TLS 1.2 */
217#define MBEDTLS_TLS_PSK_WITH_AES_128_CCM 0xC0A4 /**< TLS 1.2 */
218#define MBEDTLS_TLS_PSK_WITH_AES_256_CCM 0xC0A5 /**< TLS 1.2 */
219#define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_CCM 0xC0A6 /**< TLS 1.2 */
220#define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_CCM 0xC0A7 /**< TLS 1.2 */
221#define MBEDTLS_TLS_PSK_WITH_AES_128_CCM_8 0xC0A8 /**< TLS 1.2 */
222#define MBEDTLS_TLS_PSK_WITH_AES_256_CCM_8 0xC0A9 /**< TLS 1.2 */
223#define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_CCM_8 0xC0AA /**< TLS 1.2 */
224#define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_CCM_8 0xC0AB /**< TLS 1.2 */
Manuel Pégourié-Gonnard6768da92014-05-14 12:26:51 +0200225/* The last two are named with PSK_DHE in the RFC, which looks like a typo */
226
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200227#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_CCM 0xC0AC /**< TLS 1.2 */
228#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_CCM 0xC0AD /**< TLS 1.2 */
229#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_CCM_8 0xC0AE /**< TLS 1.2 */
230#define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_CCM_8 0xC0AF /**< TLS 1.2 */
Manuel Pégourié-Gonnard6768da92014-05-14 12:26:51 +0200231
Manuel Pégourié-Gonnard538cb7b2015-09-15 18:03:28 +0200232#define MBEDTLS_TLS_ECJPAKE_WITH_AES_128_CCM_8 0xC0FF /**< experimental */
233
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200234/* Reminder: update mbedtls_ssl_premaster_secret when adding a new key exchange.
Manuel Pégourié-Gonnardadeb7d82015-10-09 14:44:47 +0100235 * Reminder: update MBEDTLS_KEY_EXCHANGE__xxx below
Manuel Pégourié-Gonnardd9423232014-12-02 11:57:29 +0100236 */
Paul Bakker68884e32013-01-07 18:20:04 +0100237typedef enum {
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200238 MBEDTLS_KEY_EXCHANGE_NONE = 0,
239 MBEDTLS_KEY_EXCHANGE_RSA,
240 MBEDTLS_KEY_EXCHANGE_DHE_RSA,
241 MBEDTLS_KEY_EXCHANGE_ECDHE_RSA,
242 MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA,
243 MBEDTLS_KEY_EXCHANGE_PSK,
244 MBEDTLS_KEY_EXCHANGE_DHE_PSK,
245 MBEDTLS_KEY_EXCHANGE_RSA_PSK,
246 MBEDTLS_KEY_EXCHANGE_ECDHE_PSK,
247 MBEDTLS_KEY_EXCHANGE_ECDH_RSA,
248 MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA,
Manuel Pégourié-Gonnard557535d2015-09-15 17:53:32 +0200249 MBEDTLS_KEY_EXCHANGE_ECJPAKE,
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200250} mbedtls_key_exchange_type_t;
Paul Bakker68884e32013-01-07 18:20:04 +0100251
Manuel Pégourié-Gonnarde5f30722015-10-22 17:01:15 +0200252/* Key exchanges using a certificate */
Manuel Pégourié-Gonnardadeb7d82015-10-09 14:44:47 +0100253#if defined(MBEDTLS_KEY_EXCHANGE_RSA_ENABLED) || \
254 defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED) || \
255 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
256 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED) || \
257 defined(MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED) || \
Manuel Pégourié-Gonnardadeb7d82015-10-09 14:44:47 +0100258 defined(MBEDTLS_KEY_EXCHANGE_ECDH_RSA_ENABLED) || \
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200259 defined(MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA_ENABLED)
260#define MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED
Manuel Pégourié-Gonnardd9423232014-12-02 11:57:29 +0100261#endif
262
Hanno Becker1aa267c2017-04-28 17:08:27 +0100263/* Key exchanges allowing client certificate requests */
264#if defined(MBEDTLS_KEY_EXCHANGE_RSA_ENABLED) || \
265 defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED) || \
266 defined(MBEDTLS_KEY_EXCHANGE_ECDH_RSA_ENABLED) || \
267 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
268 defined(MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA_ENABLED) || \
269 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED)
270#define MBEDTLS_KEY_EXCHANGE__CERT_REQ_ALLOWED__ENABLED
271#endif
272
273/* Key exchanges involving server signature in ServerKeyExchange */
274#if defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED) || \
275 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
276 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED)
277#define MBEDTLS_KEY_EXCHANGE__WITH_SERVER_SIGNATURE__ENABLED
278#endif
279
280/* Key exchanges using ECDH */
281#if defined(MBEDTLS_KEY_EXCHANGE_ECDH_RSA_ENABLED) || \
282 defined(MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA_ENABLED)
283#define MBEDTLS_KEY_EXCHANGE__SOME__ECDH_ENABLED
284#endif
285
286/* Key exchanges that don't involve ephemeral keys */
287#if defined(MBEDTLS_KEY_EXCHANGE_RSA_ENABLED) || \
288 defined(MBEDTLS_KEY_EXCHANGE_PSK_ENABLED) || \
289 defined(MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED) || \
290 defined(MBEDTLS_KEY_EXCHANGE__SOME__ECDH_ENABLED)
291#define MBEDTLS_KEY_EXCHANGE__SOME_NON_PFS__ENABLED
292#endif
293
294/* Key exchanges that involve ephemeral keys */
295#if defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED) || \
296 defined(MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED) || \
297 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
298 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED) || \
299 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED) || \
300 defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
301#define MBEDTLS_KEY_EXCHANGE__SOME_PFS__ENABLED
302#endif
303
Manuel Pégourié-Gonnarde5f30722015-10-22 17:01:15 +0200304/* Key exchanges using a PSK */
Manuel Pégourié-Gonnardadeb7d82015-10-09 14:44:47 +0100305#if defined(MBEDTLS_KEY_EXCHANGE_PSK_ENABLED) || \
306 defined(MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED) || \
307 defined(MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED) || \
308 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED)
309#define MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED
310#endif
311
Hanno Becker1aa267c2017-04-28 17:08:27 +0100312/* Key exchanges using DHE */
313#if defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED) || \
314 defined(MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED)
315#define MBEDTLS_KEY_EXCHANGE__SOME__DHE_ENABLED
316#endif
317
318/* Key exchanges using ECDHE */
Manuel Pégourié-Gonnardadeb7d82015-10-09 14:44:47 +0100319#if defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
320 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED) || \
321 defined(MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED)
322#define MBEDTLS_KEY_EXCHANGE__SOME__ECDHE_ENABLED
323#endif
324
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200325typedef struct mbedtls_ssl_ciphersuite_t mbedtls_ssl_ciphersuite_t;
Paul Bakker68884e32013-01-07 18:20:04 +0100326
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200327#define MBEDTLS_CIPHERSUITE_WEAK 0x01 /**< Weak ciphersuite flag */
328#define MBEDTLS_CIPHERSUITE_SHORT_TAG 0x02 /**< Short authentication tag,
Manuel Pégourié-Gonnard6768da92014-05-14 12:26:51 +0200329 eg for CCM_8 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200330#define MBEDTLS_CIPHERSUITE_NODTLS 0x04 /**< Can't be used with DTLS */
Paul Bakker68884e32013-01-07 18:20:04 +0100331
332/**
333 * \brief This structure is used for storing ciphersuite information
334 */
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200335struct mbedtls_ssl_ciphersuite_t
Paul Bakker68884e32013-01-07 18:20:04 +0100336{
337 int id;
338 const char * name;
339
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200340 mbedtls_cipher_type_t cipher;
341 mbedtls_md_type_t mac;
342 mbedtls_key_exchange_type_t key_exchange;
Paul Bakker68884e32013-01-07 18:20:04 +0100343
344 int min_major_ver;
345 int min_minor_ver;
346 int max_major_ver;
347 int max_minor_ver;
348
349 unsigned char flags;
350};
351
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200352const int *mbedtls_ssl_list_ciphersuites( void );
Paul Bakker68884e32013-01-07 18:20:04 +0100353
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200354const mbedtls_ssl_ciphersuite_t *mbedtls_ssl_ciphersuite_from_string( const char *ciphersuite_name );
355const mbedtls_ssl_ciphersuite_t *mbedtls_ssl_ciphersuite_from_id( int ciphersuite_id );
Paul Bakker68884e32013-01-07 18:20:04 +0100356
Manuel Pégourié-Gonnard2cf5a7c2015-04-08 12:49:31 +0200357#if defined(MBEDTLS_PK_C)
358mbedtls_pk_type_t mbedtls_ssl_get_ciphersuite_sig_pk_alg( const mbedtls_ssl_ciphersuite_t *info );
Manuel Pégourié-Gonnard1a483832013-09-20 12:29:15 +0200359#endif
Manuel Pégourié-Gonnard09edda82013-08-19 13:50:33 +0200360
Hanno Becker1aa267c2017-04-28 17:08:27 +0100361#if defined(MBEDTLS_ECDH_C) || defined(MBEDTLS_ECDSA_C)
362static inline int mbedtls_ssl_ciphersuite_uses_ec( const mbedtls_ssl_ciphersuite_t *info )
363{
364 switch( info->key_exchange )
365 {
366 case MBEDTLS_KEY_EXCHANGE_ECDHE_RSA:
367 case MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA:
368 case MBEDTLS_KEY_EXCHANGE_ECDHE_PSK:
369 case MBEDTLS_KEY_EXCHANGE_ECDH_RSA:
370 case MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA:
371 return( 1 );
372
373 default:
374 return( 0 );
375 }
376}
377#endif /* MBEDTLS_ECDH_C || MBEDTLS_ECDSA_C */
378
379#if defined(MBEDTLS_KEY_EXCHANGE__SOME_PFS__ENABLED)
380static inline int mbedtls_ssl_ciphersuite_has_pfs( const mbedtls_ssl_ciphersuite_t *info )
381{
382 switch( info->key_exchange )
383 {
384 case MBEDTLS_KEY_EXCHANGE_DHE_RSA:
385 case MBEDTLS_KEY_EXCHANGE_DHE_PSK:
386 case MBEDTLS_KEY_EXCHANGE_ECDHE_RSA:
387 case MBEDTLS_KEY_EXCHANGE_ECDHE_PSK:
388 case MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA:
389 case MBEDTLS_KEY_EXCHANGE_ECJPAKE:
390 return( 1 );
391
392 default:
393 return( 0 );
394 }
395}
396#endif /* MBEDTLS_KEY_EXCHANGE__SOME_PFS__ENABLED */
397
398#if defined(MBEDTLS_KEY_EXCHANGE__SOME_NON_PFS__ENABLED)
399static inline int mbedtls_ssl_ciphersuite_no_pfs( const mbedtls_ssl_ciphersuite_t *info )
400{
401 switch( info->key_exchange )
402 {
403 case MBEDTLS_KEY_EXCHANGE_ECDH_RSA:
404 case MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA:
405 case MBEDTLS_KEY_EXCHANGE_RSA:
406 case MBEDTLS_KEY_EXCHANGE_PSK:
407 case MBEDTLS_KEY_EXCHANGE_RSA_PSK:
408 return( 1 );
409
410 default:
411 return( 0 );
412 }
413}
414#endif /* MBEDTLS_KEY_EXCHANGE__SOME_NON_PFS__ENABLED */
415
416#if defined(MBEDTLS_KEY_EXCHANGE__SOME__ECDH_ENABLED)
417static inline int mbedtls_ssl_ciphersuite_uses_ecdh( const mbedtls_ssl_ciphersuite_t *info )
418{
419 switch( info->key_exchange )
420 {
421 case MBEDTLS_KEY_EXCHANGE_ECDH_RSA:
422 case MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA:
423 return( 1 );
424
425 default:
426 return( 0 );
427 }
428}
429#endif /* MBEDTLS_KEY_EXCHANGE__SOME__ECDH_ENABLED */
430
431#if defined(MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED)
432static inline int mbedtls_ssl_ciphersuite_uses_psk( const mbedtls_ssl_ciphersuite_t *info )
433{
434 switch( info->key_exchange )
435 {
436 case MBEDTLS_KEY_EXCHANGE_PSK:
437 case MBEDTLS_KEY_EXCHANGE_RSA_PSK:
438 case MBEDTLS_KEY_EXCHANGE_DHE_PSK:
439 case MBEDTLS_KEY_EXCHANGE_ECDHE_PSK:
440 return( 1 );
441
442 default:
443 return( 0 );
444 }
445}
446#endif /* MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED */
447
448static inline int mbedtls_ssl_ciphersuite_cert_req_allowed( const mbedtls_ssl_ciphersuite_t *info )
449{
450 switch( info->key_exchange )
451 {
452 case MBEDTLS_KEY_EXCHANGE_RSA:
453 case MBEDTLS_KEY_EXCHANGE_DHE_RSA:
454 case MBEDTLS_KEY_EXCHANGE_ECDH_RSA:
455 case MBEDTLS_KEY_EXCHANGE_ECDHE_RSA:
456 case MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA:
457 case MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA:
458 return( 1 );
459
460 default:
461 return( 0 );
462 }
463}
464
465#if defined(MBEDTLS_KEY_EXCHANGE__SOME__DHE_ENABLED)
466static inline int mbedtls_ssl_ciphersuite_uses_dhe( const mbedtls_ssl_ciphersuite_t *info )
467{
468 switch( info->key_exchange )
469 {
470 case MBEDTLS_KEY_EXCHANGE_DHE_RSA:
471 case MBEDTLS_KEY_EXCHANGE_DHE_PSK:
472 return( 1 );
473
474 default:
475 return( 0 );
476 }
477}
478#endif /* MBEDTLS_KEY_EXCHANGE__SOME__DHE_ENABLED) */
479
480#if defined(MBEDTLS_KEY_EXCHANGE__SOME__ECDHE_ENABLED)
481static inline int mbedtls_ssl_ciphersuite_uses_ecdhe( const mbedtls_ssl_ciphersuite_t *info )
482{
483 switch( info->key_exchange )
484 {
485 case MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA:
486 case MBEDTLS_KEY_EXCHANGE_ECDHE_RSA:
487 case MBEDTLS_KEY_EXCHANGE_ECDHE_PSK:
488 return( 1 );
489
490 default:
491 return( 0 );
492 }
493}
494#endif /* MBEDTLS_KEY_EXCHANGE__SOME__ECDHE_ENABLED) */
495
496#if defined(MBEDTLS_KEY_EXCHANGE__WITH_SERVER_SIGNATURE__ENABLED)
497static inline int mbedtls_ssl_ciphersuite_uses_server_signature( const mbedtls_ssl_ciphersuite_t *info )
498{
499 switch( info->key_exchange )
500 {
501 case MBEDTLS_KEY_EXCHANGE_DHE_RSA:
502 case MBEDTLS_KEY_EXCHANGE_ECDHE_RSA:
503 case MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA:
504 return( 1 );
505
506 default:
507 return( 0 );
508 }
509}
510#endif /* MBEDTLS_KEY_EXCHANGE__WITH_SERVER_SIGNATURE__ENABLED */
Manuel Pégourié-Gonnard51451f82013-09-17 12:06:25 +0200511
Paul Bakker68884e32013-01-07 18:20:04 +0100512#ifdef __cplusplus
513}
514#endif
515
516#endif /* ssl_ciphersuites.h */