ChangeLog 163 KB
Newer Older
1
mbed TLS ChangeLog (Sorted per branch, date)
2

3
= mbed TLS 2.16.1 branch released 2019-03-19
Darryl Green's avatar
Darryl Green committed
4

5 6
Features
   * Add MBEDTLS_REMOVE_3DES_CIPHERSUITES to allow removing 3DES ciphersuites
7 8
     from the default list (enabled by default). See
     https://sweet32.info/SWEET32_CCS16.pdf.
Darryl Green's avatar
Darryl Green committed
9 10 11 12

Bugfix
   * Fix a compilation issue with mbedtls_ecp_restart_ctx not being defined
     when MBEDTLS_ECP_ALT is defined. Reported by jwhui. Fixes #2242.
Ron Eldor's avatar
Ron Eldor committed
13 14
   * Run the AD too long test only if MBEDTLS_CCM_ALT is not defined.
     Raised as a comment in #1996.
Hanno Becker's avatar
Hanno Becker committed
15 16
   * Reduce the stack consumption of mbedtls_mpi_fill_random() which could
     previously lead to a stack overflow on constrained targets.
17 18
   * Add `MBEDTLS_SELF_TEST` for the mbedtls_self_test functions
     in the header files, which missed the precompilation check. #971
Darryl Green's avatar
Darryl Green committed
19

Ron Eldor's avatar
Ron Eldor committed
20
Features
Ron Eldor's avatar
Ron Eldor committed
21 22
   * Add support for DTLS-SRTP as defined in RFC 5764. Based on #361 contributed
     by Johan Pascal.
23 24 25 26
   * Fix clobber list in MIPS assembly for large integer multiplication.
     Previously, this could lead to functionally incorrect assembly being
     produced by some optimizing compilers, showing up as failures in
     e.g. RSA or ECC signature operations. Reported in #1722, fix suggested
Jeffrey Martin's avatar
Jeffrey Martin committed
27
     by Aurelien Jarno and submitted by Jeffrey Martin.
Hanno Becker's avatar
Hanno Becker committed
28 29
   * Fix signed-to-unsigned integer conversion warning
     in X.509 module. Fixes #2212.
Ron Eldor's avatar
Ron Eldor committed
30 31
   * Reduce stack usage of `mpi_write_hlp()` by eliminating recursion.
     Fixes #2190.
32
   * Remove a duplicate #include in a sample program. Fixed by Masashi Honma #2326.
amisare's avatar
amisare committed
33 34
   * Remove the mbedtls namespacing from the header file, to fix a "file not found"
     build error. Fixed by Haijun Gu #2319.
35
   * Fix returning the value 1 when mbedtls_ecdsa_genkey failed.
Peter Kolbus's avatar
Peter Kolbus committed
36 37
   * Fix false failure in all.sh when backup files exist in include/mbedtls
     (e.g. config.h.bak). Fixed by Peter Kolbus (Garmin) #2407.
38 39 40 41 42 43
   * Ensure that unused bits are zero when writing ASN.1 bitstrings when using
     mbedtls_asn1_write_bitstring().
   * Fix issue when writing the named bitstrings in KeyUsage and NsCertType
     extensions in CSRs and CRTs that caused these bitstrings to not be encoded
     correctly as trailing zeroes were not accounted for as unused bits in the
     leading content octet. Fixes #1610.
Darryl Green's avatar
Darryl Green committed
44

45 46 47 48
Changes
   * Include configuration file in all header files that use configuration,
     instead of relying on other header files that they include.
     Inserted as an enhancement for #1371
49 50
   * Add support for alternative CSR headers, as used by Microsoft and defined
     in RFC 7468. Found by Michael Ernst. Fixes #767.
51 52
   * Fix configuration queries in ssl-opt.h. #2030
   * Ensure that ssl-opt.h can be run in OS X. #2029
53 54
   * Reduce the complexity of the timing tests. They were assuming more than the
     underlying OS actually guarantees.
k-stachowiak's avatar
k-stachowiak committed
55 56
   * Re-enable certain interoperability tests in ssl-opt.sh which had previously
     been disabled for lack of a sufficiently recent version of GnuTLS on the CI.
57 58
   * Ciphersuites based on 3DES now have the lowest priority by default when
     they are enabled.
59
>>>>>>> mbedtls-2.16.1
Ron Eldor's avatar
Ron Eldor committed
60

61
= mbed TLS 2.16.0 branch released 2018-12-21
Gilles Peskine's avatar
Gilles Peskine committed
62

63
Features
64 65 66 67 68 69 70 71
   * Add a new config.h option of MBEDTLS_CHECK_PARAMS that enables validation
     of parameters in the API. This allows detection of obvious misuses of the
     API, such as passing NULL pointers. The API of existing functions hasn't
     changed, but requirements on parameters have been made more explicit in
     the documentation. See the corresponding API documentation for each
     function to see for which parameter values it is defined. This feature is
     disabled by default. See its API documentation in config.h for additional
     steps you have to take when enabling it.
72

73 74 75 76 77 78 79 80 81
API Changes
   * The following functions in the random generator modules have been
     deprecated and replaced as shown below. The new functions change
     the return type from void to int to allow returning error codes when
     using MBEDTLS_<MODULE>_ALT for the underlying AES or message digest
     primitive. Fixes #1798.
     mbedtls_ctr_drbg_update() -> mbedtls_ctr_drbg_update_ret()
     mbedtls_hmac_drbg_update() -> mbedtls_hmac_drbg_update_ret()
   * Extend ECDH interface to enable alternative implementations.
82 83 84 85 86 87 88 89 90 91 92 93 94
   * Deprecate error codes of the form MBEDTLS_ERR_xxx_INVALID_KEY_LENGTH for
     ARIA, CAMELLIA and Blowfish. These error codes will be replaced by
     the more generic per-module error codes MBEDTLS_ERR_xxx_BAD_INPUT_DATA.
   * Additional parameter validation checks have been added for the following
     modules - AES, ARIA, Blowfish, CAMELLIA, CCM, GCM, DHM, ECP, ECDSA, ECDH,
     ECJPAKE, SHA, Chacha20 and Poly1305, cipher, pk, RSA, and MPI.
     Where modules have had parameter validation added, existing parameter
     checks may have changed. Some modules, such as Chacha20 had existing
     parameter validation whereas other modules had little. This has now been
     changed so that the same level of validation is present in all modules, and
     that it is now optional with the MBEDTLS_CHECK_PARAMS flag which by default
     is off. That means that checks which were previously present by default
     will no longer be.
95

96 97 98
New deprecations
   * Deprecate mbedtls_ctr_drbg_update and mbedtls_hmac_drbg_update
     in favor of functions that can return an error code.
Gilles Peskine's avatar
Gilles Peskine committed
99

100 101 102 103
Bugfix
   * Fix for Clang, which was reporting a warning for the bignum.c inline
     assembly for AMD64 targets creating string literals greater than those
     permitted by the ISO C99 standard. Found by Aaron Jones. Fixes #482.
104 105 106
   * Fix runtime error in `mbedtls_platform_entropy_poll()` when run
     through qemu user emulation. Reported and fix suggested by randombit
     in #1212. Fixes #1212.
107 108 109
   * Fix an unsafe bounds check when restoring an SSL session from a ticket.
     This could lead to a buffer overflow, but only in case ticket authentication
     was broken. Reported and fix suggested by Guido Vranken in #659.
110 111 112
   * Add explicit integer to enumeration type casts to example program
     programs/pkey/gen_key which previously led to compilation failure
     on some toolchains. Reported by phoenixmcallister. Fixes #2170.
113 114
   * Fix double initialization of ECC hardware that made some accelerators
     hang.
115 116
   * Clarify documentation of mbedtls_ssl_set_own_cert() regarding the absence
     of check for certificate/key matching. Reported by Attila Molnar, #507.
117

118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146
= mbed TLS 2.14.1 branch released 2018-11-30

Security
   * Fix timing variations and memory access variations in RSA PKCS#1 v1.5
     decryption that could lead to a Bleichenbacher-style padding oracle
     attack. In TLS, this affects servers that accept ciphersuites based on
     RSA decryption (i.e. ciphersuites whose name contains RSA but not
     (EC)DH(E)). Discovered by Eyal Ronen (Weizmann Institute),  Robert Gillham
     (University of Adelaide), Daniel Genkin (University of Michigan),
     Adi Shamir (Weizmann Institute), David Wong (NCC Group), and Yuval Yarom
     (University of Adelaide, Data61). The attack is described in more detail
     in the paper available here: http://cat.eyalro.net/cat.pdf  CVE-2018-19608
   * In mbedtls_mpi_write_binary(), don't leak the exact size of the number
     via branching and memory access patterns. An attacker who could submit
     a plaintext for RSA PKCS#1 v1.5 decryption but only observe the timing
     of the decryption and not its result could nonetheless decrypt RSA
     plaintexts and forge RSA signatures. Other asymmetric algorithms may
     have been similarly vulnerable. Reported by Eyal Ronen, Robert Gillham,
     Daniel Genkin, Adi Shamir, David Wong and Yuval Yarom.
   * Wipe sensitive buffers on the stack in the CTR_DRBG and HMAC_DRBG
     modules.

API Changes
   * The new functions mbedtls_ctr_drbg_update_ret() and
     mbedtls_hmac_drbg_update_ret() are similar to mbedtls_ctr_drbg_update()
     and mbedtls_hmac_drbg_update() respectively, but the new functions
     report errors whereas the old functions return void. We recommend that
     applications use the new functions.

147
= mbed TLS 2.14.0 branch released 2018-11-19
148

Hanno Becker's avatar
Hanno Becker committed
149
Security
150
   * Fix overly strict DN comparison when looking for CRLs belonging to a
151
     particular CA. This previously led to ignoring CRLs when the CRL's issuer
152 153 154 155
     name and the CA's subject name differed in their string encoding (e.g.,
     one using PrintableString and the other UTF8String) or in the choice of
     upper and lower case. Reported by Henrik Andersson of Bosch GmbH in issue
     #1784.
Hanno Becker's avatar
Hanno Becker committed
156
   * Fix a flawed bounds check in server PSK hint parsing. In case the
157
     incoming message buffer was placed within the first 64KiB of address
Hanno Becker's avatar
Hanno Becker committed
158
     space and a PSK-(EC)DHE ciphersuite was used, this allowed an attacker
159 160
     to trigger a memory access up to 64KiB beyond the incoming message buffer,
     potentially leading to an application crash or information disclosure.
