ssl_ciphersuites.h 22 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486
  1. /**
  2. * \file ssl_ciphersuites.h
  3. *
  4. * \brief SSL Ciphersuites for mbed TLS
  5. */
  6. /*
  7. * Copyright (C) 2006-2015, ARM Limited, All Rights Reserved
  8. * 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.
  21. *
  22. * This file is part of mbed TLS (https://tls.mbed.org)
  23. */
  24. #ifndef MBEDTLS_SSL_CIPHERSUITES_H
  25. #define MBEDTLS_SSL_CIPHERSUITES_H
  26. #include "pk.h"
  27. #include "cipher.h"
  28. #include "md.h"
  29. #ifdef __cplusplus
  30. extern "C" {
  31. #endif
  32. /*
  33. * Supported ciphersuites (Official IANA names)
  34. */
  35. #define MBEDTLS_TLS_RSA_WITH_NULL_MD5 0x01 /**< Weak! */
  36. #define MBEDTLS_TLS_RSA_WITH_NULL_SHA 0x02 /**< Weak! */
  37. #define MBEDTLS_TLS_RSA_WITH_RC4_128_MD5 0x04
  38. #define MBEDTLS_TLS_RSA_WITH_RC4_128_SHA 0x05
  39. #define MBEDTLS_TLS_RSA_WITH_DES_CBC_SHA 0x09 /**< Weak! Not in TLS 1.2 */
  40. #define MBEDTLS_TLS_RSA_WITH_3DES_EDE_CBC_SHA 0x0A
  41. #define MBEDTLS_TLS_DHE_RSA_WITH_DES_CBC_SHA 0x15 /**< Weak! Not in TLS 1.2 */
  42. #define MBEDTLS_TLS_DHE_RSA_WITH_3DES_EDE_CBC_SHA 0x16
  43. #define MBEDTLS_TLS_PSK_WITH_NULL_SHA 0x2C /**< Weak! */
  44. #define MBEDTLS_TLS_DHE_PSK_WITH_NULL_SHA 0x2D /**< Weak! */
  45. #define MBEDTLS_TLS_RSA_PSK_WITH_NULL_SHA 0x2E /**< Weak! */
  46. #define MBEDTLS_TLS_RSA_WITH_AES_128_CBC_SHA 0x2F
  47. #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
  50. #define MBEDTLS_TLS_RSA_WITH_NULL_SHA256 0x3B /**< Weak! */
  51. #define MBEDTLS_TLS_RSA_WITH_AES_128_CBC_SHA256 0x3C /**< TLS 1.2 */
  52. #define MBEDTLS_TLS_RSA_WITH_AES_256_CBC_SHA256 0x3D /**< TLS 1.2 */
  53. #define MBEDTLS_TLS_RSA_WITH_CAMELLIA_128_CBC_SHA 0x41
  54. #define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_128_CBC_SHA 0x45
  55. #define MBEDTLS_TLS_DHE_RSA_WITH_AES_128_CBC_SHA256 0x67 /**< TLS 1.2 */
  56. #define MBEDTLS_TLS_DHE_RSA_WITH_AES_256_CBC_SHA256 0x6B /**< TLS 1.2 */
  57. #define MBEDTLS_TLS_RSA_WITH_CAMELLIA_256_CBC_SHA 0x84
  58. #define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_256_CBC_SHA 0x88
  59. #define MBEDTLS_TLS_PSK_WITH_RC4_128_SHA 0x8A
  60. #define MBEDTLS_TLS_PSK_WITH_3DES_EDE_CBC_SHA 0x8B
  61. #define MBEDTLS_TLS_PSK_WITH_AES_128_CBC_SHA 0x8C
  62. #define MBEDTLS_TLS_PSK_WITH_AES_256_CBC_SHA 0x8D
  63. #define MBEDTLS_TLS_DHE_PSK_WITH_RC4_128_SHA 0x8E
  64. #define MBEDTLS_TLS_DHE_PSK_WITH_3DES_EDE_CBC_SHA 0x8F
  65. #define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_CBC_SHA 0x90
  66. #define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_CBC_SHA 0x91
  67. #define MBEDTLS_TLS_RSA_PSK_WITH_RC4_128_SHA 0x92
  68. #define MBEDTLS_TLS_RSA_PSK_WITH_3DES_EDE_CBC_SHA 0x93
  69. #define MBEDTLS_TLS_RSA_PSK_WITH_AES_128_CBC_SHA 0x94
  70. #define MBEDTLS_TLS_RSA_PSK_WITH_AES_256_CBC_SHA 0x95
  71. #define MBEDTLS_TLS_RSA_WITH_AES_128_GCM_SHA256 0x9C /**< TLS 1.2 */
  72. #define MBEDTLS_TLS_RSA_WITH_AES_256_GCM_SHA384 0x9D /**< TLS 1.2 */
  73. #define MBEDTLS_TLS_DHE_RSA_WITH_AES_128_GCM_SHA256 0x9E /**< TLS 1.2 */
  74. #define MBEDTLS_TLS_DHE_RSA_WITH_AES_256_GCM_SHA384 0x9F /**< TLS 1.2 */
  75. #define MBEDTLS_TLS_PSK_WITH_AES_128_GCM_SHA256 0xA8 /**< TLS 1.2 */
  76. #define MBEDTLS_TLS_PSK_WITH_AES_256_GCM_SHA384 0xA9 /**< TLS 1.2 */
  77. #define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_GCM_SHA256 0xAA /**< TLS 1.2 */
  78. #define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_GCM_SHA384 0xAB /**< TLS 1.2 */
  79. #define MBEDTLS_TLS_RSA_PSK_WITH_AES_128_GCM_SHA256 0xAC /**< TLS 1.2 */
  80. #define MBEDTLS_TLS_RSA_PSK_WITH_AES_256_GCM_SHA384 0xAD /**< TLS 1.2 */
  81. #define MBEDTLS_TLS_PSK_WITH_AES_128_CBC_SHA256 0xAE
  82. #define MBEDTLS_TLS_PSK_WITH_AES_256_CBC_SHA384 0xAF
  83. #define MBEDTLS_TLS_PSK_WITH_NULL_SHA256 0xB0 /**< Weak! */
  84. #define MBEDTLS_TLS_PSK_WITH_NULL_SHA384 0xB1 /**< Weak! */
  85. #define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_CBC_SHA256 0xB2
  86. #define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_CBC_SHA384 0xB3
  87. #define MBEDTLS_TLS_DHE_PSK_WITH_NULL_SHA256 0xB4 /**< Weak! */
  88. #define MBEDTLS_TLS_DHE_PSK_WITH_NULL_SHA384 0xB5 /**< Weak! */
  89. #define MBEDTLS_TLS_RSA_PSK_WITH_AES_128_CBC_SHA256 0xB6
  90. #define MBEDTLS_TLS_RSA_PSK_WITH_AES_256_CBC_SHA384 0xB7
  91. #define MBEDTLS_TLS_RSA_PSK_WITH_NULL_SHA256 0xB8 /**< Weak! */
  92. #define MBEDTLS_TLS_RSA_PSK_WITH_NULL_SHA384 0xB9 /**< Weak! */
  93. #define MBEDTLS_TLS_RSA_WITH_CAMELLIA_128_CBC_SHA256 0xBA /**< TLS 1.2 */
  94. #define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_128_CBC_SHA256 0xBE /**< TLS 1.2 */
  95. #define MBEDTLS_TLS_RSA_WITH_CAMELLIA_256_CBC_SHA256 0xC0 /**< TLS 1.2 */
  96. #define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_256_CBC_SHA256 0xC4 /**< TLS 1.2 */
  97. #define MBEDTLS_TLS_ECDH_ECDSA_WITH_NULL_SHA 0xC001 /**< Weak! */
  98. #define MBEDTLS_TLS_ECDH_ECDSA_WITH_RC4_128_SHA 0xC002 /**< Not in SSL3! */
  99. #define MBEDTLS_TLS_ECDH_ECDSA_WITH_3DES_EDE_CBC_SHA 0xC003 /**< Not in SSL3! */
  100. #define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA 0xC004 /**< Not in SSL3! */
  101. #define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA 0xC005 /**< Not in SSL3! */
  102. #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_NULL_SHA 0xC006 /**< Weak! */
  103. #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_RC4_128_SHA 0xC007 /**< Not in SSL3! */
  104. #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_3DES_EDE_CBC_SHA 0xC008 /**< Not in SSL3! */
  105. #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA 0xC009 /**< Not in SSL3! */
  106. #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA 0xC00A /**< Not in SSL3! */
  107. #define MBEDTLS_TLS_ECDH_RSA_WITH_NULL_SHA 0xC00B /**< Weak! */
  108. #define MBEDTLS_TLS_ECDH_RSA_WITH_RC4_128_SHA 0xC00C /**< Not in SSL3! */
  109. #define MBEDTLS_TLS_ECDH_RSA_WITH_3DES_EDE_CBC_SHA 0xC00D /**< Not in SSL3! */
  110. #define MBEDTLS_TLS_ECDH_RSA_WITH_AES_128_CBC_SHA 0xC00E /**< Not in SSL3! */
  111. #define MBEDTLS_TLS_ECDH_RSA_WITH_AES_256_CBC_SHA 0xC00F /**< Not in SSL3! */
  112. #define MBEDTLS_TLS_ECDHE_RSA_WITH_NULL_SHA 0xC010 /**< Weak! */
  113. #define MBEDTLS_TLS_ECDHE_RSA_WITH_RC4_128_SHA 0xC011 /**< Not in SSL3! */
  114. #define MBEDTLS_TLS_ECDHE_RSA_WITH_3DES_EDE_CBC_SHA 0xC012 /**< Not in SSL3! */
  115. #define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA 0xC013 /**< Not in SSL3! */
  116. #define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA 0xC014 /**< Not in SSL3! */
  117. #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 0xC023 /**< TLS 1.2 */
  118. #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384 0xC024 /**< TLS 1.2 */
  119. #define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA256 0xC025 /**< TLS 1.2 */
  120. #define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_256_CBC_SHA384 0xC026 /**< TLS 1.2 */
  121. #define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 0xC027 /**< TLS 1.2 */
  122. #define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 0xC028 /**< TLS 1.2 */
  123. #define MBEDTLS_TLS_ECDH_RSA_WITH_AES_128_CBC_SHA256 0xC029 /**< TLS 1.2 */
  124. #define MBEDTLS_TLS_ECDH_RSA_WITH_AES_256_CBC_SHA384 0xC02A /**< TLS 1.2 */
  125. #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 0xC02B /**< TLS 1.2 */
  126. #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 0xC02C /**< TLS 1.2 */
  127. #define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_128_GCM_SHA256 0xC02D /**< TLS 1.2 */
  128. #define MBEDTLS_TLS_ECDH_ECDSA_WITH_AES_256_GCM_SHA384 0xC02E /**< TLS 1.2 */
  129. #define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 0xC02F /**< TLS 1.2 */
  130. #define MBEDTLS_TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 0xC030 /**< TLS 1.2 */
  131. #define MBEDTLS_TLS_ECDH_RSA_WITH_AES_128_GCM_SHA256 0xC031 /**< TLS 1.2 */
  132. #define MBEDTLS_TLS_ECDH_RSA_WITH_AES_256_GCM_SHA384 0xC032 /**< TLS 1.2 */
  133. #define MBEDTLS_TLS_ECDHE_PSK_WITH_RC4_128_SHA 0xC033 /**< Not in SSL3! */
  134. #define MBEDTLS_TLS_ECDHE_PSK_WITH_3DES_EDE_CBC_SHA 0xC034 /**< Not in SSL3! */
  135. #define MBEDTLS_TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA 0xC035 /**< Not in SSL3! */
  136. #define MBEDTLS_TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA 0xC036 /**< Not in SSL3! */
  137. #define MBEDTLS_TLS_ECDHE_PSK_WITH_AES_128_CBC_SHA256 0xC037 /**< Not in SSL3! */
  138. #define MBEDTLS_TLS_ECDHE_PSK_WITH_AES_256_CBC_SHA384 0xC038 /**< Not in SSL3! */
  139. #define MBEDTLS_TLS_ECDHE_PSK_WITH_NULL_SHA 0xC039 /**< Weak! No SSL3! */
  140. #define MBEDTLS_TLS_ECDHE_PSK_WITH_NULL_SHA256 0xC03A /**< Weak! No SSL3! */
  141. #define MBEDTLS_TLS_ECDHE_PSK_WITH_NULL_SHA384 0xC03B /**< Weak! No SSL3! */
  142. #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_CAMELLIA_128_CBC_SHA256 0xC072 /**< Not in SSL3! */
  143. #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_CAMELLIA_256_CBC_SHA384 0xC073 /**< Not in SSL3! */
  144. #define MBEDTLS_TLS_ECDH_ECDSA_WITH_CAMELLIA_128_CBC_SHA256 0xC074 /**< Not in SSL3! */
  145. #define MBEDTLS_TLS_ECDH_ECDSA_WITH_CAMELLIA_256_CBC_SHA384 0xC075 /**< Not in SSL3! */
  146. #define MBEDTLS_TLS_ECDHE_RSA_WITH_CAMELLIA_128_CBC_SHA256 0xC076 /**< Not in SSL3! */
  147. #define MBEDTLS_TLS_ECDHE_RSA_WITH_CAMELLIA_256_CBC_SHA384 0xC077 /**< Not in SSL3! */
  148. #define MBEDTLS_TLS_ECDH_RSA_WITH_CAMELLIA_128_CBC_SHA256 0xC078 /**< Not in SSL3! */
  149. #define MBEDTLS_TLS_ECDH_RSA_WITH_CAMELLIA_256_CBC_SHA384 0xC079 /**< Not in SSL3! */
  150. #define MBEDTLS_TLS_RSA_WITH_CAMELLIA_128_GCM_SHA256 0xC07A /**< TLS 1.2 */
  151. #define MBEDTLS_TLS_RSA_WITH_CAMELLIA_256_GCM_SHA384 0xC07B /**< TLS 1.2 */
  152. #define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_128_GCM_SHA256 0xC07C /**< TLS 1.2 */
  153. #define MBEDTLS_TLS_DHE_RSA_WITH_CAMELLIA_256_GCM_SHA384 0xC07D /**< TLS 1.2 */
  154. #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_CAMELLIA_128_GCM_SHA256 0xC086 /**< TLS 1.2 */
  155. #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_CAMELLIA_256_GCM_SHA384 0xC087 /**< TLS 1.2 */
  156. #define MBEDTLS_TLS_ECDH_ECDSA_WITH_CAMELLIA_128_GCM_SHA256 0xC088 /**< TLS 1.2 */
  157. #define MBEDTLS_TLS_ECDH_ECDSA_WITH_CAMELLIA_256_GCM_SHA384 0xC089 /**< TLS 1.2 */
  158. #define MBEDTLS_TLS_ECDHE_RSA_WITH_CAMELLIA_128_GCM_SHA256 0xC08A /**< TLS 1.2 */
  159. #define MBEDTLS_TLS_ECDHE_RSA_WITH_CAMELLIA_256_GCM_SHA384 0xC08B /**< TLS 1.2 */
  160. #define MBEDTLS_TLS_ECDH_RSA_WITH_CAMELLIA_128_GCM_SHA256 0xC08C /**< TLS 1.2 */
  161. #define MBEDTLS_TLS_ECDH_RSA_WITH_CAMELLIA_256_GCM_SHA384 0xC08D /**< TLS 1.2 */
  162. #define MBEDTLS_TLS_PSK_WITH_CAMELLIA_128_GCM_SHA256 0xC08E /**< TLS 1.2 */
  163. #define MBEDTLS_TLS_PSK_WITH_CAMELLIA_256_GCM_SHA384 0xC08F /**< TLS 1.2 */
  164. #define MBEDTLS_TLS_DHE_PSK_WITH_CAMELLIA_128_GCM_SHA256 0xC090 /**< TLS 1.2 */
  165. #define MBEDTLS_TLS_DHE_PSK_WITH_CAMELLIA_256_GCM_SHA384 0xC091 /**< TLS 1.2 */
  166. #define MBEDTLS_TLS_RSA_PSK_WITH_CAMELLIA_128_GCM_SHA256 0xC092 /**< TLS 1.2 */
  167. #define MBEDTLS_TLS_RSA_PSK_WITH_CAMELLIA_256_GCM_SHA384 0xC093 /**< TLS 1.2 */
  168. #define MBEDTLS_TLS_PSK_WITH_CAMELLIA_128_CBC_SHA256 0xC094
  169. #define MBEDTLS_TLS_PSK_WITH_CAMELLIA_256_CBC_SHA384 0xC095
  170. #define MBEDTLS_TLS_DHE_PSK_WITH_CAMELLIA_128_CBC_SHA256 0xC096
  171. #define MBEDTLS_TLS_DHE_PSK_WITH_CAMELLIA_256_CBC_SHA384 0xC097
  172. #define MBEDTLS_TLS_RSA_PSK_WITH_CAMELLIA_128_CBC_SHA256 0xC098
  173. #define MBEDTLS_TLS_RSA_PSK_WITH_CAMELLIA_256_CBC_SHA384 0xC099
  174. #define MBEDTLS_TLS_ECDHE_PSK_WITH_CAMELLIA_128_CBC_SHA256 0xC09A /**< Not in SSL3! */
  175. #define MBEDTLS_TLS_ECDHE_PSK_WITH_CAMELLIA_256_CBC_SHA384 0xC09B /**< Not in SSL3! */
  176. #define MBEDTLS_TLS_RSA_WITH_AES_128_CCM 0xC09C /**< TLS 1.2 */
  177. #define MBEDTLS_TLS_RSA_WITH_AES_256_CCM 0xC09D /**< TLS 1.2 */
  178. #define MBEDTLS_TLS_DHE_RSA_WITH_AES_128_CCM 0xC09E /**< TLS 1.2 */
  179. #define MBEDTLS_TLS_DHE_RSA_WITH_AES_256_CCM 0xC09F /**< TLS 1.2 */
  180. #define MBEDTLS_TLS_RSA_WITH_AES_128_CCM_8 0xC0A0 /**< TLS 1.2 */
  181. #define MBEDTLS_TLS_RSA_WITH_AES_256_CCM_8 0xC0A1 /**< TLS 1.2 */
  182. #define MBEDTLS_TLS_DHE_RSA_WITH_AES_128_CCM_8 0xC0A2 /**< TLS 1.2 */
  183. #define MBEDTLS_TLS_DHE_RSA_WITH_AES_256_CCM_8 0xC0A3 /**< TLS 1.2 */
  184. #define MBEDTLS_TLS_PSK_WITH_AES_128_CCM 0xC0A4 /**< TLS 1.2 */
  185. #define MBEDTLS_TLS_PSK_WITH_AES_256_CCM 0xC0A5 /**< TLS 1.2 */
  186. #define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_CCM 0xC0A6 /**< TLS 1.2 */
  187. #define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_CCM 0xC0A7 /**< TLS 1.2 */
  188. #define MBEDTLS_TLS_PSK_WITH_AES_128_CCM_8 0xC0A8 /**< TLS 1.2 */
  189. #define MBEDTLS_TLS_PSK_WITH_AES_256_CCM_8 0xC0A9 /**< TLS 1.2 */
  190. #define MBEDTLS_TLS_DHE_PSK_WITH_AES_128_CCM_8 0xC0AA /**< TLS 1.2 */
  191. #define MBEDTLS_TLS_DHE_PSK_WITH_AES_256_CCM_8 0xC0AB /**< TLS 1.2 */
  192. /* The last two are named with PSK_DHE in the RFC, which looks like a typo */
  193. #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_CCM 0xC0AC /**< TLS 1.2 */
  194. #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_CCM 0xC0AD /**< TLS 1.2 */
  195. #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_128_CCM_8 0xC0AE /**< TLS 1.2 */
  196. #define MBEDTLS_TLS_ECDHE_ECDSA_WITH_AES_256_CCM_8 0xC0AF /**< TLS 1.2 */
  197. #define MBEDTLS_TLS_ECJPAKE_WITH_AES_128_CCM_8 0xC0FF /**< experimental */
  198. /* Reminder: update mbedtls_ssl_premaster_secret when adding a new key exchange.
  199. * Reminder: update MBEDTLS_KEY_EXCHANGE__xxx below
  200. */
  201. typedef enum {
  202. MBEDTLS_KEY_EXCHANGE_NONE = 0,
  203. MBEDTLS_KEY_EXCHANGE_RSA,
  204. MBEDTLS_KEY_EXCHANGE_DHE_RSA,
  205. MBEDTLS_KEY_EXCHANGE_ECDHE_RSA,
  206. MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA,
  207. MBEDTLS_KEY_EXCHANGE_PSK,
  208. MBEDTLS_KEY_EXCHANGE_DHE_PSK,
  209. MBEDTLS_KEY_EXCHANGE_RSA_PSK,
  210. MBEDTLS_KEY_EXCHANGE_ECDHE_PSK,
  211. MBEDTLS_KEY_EXCHANGE_ECDH_RSA,
  212. MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA,
  213. MBEDTLS_KEY_EXCHANGE_ECJPAKE,
  214. } mbedtls_key_exchange_type_t;
  215. /* Key exchanges using a certificate */
  216. #if defined(MBEDTLS_KEY_EXCHANGE_RSA_ENABLED) || \
  217. defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED) || \
  218. defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
  219. defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED) || \
  220. defined(MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED) || \
  221. defined(MBEDTLS_KEY_EXCHANGE_ECDH_RSA_ENABLED) || \
  222. defined(MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA_ENABLED)
  223. #define MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED
  224. #endif
  225. /* Key exchanges allowing client certificate requests */
  226. #if defined(MBEDTLS_KEY_EXCHANGE_RSA_ENABLED) || \
  227. defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED) || \
  228. defined(MBEDTLS_KEY_EXCHANGE_ECDH_RSA_ENABLED) || \
  229. defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
  230. defined(MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA_ENABLED) || \
  231. defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED)
  232. #define MBEDTLS_KEY_EXCHANGE__CERT_REQ_ALLOWED__ENABLED
  233. #endif
  234. /* Key exchanges involving server signature in ServerKeyExchange */
  235. #if defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED) || \
  236. defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
  237. defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED)
  238. #define MBEDTLS_KEY_EXCHANGE__WITH_SERVER_SIGNATURE__ENABLED
  239. #endif
  240. /* Key exchanges using ECDH */
  241. #if defined(MBEDTLS_KEY_EXCHANGE_ECDH_RSA_ENABLED) || \
  242. defined(MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA_ENABLED)
  243. #define MBEDTLS_KEY_EXCHANGE__SOME__ECDH_ENABLED
  244. #endif
  245. /* Key exchanges that don't involve ephemeral keys */
  246. #if defined(MBEDTLS_KEY_EXCHANGE_RSA_ENABLED) || \
  247. defined(MBEDTLS_KEY_EXCHANGE_PSK_ENABLED) || \
  248. defined(MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED) || \
  249. defined(MBEDTLS_KEY_EXCHANGE__SOME__ECDH_ENABLED)
  250. #define MBEDTLS_KEY_EXCHANGE__SOME_NON_PFS__ENABLED
  251. #endif
  252. /* Key exchanges that involve ephemeral keys */
  253. #if defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED) || \
  254. defined(MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED) || \
  255. defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
  256. defined(MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED) || \
  257. defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED) || \
  258. defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
  259. #define MBEDTLS_KEY_EXCHANGE__SOME_PFS__ENABLED
  260. #endif
  261. /* Key exchanges using a PSK */
  262. #if defined(MBEDTLS_KEY_EXCHANGE_PSK_ENABLED) || \
  263. defined(MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED) || \
  264. defined(MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED) || \
  265. defined(MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED)
  266. #define MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED
  267. #endif
  268. /* Key exchanges using DHE */
  269. #if defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED) || \
  270. defined(MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED)
  271. #define MBEDTLS_KEY_EXCHANGE__SOME__DHE_ENABLED
  272. #endif
  273. /* Key exchanges using ECDHE */
  274. #if defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
  275. defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED) || \
  276. defined(MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED)
  277. #define MBEDTLS_KEY_EXCHANGE__SOME__ECDHE_ENABLED
  278. #endif
  279. typedef struct mbedtls_ssl_ciphersuite_t mbedtls_ssl_ciphersuite_t;
  280. #define MBEDTLS_CIPHERSUITE_WEAK 0x01 /**< Weak ciphersuite flag */
  281. #define MBEDTLS_CIPHERSUITE_SHORT_TAG 0x02 /**< Short authentication tag,
  282. eg for CCM_8 */
  283. #define MBEDTLS_CIPHERSUITE_NODTLS 0x04 /**< Can't be used with DTLS */
  284. /**
  285. * \brief This structure is used for storing ciphersuite information
  286. */
  287. struct mbedtls_ssl_ciphersuite_t
  288. {
  289. int id;
  290. const char * name;
  291. mbedtls_cipher_type_t cipher;
  292. mbedtls_md_type_t mac;
  293. mbedtls_key_exchange_type_t key_exchange;
  294. int min_major_ver;
  295. int min_minor_ver;
  296. int max_major_ver;
  297. int max_minor_ver;
  298. unsigned char flags;
  299. };
  300. const int *mbedtls_ssl_list_ciphersuites( void );
  301. const mbedtls_ssl_ciphersuite_t *mbedtls_ssl_ciphersuite_from_string( const char *ciphersuite_name );
  302. const mbedtls_ssl_ciphersuite_t *mbedtls_ssl_ciphersuite_from_id( int ciphersuite_id );
  303. #if defined(MBEDTLS_PK_C)
  304. mbedtls_pk_type_t mbedtls_ssl_get_ciphersuite_sig_pk_alg( const mbedtls_ssl_ciphersuite_t *info );
  305. mbedtls_pk_type_t mbedtls_ssl_get_ciphersuite_sig_alg( const mbedtls_ssl_ciphersuite_t *info );
  306. #endif
  307. int mbedtls_ssl_ciphersuite_uses_ec( const mbedtls_ssl_ciphersuite_t *info );
  308. int mbedtls_ssl_ciphersuite_uses_psk( const mbedtls_ssl_ciphersuite_t *info );
  309. #if defined(MBEDTLS_KEY_EXCHANGE__SOME_PFS__ENABLED)
  310. static inline int mbedtls_ssl_ciphersuite_has_pfs( const mbedtls_ssl_ciphersuite_t *info )
  311. {
  312. switch( info->key_exchange )
  313. {
  314. case MBEDTLS_KEY_EXCHANGE_DHE_RSA:
  315. case MBEDTLS_KEY_EXCHANGE_DHE_PSK:
  316. case MBEDTLS_KEY_EXCHANGE_ECDHE_RSA:
  317. case MBEDTLS_KEY_EXCHANGE_ECDHE_PSK:
  318. case MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA:
  319. case MBEDTLS_KEY_EXCHANGE_ECJPAKE:
  320. return( 1 );
  321. default:
  322. return( 0 );
  323. }
  324. }
  325. #endif /* MBEDTLS_KEY_EXCHANGE__SOME_PFS__ENABLED */
  326. #if defined(MBEDTLS_KEY_EXCHANGE__SOME_NON_PFS__ENABLED)
  327. static inline int mbedtls_ssl_ciphersuite_no_pfs( const mbedtls_ssl_ciphersuite_t *info )
  328. {
  329. switch( info->key_exchange )
  330. {
  331. case MBEDTLS_KEY_EXCHANGE_ECDH_RSA:
  332. case MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA:
  333. case MBEDTLS_KEY_EXCHANGE_RSA:
  334. case MBEDTLS_KEY_EXCHANGE_PSK:
  335. case MBEDTLS_KEY_EXCHANGE_RSA_PSK:
  336. return( 1 );
  337. default:
  338. return( 0 );
  339. }
  340. }
  341. #endif /* MBEDTLS_KEY_EXCHANGE__SOME_NON_PFS__ENABLED */
  342. #if defined(MBEDTLS_KEY_EXCHANGE__SOME__ECDH_ENABLED)
  343. static inline int mbedtls_ssl_ciphersuite_uses_ecdh( const mbedtls_ssl_ciphersuite_t *info )
  344. {
  345. switch( info->key_exchange )
  346. {
  347. case MBEDTLS_KEY_EXCHANGE_ECDH_RSA:
  348. case MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA:
  349. return( 1 );
  350. default:
  351. return( 0 );
  352. }
  353. }
  354. #endif /* MBEDTLS_KEY_EXCHANGE__SOME__ECDH_ENABLED */
  355. static inline int mbedtls_ssl_ciphersuite_cert_req_allowed( const mbedtls_ssl_ciphersuite_t *info )
  356. {
  357. switch( info->key_exchange )
  358. {
  359. case MBEDTLS_KEY_EXCHANGE_RSA:
  360. case MBEDTLS_KEY_EXCHANGE_DHE_RSA:
  361. case MBEDTLS_KEY_EXCHANGE_ECDH_RSA:
  362. case MBEDTLS_KEY_EXCHANGE_ECDHE_RSA:
  363. case MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA:
  364. case MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA:
  365. return( 1 );
  366. default:
  367. return( 0 );
  368. }
  369. }
  370. #if defined(MBEDTLS_KEY_EXCHANGE__SOME__DHE_ENABLED)
  371. static inline int mbedtls_ssl_ciphersuite_uses_dhe( const mbedtls_ssl_ciphersuite_t *info )
  372. {
  373. switch( info->key_exchange )
  374. {
  375. case MBEDTLS_KEY_EXCHANGE_DHE_RSA:
  376. case MBEDTLS_KEY_EXCHANGE_DHE_PSK:
  377. return( 1 );
  378. default:
  379. return( 0 );
  380. }
  381. }
  382. #endif /* MBEDTLS_KEY_EXCHANGE__SOME__DHE_ENABLED) */
  383. #if defined(MBEDTLS_KEY_EXCHANGE__SOME__ECDHE_ENABLED)
  384. static inline int mbedtls_ssl_ciphersuite_uses_ecdhe( const mbedtls_ssl_ciphersuite_t *info )
  385. {
  386. switch( info->key_exchange )
  387. {
  388. case MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA:
  389. case MBEDTLS_KEY_EXCHANGE_ECDHE_RSA:
  390. case MBEDTLS_KEY_EXCHANGE_ECDHE_PSK:
  391. return( 1 );
  392. default:
  393. return( 0 );
  394. }
  395. }
  396. #endif /* MBEDTLS_KEY_EXCHANGE__SOME__ECDHE_ENABLED) */
  397. #if defined(MBEDTLS_KEY_EXCHANGE__WITH_SERVER_SIGNATURE__ENABLED)
  398. static inline int mbedtls_ssl_ciphersuite_uses_server_signature( const mbedtls_ssl_ciphersuite_t *info )
  399. {
  400. switch( info->key_exchange )
  401. {
  402. case MBEDTLS_KEY_EXCHANGE_DHE_RSA:
  403. case MBEDTLS_KEY_EXCHANGE_ECDHE_RSA:
  404. case MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA:
  405. return( 1 );
  406. default:
  407. return( 0 );
  408. }
  409. }
  410. #endif /* MBEDTLS_KEY_EXCHANGE__WITH_SERVER_SIGNATURE__ENABLED */
  411. #ifdef __cplusplus
  412. }
  413. #endif
  414. #endif /* ssl_ciphersuites.h */