161 162 163 164
   * Fix mbedtls_mpi_is_prime() to use more rounds of probabilistic testing. The
     previous settings for the number of rounds made it practical for an
     adversary to construct non-primes that would be erroneously accepted as
     primes with high probability. This does not have an impact on the
165 166
     security of TLS, but can matter in other contexts with numbers chosen
     potentially by an adversary that should be prime and can be validated.
167 168 169 170 171
     For example, the number of rounds was enough to securely generate RSA key
     pairs or Diffie-Hellman parameters, but was insufficient to validate
     Diffie-Hellman parameters properly.
     See "Prime and Prejudice" by by Martin R. Albrecht and Jake Massimo and
     Kenneth G. Paterson and Juraj Somorovsky.
Hanno Becker's avatar
Hanno Becker committed
172

173
Features
174
   * Add support for temporarily suspending expensive ECC computations after
175 176 177 178 179
     some configurable amount of operations. This is intended to be used in
     constrained, single-threaded systems where ECC is time consuming and can
     block other operations until they complete. This is disabled by default,
     but can be enabled by MBEDTLS_ECP_RESTARTABLE at compile time and
     configured by mbedtls_ecp_set_max_ops() at runtime. It applies to the new
180 181 182 183
     xxx_restartable functions in ECP, ECDSA, PK and X.509 (CRL not supported
     yet), and to existing functions in ECDH and SSL (currently only
     implemented client-side, for ECDHE-ECDSA ciphersuites in TLS 1.2,
     including client authentication).
184 185 186 187
   * Add support for Arm CPU DSP extensions to accelerate asymmetric key
     operations. On CPUs where the extensions are available, they can accelerate
     MPI multiplications used in ECC and RSA cryptography. Contributed by
     Aurelien Jarno.
188 189 190 191 192
   * Extend RSASSA-PSS signature to allow a smaller salt size. Previously, PSS
     signature always used a salt with the same length as the hash, and returned
     an error if this was not possible. Now the salt size may be up to two bytes
     shorter. This allows the library to support all hash and signature sizes
     that comply with FIPS 186-4, including SHA-512 with a 1024-bit key.
193 194
   * Add support for 128-bit keys in CTR_DRBG. Note that using keys shorter
     than 256 bits limits the security of generated material to 128 bits.
195

196
API Changes
197 198 199 200
   * Add a common error code of `MBEDTLS_ERR_PLATFORM_FEATURE_UNSUPPORTED` for
     a feature that is not supported by underlying alternative
     implementations implementing cryptographic primitives. This is useful for
     hardware accelerators that don't implement all options or features.
201

Ron Eldor's avatar
Ron Eldor committed
202
New deprecations
203 204 205 206
   * All module specific errors following the form
     MBEDTLS_ERR_XXX_FEATURE_UNAVAILABLE that indicate a feature is not
     supported are deprecated and are now replaced by the new equivalent
     platform error.
207
   * All module specific generic hardware acceleration errors following the
208 209
     form MBEDTLS_ERR_XXX_HW_ACCEL_FAILED that are deprecated and are replaced
     by the equivalent plaform error.
210 211 212
   * Deprecate the function mbedtls_mpi_is_prime() in favor of
     mbedtls_mpi_is_prime_ext() which allows specifying the number of
     Miller-Rabin rounds.
Ron Eldor's avatar
Ron Eldor committed
213

214
Bugfix
215 216 217 218
   * Fix wrong order of freeing in programs/ssl/ssl_server2 example
     application leading to a memory leak in case both
     MBEDTLS_MEMORY_BUFFER_ALLOC_C and MBEDTLS_MEMORY_BACKTRACE are set.
     Fixes #2069.
219 220
   * Fix a bug in the update function for SSL ticket keys which previously
     invalidated keys of a lifetime of less than a 1s. Fixes #1968.
221 222
   * Fix failure in hmac_drbg in the benchmark sample application, when
     MBEDTLS_THREADING_C is defined. Found by TrinityTonic, #1095
Hanno Becker's avatar
Hanno Becker committed
223 224 225
   * Fix a bug in the record decryption routine ssl_decrypt_buf()
     which lead to accepting properly authenticated but improperly
     padded records in case of CBC ciphersuites using Encrypt-then-MAC.
Hanno Becker's avatar
Hanno Becker committed
226 227
   * Fix memory leak and freeing without initialization in the example
     program programs/x509/cert_write. Fixes #1422.
228 229
   * Ignore IV in mbedtls_cipher_set_iv() when the cipher mode is
     MBEDTLS_MODE_ECB. Found by ezdevelop. Fixes #1091.
Hanno Becker's avatar
Hanno Becker committed
230 231 232 233
   * Zeroize memory used for buffering or reassembling handshake messages
     after use.
   * Use `mbedtls_platform_zeroize()` instead of `memset()` for zeroization
     of sensitive data in the example programs aescrypt2 and crypt_and_hash.
Hanno Becker's avatar
Hanno Becker committed
234 235 236
   * Change the default string format used for various X.509 DN attributes to
     UTF8String. Previously, the use of the PrintableString format led to
     wildcards and non-ASCII characters being unusable in some DN attributes.
237 238
     Reported by raprepo in #1860 and by kevinpt in #468. Fix contributed by
     Thomas-Dee.
Hanno Becker's avatar
Hanno Becker committed
239 240 241 242
   * Fix compilation failure for configurations which use compile time
     replacements of standard calloc/free functions through the macros
     MBEDTLS_PLATFORM_CALLOC_MACRO and MBEDTLS_PLATFORM_FREE_MACRO.
     Reported by ole-de and ddhome2006. Fixes #882, #1642 and #1706.
243 244

Changes
245
   * Removed support for Yotta as a build tool.
246
   * Add tests for session resumption in DTLS.
Gilles Peskine's avatar
Gilles Peskine committed
247 248 249
   * Close a test gap in (D)TLS between the client side and the server side:
     test the handling of large packets and small packets on the client side
     in the same way as on the server side.
250 251
   * Change the dtls_client and dtls_server samples to work by default over
     IPv6 and optionally by a build option over IPv4.
252 253 254
   * Change the use of Windows threading to use Microsoft Visual C++ runtime
     calls, rather than Win32 API calls directly. This is necessary to avoid
     conflict with C runtime usage. Found and fixed by irwir.
255 256 257 258 259 260 261 262
   * Remember the string format of X.509 DN attributes when replicating
     X.509 DNs. Previously, DN attributes were always written in their default
     string format (mostly PrintableString), which could lead to CRTs being
     created which used PrintableStrings in the issuer field even though the
     signing CA used UTF8Strings in its subject field; while X.509 compliant,
     such CRTs were rejected in some applications, e.g. some versions of
     Firefox, curl and GnuTLS. Reported in #1033 by Moschn. Fix contributed by
     Thomas-Dee.
Hanno Becker's avatar
Hanno Becker committed
263 264
   * Improve documentation of mbedtls_ssl_get_verify_result().
     Fixes #517 reported by github-monoculture.
265 266 267
   * Add MBEDTLS_MPI_GEN_PRIME_FLAG_LOW_ERR flag to mbedtls_mpi_gen_prime() and
     use it to reduce error probability in RSA key generation to levels mandated
     by FIPS-186-4.
268

269
= mbed TLS 2.13.1 branch released 2018-09-06
270

271
API Changes
272
   * Extend the platform module with an abstraction mbedtls_platform_gmtime_r()
273
     whose implementation should behave as a thread-safe version of gmtime().
274
     This allows users to configure such an implementation at compile time when
275 276 277
     the target system cannot be deduced automatically, by setting the option
     MBEDTLS_PLATFORM_GMTIME_R_ALT. At this stage Mbed TLS is only able to
     automatically select implementations for Windows and POSIX C libraries.
278

279
Bugfix
280 281
   * Fix build failures on platforms where only gmtime() is available but
     neither gmtime_r() nor gmtime_s() are present. Fixes #1907.
282

283
= mbed TLS 2.13.0 branch released 2018-08-31
284

k-stachowiak's avatar
k-stachowiak committed
285
Security
k-stachowiak's avatar
k-stachowiak committed
286 287 288 289
   * Fix an issue in the X.509 module which could lead to a buffer overread
     during certificate extensions parsing. In case of receiving malformed
     input (extensions length field equal to 0), an illegal read of one byte
     beyond the input buffer is made. Found and analyzed by Nathan Crandall.
k-stachowiak's avatar
k-stachowiak committed
290

291
Features
292 293
   * Add support for fragmentation of outgoing DTLS handshake messages. This
     is controlled by the maximum fragment length as set locally or negotiated
294
     with the peer, as well as by a new per-connection MTU option, set using
295
     mbedtls_ssl_set_mtu().
296 297 298
   * Add support for auto-adjustment of MTU to a safe value during the
     handshake when flights do not get through (RFC 6347, section 4.1.1.1,
     last paragraph).
Hanno Becker's avatar
Hanno Becker committed
299 300
   * Add support for packing multiple records within a single datagram,
     enabled by default.
Hanno Becker's avatar
Hanno Becker committed
301
   * Add support for buffering out-of-order handshake messages in DTLS.
Hanno Becker's avatar
Hanno Becker committed
302 303 304
     The maximum amount of RAM used for this can be controlled by the
     compile-time constant MBEDTLS_SSL_DTLS_MAX_BUFFERING defined
     in mbedtls/config.h.
Hanno Becker's avatar
Hanno Becker committed
305 306

API Changes
307
   * Add function mbedtls_ssl_set_datagram_packing() to configure
Hanno Becker's avatar
Hanno Becker committed
308
     the use of datagram packing (enabled by default).
309

310
Bugfix
311 312
   * Fix a potential memory leak in mbedtls_ssl_setup() function. An allocation
     failure in the function could lead to other buffers being leaked.
313 314
   * Fixes an issue with MBEDTLS_CHACHAPOLY_C which would not compile if
     MBEDTLS_ARC4_C and MBEDTLS_CIPHER_NULL_CIPHER weren't also defined. #1890
315 316
   * Fix a memory leak in ecp_mul_comb() if ecp_precompute_comb() fails.
     Fix contributed by Espressif Systems.
Ron Eldor's avatar
Ron Eldor committed
317
   * Add ecc extensions only if an ecc based ciphersuite is used.
Ron Eldor's avatar
Ron Eldor committed
318 319
     This improves compliance to RFC 4492, and as a result, solves
     interoperability issues with BouncyCastle. Raised by milenamil in #1157.
320 321
   * Replace printf with mbedtls_printf in the ARIA module. Found by
     TrinityTonic in #1908.
322
   * Fix potential use-after-free in mbedtls_ssl_get_max_frag_len()
Hanno Becker's avatar
Hanno Becker committed
323
     and mbedtls_ssl_get_record_expansion() after a session reset. Fixes #1941.
324 325 326 327 328
   * Fix a bug that caused SSL/TLS clients to incorrectly abort the handshake
     with TLS versions 1.1 and earlier when the server requested authentication
     without providing a list of CAs. This was due to an overly strict bounds
     check in parsing the CertificateRequest message,
     introduced in Mbed TLS 2.12.0. Fixes #1954.
Hanno Becker's avatar
Hanno Becker committed
329 330 331
   * Fix a miscalculation of the maximum record expansion in
     mbedtls_ssl_get_record_expansion() in case of ChachaPoly ciphersuites,
     or CBC ciphersuites in (D)TLS versions 1.1 or higher. Fixes #1913, #1914.
332 333
   * Fix undefined shifts with negative values in certificates parsing
     (found by Catena cyber using oss-fuzz)
Hanno Becker's avatar
Hanno Becker committed
334 335
   * Fix memory leak and free without initialization in pk_encrypt
     and pk_decrypt example programs. Reported by Brace Stout. Fixes #1128.
336
   * Remove redundant else statement. Raised by irwir. Fixes #1776.
337

338 339 340
Changes
   * Copy headers preserving timestamps when doing a "make install".
     Contributed by xueruini.
341 342
   * Allow the forward declaration of public structs. Contributed by Dawid
     Drozd. Fixes #1215 raised by randombit.
343 344
   * Improve compatibility with some alternative CCM implementations by using
     CCM test vectors from RAM.
Hanno Becker's avatar
Hanno Becker committed
345
   * Add support for buffering of out-of-order handshake messages.
346 347 348 349
   * Add warnings to the documentation of the HKDF module to reduce the risk
     of misusing the mbedtls_hkdf_extract() and mbedtls_hkdf_expand()
     functions. Fixes #1775. Reported by Brian J. Murray.

Jaeden Amero's avatar
Jaeden Amero committed
350
= mbed TLS 2.12.0 branch released 2018-07-25
351

Gilles Peskine's avatar
Gilles Peskine committed
352 353 354 355 356 357 358 359 360 361 362 363 364 365
Security
   * Fix a vulnerability in TLS ciphersuites based on CBC and using SHA-384,
     in (D)TLS 1.0 to 1.2, that allowed an active network attacker to
     partially recover the plaintext of messages under some conditions by
     exploiting timing measurements. With DTLS, the attacker could perform
     this recovery by sending many messages in the same connection. With TLS
     or if mbedtls_ssl_conf_dtls_badmac_limit() was used, the attack only
     worked if the same secret (for example a HTTP Cookie) has been repeatedly
     sent over connections manipulated by the attacker. Connections using GCM
     or CCM instead of CBC, using hash sizes other than SHA-384, or using
     Encrypt-then-Mac (RFC 7366) were not affected. The vulnerability was
     caused by a miscalculation (for SHA-384) in a countermeasure to the
     original Lucky 13 attack. Found by Kenny Paterson, Eyal Ronen and Adi
     Shamir.
366 367 368
   * Fix a vulnerability in TLS ciphersuites based on CBC, in (D)TLS 1.0 to
     1.2, that allowed a local attacker, able to execute code on the local
     machine as well as manipulate network packets, to partially recover the
369 370 371 372 373 374 375
     plaintext of messages under some conditions by using a cache attack
     targetting an internal MD/SHA buffer. With TLS or if
     mbedtls_ssl_conf_dtls_badmac_limit() was used, the attack only worked if
     the same secret (for example a HTTP Cookie) has been repeatedly sent over
     connections manipulated by the attacker. Connections using GCM or CCM
     instead of CBC or using Encrypt-then-Mac (RFC 7366) were not affected.
     Found by Kenny Paterson, Eyal Ronen and Adi Shamir.
376 377 378 379 380 381 382 383
   * Add a counter-measure against a vulnerability in TLS ciphersuites based
     on CBC, in (D)TLS 1.0 to 1.2, that allowed a local attacker, able to
     execute code on the local machine as well as manipulate network packets,
     to partially recover the plaintext of messages under some conditions (see
     previous entry) by using a cache attack targeting the SSL input record
     buffer. Connections using GCM or CCM instead of CBC or using
     Encrypt-then-Mac (RFC 7366) were not affected. Found by Kenny Paterson,
     Eyal Ronen and Adi Shamir.
Gilles Peskine's avatar
Gilles Peskine committed
384

385 386
Features
   * Add new crypto primitives from RFC 7539: stream cipher Chacha20, one-time
387
     authenticator Poly1305 and AEAD construct Chacha20-Poly1305. Contributed
388
     by Daniel King.
389
   * Add support for CHACHA20-POLY1305 ciphersuites from RFC 7905.
390 391
   * Add platform support for the Haiku OS. (https://www.haiku-os.org).
     Contributed by Augustin Cavalier.
392 393 394 395 396
   * Make the receive and transmit buffers independent sizes, for situations
     where the outgoing buffer can be fixed at a smaller size than the incoming
     buffer, which can save some RAM. If buffer lengths are kept equal, there
     is no functional difference. Contributed by Angus Gratton, and also
     independently contributed again by Paul Sokolovsky.
Ron Eldor's avatar
Ron Eldor committed
397
   * Add support for key wrapping modes based on AES as defined by
398
     NIST SP 800-38F algorithms KW and KWP and by RFC 3394 and RFC 5649.
399

400 401 402
Bugfix
   * Fix the key_app_writer example which was writing a leading zero byte which
     was creating an invalid ASN.1 tag. Found by Aryeh R. Fixes #1257.
niisato's avatar
niisato committed
403
   * Fix compilation error on C++, because of a variable named new.
niisato's avatar
niisato committed
404
     Found and fixed by Hirotaka Niisato in #1783.
405
   * Fix "no symbols" warning issued by ranlib when building on Mac OS X. Fix
406
     contributed by tabascoeye.
407 408
   * Clarify documentation for mbedtls_ssl_write() to include 0 as a valid
     return value. Found by @davidwu2000. #839
409 410
   * Fix a memory leak in mbedtls_x509_csr_parse(), found by catenacyber,
     Philippe Antoine. Fixes #1623.
411 412
   * Remove unused headers included in x509.c. Found by Chris Hanson and fixed
     by Brendan Shanks. Part of a fix for #992.
Ron Eldor's avatar
Ron Eldor committed
413 414
   * Fix compilation error when MBEDTLS_ARC4_C is disabled and
     MBEDTLS_CIPHER_NULL_CIPHER is enabled. Found by TrinityTonic in #1719.
415 416
   * Added length checks to some TLS parsing functions. Found and fixed by
     Philippe Antoine from Catena cyber. #1663.
417 418
   * Fix the inline assembly for the MPI multiply helper function for i386 and
     i386 with SSE2. Found by László Langó. Fixes #1550
Ron Eldor's avatar
Ron Eldor committed
419
   * Fix namespacing in header files. Remove the `mbedtls` namespacing in
420
     the `#include` in the header files. Resolves #857
421 422 423
   * Fix compiler warning of 'use before initialisation' in
     mbedtls_pk_parse_key(). Found by Martin Boye Petersen and fixed by Dawid
     Drozd. #1098
424 425 426 427 428 429
   * Fix decryption for zero length messages (which contain all padding) when a
     CBC based ciphersuite is used together with Encrypt-then-MAC. Previously,
     such a message was wrongly reported as an invalid record and therefore lead
     to the connection being terminated. Seen most often with OpenSSL using
     TLS 1.0. Reported by @kFYatek and by Conor Murphy on the forum. Fix
     contributed by Espressif Systems. Fixes #1632
430 431 432
   * Fix ssl_client2 example to send application data with 0-length content
     when the request_size argument is set to 0 as stated in the documentation.
     Fixes #1833.
433 434
   * Correct the documentation for `mbedtls_ssl_get_session()`. This API has
     deep copy of the session, and the peer certificate is not lost. Fixes #926.
435
   * Fix build using -std=c99. Fixed by Nick Wilson.
436

437
Changes
438 439 440 441 442
   * Fail when receiving a TLS alert message with an invalid length, or invalid
     zero-length messages when using TLS 1.2. Contributed by Espressif Systems.
   * Change the default behaviour of mbedtls_hkdf_extract() to return an error
     when calling with a NULL salt and non-zero salt_len. Contributed by
     Brian J Murray
443 444
   * Change the shebang line in Perl scripts to look up perl in the PATH.
     Contributed by fbrosson.
445 446 447
   * Allow overriding the time on Windows via the platform-time abstraction.
     Fixed by Nick Wilson.
   * Use gmtime_r/gmtime_s for thread-safety. Fixed by Nick Wilson.
448

449 450 451
= mbed TLS 2.11.0 branch released 2018-06-18

Features
452 453 454 455 456
   * Add additional block mode, OFB (Output Feedback), to the AES module and
     cipher abstraction module.
   * Implement the HMAC-based extract-and-expand key derivation function
     (HKDF) per RFC 5869. Contributed by Thomas Fossati.
   * Add support for the CCM* block cipher mode as defined in IEEE Std. 802.15.4.
457 458
   * Add support for the XTS block cipher mode with AES (AES-XTS).
     Contributed by Aorimn in pull request #414.
459 460 461
   * In TLS servers, support offloading private key operations to an external
     cryptoprocessor. Private key operations can be asynchronous to allow
     non-blocking operation of the TLS server stack.
462

463
Bugfix
464 465
   * Fix the cert_write example to handle certificates signed with elliptic
     curves as well as RSA. Fixes #777 found by dbedev.
466 467
   * Fix for redefinition of _WIN32_WINNT to avoid overriding a definition
     used by user applications. Found and fixed by Fabio Alessandrelli.
468 469
   * Fix compilation warnings with IAR toolchain, on 32 bit platform.
     Reported by rahmanih in #683
470
   * Fix braces in mbedtls_memory_buffer_alloc_status(). Found by sbranden, #552.
471 472 473

Changes
   * Changed CMake defaults for IAR to treat all compiler warnings as errors.
474 475 476
   * Changed the Clang parameters used in the CMake build files to work for
     versions later than 3.6. Versions of Clang earlier than this may no longer
     work. Fixes #1072
477

478
= mbed TLS 2.10.0 branch released 2018-06-06
479

480 481 482 483
Features
   * Add support for ARIA cipher (RFC 5794) and associated TLS ciphersuites
     (RFC 6209). Disabled by default, see MBEDTLS_ARIA_C in config.h

484
API Changes
485 486 487 488 489 490 491 492 493
   * Extend the platform module with a util component that contains
     functionality shared by multiple Mbed TLS modules. At this stage
     platform_util.h (and its associated platform_util.c) only contain
     mbedtls_platform_zeroize(), which is a critical function from a security
     point of view. mbedtls_platform_zeroize() needs to be regularly tested
     against compilers to ensure that calls to it are not removed from the
     output binary as part of redundant code elimination optimizations.
     Therefore, mbedtls_platform_zeroize() is moved to the platform module to
     facilitate testing and maintenance.
494

495 496 497 498
Bugfix
   * Fix an issue with MicroBlaze support in bn_mul.h which was causing the
     build to fail. Found by zv-io. Fixes #1651.

499 500
Changes
   * Support TLS testing in out-of-source builds using cmake. Fixes #1193.
501 502
   * Fix redundant declaration of mbedtls_ssl_list_ciphersuites. Raised by
     TrinityTonic. #1359.
503

Jaeden Amero's avatar
Jaeden Amero committed
504
= mbed TLS 2.9.0 branch released 2018-04-30
505

506
Security
507 508 509 510 511 512 513 514 515 516 517 518 519
   * Fix an issue in the X.509 module which could lead to a buffer overread
     during certificate validation. Additionally, the issue could also lead to
     unnecessary callback checks being made or to some validation checks to be
     omitted. The overread could be triggered remotely, while the other issues
     would require a non DER-compliant certificate to be correctly signed by a
     trusted CA, or a trusted CA with a non DER-compliant certificate. Found by
     luocm. Fixes #825.
   * Fix the buffer length assertion in the ssl_parse_certificate_request()
     function which led to an arbitrary overread of the message buffer. The
     overreads could be caused by receiving a malformed message at the point
     where an optional signature algorithms list is expected when the signature
     algorithms section is too short. In builds with debug output, the overread
     data is output with the debug data.
Andrzej Kurek's avatar
Andrzej Kurek committed
520
   * Fix a client-side bug in the validation of the server's ciphersuite choice
521 522 523 524
     which could potentially lead to the client accepting a ciphersuite it didn't
     offer or a ciphersuite that cannot be used with the TLS or DTLS version
     chosen by the server. This could lead to corruption of internal data
     structures for some configurations.
525

526
Features
527 528 529
   * Add an option, MBEDTLS_AES_FEWER_TABLES, to dynamically compute smaller AES
     tables during runtime, thereby reducing the RAM/ROM footprint by ~6KiB.
     Suggested and contributed by jkivilin in pull request #394.
Gilles Peskine's avatar
Gilles Peskine committed
530 531 532
   * Add initial support for Curve448 (RFC 7748). Only mbedtls_ecp_mul() and
     ECDH primitive functions (mbedtls_ecdh_gen_public(),
     mbedtls_ecdh_compute_shared()) are supported for now. Contributed by
533
     Nicholas Wilson in pull request #348.
534

535
API Changes
536 537 538 539 540 541
   * Extend the public API with the function of mbedtls_net_poll() to allow user
     applications to wait for a network context to become ready before reading
     or writing.
   * Add function mbedtls_ssl_check_pending() to the public API to allow
     a check for whether more more data is pending to be processed in the
     internal message buffers.
542 543 544
     This function is necessary to determine when it is safe to idle on the
     underlying transport in case event-driven IO is used.

545
Bugfix
546
   * Fix a spurious uninitialized variable warning in cmac.c. Fix independently
547
     contributed by Brian J Murray and David Brown.
548 549 550
   * Add missing dependencies in test suites that led to build failures
     in configurations that omit certain hashes or public-key algorithms.
     Fixes #1040.
551 552
   * Fix C89 incompatibility in benchmark.c. Contributed by Brendan Shanks.
     #1353
Gilles Peskine's avatar
Gilles Peskine committed
553
   * Add missing dependencies for MBEDTLS_HAVE_TIME_DATE and
554 555 556 557
     MBEDTLS_VERSION_FEATURES in some test suites. Contributed by
     Deomid Ryabkov. Fixes #1299, #1475.
   * Fix the Makefile build process for building shared libraries on Mac OS X.
     Fixed by mnacamura.
558
   * Fix parsing of PKCS#8 encoded Elliptic Curve keys. Previously Mbed TLS was
559
     unable to parse keys which had only the optional parameters field of the
560
     ECPrivateKey structure. Found by Jethro Beekman, fixed in #1379.
561 562 563
   * Return the plaintext data more quickly on unpadded CBC decryption, as
     stated in the mbedtls_cipher_update() documentation. Contributed by
     Andy Leiserson.
564 565
   * Fix overriding and ignoring return values when parsing and writing to
     a file in pk_sign program. Found by kevlut in #1142.
566 567 568 569 570
   * Restrict usage of error code MBEDTLS_ERR_SSL_WANT_READ to situations
     where data needs to be fetched from the underlying transport in order
     to make progress. Previously, this error code was also occasionally
     returned when unexpected messages were being discarded, ignoring that
     further messages could potentially already be pending to be processed
571 572
     in the internal buffers; these cases led to deadlocks when event-driven
     I/O was used. Found and reported by Hubert Mis in #772.
573 574 575
   * Fix buffer length assertions in the ssl_parse_certificate_request()
     function which leads to a potential one byte overread of the message
     buffer.
576 577
   * Fix invalid buffer sizes passed to zlib during record compression and
     decompression.
578 579 580 581
   * Fix the soversion of libmbedcrypto to match the soversion of the
     maintained 2.7 branch. The soversion was increased in Mbed TLS
     version 2.7.1 to reflect breaking changes in that release, but the
     increment was missed in 2.8.0 and later releases outside of the 2.7 branch.
582

583 584
Changes
   * Remove some redundant code in bignum.c. Contributed by Alexey Skalozub.
585 586
   * Support cmake builds where Mbed TLS is a subproject. Fix contributed
     independently by Matthieu Volat and Arne Schwabe.
587 588 589
   * Improve testing in configurations that omit certain hashes or
     public-key algorithms. Includes contributions by Gert van Dijk.
   * Improve negative testing of X.509 parsing.
590 591 592
   * Do not define global mutexes around readdir() and gmtime() in
     configurations where the feature is disabled. Found and fixed by Gergely
     Budai.
593 594 595 596
   * Harden the function mbedtls_ssl_config_free() against misuse, so that it
     doesn't leak memory if the user doesn't use mbedtls_ssl_conf_psk() and
     instead incorrectly manipulates the configuration structure directly.
     Found and fix submitted by junyeonLEE in #1220.
597 598 599
   * Provide an empty implementation of mbedtls_pkcs5_pbes2() when
     MBEDTLS_ASN1_PARSE_C is not enabled. This allows the use of PBKDF2
     without PBES2. Fixed by Marcos Del Sol Vives.
600 601 602
   * Add the order of the base point as N in the mbedtls_ecp_group structure
     for Curve25519 (other curves had it already). Contributed by Nicholas
     Wilson #481
603 604
   * Improve the documentation of mbedtls_net_accept(). Contributed by Ivan
     Krylov.
605 606
   * Improve the documentation of mbedtls_ssl_write(). Suggested by
     Paul Sokolovsky in #1356.
607
   * Add an option in the Makefile to support ar utilities where the operation
608 609
     letter must not be prefixed by '-', such as LLVM. Found and fixed by
     Alex Hixon.
610
   * Allow configuring the shared library extension by setting the DLEXT
611
     environment variable when using the project makefiles.
612
   * Optimize unnecessary zeroing in mbedtls_mpi_copy. Based on a contribution
613
     by Alexey Skalozub in #405.
614 615 616
   * In the SSL module, when f_send, f_recv or f_recv_timeout report
     transmitting more than the required length, return an error. Raised by
     Sam O'Connor in #1245.
617 618 619
   * Improve robustness of mbedtls_ssl_derive_keys against the use of
     HMAC functions with non-HMAC ciphersuites. Independently contributed
     by Jiayuan Chen in #1377. Fixes #1437.
620 621
   * Improve security of RSA key generation by including criteria from
     FIPS 186-4. Contributed by Jethro Beekman. #1380
Gilles Peskine's avatar
Gilles Peskine committed
622 623 624 625 626
   * Declare functions in header files even when an alternative implementation
     of the corresponding module is activated by defining the corresponding
     MBEDTLS_XXX_ALT macro. This means that alternative implementations do
     not need to copy the declarations, and ensures that they will have the
     same API.
Andrzej Kurek's avatar
Andrzej Kurek committed
627
   * Add platform setup and teardown calls in test suites.
628

Jaeden Amero's avatar
Jaeden Amero committed
629
= mbed TLS 2.8.0 branch released 2018-03-16
630

631 632 633 634 635 636 637 638 639
Default behavior changes
   * The truncated HMAC extension now conforms to RFC 6066. This means
     that when both sides of a TLS connection negotiate the truncated
     HMAC extension, Mbed TLS can now interoperate with other
     compliant implementations, but this breaks interoperability with
     prior versions of Mbed TLS. To restore the old behavior, enable
     the (deprecated) option MBEDTLS_SSL_TRUNCATED_HMAC_COMPAT in
     config.h. Found by Andreas Walz (ivESK, Offenburg University of
     Applied Sciences).
640

641
Security
642 643 644 645
   * Fix implementation of the truncated HMAC extension. The previous
     implementation allowed an offline 2^80 brute force attack on the
     HMAC key of a single, uninterrupted connection (with no
     resumption of the session).
646 647
   * Verify results of RSA private key operations to defend
     against Bellcore glitch attack.
Krzysztof Stachowiak's avatar
Krzysztof Stachowiak committed
648 649
   * Fix a buffer overread in ssl_parse_server_key_exchange() that could cause
     a crash on invalid input.
650 651
   * Fix a buffer overread in ssl_parse_server_psk_hint() that could cause a
     crash on invalid input.
652 653
   * Fix CRL parsing to reject CRLs containing unsupported critical
     extensions. Found by Falko Strenzke and Evangelos Karatsiolis.
Hanno Becker's avatar
Hanno Becker committed
654

655 656 657
Features
   * Extend PKCS#8 interface by introducing support for the entire SHA
     algorithms family when encrypting private keys using PKCS#5 v2.0.
658 659 660
     This allows reading encrypted PEM files produced by software that
     uses PBKDF2-SHA2, such as OpenSSL 1.1. Submitted by Antonio Quartulli,
     OpenVPN Inc. Fixes #1339
661
   * Add support for public keys encoded in PKCS#1 format. #1122
662

663 664 665 666
New deprecations
   * Deprecate support for record compression (configuration option
     MBEDTLS_ZLIB_SUPPORT).

667 668 669
Bugfix
   * Fix the name of a DHE parameter that was accidentally changed in 2.7.0.
     Fixes #1358.
670
   * Fix test_suite_pk to work on 64-bit ILP32 systems. #849
Ron Eldor's avatar
Ron Eldor committed
671 672
   * Fix mbedtls_x509_crt_profile_suiteb, which used to reject all certificates
     with flag MBEDTLS_X509_BADCERT_BAD_PK even when the key type was correct.
673 674
     In the context of SSL, this resulted in handshake failure. Reported by
     daniel in the Mbed TLS forum. #1351
675
   * Fix Windows x64 builds with the included mbedTLS.sln file. #1347
676 677 678 679
   * Fix setting version TLSv1 as minimal version, even if TLS 1
     is not enabled. Set MBEDTLS_SSL_MIN_MAJOR_VERSION
     and MBEDTLS_SSL_MIN_MINOR_VERSION instead of
     MBEDTLS_SSL_MAJOR_VERSION_3 and MBEDTLS_SSL_MINOR_VERSION_1. #664
Ron Eldor's avatar
Ron Eldor committed
680 681
   * Fix compilation error on Mingw32 when _TRUNCATE is defined. Use _TRUNCATE
     only if __MINGW32__ not defined. Fix suggested by Thomas Glanzmann and
682
     Nick Wilson on issue #355
683
   * In test_suite_pk, pass valid parameters when testing for hash length
684
     overflow. #1179
685 686
   * Fix memory allocation corner cases in memory_buffer_alloc.c module. Found
     by Guido Vranken. #639
687
   * Log correct number of ciphersuites used in Client Hello message. #918
688 689
   * Fix X509 CRT parsing that would potentially accept an invalid tag when
     parsing the subject alternative names.
Krzysztof Stachowiak's avatar
Krzysztof Stachowiak committed
690 691
   * Fix a possible arithmetic overflow in ssl_parse_server_key_exchange()
     that could cause a key exchange to fail on valid data.
692 693
   * Fix a possible arithmetic overflow in ssl_parse_server_psk_hint() that
     could cause a key exchange to fail on valid data.
694 695
   * Don't define mbedtls_aes_decrypt and mbedtls_aes_encrypt under
     MBEDTLS_DEPRECATED_REMOVED. #1388
Sanne Wouda's avatar
Sanne Wouda committed
696 697
   * Fix a 1-byte heap buffer overflow (read-only) during private key parsing.
     Found through fuzz testing.
698 699 700 701

Changes
   * Fix tag lengths and value ranges in the documentation of CCM encryption.
     Contributed by Mathieu Briand.
702
   * Fix typo in a comment ctr_drbg.c. Contributed by Paul Sokolovsky.
703
   * Remove support for the library reference configuration for picocoin.
704 705
   * MD functions deprecated in 2.7.0 are no longer inline, to provide
     a migration path for those depending on the library's ABI.
Gilles Peskine's avatar
Gilles Peskine committed
706
   * Clarify the documentation of mbedtls_ssl_setup.
707 708
   * Use (void) when defining functions with no parameters. Contributed by
     Joris Aerts. #678
709

710
= mbed TLS 2.7.0 branch released 2018-02-03
711

712
Security
713 714 715 716 717 718 719 720 721 722 723 724 725 726 727
   * Fix a heap corruption issue in the implementation of the truncated HMAC
     extension. When the truncated HMAC extension is enabled and CBC is used,
     sending a malicious application packet could be used to selectively corrupt
     6 bytes on the peer's heap, which could potentially lead to crash or remote
     code execution. The issue could be triggered remotely from either side in
     both TLS and DTLS. CVE-2018-0488
   * Fix a buffer overflow in RSA-PSS verification when the hash was too large
     for the key size, which could potentially lead to crash or remote code
     execution. Found by Seth Terashima, Qualcomm Product Security Initiative,
     Qualcomm Technologies Inc. CVE-2018-0487
   * Fix buffer overflow in RSA-PSS verification when the unmasked data is all
     zeros.
   * Fix an unsafe bounds check in ssl_parse_client_psk_identity() when adding
     64 KiB to the address of the SSL buffer and causing a wrap around.
   * Fix a potential heap buffer overflow in mbedtls_ssl_write(). When the (by
Hanno Becker's avatar
Hanno Becker committed
728 729 730 731 732 733
     default enabled) maximum fragment length extension is disabled in the
     config and the application data buffer passed to mbedtls_ssl_write
     is larger than the internal message buffer (16384 bytes by default), the
     latter overflows. The exploitability of this issue depends on whether the
     application layer can be forced into sending such large packets. The issue
     was independently reported by Tim Nordell via e-mail and by Florin Petriuc
734 735 736 737
     and sjorsdewit on GitHub. Fix proposed by Florin Petriuc in #1022.
     Fixes #707.
   * Add a provision to prevent compiler optimizations breaking the time
     constancy of mbedtls_ssl_safer_memcmp().
738
   * Ensure that buffers are cleared after use if they contain sensitive data.
739
     Changes were introduced in multiple places in the library.
740 741
   * Set PEM buffer to zero before freeing it, to avoid decoded private keys
     being leaked to memory after release.
742 743
   * Fix dhm_check_range() failing to detect trivial subgroups and potentially
     leaking 1 bit of the private key. Reported by prashantkspatil.
744 745 746 747
   * Make mbedtls_mpi_read_binary() constant-time with respect to the input
     data. Previously, trailing zero bytes were detected and omitted for the
     sake of saving memory, but potentially leading to slight timing
     differences. Reported by Marco Macchetti, Kudelski Group.
748 749
   * Wipe stack buffer temporarily holding EC private exponent
     after keypair generation.
750
   * Fix a potential heap buffer over-read in ALPN extension parsing
751 752
     (server-side). Could result in application crash, but only if an ALPN
     name larger than 16 bytes had been configured on the server.
Hanno Becker's avatar
Hanno Becker committed
753 754 755
   * Change default choice of DHE parameters from untrustworthy RFC 5114
     to RFC 3526 containing parameters generated in a nothing-up-my-sleeve
     manner.
756

757 758
Features
   * Allow comments in test data files.
759 760
   * The selftest program can execute a subset of the tests based on command
     line arguments.
761 762
   * New unit tests for timing. Improve the self-test to be more robust
     when run on a heavily-loaded machine.
763
   * Add alternative implementation support for CCM and CMAC (MBEDTLS_CCM_ALT,
764
     MBEDTLS_CMAC_ALT). Submitted by Steven Cooreman, Silicon Labs.
765
   * Add support for alternative implementations of GCM, selected by the
766
     configuration flag MBEDTLS_GCM_ALT.
767 768 769 770 771 772
   * Add support for alternative implementations for ECDSA, controlled by new
     configuration flags MBEDTLS_ECDSA_SIGN_ALT, MBEDTLS_ECDSA_VERIFY_ALT and
     MBEDTLS_ECDSDA_GENKEY_AT in config.h.
     The following functions from the ECDSA module can be replaced
     with alternative implementation:
     mbedtls_ecdsa_sign(), mbedtls_ecdsa_verify() and mbedtls_ecdsa_genkey().
773 774
   * Add support for alternative implementation of ECDH, controlled by the
     new configuration flags MBEDTLS_ECDH_COMPUTE_SHARED_ALT and
775 776 777 778
     MBEDTLS_ECDH_GEN_PUBLIC_ALT in config.h.
     The following functions from the ECDH module can be replaced
     with an alternative implementation:
     mbedtls_ecdh_gen_public() and mbedtls_ecdh_compute_shared().
779 780
   * Add support for alternative implementation of ECJPAKE, controlled by
     the new configuration flag MBEDTLS_ECJPAKE_ALT.
781
   * Add mechanism to provide alternative implementation of the DHM module.
782

783 784 785
API Changes
   * Extend RSA interface by multiple functions allowing structure-
     independent setup and export of RSA contexts. Most notably,
786
     mbedtls_rsa_import() and mbedtls_rsa_complete() are introduced for setting
787 788 789 790 791 792
     up RSA contexts from partial key material and having them completed to the
     needs of the implementation automatically. This allows to setup private RSA
     contexts from keys consisting of N,D,E only, even if P,Q are needed for the
     purpose or CRT and/or blinding.
   * The configuration option MBEDTLS_RSA_ALT can be used to define alternative
     implementations of the RSA interface declared in rsa.h.
793 794 795 796 797 798 799
   * The following functions in the message digest modules (MD2, MD4, MD5,
     SHA1, SHA256, SHA512) have been deprecated and replaced as shown below.
     The new functions change the return type from void to int to allow
     returning error codes when using MBEDTLS_<MODULE>_ALT.
     mbedtls_<MODULE>_starts() -> mbedtls_<MODULE>_starts_ret()
     mbedtls_<MODULE>_update() -> mbedtls_<MODULE>_update_ret()
     mbedtls_<MODULE>_finish() -> mbedtls_<MODULE>_finish_ret()
800
     mbedtls_<MODULE>_process() -> mbedtls_internal_<MODULE>_process()
801

802 803
New deprecations
   * Deprecate usage of RSA primitives with non-matching key-type
804
     (e.g. signing with a public key).
805 806
   * Direct manipulation of structure fields of RSA contexts is deprecated.
     Users are advised to use the extended RSA API instead.
807 808 809 810 811
   * Deprecate usage of message digest functions that return void
     (mbedtls_<MODULE>_starts, mbedtls_<MODULE>_update,
     mbedtls_<MODULE>_finish and mbedtls_<MODULE>_process where <MODULE> is
     any of MD2, MD4, MD5, SHA1, SHA256, SHA512) in favor of functions
     that can return an error code.
Hanno Becker's avatar
Hanno Becker committed
812 813 814 815 816
   * Deprecate untrustworthy DHE parameters from RFC 5114. Superseded by
     parameters from RFC 3526 or the newly added parameters from RFC 7919.
   * Deprecate hex string DHE constants MBEDTLS_DHM_RFC3526_MODP_2048_P etc.
     Supserseded by binary encoded constants MBEDTLS_DHM_RFC3526_MODP_2048_P_BIN
     etc.
817 818
   * Deprecate mbedtls_ssl_conf_dh_param() for setting default DHE parameters
     from hex strings. Superseded by mbedtls_ssl_conf_dh_param_bin()
Hanno Becker's avatar
Hanno Becker committed
819
     accepting DHM parameters in binary form, matching the new constants.
820

821
Bugfix
822 823
   * Fix ssl_parse_record_header() to silently discard invalid DTLS records
     as recommended in RFC 6347 Section 4.1.2.7.
824
   * Fix memory leak in mbedtls_ssl_set_hostname() when called multiple times.
825
     Found by projectgus and Jethro Beekman, #836.
826
   * Fix usage help in ssl_server2 example. Found and fixed by Bei Lin.
827 828 829
   * Parse signature algorithm extension when renegotiating. Previously,
     renegotiated handshakes would only accept signatures using SHA-1
     regardless of the peer's preferences, or fail if SHA-1 was disabled.
830 831 832
   * Fix leap year calculation in x509_date_is_valid() to ensure that invalid
     dates on leap years with 100 and 400 intervals are handled correctly. Found
     by Nicholas Wilson. #694
833 834
   * Fix some invalid RSA-PSS signatures with keys of size 8N+1 that were
     accepted. Generating these signatures required the private key.
835 836 837
   * Fix out-of-memory problem when parsing 4096-bit PKCS8-encrypted RSA keys.
     Found independently by Florian in the mbed TLS forum and by Mishamax.
     #878, #1019.
838 839
   * Fix variable used before assignment compilation warnings with IAR
     toolchain. Found by gkerrien38.
840 841 842 843 844 845
   * Fix unchecked return codes from AES, DES and 3DES functions in
     pem_aes_decrypt(), pem_des_decrypt() and pem_des3_decrypt() respectively.
     If a call to one of the functions of the cryptographic primitive modules
     failed, the error may not be noticed by the function
     mbedtls_pem_read_buffer() causing it to return invalid values. Found by
     Guido Vranken. #756
846 847
   * Include configuration file in md.h, to fix compilation warnings.
     Reported by aaronmdjones in #1001
Hanno Becker's avatar
Hanno Becker committed
848 849 850
   * Correct extraction of signature-type from PK instance in X.509 CRT and CSR
     writing routines that prevented these functions to work with alternative
     RSA implementations. Raised by J.B. in the Mbed TLS forum. Fixes #1011.
Hanno Becker's avatar
Hanno Becker committed
851 852
   * Don't print X.509 version tag for v1 CRT's, and omit extensions for
     non-v3 CRT's.
Gilles Peskine's avatar
Gilles Peskine committed
853
   * Fix bugs in RSA test suite under MBEDTLS_NO_PLATFORM_ENTROPY. #1023 #1024
854
   * Fix net_would_block() to avoid modification by errno through fcntl() call.
855
     Found by nkolban. Fixes #845.
856
   * Fix handling of handshake messages in mbedtls_ssl_read() in case
Hanno Becker's avatar
Hanno Becker committed
857
     MBEDTLS_SSL_RENEGOTIATION is disabled. Found by erja-gp.
858
   * Add a check for invalid private parameters in mbedtls_ecdsa_sign().
859
     Reported by Yolan Romailler.
860
   * Fix word size check in in pk.c to not depend on MBEDTLS_HAVE_INT64.
861
   * Fix incorrect unit in benchmark output. #850
Hanno Becker's avatar
Hanno Becker committed
862 863
   * Add size-checks for record and handshake message content, securing
     fragile yet non-exploitable code-paths.
864 865
   * Fix crash when calling mbedtls_ssl_cache_free() twice. Found by
     MilenkoMitrovic, #1104
866
   * Fix mbedtls_timing_alarm(0) on Unix and MinGW.
867
   * Fix use of uninitialized memory in mbedtls_timing_get_timer() when reset=1.
868 869
   * Fix possible memory leaks in mbedtls_gcm_self_test().
   * Added missing return code checks in mbedtls_aes_self_test().
Hanno Becker's avatar
Hanno Becker committed
870 871 872 873
   * Fix issues in RSA key generation program programs/x509/rsa_genkey and the
     RSA test suite where the failure of CTR DRBG initialization lead to
     freeing an RSA context and several MPI's without proper initialization
     beforehand.
Gilles Peskine's avatar
Gilles Peskine committed
874
   * Fix error message in programs/pkey/gen_key.c. Found and fixed by Chris Xue.
875 876
   * Fix programs/pkey/dh_server.c so that it actually works with dh_client.c.
     Found and fixed by Martijn de Milliano.
877 878 879 880
   * Fix an issue in the cipher decryption with the mode
     MBEDTLS_PADDING_ONE_AND_ZEROS that sometimes accepted invalid padding.
     Note, this padding mode is not used by the TLS protocol. Found and fixed by
     Micha Kraus.
881 882 883 884
   * Fix the entropy.c module to not call mbedtls_sha256_starts() or
     mbedtls_sha512_starts() in the mbedtls_entropy_init() function.
   * Fix the entropy.c module to ensure that mbedtls_sha256_init() or
     mbedtls_sha512_init() is called before operating on the relevant context
885 886 887
     structure. Do not assume that zeroizing a context is a correct way to
     reset it. Found independently by ccli8 on Github.
   * In mbedtls_entropy_free(), properly free the message digest context.
888 889
   * Fix status handshake status message in programs/ssl/dtls_client.c. Found
     and fixed by muddog.
Hanno Becker's avatar
Hanno Becker committed
890 891

Changes
892
   * Extend cert_write example program by options to set the certificate version
Hanno Becker's avatar
Hanno Becker committed
893 894
     and the message digest. Further, allow enabling/disabling of authority
     identifier, subject identifier and basic constraints extensions.
895 896 897 898
   * Only check for necessary RSA structure fields in `mbedtls_rsa_private`. In
     particular, don't require P,Q if neither CRT nor blinding are
     used. Reported and fix proposed independently by satur9nine and sliai
     on GitHub.
899
   * Only run AES-192 self-test if AES-192 is available. Fixes #963.
Gilles Peskine's avatar
Gilles Peskine committed
900 901
   * Tighten the RSA PKCS#1 v1.5 signature verification code and remove the
     undeclared dependency of the RSA module on the ASN.1 module.
902 903 904 905
   * Update all internal usage of deprecated message digest functions to the
     new ones with return codes. In particular, this modifies the
     mbedtls_md_info_t structure. Propagate errors from these functions
     everywhere except some locations in the ssl_tls.c module.
Jaeden Amero's avatar
Jaeden Amero committed
906
   * Improve CTR_DRBG error handling by propagating underlying AES errors.
907 908 909
   * Add MBEDTLS_ERR_XXX_HW_ACCEL_FAILED error codes for all cryptography
     modules where the software implementation can be replaced by a hardware
     implementation.
Hanno Becker's avatar
Hanno Becker committed
910 911
   * Add explicit warnings for the use of MD2, MD4, MD5, SHA-1, DES and ARC4
     throughout the library.
912

913
= mbed TLS 2.6.0 branch released 2017-08-10
914

915
Security
916
   * Fix authentication bypass in SSL/TLS: when authmode is set to optional,
917 918
     mbedtls_ssl_get_verify_result() would incorrectly return 0 when the peer's
     X.509 certificate chain had more than MBEDTLS_X509_MAX_INTERMEDIATE_CA
919 920
     (default: 8) intermediates, even when it was not trusted. This could be
     triggered remotely from either side. (With authmode set to 'required'
921 922
     (the default), the handshake was correctly aborted).
   * Reliably wipe sensitive data after use in the AES example applications
Hanno Becker's avatar
Hanno Becker committed
923 924
     programs/aes/aescrypt2 and programs/aes/crypt_and_hash.
     Found by Laurent Simon.
925

926 927
Features
   * Add the functions mbedtls_platform_setup() and mbedtls_platform_teardown()
928 929
     and the context struct mbedtls_platform_context to perform
     platform-specific setup and teardown operations. The macro
930
     MBEDTLS_PLATFORM_SETUP_TEARDOWN_ALT allows the functions to be overridden
931
     by the user in a platform_alt.h file. These new functions are required in
932 933
     some embedded environments to provide a means of initialising underlying
     cryptographic acceleration hardware.
934

935 936 937 938
API Changes
   * Reverted API/ABI breaking changes introduced in mbed TLS 2.5.1, to make the
     API consistent with mbed TLS 2.5.0. Specifically removed the inline
     qualifier from the functions mbedtls_aes_decrypt, mbedtls_aes_encrypt,
939 940
     mbedtls_ssl_ciphersuite_uses_ec and mbedtls_ssl_ciphersuite_uses_psk. Found
     by James Cowgill. #978
941 942 943
   * Certificate verification functions now set flags to -1 in case the full
     chain was not verified due to an internal error (including in the verify
     callback) or chain length limitations.
944
   * With authmode set to optional, the TLS handshake is now aborted if the
945
     verification of the peer's certificate failed due to an overlong chain or
946
     a fatal error in the verify callback.
947

948
Bugfix
949 950 951
   * Add a check if iv_len is zero in GCM, and return an error if it is zero.
     Reported by roberto. #716
   * Replace preprocessor condition from #if defined(MBEDTLS_THREADING_PTHREAD)
952
     to #if defined(MBEDTLS_THREADING_C) as the library cannot assume they will
953
     always be implemented by pthread support. #696
954 955
   * Fix a resource leak on Windows platforms in mbedtls_x509_crt_parse_path(),
     in the case of an error. Found by redplait. #590
956
   * Add MBEDTLS_MPI_CHK to check for error value of mbedtls_mpi_fill_random.
957
     Reported and fix suggested by guidovranken. #740
958 959
   * Fix conditional preprocessor directives in bignum.h to enable 64-bit
     compilation when using ARM Compiler 6.
960
   * Fix a potential integer overflow in the version verification for DER
961
     encoded X.509 CRLs. The overflow could enable maliciously constructed CRLs
962 963
     to bypass the version verification check. Found by Peng Li/Yueh-Hsun Lin,
     KNOX Security, Samsung Research America
964
   * Fix potential integer overflow in the version verification for DER
965
     encoded X.509 CSRs. The overflow could enable maliciously constructed CSRs
966 967
     to bypass the version verification check. Found by Peng Li/Yueh-Hsun Lin,
     KNOX Security, Samsung Research America
968
   * Fix a potential integer overflow in the version verification for DER
969
     encoded X.509 certificates. The overflow could enable maliciously
970
     constructed certificates to bypass the certificate verification check.
971
   * Fix a call to the libc function time() to call the platform abstraction
972 973 974
     function mbedtls_time() instead. Found by wairua. #666
   * Avoid shadowing of time and index functions through mbed TLS function
     arguments. Found by inestlerode. #557.
975

976
Changes
977
   * Added config.h option MBEDTLS_NO_UDBL_DIVISION, to prevent the use of
978 979
     64-bit division. This is useful on embedded platforms where 64-bit division
     created a dependency on external libraries. #708
980 981 982
   * Removed mutexes from ECP hardware accelerator code. Now all hardware
     accelerator code in the library leaves concurrency handling to the
     platform. Reported by Steven Cooreman. #863
983 984
   * Define the macro MBEDTLS_AES_ROM_TABLES in the configuration file
     config-no-entropy.h to reduce the RAM footprint.
985 986
   * Added a test script that can be hooked into git that verifies commits
     before they are pushed.
987
   * Improve documentation of PKCS1 decryption functions.
988

989
= mbed TLS 2.5.1 released 2017-06-21
Hanno Becker's avatar
Hanno Becker committed
990

991
Security
Hanno Becker's avatar
Hanno Becker committed
992 993 994 995 996
   * Fixed unlimited overread of heap-based buffer in mbedtls_ssl_read().
     The issue could only happen client-side with renegotiation enabled.
     Could result in DoS (application crash) or information leak
     (if the application layer sent data read from mbedtls_ssl_read()
     back to the server or to a third party). Can be triggered remotely.
997 998 999
   * Removed SHA-1 and RIPEMD-160 from the default hash algorithms for
     certificate verification. SHA-1 can be turned back on with a compile-time
     option if needed.
1000 1001
   * Fixed offset in FALLBACK_SCSV parsing that caused TLS server to fail to
     detect it sometimes. Reported by Hugo Leisink. #810
1002 1003
   * Tighten parsing of RSA PKCS#1 v1.5 signatures, to avoid a
     potential Bleichenbacher/BERserk-style attack.
1004

Hanno Becker's avatar
Hanno Becker committed
1005
Bugfix
Janos Follath's avatar
Janos Follath committed
1006 1007 1008
   * Remove size zero arrays from ECJPAKE test suite. Size zero arrays are not
     valid C and they prevented the test from compiling in Visual Studio 2015
     and with GCC using the -Wpedantic compilation option.
1009 1010
   * Fix insufficient support for signature-hash-algorithm extension,
     resulting in compatibility problems with Chrome. Found by hfloyrd. #823
Janos Follath's avatar
Janos Follath committed
1011 1012
   * Fix behaviour that hid the original cause of fatal alerts in some cases
     when sending the alert failed. The fix makes sure not to hide the error
1013
     that triggered the alert.
Janos Follath's avatar
Janos Follath committed
1014 1015 1016 1017
   * Fix SSLv3 renegotiation behaviour and stop processing data received from
     peer after sending a fatal alert to refuse a renegotiation attempt.
     Previous behaviour was to keep processing data even after the alert has
     been sent.
1018
   * Accept empty trusted CA chain in authentication mode
1019
     MBEDTLS_SSL_VERIFY_OPTIONAL. Found by Jethro Beekman. #864
Janos Follath's avatar
Janos Follath committed
1020 1021 1022 1023 1024 1025 1026 1027 1028 1029
   * Fix implementation of mbedtls_ssl_parse_certificate() to not annihilate
     fatal errors in authentication mode MBEDTLS_SSL_VERIFY_OPTIONAL and to
     reflect bad EC curves within verification result.
   * Fix bug that caused the modular inversion function to accept the invalid
     modulus 1 and therefore to hang. Found by blaufish. #641.
   * Fix incorrect sign computation in modular exponentiation when the base is
     a negative MPI. Previously the result was always negative. Found by Guido
     Vranken.
   * Fix a numerical underflow leading to stack overflow in mpi_read_file()
     that was triggered uppon reading an empty line. Found by Guido Vranken.
1030

Gilles Peskine's avatar
Gilles Peskine committed
1031
Changes
Janos Follath's avatar
Janos Follath committed
1032 1033
   * Send fatal alerts in more cases. The previous behaviour was to skip
     sending the fatal alert and just drop the connection.
1034
   * Clarify ECDSA documentation and improve the sample code to avoid
Janos Follath's avatar
Janos Follath committed
1035
     misunderstanding and potentially dangerous use of the API. Pointed out
1036
     by Jean-Philippe Aumasson.
Gilles Peskine's avatar
Gilles Peskine committed
1037

1038
= mbed TLS 2.5.0 branch released 2017-05-17
1039

1040
Security
Gilles Peskine's avatar
Gilles Peskine committed
1041
   * Wipe stack buffers in RSA private key operations
Janos Follath's avatar
Janos Follath committed
1042 1043
     (rsa_rsaes_pkcs1_v15_decrypt(), rsa_rsaes_oaep_decrypt). Found by Laurent
     Simon.
1044 1045 1046 1047 1048 1049
   * Add exponent blinding to RSA private operations as a countermeasure
     against side-channel attacks like the cache attack described in
     https://arxiv.org/abs/1702.08719v2.
     Found and fix proposed by Michael Schwarz, Samuel Weiser, Daniel Gruss,
     Clémentine Maurice and Stefan Mangard.

Simon Butcher's avatar
Simon Butcher committed
1050
Features
Janos Follath's avatar
Janos Follath committed
1051 1052 1053 1054
   * Add hardware acceleration support for the Elliptic Curve Point module.
     This involved exposing parts of the internal interface to enable
     replacing the core functions and adding and alternative, module level
     replacement support for enabling the extension of the interface.
1055 1056 1057 1058
   * Add a new configuration option to 'mbedtls_ssl_config' to enable
     suppressing the CA list in Certificate Request messages. The default
     behaviour has not changed, namely every configured CAs name is included.

1059 1060 1061 1062 1063 1064 1065 1066
API Changes
   * The following functions in the AES module have been deprecated and replaced
     by the functions shown below. The new functions change the return type from
     void to int to allow returning error codes when using MBEDTLS_AES_ALT,
     MBEDTLS_AES_DECRYPT_ALT or MBEDTLS_AES_ENCRYPT_ALT.
     mbedtls_aes_decrypt() -> mbedtls_internal_aes_decrypt()
     mbedtls_aes_encrypt() -> mbedtls_internal_aes_encrypt()

1067 1068 1069
Bugfix
   * Remove macros from compat-1.3.h that correspond to deleted items from most
     recent versions of the library. Found by Kyle Keen.
Janos Follath's avatar
Janos Follath committed
1070 1071 1072 1073 1074 1075
   * Fixed issue in the Threading module that prevented mutexes from
     initialising. Found by sznaider. #667 #843
   * Add checks in the PK module for the RSA functions on 64-bit systems.
     The PK and RSA modules use different types for passing hash length and
     without these checks the type cast could lead to data loss. Found by Guido
     Vranken.
1076

1077
= mbed TLS 2.4.2 branch released 2017-03-08
1078

Janos Follath's avatar
Janos Follath committed
1079
Security
1080 1081 1082 1083 1084
   * Add checks to prevent signature forgeries for very large messages while
     using RSA through the PK module in 64-bit systems. The issue was caused by
     some data loss when casting a size_t to an unsigned int value in the
     functions rsa_verify_wrap(), rsa_sign_wrap(), rsa_alt_sign_wrap() and
     mbedtls_pk_sign(). Found by Jean-Philippe Aumasson.
1085 1086 1087 1088 1089
   * Fixed potential livelock during the parsing of a CRL in PEM format in
     mbedtls_x509_crl_parse(). A string containing a CRL followed by trailing
     characters after the footer could result in the execution of an infinite
     loop. The issue can be triggered remotely. Found by Greg Zaverucha,
     Microsoft.
Janos Follath's avatar
Janos Follath committed
1090 1091
   * Removed MD5 from the allowed hash algorithms for CertificateRequest and
     CertificateVerify messages, to prevent SLOTH attacks against TLS 1.2.
1092
     Introduced by interoperability fix for #513.
1093 1094 1095
   * Fixed a bug that caused freeing a buffer that was allocated on the stack,
     when verifying the validity of a key on secp224k1. This could be
     triggered remotely for example with a maliciously constructed certificate
1096
     and potentially could lead to remote code execution on some platforms.
1097 1098
     Reported independently by rongsaws and Aleksandar Nikolic, Cisco Talos
     team. #569 CVE-2017-2784
1099

1100
Bugfix
1101 1102 1103 1104 1105
   * Fix output certificate verification flags set by x509_crt_verify_top() when
     traversing a chain of trusted CA. The issue would cause both flags,
     MBEDTLS_X509_BADCERT_NOT_TRUSTED and MBEDTLS_X509_BADCERT_EXPIRED, to be
     set when the verification conditions are not met regardless of the cause.
     Found by Harm Verhagen and inestlerode. #665 #561
1106 1107 1108
   * Fix the redefinition of macro ssl_set_bio to an undefined symbol
     mbedtls_ssl_set_bio_timeout in compat-1.3.h, by removing it.
     Found by omlib-lin. #673
1109 1110
   * Fix unused variable/function compilation warnings in pem.c, x509_crt.c and
     x509_csr.c that are reported when building mbed TLS with a config.h that
1111
     does not define MBEDTLS_PEM_PARSE_C. Found by omnium21. #562
1112 1113 1114 1115 1116
   * Fix incorrect renegotiation condition in ssl_check_ctr_renegotiate() that
     would compare 64 bits of the record counter instead of 48 bits as indicated
     in RFC 6347 Section 4.3.1. This could cause the execution of the
     renegotiation routines at unexpected times when the protocol is DTLS. Found
     by wariua. #687
1117
   * Fixed multiple buffer overreads in mbedtls_pem_read_buffer() when parsing
1118
     the input string in PEM format to extract the different components. Found
1119
     by Eyal Itkin.
1120 1121 1122 1123 1124 1125
   * Fixed potential arithmetic overflow in mbedtls_ctr_drbg_reseed() that could
     cause buffer bound checks to be bypassed. Found by Eyal Itkin.
   * Fixed potential arithmetic overflows in mbedtls_cipher_update() that could
     cause buffer bound checks to be bypassed. Found by Eyal Itkin.
   * Fixed potential arithmetic overflow in mbedtls_md2_update() that could
     cause buffer bound checks to be bypassed. Found by Eyal Itkin.
1126 1127
   * Fixed potential arithmetic overflow in mbedtls_base64_decode() that could
     cause buffer bound checks to be bypassed. Found by Eyal Itkin.
1128 1129
   * Fixed heap overreads in mbedtls_x509_get_time(). Found by Peng
     Li/Yueh-Hsun Lin, KNOX Security, Samsung Research America.
1130 1131
   * Fix potential memory leak in mbedtls_x509_crl_parse(). The leak was caused
     by missing calls to mbedtls_pem_free() in cases when a
1132 1133
     MBEDTLS_ERR_PEM_NO_HEADER_FOOTER_PRESENT error was encountered. Found and
     fix proposed by Guido Vranken. #722
1134 1135 1136
   * Fixed the templates used to generate project and solution files for Visual
     Studio 2015 as well as the files themselves, to remove a build warning
     generated in Visual Studio 2015. Reported by Steve Valliere. #742
1137 1138
   * Fix a resource leak in ssl_cookie, when using MBEDTLS_THREADING_C.
     Raised and fix suggested by Alan Gillingham in the mbed TLS forum. #771
1139 1140 1141
   * Fix 1 byte buffer overflow in mbedtls_mpi_write_string() when the MPI
     number to write in hexadecimal is negative and requires an odd number of
     digits. Found and fixed by Guido Vranken.
1142 1143
   * Fix unlisted DES configuration dependency in some pkparse test cases. Found
     by inestlerode. #555
1144

1145
= mbed TLS 2.4.1 branch released 2016-12-13
1146 1147 1148 1149 1150 1151

Changes
   * Update to CMAC test data, taken from - NIST Special Publication 800-38B -
     Recommendation for Block Cipher Modes of Operation: The CMAC Mode for
     Authentication – October  2016

1152
= mbed TLS 2.4.0 branch released 2016-10-17
1153

1154
Security
1155 1156 1157 1158 1159 1160
   * Removed the MBEDTLS_SSL_AEAD_RANDOM_IV option, because it was not compliant
     with RFC-5116 and could lead to session key recovery in very long TLS
     sessions. "Nonce-Disrespecting Adversaries Practical Forgery Attacks on GCM in
     TLS" - H. Bock, A. Zauner, S. Devlin, J. Somorovsky, P. Jovanovic.
     https://eprint.iacr.org/2016/475.pdf
   * Fixed potential stack corruption in mbedtls_x509write_crt_der() and
1161
     mbedtls_x509write_csr_der() when the signature is copied to the buffer
1162
     without checking whether there is enough space in the destination. The
1163
     issue cannot be triggered remotely. Found by Jethro Beekman.
1164

1165
Features
Simon Butcher's avatar
Simon Butcher committed
1166 1167
   * Added support for CMAC for AES and 3DES and AES-CMAC-PRF-128, as defined by
     NIST SP 800-38B, RFC-4493 and RFC-4615.
1168 1169 1170 1171
   * Added hardware entropy selftest to verify that the hardware entropy source
     is functioning correctly.
   * Added a script to print build environment info for diagnostic use in test
     scripts, which is also now called by all.sh.
1172 1173 1174
   * Added the macro MBEDTLS_X509_MAX_FILE_PATH_LEN that enables the user to
     configure the maximum length of a file path that can be buffered when
     calling mbedtls_x509_crt_parse_path().
1175
   * Added a configuration file config-no-entropy.h that configures the subset of
1176
     library features that do not require an entropy source.
1177 1178 1179
   * Added the macro MBEDTLS_ENTROPY_MIN_HARDWARE in config.h. This allows users
     to configure the minimum number of bytes for entropy sources using the
     mbedtls_hardware_poll() function.
1180 1181 1182 1183 1184 1185

Bugfix
   * Fix for platform time abstraction to avoid dependency issues where a build
     may need time but not the standard C library abstraction, and added
     configuration consistency checks to check_config.h
   * Fix dependency issue in Makefile to allow parallel builds.
1186 1187
   * Fix incorrect handling of block lengths in crypt_and_hash.c sample program,
     when GCM is used. Found by udf2457. #441
1188 1189
   * Fix for key exchanges based on ECDH-RSA or ECDH-ECDSA which weren't
     enabled unless others were also present. Found by David Fernandez. #428
1190 1191
   * Fix for out-of-tree builds using CMake. Found by jwurzer, and fix based on
     a contribution from Tobias Tangemann. #541
1192
   * Fixed cert_app.c sample program for debug output and for use when no root
1193
     certificates are provided.
1194
   * Fix conditional statement that would cause a 1 byte overread in
1195
     mbedtls_asn1_get_int(). Found and fixed by Guido Vranken. #599
1196
   * Fixed pthread implementation to avoid unintended double initialisations
1197
     and double frees. Found by Niklas Amnebratt.
1198 1199 1200
   * Fixed the sample applications gen_key.c, cert_req.c and cert_write.c for
     builds where the configuration MBEDTLS_PEM_WRITE_C is not defined. Found
     by inestlerode. #559.
1201 1202
   * Fix mbedtls_x509_get_sig() to update the ASN1 type in the mbedtls_x509_buf
     data structure until after error checks are successful. Found by
1203
     subramanyam-c. #622
1204
   * Fix documentation and implementation missmatch for function arguments of
1205
     mbedtls_gcm_finish(). Found by cmiatpaar. #602
1206
   * Guarantee that P>Q at RSA key generation. Found by inestlerode. #558
1207 1208
   * Fix potential byte overread when verifying malformed SERVER_HELLO in
     ssl_parse_hello_verify_request() for DTLS. Found by Guido Vranken.
1209
   * Fix check for validity of date when parsing in mbedtls_x509_get_time().
1210
     Found by subramanyam-c. #626
1211 1212 1213
   * Fix compatibility issue with Internet Explorer client authentication,
     where the limited hash choices prevented the client from sending its
     certificate. Found by teumas. #513
1214
   * Fix compilation without MBEDTLS_SELF_TEST enabled.
1215 1216 1217 1218 1219 1220 1221 1222 1223

Changes
   * Extended test coverage of special cases, and added new timing test suite.
   * Removed self-tests from the basic-built-test.sh script, and added all
     missing self-tests to the test suites, to ensure self-tests are only
     executed once.
   * Added support for 3 and 4 byte lengths to mbedtls_asn1_write_len().
   * Added support for a Yotta specific configuration file -
     through the symbol YOTTA_CFG_MBEDTLS_TARGET_CONFIG_FILE.
1224
   * Added optimization for code space for X.509/OID based on configured
1225
     features. Contributed by Aviv Palivoda.
1226 1227 1228 1229
   * Renamed source file library/net.c to library/net_sockets.c to avoid
     naming collision in projects which also have files with the common name
     net.c. For consistency, the corresponding header file, net.h, is marked as
     deprecated, and its contents moved to net_sockets.h.
1230 1231
   * Changed the strategy for X.509 certificate parsing and validation, to no
     longer disregard certificates with unrecognised fields.
1232

1233
= mbed TLS 2.3.0 branch released 2016-06-28
1234

1235
Security
1236
   * Fix missing padding length check in mbedtls_rsa_rsaes_pkcs1_v15_decrypt
1237
     required by PKCS1 v2.2
1238 1239
   * Fix potential integer overflow to buffer overflow in
     mbedtls_rsa_rsaes_pkcs1_v15_encrypt and mbedtls_rsa_rsaes_oaep_encrypt
1240
     (not triggerable remotely in (D)TLS).
1241
   * Fix a potential integer underflow to buffer overread in
Janos Follath's avatar
Janos Follath committed
1242 1243
     mbedtls_rsa_rsaes_oaep_decrypt. It is not triggerable remotely in
     SSL/TLS.
1244

1245 1246 1247 1248
Features
   * Support for platform abstraction of the standard C library time()
     function.

1249 1250 1251
Bugfix
   * Fix bug in mbedtls_mpi_add_mpi() that caused wrong results when the three
     arguments where the same (in-place doubling). Found and fixed by Janos
1252
     Follath. #309
1253 1254
   * Fix potential build failures related to the 'apidoc' target, introduced
     in the previous patch release. Found by Robert Scheck. #390 #391
1255
   * Fix issue in Makefile that prevented building using armar. #386
1256 1257
   * Fix memory leak that occured only when ECJPAKE was enabled and ECDHE and
     ECDSA was disabled in config.h . The leak didn't occur by default.
1258 1259 1260
   * Fix an issue that caused valid certificates to be rejected whenever an
     expired or not yet valid certificate was parsed before a valid certificate
     in the trusted certificate list.
1261
   * Fix bug in mbedtls_x509_crt_parse that caused trailing extra data in the
1262
     buffer after DER certificates to be included in the raw representation.
1263
   * Fix issue that caused a hang when generating RSA keys of odd bitlength
1264 1265
   * Fix bug in mbedtls_rsa_rsaes_pkcs1_v15_encrypt that made null pointer
     dereference possible.
1266 1267
   * Fix issue that caused a crash if invalid curves were passed to
     mbedtls_ssl_conf_curves. #373
1268
   * Fix issue in ssl_fork_server which was preventing it from functioning. #429
Paul Bakker's avatar
Paul Bakker committed
1269
   * Fix memory leaks in test framework
1270
   * Fix test in ssl-opt.sh that does not run properly with valgrind
1271
   * Fix unchecked calls to mmbedtls_md_setup(). Fix by Brian Murray. #502
1272

1273 1274 1275 1276
Changes
   * On ARM platforms, when compiling with -O0 with GCC, Clang or armcc5,
     don't use the optimized assembly for bignum multiplication. This removes
     the need to pass -fomit-frame-pointer to avoid a build error with -O0.
1277
   * Disabled SSLv3 in the default configuration.
1278 1279
   * Optimized mbedtls_mpi_zeroize() for MPI integer size. (Fix by Alexey
     Skalozub).
1280 1281
   * Fix non-compliance server extension handling. Extensions for SSLv3 are now
     ignored, as required by RFC6101.
Manuel Pégourié-Gonnard's avatar