blob: 904eb93e55761c742869bee44c4cf78967b41061 [file] [log] [blame]
Jens Wiklander817466c2018-05-22 13:49:31 +02001mbed TLS ChangeLog (Sorted per branch, date)
2
3= mbed TLS 2.6.1 branch released 2017-10-08
4
5Bugfix
6 * Parse signature algorithm extension when renegotiating. Previously,
7 renegotiated handshakes would only accept signatures using SHA-1
8 regardless of the peer's preferences, or fail if SHA-1 was disabled.
9
10= mbed TLS 2.6.0 branch released 2017-08-10
11
12Security
13 * Fix authentication bypass in SSL/TLS: when authmode is set to optional,
14 mbedtls_ssl_get_verify_result() would incorrectly return 0 when the peer's
15 X.509 certificate chain had more than MBEDTLS_X509_MAX_INTERMEDIATE_CA
16 (default: 8) intermediates, even when it was not trusted. This could be
17 triggered remotely from either side. (With authmode set to 'required'
18 (the default), the handshake was correctly aborted).
19 * Reliably wipe sensitive data after use in the AES example applications
20 programs/aes/aescrypt2 and programs/aes/crypt_and_hash.
21 Found by Laurent Simon.
22
23Features
24 * Add the functions mbedtls_platform_setup() and mbedtls_platform_teardown()
25 and the context struct mbedtls_platform_context to perform
26 platform-specific setup and teardown operations. The macro
27 MBEDTLS_PLATFORM_SETUP_TEARDOWN_ALT allows the functions to be overridden
28 by the user in a platform_alt.h file. These new functions are required in
29 some embedded environments to provide a means of initialising underlying
30 cryptographic acceleration hardware.
31
32API Changes
33 * Reverted API/ABI breaking changes introduced in mbed TLS 2.5.1, to make the
34 API consistent with mbed TLS 2.5.0. Specifically removed the inline
35 qualifier from the functions mbedtls_aes_decrypt, mbedtls_aes_encrypt,
36 mbedtls_ssl_ciphersuite_uses_ec and mbedtls_ssl_ciphersuite_uses_psk. Found
37 by James Cowgill. #978
38 * Certificate verification functions now set flags to -1 in case the full
39 chain was not verified due to an internal error (including in the verify
40 callback) or chain length limitations.
41 * With authmode set to optional, the TLS handshake is now aborted if the
42 verification of the peer's certificate failed due to an overlong chain or
43 a fatal error in the verify callback.
44
45Bugfix
46 * Add a check if iv_len is zero in GCM, and return an error if it is zero.
47 Reported by roberto. #716
48 * Replace preprocessor condition from #if defined(MBEDTLS_THREADING_PTHREAD)
49 to #if defined(MBEDTLS_THREADING_C) as the library cannot assume they will
50 always be implemented by pthread support. #696
51 * Fix a resource leak on Windows platforms in mbedtls_x509_crt_parse_path(),
52 in the case of an error. Found by redplait. #590
53 * Add MBEDTLS_MPI_CHK to check for error value of mbedtls_mpi_fill_random.
54 Reported and fix suggested by guidovranken. #740
55 * Fix conditional preprocessor directives in bignum.h to enable 64-bit
56 compilation when using ARM Compiler 6.
57 * Fix a potential integer overflow in the version verification for DER
58 encoded X.509 CRLs. The overflow could enable maliciously constructed CRLs
59 to bypass the version verification check. Found by Peng Li/Yueh-Hsun Lin,
60 KNOX Security, Samsung Research America
61 * Fix potential integer overflow in the version verification for DER
62 encoded X.509 CSRs. The overflow could enable maliciously constructed CSRs
63 to bypass the version verification check. Found by Peng Li/Yueh-Hsun Lin,
64 KNOX Security, Samsung Research America
65 * Fix a potential integer overflow in the version verification for DER
66 encoded X.509 certificates. The overflow could enable maliciously
67 constructed certificates to bypass the certificate verification check.
68 * Fix a call to the libc function time() to call the platform abstraction
69 function mbedtls_time() instead. Found by wairua. #666
70 * Avoid shadowing of time and index functions through mbed TLS function
71 arguments. Found by inestlerode. #557.
72
73Changes
74 * Added config.h option MBEDTLS_NO_UDBL_DIVISION, to prevent the use of
75 64-bit division. This is useful on embedded platforms where 64-bit division
76 created a dependency on external libraries. #708
77 * Removed mutexes from ECP hardware accelerator code. Now all hardware
78 accelerator code in the library leaves concurrency handling to the
79 platform. Reported by Steven Cooreman. #863
80 * Define the macro MBEDTLS_AES_ROM_TABLES in the configuration file
81 config-no-entropy.h to reduce the RAM footprint.
82 * Added a test script that can be hooked into git that verifies commits
83 before they are pushed.
84 * Improve documentation of PKCS1 decryption functions.
85
86= mbed TLS 2.5.1 released 2017-06-21
87
88Security
89 * Fixed unlimited overread of heap-based buffer in mbedtls_ssl_read().
90 The issue could only happen client-side with renegotiation enabled.
91 Could result in DoS (application crash) or information leak
92 (if the application layer sent data read from mbedtls_ssl_read()
93 back to the server or to a third party). Can be triggered remotely.
94 * Removed SHA-1 and RIPEMD-160 from the default hash algorithms for
95 certificate verification. SHA-1 can be turned back on with a compile-time
96 option if needed.
97 * Fixed offset in FALLBACK_SCSV parsing that caused TLS server to fail to
98 detect it sometimes. Reported by Hugo Leisink. #810
99 * Tighten parsing of RSA PKCS#1 v1.5 signatures, to avoid a
100 potential Bleichenbacher/BERserk-style attack.
101
102Bugfix
103 * Remove size zero arrays from ECJPAKE test suite. Size zero arrays are not
104 valid C and they prevented the test from compiling in Visual Studio 2015
105 and with GCC using the -Wpedantic compilation option.
106 * Fix insufficient support for signature-hash-algorithm extension,
107 resulting in compatibility problems with Chrome. Found by hfloyrd. #823
108 * Fix behaviour that hid the original cause of fatal alerts in some cases
109 when sending the alert failed. The fix makes sure not to hide the error
110 that triggered the alert.
111 * Fix SSLv3 renegotiation behaviour and stop processing data received from
112 peer after sending a fatal alert to refuse a renegotiation attempt.
113 Previous behaviour was to keep processing data even after the alert has
114 been sent.
115 * Accept empty trusted CA chain in authentication mode
116 MBEDTLS_SSL_VERIFY_OPTIONAL.
117 Found by jethrogb. #864
118 * Fix implementation of mbedtls_ssl_parse_certificate() to not annihilate
119 fatal errors in authentication mode MBEDTLS_SSL_VERIFY_OPTIONAL and to
120 reflect bad EC curves within verification result.
121 * Fix bug that caused the modular inversion function to accept the invalid
122 modulus 1 and therefore to hang. Found by blaufish. #641.
123 * Fix incorrect sign computation in modular exponentiation when the base is
124 a negative MPI. Previously the result was always negative. Found by Guido
125 Vranken.
126 * Fix a numerical underflow leading to stack overflow in mpi_read_file()
127 that was triggered uppon reading an empty line. Found by Guido Vranken.
128
129Changes
130 * Send fatal alerts in more cases. The previous behaviour was to skip
131 sending the fatal alert and just drop the connection.
132 * Clarify ECDSA documentation and improve the sample code to avoid
133 misunderstanding and potentially dangerous use of the API. Pointed out
134 by Jean-Philippe Aumasson.
135
136= mbed TLS 2.5.0 branch released 2017-05-17
137
138Security
139 * Wipe stack buffers in RSA private key operations
140 (rsa_rsaes_pkcs1_v15_decrypt(), rsa_rsaes_oaep_decrypt). Found by Laurent
141 Simon.
142 * Add exponent blinding to RSA private operations as a countermeasure
143 against side-channel attacks like the cache attack described in
144 https://arxiv.org/abs/1702.08719v2.
145 Found and fix proposed by Michael Schwarz, Samuel Weiser, Daniel Gruss,
146 Clémentine Maurice and Stefan Mangard.
147
148Features
149 * Add hardware acceleration support for the Elliptic Curve Point module.
150 This involved exposing parts of the internal interface to enable
151 replacing the core functions and adding and alternative, module level
152 replacement support for enabling the extension of the interface.
153 * Add a new configuration option to 'mbedtls_ssl_config' to enable
154 suppressing the CA list in Certificate Request messages. The default
155 behaviour has not changed, namely every configured CAs name is included.
156
157API Changes
158 * The following functions in the AES module have been deprecated and replaced
159 by the functions shown below. The new functions change the return type from
160 void to int to allow returning error codes when using MBEDTLS_AES_ALT,
161 MBEDTLS_AES_DECRYPT_ALT or MBEDTLS_AES_ENCRYPT_ALT.
162 mbedtls_aes_decrypt() -> mbedtls_internal_aes_decrypt()
163 mbedtls_aes_encrypt() -> mbedtls_internal_aes_encrypt()
164
165Bugfix
166 * Remove macros from compat-1.3.h that correspond to deleted items from most
167 recent versions of the library. Found by Kyle Keen.
168 * Fixed issue in the Threading module that prevented mutexes from
169 initialising. Found by sznaider. #667 #843
170 * Add checks in the PK module for the RSA functions on 64-bit systems.
171 The PK and RSA modules use different types for passing hash length and
172 without these checks the type cast could lead to data loss. Found by Guido
173 Vranken.
174
175= mbed TLS 2.4.2 branch released 2017-03-08
176
177Security
178 * Add checks to prevent signature forgeries for very large messages while
179 using RSA through the PK module in 64-bit systems. The issue was caused by
180 some data loss when casting a size_t to an unsigned int value in the
181 functions rsa_verify_wrap(), rsa_sign_wrap(), rsa_alt_sign_wrap() and
182 mbedtls_pk_sign(). Found by Jean-Philippe Aumasson.
183 * Fixed potential livelock during the parsing of a CRL in PEM format in
184 mbedtls_x509_crl_parse(). A string containing a CRL followed by trailing
185 characters after the footer could result in the execution of an infinite
186 loop. The issue can be triggered remotely. Found by Greg Zaverucha,
187 Microsoft.
188 * Removed MD5 from the allowed hash algorithms for CertificateRequest and
189 CertificateVerify messages, to prevent SLOTH attacks against TLS 1.2.
190 Introduced by interoperability fix for #513.
191 * Fixed a bug that caused freeing a buffer that was allocated on the stack,
192 when verifying the validity of a key on secp224k1. This could be
193 triggered remotely for example with a maliciously constructed certificate
194 and potentially could lead to remote code execution on some platforms.
195 Reported independently by rongsaws and Aleksandar Nikolic, Cisco Talos
196 team. #569 CVE-2017-2784
197
198Bugfix
199 * Fix output certificate verification flags set by x509_crt_verify_top() when
200 traversing a chain of trusted CA. The issue would cause both flags,
201 MBEDTLS_X509_BADCERT_NOT_TRUSTED and MBEDTLS_X509_BADCERT_EXPIRED, to be
202 set when the verification conditions are not met regardless of the cause.
203 Found by Harm Verhagen and inestlerode. #665 #561
204 * Fix the redefinition of macro ssl_set_bio to an undefined symbol
205 mbedtls_ssl_set_bio_timeout in compat-1.3.h, by removing it.
206 Found by omlib-lin. #673
207 * Fix unused variable/function compilation warnings in pem.c, x509_crt.c and
208 x509_csr.c that are reported when building mbed TLS with a config.h that
209 does not define MBEDTLS_PEM_PARSE_C. Found by omnium21. #562
210 * Fix incorrect renegotiation condition in ssl_check_ctr_renegotiate() that
211 would compare 64 bits of the record counter instead of 48 bits as indicated
212 in RFC 6347 Section 4.3.1. This could cause the execution of the
213 renegotiation routines at unexpected times when the protocol is DTLS. Found
214 by wariua. #687
215 * Fixed multiple buffer overreads in mbedtls_pem_read_buffer() when parsing
216 the input string in PEM format to extract the different components. Found
217 by Eyal Itkin.
218 * Fixed potential arithmetic overflow in mbedtls_ctr_drbg_reseed() that could
219 cause buffer bound checks to be bypassed. Found by Eyal Itkin.
220 * Fixed potential arithmetic overflows in mbedtls_cipher_update() that could
221 cause buffer bound checks to be bypassed. Found by Eyal Itkin.
222 * Fixed potential arithmetic overflow in mbedtls_md2_update() that could
223 cause buffer bound checks to be bypassed. Found by Eyal Itkin.
224 * Fixed potential arithmetic overflow in mbedtls_base64_decode() that could
225 cause buffer bound checks to be bypassed. Found by Eyal Itkin.
226 * Fixed heap overreads in mbedtls_x509_get_time(). Found by Peng
227 Li/Yueh-Hsun Lin, KNOX Security, Samsung Research America.
228 * Fix potential memory leak in mbedtls_x509_crl_parse(). The leak was caused
229 by missing calls to mbedtls_pem_free() in cases when a
230 MBEDTLS_ERR_PEM_NO_HEADER_FOOTER_PRESENT error was encountered. Found and
231 fix proposed by Guido Vranken. #722
232 * Fixed the templates used to generate project and solution files for Visual
233 Studio 2015 as well as the files themselves, to remove a build warning
234 generated in Visual Studio 2015. Reported by Steve Valliere. #742
235 * Fix a resource leak in ssl_cookie, when using MBEDTLS_THREADING_C.
236 Raised and fix suggested by Alan Gillingham in the mbed TLS forum. #771
237 * Fix 1 byte buffer overflow in mbedtls_mpi_write_string() when the MPI
238 number to write in hexadecimal is negative and requires an odd number of
239 digits. Found and fixed by Guido Vranken.
240 * Fix unlisted DES configuration dependency in some pkparse test cases. Found
241 by inestlerode. #555
242
243= mbed TLS 2.4.1 branch released 2016-12-13
244
245Changes
246 * Update to CMAC test data, taken from - NIST Special Publication 800-38B -
247 Recommendation for Block Cipher Modes of Operation: The CMAC Mode for
248 Authentication – October 2016
249
250= mbed TLS 2.4.0 branch released 2016-10-17
251
252Security
253 * Removed the MBEDTLS_SSL_AEAD_RANDOM_IV option, because it was not compliant
254 with RFC-5116 and could lead to session key recovery in very long TLS
255 sessions. "Nonce-Disrespecting Adversaries Practical Forgery Attacks on GCM in
256 TLS" - H. Bock, A. Zauner, S. Devlin, J. Somorovsky, P. Jovanovic.
257 https://eprint.iacr.org/2016/475.pdf
258 * Fixed potential stack corruption in mbedtls_x509write_crt_der() and
259 mbedtls_x509write_csr_der() when the signature is copied to the buffer
260 without checking whether there is enough space in the destination. The
261 issue cannot be triggered remotely. Found by Jethro Beekman.
262
263Features
264 * Added support for CMAC for AES and 3DES and AES-CMAC-PRF-128, as defined by
265 NIST SP 800-38B, RFC-4493 and RFC-4615.
266 * Added hardware entropy selftest to verify that the hardware entropy source
267 is functioning correctly.
268 * Added a script to print build environment info for diagnostic use in test
269 scripts, which is also now called by all.sh.
270 * Added the macro MBEDTLS_X509_MAX_FILE_PATH_LEN that enables the user to
271 configure the maximum length of a file path that can be buffered when
272 calling mbedtls_x509_crt_parse_path().
273 * Added a configuration file config-no-entropy.h that configures the subset of
274 library features that do not require an entropy source.
275 * Added the macro MBEDTLS_ENTROPY_MIN_HARDWARE in config.h. This allows users
276 to configure the minimum number of bytes for entropy sources using the
277 mbedtls_hardware_poll() function.
278
279Bugfix
280 * Fix for platform time abstraction to avoid dependency issues where a build
281 may need time but not the standard C library abstraction, and added
282 configuration consistency checks to check_config.h
283 * Fix dependency issue in Makefile to allow parallel builds.
284 * Fix incorrect handling of block lengths in crypt_and_hash.c sample program,
285 when GCM is used. Found by udf2457. #441
286 * Fix for key exchanges based on ECDH-RSA or ECDH-ECDSA which weren't
287 enabled unless others were also present. Found by David Fernandez. #428
288 * Fix for out-of-tree builds using CMake. Found by jwurzer, and fix based on
289 a contribution from Tobias Tangemann. #541
290 * Fixed cert_app.c sample program for debug output and for use when no root
291 certificates are provided.
292 * Fix conditional statement that would cause a 1 byte overread in
293 mbedtls_asn1_get_int(). Found and fixed by Guido Vranken. #599
294 * Fixed pthread implementation to avoid unintended double initialisations
295 and double frees. Found by Niklas Amnebratt.
296 * Fixed the sample applications gen_key.c, cert_req.c and cert_write.c for
297 builds where the configuration MBEDTLS_PEM_WRITE_C is not defined. Found
298 by inestlerode. #559.
299 * Fix mbedtls_x509_get_sig() to update the ASN1 type in the mbedtls_x509_buf
300 data structure until after error checks are successful. Found by
301 subramanyam-c. #622
302 * Fix documentation and implementation missmatch for function arguments of
303 mbedtls_gcm_finish(). Found by cmiatpaar. #602
304 * Guarantee that P>Q at RSA key generation. Found by inestlerode. #558
305 * Fix potential byte overread when verifying malformed SERVER_HELLO in
306 ssl_parse_hello_verify_request() for DTLS. Found by Guido Vranken.
307 * Fix check for validity of date when parsing in mbedtls_x509_get_time().
308 Found by subramanyam-c. #626
309 * Fix compatibility issue with Internet Explorer client authentication,
310 where the limited hash choices prevented the client from sending its
311 certificate. Found by teumas. #513
312 * Fix compilation without MBEDTLS_SELF_TEST enabled.
313
314Changes
315 * Extended test coverage of special cases, and added new timing test suite.
316 * Removed self-tests from the basic-built-test.sh script, and added all
317 missing self-tests to the test suites, to ensure self-tests are only
318 executed once.
319 * Added support for 3 and 4 byte lengths to mbedtls_asn1_write_len().
320 * Added support for a Yotta specific configuration file -
321 through the symbol YOTTA_CFG_MBEDTLS_TARGET_CONFIG_FILE.
322 * Added optimization for code space for X.509/OID based on configured
323 features. Contributed by Aviv Palivoda.
324 * Renamed source file library/net.c to library/net_sockets.c to avoid
325 naming collision in projects which also have files with the common name
326 net.c. For consistency, the corresponding header file, net.h, is marked as
327 deprecated, and its contents moved to net_sockets.h.
328 * Changed the strategy for X.509 certificate parsing and validation, to no
329 longer disregard certificates with unrecognised fields.
330
331= mbed TLS 2.3.0 branch released 2016-06-28
332
333Security
334 * Fix missing padding length check in mbedtls_rsa_rsaes_pkcs1_v15_decrypt
335 required by PKCS1 v2.2
336 * Fix potential integer overflow to buffer overflow in
337 mbedtls_rsa_rsaes_pkcs1_v15_encrypt and mbedtls_rsa_rsaes_oaep_encrypt
338 (not triggerable remotely in (D)TLS).
339 * Fix a potential integer underflow to buffer overread in
340 mbedtls_rsa_rsaes_oaep_decrypt. It is not triggerable remotely in
341 SSL/TLS.
342
343Features
344 * Support for platform abstraction of the standard C library time()
345 function.
346
347Bugfix
348 * Fix bug in mbedtls_mpi_add_mpi() that caused wrong results when the three
349 arguments where the same (in-place doubling). Found and fixed by Janos
350 Follath. #309
351 * Fix potential build failures related to the 'apidoc' target, introduced
352 in the previous patch release. Found by Robert Scheck. #390 #391
353 * Fix issue in Makefile that prevented building using armar. #386
354 * Fix memory leak that occured only when ECJPAKE was enabled and ECDHE and
355 ECDSA was disabled in config.h . The leak didn't occur by default.
356 * Fix an issue that caused valid certificates to be rejected whenever an
357 expired or not yet valid certificate was parsed before a valid certificate
358 in the trusted certificate list.
359 * Fix bug in mbedtls_x509_crt_parse that caused trailing extra data in the
360 buffer after DER certificates to be included in the raw representation.
361 * Fix issue that caused a hang when generating RSA keys of odd bitlength
362 * Fix bug in mbedtls_rsa_rsaes_pkcs1_v15_encrypt that made null pointer
363 dereference possible.
364 * Fix issue that caused a crash if invalid curves were passed to
365 mbedtls_ssl_conf_curves. #373
366 * Fix issue in ssl_fork_server which was preventing it from functioning. #429
367 * Fix memory leaks in test framework
368 * Fix test in ssl-opt.sh that does not run properly with valgrind
369 * Fix unchecked calls to mmbedtls_md_setup(). Fix by Brian Murray. #502
370
371Changes
372 * On ARM platforms, when compiling with -O0 with GCC, Clang or armcc5,
373 don't use the optimized assembly for bignum multiplication. This removes
374 the need to pass -fomit-frame-pointer to avoid a build error with -O0.
375 * Disabled SSLv3 in the default configuration.
376 * Optimized mbedtls_mpi_zeroize() for MPI integer size. (Fix by Alexey
377 Skalozub).
378 * Fix non-compliance server extension handling. Extensions for SSLv3 are now
379 ignored, as required by RFC6101.
380
381= mbed TLS 2.2.1 released 2016-01-05
382
383Security
384 * Fix potential double free when mbedtls_asn1_store_named_data() fails to
385 allocate memory. Only used for certificate generation, not triggerable
386 remotely in SSL/TLS. Found by Rafał Przywara. #367
387 * Disable MD5 handshake signatures in TLS 1.2 by default to prevent the
388 SLOTH attack on TLS 1.2 server authentication (other attacks from the
389 SLOTH paper do not apply to any version of mbed TLS or PolarSSL).
390 https://www.mitls.org/pages/attacks/SLOTH
391
392Bugfix
393 * Fix over-restrictive length limit in GCM. Found by Andreas-N. #362
394 * Fix bug in certificate validation that caused valid chains to be rejected
395 when the first intermediate certificate has pathLenConstraint=0. Found by
396 Nicholas Wilson. Introduced in mbed TLS 2.2.0. #280
397 * Removed potential leak in mbedtls_rsa_rsassa_pkcs1_v15_sign(), found by
398 JayaraghavendranK. #372
399 * Fix suboptimal handling of unexpected records that caused interop issues
400 with some peers over unreliable links. Avoid dropping an entire DTLS
401 datagram if a single record in a datagram is unexpected, instead only
402 drop the record and look at subsequent records (if any are present) in
403 the same datagram. Found by jeannotlapin. #345
404
405= mbed TLS 2.2.0 released 2015-11-04
406
407Security
408 * Fix potential double free if mbedtls_ssl_conf_psk() is called more than
409 once and some allocation fails. Cannot be forced remotely. Found by Guido
410 Vranken, Intelworks.
411 * Fix potential heap corruption on Windows when
412 mbedtls_x509_crt_parse_path() is passed a path longer than 2GB. Cannot be
413 triggered remotely. Found by Guido Vranken, Intelworks.
414 * Fix potential buffer overflow in some asn1_write_xxx() functions.
415 Cannot be triggered remotely unless you create X.509 certificates based
416 on untrusted input or write keys of untrusted origin. Found by Guido
417 Vranken, Intelworks.
418 * The X509 max_pathlen constraint was not enforced on intermediate
419 certificates. Found by Nicholas Wilson, fix and tests provided by
420 Janos Follath. #280 and #319
421
422Features
423 * Experimental support for EC J-PAKE as defined in Thread 1.0.0.
424 Disabled by default as the specification might still change.
425 * Added a key extraction callback to accees the master secret and key
426 block. (Potential uses include EAP-TLS and Thread.)
427
428Bugfix
429 * Self-signed certificates were not excluded from pathlen counting,
430 resulting in some valid X.509 being incorrectly rejected. Found and fix
431 provided by Janos Follath. #319
432 * Fix build error with configurations where ECDHE-PSK is the only key
433 exchange. Found and fix provided by Chris Hammond. #270
434 * Fix build error with configurations where RSA, RSA-PSK, ECDH-RSA or
435 ECHD-ECDSA if the only key exchange. Multiple reports. #310
436 * Fixed a bug causing some handshakes to fail due to some non-fatal alerts
437 not being properly ignored. Found by mancha and Kasom Koht-arsa, #308
438 * mbedtls_x509_crt_verify(_with_profile)() now also checks the key type and
439 size/curve against the profile. Before that, there was no way to set a
440 minimum key size for end-entity certificates with RSA keys. Found by
441 Matthew Page of Scannex Electronics Ltd.
442 * Fix failures in MPI on Sparc(64) due to use of bad assembly code.
443 Found by Kurt Danielson. #292
444 * Fix typo in name of the extKeyUsage OID. Found by inestlerode, #314
445 * Fix bug in ASN.1 encoding of booleans that caused generated CA
446 certificates to be rejected by some applications, including OS X
447 Keychain. Found and fixed by Jonathan Leroy, Inikup.
448
449Changes
450 * Improved performance of mbedtls_ecp_muladd() when one of the scalars is 1
451 or -1.
452
453= mbed TLS 2.1.2 released 2015-10-06
454
455Security
456 * Added fix for CVE-2015-5291 to prevent heap corruption due to buffer
457 overflow of the hostname or session ticket. Found by Guido Vranken,
458 Intelworks.
459 * Fix potential double-free if mbedtls_ssl_set_hs_psk() is called more than
460 once in the same handhake and mbedtls_ssl_conf_psk() was used.
461 Found and patch provided by Guido Vranken, Intelworks. Cannot be forced
462 remotely.
463 * Fix stack buffer overflow in pkcs12 decryption (used by
464 mbedtls_pk_parse_key(file)() when the password is > 129 bytes.
465 Found by Guido Vranken, Intelworks. Not triggerable remotely.
466 * Fix potential buffer overflow in mbedtls_mpi_read_string().
467 Found by Guido Vranken, Intelworks. Not exploitable remotely in the context
468 of TLS, but might be in other uses. On 32 bit machines, requires reading a
469 string of close to or larger than 1GB to exploit; on 64 bit machines, would
470 require reading a string of close to or larger than 2^62 bytes.
471 * Fix potential random memory allocation in mbedtls_pem_read_buffer()
472 on crafted PEM input data. Found and fix provided by Guido Vranken,
473 Intelworks. Not triggerable remotely in TLS. Triggerable remotely if you
474 accept PEM data from an untrusted source.
475 * Fix possible heap buffer overflow in base64_encoded() when the input
476 buffer is 512MB or larger on 32-bit platforms. Found by Guido Vranken,
477 Intelworks. Not trigerrable remotely in TLS.
478 * Fix potential double-free if mbedtls_conf_psk() is called repeatedly on
479 the same mbedtls_ssl_config object and memory allocation fails. Found by
480 Guido Vranken, Intelworks. Cannot be forced remotely.
481 * Fix potential heap buffer overflow in servers that perform client
482 authentication against a crafted CA cert. Cannot be triggered remotely
483 unless you allow third parties to pick trust CAs for client auth.
484 Found by Guido Vranken, Intelworks.
485
486Bugfix
487 * Fix compile error in net.c with musl libc. Found and patch provided by
488 zhasha (#278).
489 * Fix macroization of 'inline' keyword when building as C++. (#279)
490
491Changes
492 * Added checking of hostname length in mbedtls_ssl_set_hostname() to ensure
493 domain names are compliant with RFC 1035.
494 * Fixed paths for check_config.h in example config files. (Found by bachp)
495 (#291)
496
497= mbed TLS 2.1.1 released 2015-09-17
498
499Security
500 * Add countermeasure against Lenstra's RSA-CRT attack for PKCS#1 v1.5
501 signatures. (Found by Florian Weimer, Red Hat.)
502 https://securityblog.redhat.com/2015/09/02/factoring-rsa-keys-with-tls-perfect-forward-secrecy/
503 * Fix possible client-side NULL pointer dereference (read) when the client
504 tries to continue the handshake after it failed (a misuse of the API).
505 (Found and patch provided by Fabian Foerg, Gotham Digital Science using
506 afl-fuzz.)
507
508Bugfix
509 * Fix warning when using a 64bit platform. (found by embedthis) (#275)
510 * Fix off-by-one error in parsing Supported Point Format extension that
511 caused some handshakes to fail.
512
513Changes
514 * Made X509 profile pointer const in mbedtls_ssl_conf_cert_profile() to allow
515 use of mbedtls_x509_crt_profile_next. (found by NWilson)
516 * When a client initiates a reconnect from the same port as a live
517 connection, if cookie verification is available
518 (MBEDTLS_SSL_DTLS_HELLO_VERIFY defined in config.h, and usable cookie
519 callbacks set with mbedtls_ssl_conf_dtls_cookies()), this will be
520 detected and mbedtls_ssl_read() will return
521 MBEDTLS_ERR_SSL_CLIENT_RECONNECT - it is then possible to start a new
522 handshake with the same context. (See RFC 6347 section 4.2.8.)
523
524= mbed TLS 2.1.0 released 2015-09-04
525
526Features
527 * Added support for yotta as a build system.
528 * Primary open source license changed to Apache 2.0 license.
529
530Bugfix
531 * Fix segfault in the benchmark program when benchmarking DHM.
532 * Fix build error with CMake and pre-4.5 versions of GCC (found by Hugo
533 Leisink).
534 * Fix bug when parsing a ServerHello without extensions (found by David
535 Sears).
536 * Fix bug in CMake lists that caused libmbedcrypto.a not to be installed
537 (found by Benoit Lecocq).
538 * Fix bug in Makefile that caused libmbedcrypto and libmbedx509 not to be
539 installed (found by Rawi666).
540 * Fix compile error with armcc 5 with --gnu option.
541 * Fix bug in Makefile that caused programs not to be installed correctly
542 (found by robotanarchy) (#232).
543 * Fix bug in Makefile that prevented from installing without building the
544 tests (found by robotanarchy) (#232).
545 * Fix missing -static-libgcc when building shared libraries for Windows
546 with make.
547 * Fix link error when building shared libraries for Windows with make.
548 * Fix error when loading libmbedtls.so.
549 * Fix bug in mbedtls_ssl_conf_default() that caused the default preset to
550 be always used (found by dcb314) (#235)
551 * Fix bug in mbedtls_rsa_public() and mbedtls_rsa_private() that could
552 result trying to unlock an unlocked mutex on invalid input (found by
553 Fredrik Axelsson) (#257)
554 * Fix -Wshadow warnings (found by hnrkp) (#240)
555 * Fix memory corruption on client with overlong PSK identity, around
556 SSL_MAX_CONTENT_LEN or higher - not triggerrable remotely (found by
557 Aleksandrs Saveljevs) (#238)
558 * Fix unused function warning when using MBEDTLS_MDx_ALT or
559 MBEDTLS_SHAxxx_ALT (found by Henrik) (#239)
560 * Fix memory corruption in pkey programs (found by yankuncheng) (#210)
561
562Changes
563 * The PEM parser now accepts a trailing space at end of lines (#226).
564 * It is now possible to #include a user-provided configuration file at the
565 end of the default config.h by defining MBEDTLS_USER_CONFIG_FILE on the
566 compiler's command line.
567 * When verifying a certificate chain, if an intermediate certificate is
568 trusted, no later cert is checked. (suggested by hannes-landeholm)
569 (#220).
570 * Prepend a "thread identifier" to debug messages (issue pointed out by
571 Hugo Leisink) (#210).
572 * Add mbedtls_ssl_get_max_frag_len() to query the current maximum fragment
573 length.
574
575= mbed TLS 2.0.0 released 2015-07-13
576
577Features
578 * Support for DTLS 1.0 and 1.2 (RFC 6347).
579 * Ability to override core functions from MDx, SHAx, AES and DES modules
580 with custom implementation (eg hardware accelerated), complementing the
581 ability to override the whole module.
582 * New server-side implementation of session tickets that rotate keys to
583 preserve forward secrecy, and allows sharing across multiple contexts.
584 * Added a concept of X.509 cerificate verification profile that controls
585 which algorithms and key sizes (curves for ECDSA) are acceptable.
586 * Expanded configurability of security parameters in the SSL module with
587 mbedtls_ssl_conf_dhm_min_bitlen() and mbedtls_ssl_conf_sig_hashes().
588 * Introduced a concept of presets for SSL security-relevant configuration
589 parameters.
590
591API Changes
592 * The library has been split into libmbedcrypto, libmbedx509, libmbedtls.
593 You now need to link to all of them if you use TLS for example.
594 * All public identifiers moved to the mbedtls_* or MBEDTLS_* namespace.
595 Some names have been further changed to make them more consistent.
596 Migration helpers scripts/rename.pl and include/mbedlts/compat-1.3.h are
597 provided. Full list of renamings in scripts/data_files/rename-1.3-2.0.txt
598 * Renamings of fields inside structures, not covered by the previous list:
599 mbedtls_cipher_info_t.key_length -> key_bitlen
600 mbedtls_cipher_context_t.key_length -> key_bitlen
601 mbedtls_ecp_curve_info.size -> bit_size
602 * Headers are now found in the 'mbedtls' directory (previously 'polarssl').
603 * The following _init() functions that could return errors have
604 been split into an _init() that returns void and another function that
605 should generally be the first function called on this context after init:
606 mbedtls_ssl_init() -> mbedtls_ssl_setup()
607 mbedtls_ccm_init() -> mbedtls_ccm_setkey()
608 mbedtls_gcm_init() -> mbedtls_gcm_setkey()
609 mbedtls_hmac_drbg_init() -> mbedtls_hmac_drbg_seed(_buf)()
610 mbedtls_ctr_drbg_init() -> mbedtls_ctr_drbg_seed()
611 Note that for mbedtls_ssl_setup(), you need to be done setting up the
612 ssl_config structure before calling it.
613 * Most ssl_set_xxx() functions (all except ssl_set_bio(), ssl_set_hostname(),
614 ssl_set_session() and ssl_set_client_transport_id(), plus
615 ssl_legacy_renegotiation()) have been renamed to mbedtls_ssl_conf_xxx()
616 (see rename.pl and compat-1.3.h above) and their first argument's type
617 changed from ssl_context to ssl_config.
618 * ssl_set_bio() changed signature (contexts merged, order switched, one
619 additional callback for read-with-timeout).
620 * The following functions have been introduced and must be used in callback
621 implementations (SNI, PSK) instead of their *conf counterparts:
622 mbedtls_ssl_set_hs_own_cert()
623 mbedtls_ssl_set_hs_ca_chain()
624 mbedtls_ssl_set_hs_psk()
625 * mbedtls_ssl_conf_ca_chain() lost its last argument (peer_cn), now set
626 using mbedtls_ssl_set_hostname().
627 * mbedtls_ssl_conf_session_cache() changed prototype (only one context
628 pointer, parameters reordered).
629 * On server, mbedtls_ssl_conf_session_tickets_cb() must now be used in
630 place of mbedtls_ssl_conf_session_tickets() to enable session tickets.
631 * The SSL debug callback gained two new arguments (file name, line number).
632 * Debug modes were removed.
633 * mbedtls_ssl_conf_truncated_hmac() now returns void.
634 * mbedtls_memory_buffer_alloc_init() now returns void.
635 * X.509 verification flags are now an uint32_t. Affect the signature of:
636 mbedtls_ssl_get_verify_result()
637 mbedtls_x509_ctr_verify_info()
638 mbedtls_x509_crt_verify() (flags, f_vrfy -> needs to be updated)
639 mbedtls_ssl_conf_verify() (f_vrfy -> needs to be updated)
640 * The following functions changed prototype to avoid an in-out length
641 parameter:
642 mbedtls_base64_encode()
643 mbedtls_base64_decode()
644 mbedtls_mpi_write_string()
645 mbedtls_dhm_calc_secret()
646 * In the NET module, all "int" and "int *" arguments for file descriptors
647 changed type to "mbedtls_net_context *".
648 * net_accept() gained new arguments for the size of the client_ip buffer.
649 * In the threading layer, mbedtls_mutex_init() and mbedtls_mutex_free() now
650 return void.
651 * ecdsa_write_signature() gained an addtional md_alg argument and
652 ecdsa_write_signature_det() was deprecated.
653 * pk_sign() no longer accepts md_alg == POLARSSL_MD_NONE with ECDSA.
654 * Last argument of x509_crt_check_key_usage() and
655 mbedtls_x509write_crt_set_key_usage() changed from int to unsigned.
656 * test_ca_list (from certs.h) is renamed to test_cas_pem and is only
657 available if POLARSSL_PEM_PARSE_C is defined (it never worked without).
658 * Test certificates in certs.c are no longer guaranteed to be nul-terminated
659 strings; use the new *_len variables instead of strlen().
660 * Functions mbedtls_x509_xxx_parse(), mbedtls_pk_parse_key(),
661 mbedtls_pk_parse_public_key() and mbedtls_dhm_parse_dhm() now expect the
662 length parameter to include the terminating null byte for PEM input.
663 * Signature of mpi_mul_mpi() changed to make the last argument unsigned
664 * calloc() is now used instead of malloc() everywhere. API of platform
665 layer and the memory_buffer_alloc module changed accordingly.
666 (Thanks to Mansour Moufid for helping with the replacement.)
667 * Change SSL_DISABLE_RENEGOTIATION config.h flag to SSL_RENEGOTIATION
668 (support for renegotiation now needs explicit enabling in config.h).
669 * Split MBEDTLS_HAVE_TIME into MBEDTLS_HAVE_TIME and MBEDTLS_HAVE_TIME_DATE
670 in config.h
671 * net_connect() and net_bind() have a new 'proto' argument to choose
672 between TCP and UDP, using the macros NET_PROTO_TCP or NET_PROTO_UDP.
673 Their 'port' argument type is changed to a string.
674 * Some constness fixes
675
676Removals
677 * Removed mbedtls_ecp_group_read_string(). Only named groups are supported.
678 * Removed mbedtls_ecp_sub() and mbedtls_ecp_add(), use
679 mbedtls_ecp_muladd().
680 * Removed individual mdX_hmac, shaX_hmac, mdX_file and shaX_file functions
681 (use generic functions from md.h)
682 * Removed mbedtls_timing_msleep(). Use mbedtls_net_usleep() or a custom
683 waiting function.
684 * Removed test DHM parameters from the test certs module.
685 * Removed the PBKDF2 module (use PKCS5).
686 * Removed POLARSSL_ERROR_STRERROR_BC (use mbedtls_strerror()).
687 * Removed compat-1.2.h (helper for migrating from 1.2 to 1.3).
688 * Removed openssl.h (very partial OpenSSL compatibility layer).
689 * Configuration options POLARSSL_HAVE_LONGLONG was removed (now always on).
690 * Configuration options POLARSSL_HAVE_INT8 and POLARSSL_HAVE_INT16 have
691 been removed (compiler is required to support 32-bit operations).
692 * Configuration option POLARSSL_HAVE_IPV6 was removed (always enabled).
693 * Removed test program o_p_test, the script compat.sh does more.
694 * Removed test program ssl_test, superseded by ssl-opt.sh.
695 * Removed helper script active-config.pl
696
697New deprecations
698 * md_init_ctx() is deprecated in favour of md_setup(), that adds a third
699 argument (allowing memory savings if HMAC is not used)
700
701Semi-API changes (technically public, morally private)
702 * Renamed a few headers to include _internal in the name. Those headers are
703 not supposed to be included by users.
704 * Changed md_info_t into an opaque structure (use md_get_xxx() accessors).
705 * Changed pk_info_t into an opaque structure.
706 * Changed cipher_base_t into an opaque structure.
707 * Removed sig_oid2 and rename sig_oid1 to sig_oid in x509_crt and x509_crl.
708 * x509_crt.key_usage changed from unsigned char to unsigned int.
709 * Removed r and s from ecdsa_context
710 * Removed mode from des_context and des3_context
711
712Default behavior changes
713 * The default minimum TLS version is now TLS 1.0.
714 * RC4 is now blacklisted by default in the SSL/TLS layer, and excluded from the
715 default ciphersuite list returned by ssl_list_ciphersuites()
716 * Support for receiving SSLv2 ClientHello is now disabled by default at
717 compile time.
718 * The default authmode for SSL/TLS clients is now REQUIRED.
719 * Support for RSA_ALT contexts in the PK layer is now optional. Since is is
720 enabled in the default configuration, this is only noticeable if using a
721 custom config.h
722 * Default DHM parameters server-side upgraded from 1024 to 2048 bits.
723 * A minimum RSA key size of 2048 bits is now enforced during ceritificate
724 chain verification.
725 * Negotiation of truncated HMAC is now disabled by default on server too.
726 * The following functions are now case-sensitive:
727 mbedtls_cipher_info_from_string()
728 mbedtls_ecp_curve_info_from_name()
729 mbedtls_md_info_from_string()
730 mbedtls_ssl_ciphersuite_from_string()
731 mbedtls_version_check_feature()
732
733Requirement changes
734 * The minimum MSVC version required is now 2010 (better C99 support).
735 * The NET layer now unconditionnaly relies on getaddrinfo() and select().
736 * Compiler is required to support C99 types such as long long and uint32_t.
737
738API changes from the 1.4 preview branch
739 * ssl_set_bio_timeout() was removed, split into mbedtls_ssl_set_bio() with
740 new prototype, and mbedtls_ssl_set_read_timeout().
741 * The following functions now return void:
742 mbedtls_ssl_conf_transport()
743 mbedtls_ssl_conf_max_version()
744 mbedtls_ssl_conf_min_version()
745 * DTLS no longer hard-depends on TIMING_C, but uses a callback interface
746 instead, see mbedtls_ssl_set_timer_cb(), with the Timing module providing
747 an example implementation, see mbedtls_timing_delay_context and
748 mbedtls_timing_set/get_delay().
749 * With UDP sockets, it is no longer necessary to call net_bind() again
750 after a successful net_accept().
751
752Changes
753 * mbedtls_ctr_drbg_random() and mbedtls_hmac_drbg_random() are now
754 thread-safe if MBEDTLS_THREADING_C is enabled.
755 * Reduced ROM fooprint of SHA-256 and added an option to reduce it even
756 more (at the expense of performance) MBEDTLS_SHA256_SMALLER.
757
758= mbed TLS 1.3 branch
759
760Security
761 * With authmode set to SSL_VERIFY_OPTIONAL, verification of keyUsage and
762 extendedKeyUsage on the leaf certificate was lost (results not accessible
763 via ssl_get_verify_results()).
764 * Add countermeasure against "Lucky 13 strikes back" cache-based attack,
765 https://dl.acm.org/citation.cfm?id=2714625
766
767Features
768 * Improve ECC performance by using more efficient doubling formulas
769 (contributed by Peter Dettman).
770 * Add x509_crt_verify_info() to display certificate verification results.
771 * Add support for reading DH parameters with privateValueLength included
772 (contributed by Daniel Kahn Gillmor).
773 * Add support for bit strings in X.509 names (request by Fredrik Axelsson).
774 * Add support for id-at-uniqueIdentifier in X.509 names.
775 * Add support for overriding snprintf() (except on Windows) and exit() in
776 the platform layer.
777 * Add an option to use macros instead of function pointers in the platform
778 layer (helps get rid of unwanted references).
779 * Improved Makefiles for Windows targets by fixing library targets and making
780 cross-compilation easier (thanks to Alon Bar-Lev).
781 * The benchmark program also prints heap usage for public-key primitives
782 if POLARSSL_MEMORY_BUFFER_ALLOC_C and POLARSSL_MEMORY_DEBUG are defined.
783 * New script ecc-heap.sh helps measuring the impact of ECC parameters on
784 speed and RAM (heap only for now) usage.
785 * New script memory.sh helps measuring the ROM and RAM requirements of two
786 reduced configurations (PSK-CCM and NSA suite B).
787 * Add config flag POLARSSL_DEPRECATED_WARNING (off by default) to produce
788 warnings on use of deprecated functions (with GCC and Clang only).
789 * Add config flag POLARSSL_DEPRECATED_REMOVED (off by default) to produce
790 errors on use of deprecated functions.
791
792Bugfix
793 * Fix compile errors with PLATFORM_NO_STD_FUNCTIONS.
794 * Fix compile error with PLATFORM_EXIT_ALT (thanks to Rafał Przywara).
795 * Fix bug in entropy.c when THREADING_C is also enabled that caused
796 entropy_free() to crash (thanks to Rafał Przywara).
797 * Fix memory leak when gcm_setkey() and ccm_setkey() are used more than
798 once on the same context.
799 * Fix bug in ssl_mail_client when password is longer that username (found
800 by Bruno Pape).
801 * Fix undefined behaviour (memcmp( NULL, NULL, 0 );) in X.509 modules
802 (detected by Clang's 3.6 UBSan).
803 * mpi_size() and mpi_msb() would segfault when called on an mpi that is
804 initialized but not set (found by pravic).
805 * Fix detection of support for getrandom() on Linux (reported by syzzer) by
806 doing it at runtime (using uname) rather that compile time.
807 * Fix handling of symlinks by "make install" (found by Gaël PORTAY).
808 * Fix potential NULL pointer dereference (not trigerrable remotely) when
809 ssl_write() is called before the handshake is finished (introduced in
810 1.3.10) (first reported by Martin Blumenstingl).
811 * Fix bug in pk_parse_key() that caused some valid private EC keys to be
812 rejected.
813 * Fix bug in Via Padlock support (found by Nikos Mavrogiannopoulos).
814 * Fix thread safety bug in RSA operations (found by Fredrik Axelsson).
815 * Fix hardclock() (only used in the benchmarking program) with some
816 versions of mingw64 (found by kxjhlele).
817 * Fix warnings from mingw64 in timing.c (found by kxjklele).
818 * Fix potential unintended sign extension in asn1_get_len() on 64-bit
819 platforms.
820 * Fix potential memory leak in ssl_set_psk() (found by Mansour Moufid).
821 * Fix compile error when POLARSSL_SSL_DISABLE_RENEGOTATION and
822 POLARSSL_SSL_SSESSION_TICKETS where both enabled in config.h (introduced
823 in 1.3.10).
824 * Add missing extern "C" guard in aesni.h (reported by amir zamani).
825 * Add missing dependency on SHA-256 in some x509 programs (reported by
826 Gergely Budai).
827 * Fix bug related to ssl_set_curves(): the client didn't check that the
828 curve picked by the server was actually allowed.
829
830Changes
831 * Remove bias in mpi_gen_prime (contributed by Pascal Junod).
832 * Remove potential sources of timing variations (some contributed by Pascal
833 Junod).
834 * Options POLARSSL_HAVE_INT8 and POLARSSL_HAVE_INT16 are deprecated.
835 * Enabling POLARSSL_NET_C without POLARSSL_HAVE_IPV6 is deprecated.
836 * compat-1.2.h and openssl.h are deprecated.
837 * Adjusting/overriding CFLAGS and LDFLAGS with the make build system is now
838 more flexible (warning: OFLAGS is not used any more) (see the README)
839 (contributed by Alon Bar-Lev).
840 * ssl_set_own_cert() no longer calls pk_check_pair() since the
841 performance impact was bad for some users (this was introduced in 1.3.10).
842 * Move from SHA-1 to SHA-256 in example programs using signatures
843 (suggested by Thorsten Mühlfelder).
844 * Remove some unneeded inclusions of header files from the standard library
845 "minimize" others (eg use stddef.h if only size_t is needed).
846 * Change #include lines in test files to use double quotes instead of angle
847 brackets for uniformity with the rest of the code.
848 * Remove dependency on sscanf() in X.509 parsing modules.
849
850= mbed TLS 1.3.10 released 2015-02-09
851Security
852 * NULL pointer dereference in the buffer-based allocator when the buffer is
853 full and polarssl_free() is called (found by Mark Hasemeyer)
854 (only possible if POLARSSL_MEMORY_BUFFER_ALLOC_C is enabled, which it is
855 not by default).
856 * Fix remotely-triggerable uninitialised pointer dereference caused by
857 crafted X.509 certificate (TLS server is not affected if it doesn't ask for a
858 client certificate) (found using Codenomicon Defensics).
859 * Fix remotely-triggerable memory leak caused by crafted X.509 certificates
860 (TLS server is not affected if it doesn't ask for a client certificate)
861 (found using Codenomicon Defensics).
862 * Fix potential stack overflow while parsing crafted X.509 certificates
863 (TLS server is not affected if it doesn't ask for a client certificate)
864 (found using Codenomicon Defensics).
865 * Fix timing difference that could theoretically lead to a
866 Bleichenbacher-style attack in the RSA and RSA-PSK key exchanges
867 (reported by Sebastian Schinzel).
868
869Features
870 * Add support for FALLBACK_SCSV (draft-ietf-tls-downgrade-scsv).
871 * Add support for Extended Master Secret (draft-ietf-tls-session-hash).
872 * Add support for Encrypt-then-MAC (RFC 7366).
873 * Add function pk_check_pair() to test if public and private keys match.
874 * Add x509_crl_parse_der().
875 * Add compile-time option POLARSSL_X509_MAX_INTERMEDIATE_CA to limit the
876 length of an X.509 verification chain.
877 * Support for renegotiation can now be disabled at compile-time
878 * Support for 1/n-1 record splitting, a countermeasure against BEAST.
879 * Certificate selection based on signature hash, preferring SHA-1 over SHA-2
880 for pre-1.2 clients when multiple certificates are available.
881 * Add support for getrandom() syscall on recent Linux kernels with Glibc or
882 a compatible enough libc (eg uClibc).
883 * Add ssl_set_arc4_support() to make it easier to disable RC4 at runtime
884 while using the default ciphersuite list.
885 * Added new error codes and debug messages about selection of
886 ciphersuite/certificate.
887
888Bugfix
889 * Stack buffer overflow if ctr_drbg_update() is called with too large
890 add_len (found by Jean-Philippe Aumasson) (not triggerable remotely).
891 * Possible buffer overflow of length at most POLARSSL_MEMORY_ALIGN_MULTIPLE
892 if memory_buffer_alloc_init() was called with buf not aligned and len not
893 a multiple of POLARSSL_MEMORY_ALIGN_MULTIPLE (not triggerable remotely).
894 * User set CFLAGS were ignored by Cmake with gcc (introduced in 1.3.9, found
895 by Julian Ospald).
896 * Fix potential undefined behaviour in Camellia.
897 * Fix potential failure in ECDSA signatures when POLARSSL_ECP_MAX_BITS is a
898 multiple of 8 (found by Gergely Budai).
899 * Fix unchecked return code in x509_crt_parse_path() on Windows (found by
900 Peter Vaskovic).
901 * Fix assembly selection for MIPS64 (thanks to James Cowgill).
902 * ssl_get_verify_result() now works even if the handshake was aborted due
903 to a failed verification (found by Fredrik Axelsson).
904 * Skip writing and parsing signature_algorithm extension if none of the
905 key exchanges enabled needs certificates. This fixes a possible interop
906 issue with some servers when a zero-length extension was sent. (Reported
907 by Peter Dettman.)
908 * On a 0-length input, base64_encode() did not correctly set output length
909 (found by Hendrik van den Boogaard).
910
911Changes
912 * Use deterministic nonces for AEAD ciphers in TLS by default (possible to
913 switch back to random with POLARSSL_SSL_AEAD_RANDOM_IV in config.h).
914 * Blind RSA private operations even when POLARSSL_RSA_NO_CRT is defined.
915 * ssl_set_own_cert() now returns an error on key-certificate mismatch.
916 * Forbid repeated extensions in X.509 certificates.
917 * debug_print_buf() now prints a text view in addition to hexadecimal.
918 * A specific error is now returned when there are ciphersuites in common
919 but none of them is usable due to external factors such as no certificate
920 with a suitable (extended)KeyUsage or curve or no PSK set.
921 * It is now possible to disable negotiation of truncated HMAC server-side
922 at runtime with ssl_set_truncated_hmac().
923 * Example programs for SSL client and server now disable SSLv3 by default.
924 * Example programs for SSL client and server now disable RC4 by default.
925 * Use platform.h in all test suites and programs.
926
927= PolarSSL 1.3.9 released 2014-10-20
928Security
929 * Lowest common hash was selected from signature_algorithms extension in
930 TLS 1.2 (found by Darren Bane) (introduced in 1.3.8).
931 * Remotely-triggerable memory leak when parsing some X.509 certificates
932 (server is not affected if it doesn't ask for a client certificate)
933 (found using Codenomicon Defensics).
934 * Remotely-triggerable memory leak when parsing crafted ClientHello
935 (not affected if ECC support was compiled out) (found using Codenomicon
936 Defensics).
937
938Bugfix
939 * Support escaping of commas in x509_string_to_names()
940 * Fix compile error in ssl_pthread_server (found by Julian Ospald).
941 * Fix net_accept() regarding non-blocking sockets (found by Luca Pesce).
942 * Don't print uninitialised buffer in ssl_mail_client (found by Marc Abel).
943 * Fix warnings from Clang's scan-build (contributed by Alfred Klomp).
944 * Fix compile error in timing.c when POLARSSL_NET_C and POLARSSL_SELFTEST
945 are defined but not POLARSSL_HAVE_TIME (found by Stephane Di Vito).
946 * Remove non-existent file from VS projects (found by Peter Vaskovic).
947 * ssl_read() could return non-application data records on server while
948 renegotation was pending, and on client when a HelloRequest was received.
949 * Server-initiated renegotiation would fail with non-blocking I/O if the
950 write callback returned WANT_WRITE when requesting renegotiation.
951 * ssl_close_notify() could send more than one message in some circumstances
952 with non-blocking I/O.
953 * Fix compiler warnings on iOS (found by Sander Niemeijer).
954 * x509_crt_parse() did not increase total_failed on PEM error
955 * Fix compile error with armcc in mpi_is_prime()
956 * Fix potential bad read in parsing ServerHello (found by Adrien
957 Vialletelle).
958
959Changes
960 * Ciphersuites using SHA-256 or SHA-384 now require TLS 1.x (there is no
961 standard defining how to use SHA-2 with SSL 3.0).
962 * Ciphersuites using RSA-PSK key exchange new require TLS 1.x (the spec is
963 ambiguous on how to encode some packets with SSL 3.0).
964 * Made buffer size in pk_write_(pub)key_pem() more dynamic, eg smaller if
965 RSA is disabled, larger if POLARSSL_MPI_MAX_SIZE is larger.
966 * ssl_read() now returns POLARSSL_ERR_NET_WANT_READ rather than
967 POLARSSL_ERR_SSL_UNEXPECTED_MESSAGE on harmless alerts.
968 * POLARSSL_MPI_MAX_SIZE now defaults to 1024 in order to allow 8192 bits
969 RSA keys.
970 * Accept spaces at end of line or end of buffer in base64_decode().
971 * X.509 certificates with more than one AttributeTypeAndValue per
972 RelativeDistinguishedName are not accepted any more.
973
974= PolarSSL 1.3.8 released 2014-07-11
975Security
976 * Fix length checking for AEAD ciphersuites (found by Codenomicon).
977 It was possible to crash the server (and client) using crafted messages
978 when a GCM suite was chosen.
979
980Features
981 * Add CCM module and cipher mode to Cipher Layer
982 * Support for CCM and CCM_8 ciphersuites
983 * Support for parsing and verifying RSASSA-PSS signatures in the X.509
984 modules (certificates, CRLs and CSRs).
985 * Blowfish in the cipher layer now supports variable length keys.
986 * Add example config.h for PSK with CCM, optimized for low RAM usage.
987 * Optimize for RAM usage in example config.h for NSA Suite B profile.
988 * Add POLARSSL_REMOVE_ARC4_CIPHERSUITES to allow removing RC4 ciphersuites
989 from the default list (inactive by default).
990 * Add server-side enforcement of sent renegotiation requests
991 (ssl_set_renegotiation_enforced())
992 * Add SSL_CIPHERSUITES config.h flag to allow specifying a list of
993 ciphersuites to use and save some memory if the list is small.
994
995Changes
996 * Add LINK_WITH_PTHREAD option in CMake for explicit linking that is
997 required on some platforms (e.g. OpenBSD)
998 * Migrate zeroizing of data to polarssl_zeroize() instead of memset()
999 against unwanted compiler optimizations
1000 * md_list() now returns hashes strongest first
1001 * Selection of hash for signing ServerKeyExchange in TLS 1.2 now picks
1002 strongest offered by client.
1003 * All public contexts have _init() and _free() functions now for simpler
1004 usage pattern
1005
1006Bugfix
1007 * Fix in debug_print_msg()
1008 * Enforce alignment in the buffer allocator even if buffer is not aligned
1009 * Remove less-than-zero checks on unsigned numbers
1010 * Stricter check on SSL ClientHello internal sizes compared to actual packet
1011 size (found by TrustInSoft)
1012 * Fix WSAStartup() return value check (found by Peter Vaskovic)
1013 * Other minor issues (found by Peter Vaskovic)
1014 * Fix symlink command for cross compiling with CMake (found by Andre
1015 Heinecke)
1016 * Fix DER output of gen_key app (found by Gergely Budai)
1017 * Very small records were incorrectly rejected when truncated HMAC was in
1018 use with some ciphersuites and versions (RC4 in all versions, CBC with
1019 versions < TLS 1.1).
1020 * Very large records using more than 224 bytes of padding were incorrectly
1021 rejected with CBC-based ciphersuites and TLS >= 1.1
1022 * Very large records using less padding could cause a buffer overread of up
1023 to 32 bytes with CBC-based ciphersuites and TLS >= 1.1
1024 * Restore ability to use a v1 cert as a CA if trusted locally. (This had
1025 been removed in 1.3.6.)
1026 * Restore ability to locally trust a self-signed cert that is not a proper
1027 CA for use as an end entity certificate. (This had been removed in
1028 1.3.6.)
1029 * Fix preprocessor checks for bn_mul PPC asm (found by Barry K. Nathan).
1030 * Use \n\t rather than semicolons for bn_mul asm, since some assemblers
1031 interpret semicolons as comment delimiters (found by Barry K. Nathan).
1032 * Fix off-by-one error in parsing Supported Point Format extension that
1033 caused some handshakes to fail.
1034 * Fix possible miscomputation of the premaster secret with DHE-PSK key
1035 exchange that caused some handshakes to fail with other implementations.
1036 (Failure rate <= 1/255 with common DHM moduli.)
1037 * Disable broken Sparc64 bn_mul assembly (found by Florian Obser).
1038 * Fix base64_decode() to return and check length correctly (in case of
1039 tight buffers)
1040 * Fix mpi_write_string() to write "00" as hex output for empty MPI (found
1041 by Hui Dong)
1042
1043= PolarSSL 1.3.7 released on 2014-05-02
1044Features
1045 * debug_set_log_mode() added to determine raw or full logging
1046 * debug_set_threshold() added to ignore messages over threshold level
1047 * version_check_feature() added to check for compile-time options at
1048 run-time
1049
1050Changes
1051 * POLARSSL_CONFIG_OPTIONS has been removed. All values are individually
1052 checked and filled in the relevant module headers
1053 * Debug module only outputs full lines instead of parts
1054 * Better support for the different Attribute Types from IETF PKIX (RFC 5280)
1055 * AES-NI now compiles with "old" assemblers too
1056 * Ciphersuites based on RC4 now have the lowest priority by default
1057
1058Bugfix
1059 * Only iterate over actual certificates in ssl_write_certificate_request()
1060 (found by Matthew Page)
1061 * Typos in platform.c and pkcs11.c (found by Daniel Phillips and Steffan
1062 Karger)
1063 * cert_write app should use subject of issuer certificate as issuer of cert
1064 * Fix false reject in padding check in ssl_decrypt_buf() for CBC
1065 ciphersuites, for full SSL frames of data.
1066 * Improve interoperability by not writing extension length in ClientHello /
1067 ServerHello when no extensions are present (found by Matthew Page)
1068 * rsa_check_pubkey() now allows an E up to N
1069 * On OpenBSD, use arc4random_buf() instead of rand() to prevent warnings
1070 * mpi_fill_random() was creating numbers larger than requested on
1071 big-endian platform when size was not an integer number of limbs
1072 * Fix dependencies issues in X.509 test suite.
1073 * Some parts of ssl_tls.c were compiled even when the module was disabled.
1074 * Fix detection of DragonflyBSD in net.c (found by Markus Pfeiffer)
1075 * Fix detection of Clang on some Apple platforms with CMake
1076 (found by Barry K. Nathan)
1077
1078= PolarSSL 1.3.6 released on 2014-04-11
1079
1080Features
1081 * Support for the ALPN SSL extension
1082 * Add option 'use_dev_random' to gen_key application
1083 * Enable verification of the keyUsage extension for CA and leaf
1084 certificates (POLARSSL_X509_CHECK_KEY_USAGE)
1085 * Enable verification of the extendedKeyUsage extension
1086 (POLARSSL_X509_CHECK_EXTENDED_KEY_USAGE)
1087
1088Changes
1089 * x509_crt_info() now prints information about parsed extensions as well
1090 * pk_verify() now returns a specific error code when the signature is valid
1091 but shorter than the supplied length.
1092 * Use UTC time to check certificate validity.
1093 * Reject certificates with times not in UTC, per RFC 5280.
1094
1095Security
1096 * Avoid potential timing leak in ecdsa_sign() by blinding modular division.
1097 (Found by Watson Ladd.)
1098 * The notAfter date of some certificates was no longer checked since 1.3.5.
1099 This affects certificates in the user-supplied chain except the top
1100 certificate. If the user-supplied chain contains only one certificates,
1101 it is not affected (ie, its notAfter date is properly checked).
1102 * Prevent potential NULL pointer dereference in ssl_read_record() (found by
1103 TrustInSoft)
1104
1105Bugfix
1106 * The length of various ClientKeyExchange messages was not properly checked.
1107 * Some example server programs were not sending the close_notify alert.
1108 * Potential memory leak in mpi_exp_mod() when error occurs during
1109 calculation of RR.
1110 * Fixed malloc/free default #define in platform.c (found by Gergely Budai).
1111 * Fixed type which made POLARSSL_ENTROPY_FORCE_SHA256 uneffective (found by
1112 Gergely Budai).
1113 * Fix #include path in ecdsa.h which wasn't accepted by some compilers.
1114 (found by Gergely Budai)
1115 * Fix compile errors when POLARSSL_ERROR_STRERROR_BC is undefined (found by
1116 Shuo Chen).
1117 * oid_get_numeric_string() used to truncate the output without returning an
1118 error if the output buffer was just 1 byte too small.
1119 * dhm_parse_dhm() (hence dhm_parse_dhmfile()) did not set dhm->len.
1120 * Calling pk_debug() on an RSA-alt key would segfault.
1121 * pk_get_size() and pk_get_len() were off by a factor 8 for RSA-alt keys.
1122 * Potential buffer overwrite in pem_write_buffer() because of low length
1123 indication (found by Thijs Alkemade)
1124 * EC curves constants, which should be only in ROM since 1.3.3, were also
1125 stored in RAM due to missing 'const's (found by Gergely Budai).
1126
1127= PolarSSL 1.3.5 released on 2014-03-26
1128Features
1129 * HMAC-DRBG as a separate module
1130 * Option to set the Curve preference order (disabled by default)
1131 * Single Platform compatilibity layer (for memory / printf / fprintf)
1132 * Ability to provide alternate timing implementation
1133 * Ability to force the entropy module to use SHA-256 as its basis
1134 (POLARSSL_ENTROPY_FORCE_SHA256)
1135 * Testing script ssl-opt.sh added for testing 'live' ssl option
1136 interoperability against OpenSSL and PolarSSL
1137 * Support for reading EC keys that use SpecifiedECDomain in some cases.
1138 * Entropy module now supports seed writing and reading
1139
1140Changes
1141 * Deprecated the Memory layer
1142 * entropy_add_source(), entropy_update_manual() and entropy_gather()
1143 now thread-safe if POLARSSL_THREADING_C defined
1144 * Improvements to the CMake build system, contributed by Julian Ospald.
1145 * Work around a bug of the version of Clang shipped by Apple with Mavericks
1146 that prevented bignum.c from compiling. (Reported by Rafael Baptista.)
1147 * Revamped the compat.sh interoperatibility script to include support for
1148 testing against GnuTLS
1149 * Deprecated ssl_set_own_cert_rsa() and ssl_set_own_cert_rsa_alt()
1150 * Improvements to tests/Makefile, contributed by Oden Eriksson.
1151
1152Security
1153 * Forbid change of server certificate during renegotiation to prevent
1154 "triple handshake" attack when authentication mode is 'optional' (the
1155 attack was already impossible when authentication is required).
1156 * Check notBefore timestamp of certificates and CRLs from the future.
1157 * Forbid sequence number wrapping
1158 * Fixed possible buffer overflow with overlong PSK
1159 * Possible remotely-triggered out-of-bounds memory access fixed (found by
1160 TrustInSoft)
1161
1162Bugfix
1163 * ecp_gen_keypair() does more tries to prevent failure because of
1164 statistics
1165 * Fixed bug in RSA PKCS#1 v1.5 "reversed" operations
1166 * Fixed testing with out-of-source builds using cmake
1167 * Fixed version-major intolerance in server
1168 * Fixed CMake symlinking on out-of-source builds
1169 * Fixed dependency issues in test suite
1170 * Programs rsa_sign_pss and rsa_verify_pss were not using PSS since 1.3.0
1171 * Bignum's MIPS-32 assembly was used on MIPS-64, causing chaos. (Found by
1172 Alex Wilson.)
1173 * ssl_cache was creating entries when max_entries=0 if TIMING_C was enabled.
1174 * m_sleep() was sleeping twice too long on most Unix platforms.
1175 * Fixed bug with session tickets and non-blocking I/O in the unlikely case
1176 send() would return an EAGAIN error when sending the ticket.
1177 * ssl_cache was leaking memory when reusing a timed out entry containing a
1178 client certificate.
1179 * ssl_srv was leaking memory when client presented a timed out ticket
1180 containing a client certificate
1181 * ssl_init() was leaving a dirty pointer in ssl_context if malloc of
1182 out_ctr failed
1183 * ssl_handshake_init() was leaving dirty pointers in subcontexts if malloc
1184 of one of them failed
1185 * Fix typo in rsa_copy() that impacted PKCS#1 v2 contexts
1186 * x509_get_current_time() uses localtime_r() to prevent thread issues
1187
1188= PolarSSL 1.3.4 released on 2014-01-27
1189Features
1190 * Support for the Koblitz curves: secp192k1, secp224k1, secp256k1
1191 * Support for RIPEMD-160
1192 * Support for AES CFB8 mode
1193 * Support for deterministic ECDSA (RFC 6979)
1194
1195Bugfix
1196 * Potential memory leak in bignum_selftest()
1197 * Replaced expired test certificate
1198 * ssl_mail_client now terminates lines with CRLF, instead of LF
1199 * net module handles timeouts on blocking sockets better (found by Tilman
1200 Sauerbeck)
1201 * Assembly format fixes in bn_mul.h
1202
1203Security
1204 * Missing MPI_CHK calls added around unguarded mpi calls (found by
1205 TrustInSoft)
1206
1207= PolarSSL 1.3.3 released on 2013-12-31
1208Features
1209 * EC key generation support in gen_key app
1210 * Support for adhering to client ciphersuite order preference
1211 (POLARSSL_SSL_SRV_RESPECT_CLIENT_PREFERENCE)
1212 * Support for Curve25519
1213 * Support for ECDH-RSA and ECDH-ECDSA key exchanges and ciphersuites
1214 * Support for IPv6 in the NET module
1215 * AES-NI support for AES, AES-GCM and AES key scheduling
1216 * SSL Pthread-based server example added (ssl_pthread_server)
1217
1218Changes
1219 * gen_prime() speedup
1220 * Speedup of ECP multiplication operation
1221 * Relaxed some SHA2 ciphersuite's version requirements
1222 * Dropped use of readdir_r() instead of readdir() with threading support
1223 * More constant-time checks in the RSA module
1224 * Split off curves from ecp.c into ecp_curves.c
1225 * Curves are now stored fully in ROM
1226 * Memory usage optimizations in ECP module
1227 * Removed POLARSSL_THREADING_DUMMY
1228
1229Bugfix
1230 * Fixed bug in mpi_set_bit() on platforms where t_uint is wider than int
1231 * Fixed X.509 hostname comparison (with non-regular characters)
1232 * SSL now gracefully handles missing RNG
1233 * Missing defines / cases for RSA_PSK key exchange
1234 * crypt_and_hash app checks MAC before final decryption
1235 * Potential memory leak in ssl_ticket_keys_init()
1236 * Memory leak in benchmark application
1237 * Fixed x509_crt_parse_path() bug on Windows platforms
1238 * Added missing MPI_CHK() around some statements in mpi_div_mpi() (found by
1239 TrustInSoft)
1240 * Fixed potential overflow in certificate size verification in
1241 ssl_write_certificate() (found by TrustInSoft)
1242
1243Security
1244 * Possible remotely-triggered out-of-bounds memory access fixed (found by
1245 TrustInSoft)
1246
1247= PolarSSL 1.3.2 released on 2013-11-04
1248Features
1249 * PK tests added to test framework
1250 * Added optional optimization for NIST MODP curves (POLARSSL_ECP_NIST_OPTIM)
1251 * Support for Camellia-GCM mode and ciphersuites
1252
1253Changes
1254 * Padding checks in cipher layer are now constant-time
1255 * Value comparisons in SSL layer are now constant-time
1256 * Support for serialNumber, postalAddress and postalCode in X509 names
1257 * SSL Renegotiation was refactored
1258
1259Bugfix
1260 * More stringent checks in cipher layer
1261 * Server does not send out extensions not advertised by client
1262 * Prevent possible alignment warnings on casting from char * to 'aligned *'
1263 * Misc fixes and additions to dependency checks
1264 * Const correctness
1265 * cert_write with selfsign should use issuer_name as subject_name
1266 * Fix ECDSA corner case: missing reduction mod N (found by DualTachyon)
1267 * Defines to handle UEFI environment under MSVC
1268 * Server-side initiated renegotiations send HelloRequest
1269
1270= PolarSSL 1.3.1 released on 2013-10-15
1271Features
1272 * Support for Brainpool curves and TLS ciphersuites (RFC 7027)
1273 * Support for ECDHE-PSK key-exchange and ciphersuites
1274 * Support for RSA-PSK key-exchange and ciphersuites
1275
1276Changes
1277 * RSA blinding locks for a smaller amount of time
1278 * TLS compression only allocates working buffer once
1279 * Introduced POLARSSL_HAVE_READDIR_R for systems without it
1280 * config.h is more script-friendly
1281
1282Bugfix
1283 * Missing MSVC defines added
1284 * Compile errors with POLARSSL_RSA_NO_CRT
1285 * Header files with 'polarssl/'
1286 * Const correctness
1287 * Possible naming collision in dhm_context
1288 * Better support for MSVC
1289 * threading_set_alt() name
1290 * Added missing x509write_crt_set_version()
1291
1292= PolarSSL 1.3.0 released on 2013-10-01
1293Features
1294 * Elliptic Curve Cryptography module added
1295 * Elliptic Curve Diffie Hellman module added
1296 * Ephemeral Elliptic Curve Diffie Hellman support for SSL/TLS
1297 (ECDHE-based ciphersuites)
1298 * Ephemeral Elliptic Curve Digital Signature Algorithm support for SSL/TLS
1299 (ECDSA-based ciphersuites)
1300 * Ability to specify allowed ciphersuites based on the protocol version.
1301 * PSK and DHE-PSK based ciphersuites added
1302 * Memory allocation abstraction layer added
1303 * Buffer-based memory allocator added (no malloc() / free() / HEAP usage)
1304 * Threading abstraction layer added (dummy / pthread / alternate)
1305 * Public Key abstraction layer added
1306 * Parsing Elliptic Curve keys
1307 * Parsing Elliptic Curve certificates
1308 * Support for max_fragment_length extension (RFC 6066)
1309 * Support for truncated_hmac extension (RFC 6066)
1310 * Support for zeros-and-length (ANSI X.923) padding, one-and-zeros
1311 (ISO/IEC 7816-4) padding and zero padding in the cipher layer
1312 * Support for session tickets (RFC 5077)
1313 * Certificate Request (CSR) generation with extensions (key_usage,
1314 ns_cert_type)
1315 * X509 Certificate writing with extensions (basic_constraints,
1316 issuer_key_identifier, etc)
1317 * Optional blinding for RSA, DHM and EC
1318 * Support for multiple active certificate / key pairs in SSL servers for
1319 the same host (Not to be confused with SNI!)
1320
1321Changes
1322 * Ability to enable / disable SSL v3 / TLS 1.0 / TLS 1.1 / TLS 1.2
1323 individually
1324 * Introduced separate SSL Ciphersuites module that is based on
1325 Cipher and MD information
1326 * Internals for SSL module adapted to have separate IV pointer that is
1327 dynamically set (Better support for hardware acceleration)
1328 * Moved all OID functionality to a separate module. RSA function
1329 prototypes for the RSA sign and verify functions changed as a result
1330 * Split up the GCM module into a starts/update/finish cycle
1331 * Client and server now filter sent and accepted ciphersuites on minimum
1332 and maximum protocol version
1333 * Ability to disable server_name extension (RFC 6066)
1334 * Renamed error_strerror() to the less conflicting polarssl_strerror()
1335 (Ability to keep old as well with POLARSSL_ERROR_STRERROR_BC)
1336 * SHA2 renamed to SHA256, SHA4 renamed to SHA512 and functions accordingly
1337 * All RSA operations require a random generator for blinding purposes
1338 * X509 core refactored
1339 * x509_crt_verify() now case insensitive for cn (RFC 6125 6.4)
1340 * Also compiles / runs without time-based functions (!POLARSSL_HAVE_TIME)
1341 * Support faulty X509 v1 certificates with extensions
1342 (POLARSSL_X509_ALLOW_EXTENSIONS_NON_V3)
1343
1344Bugfix
1345 * Fixed parse error in ssl_parse_certificate_request()
1346 * zlib compression/decompression skipped on empty blocks
1347 * Support for AIX header locations in net.c module
1348 * Fixed file descriptor leaks
1349
1350Security
1351 * RSA blinding on CRT operations to counter timing attacks
1352 (found by Cyril Arnaud and Pierre-Alain Fouque)
1353
1354
1355= Version 1.2.14 released 2015-05-??
1356
1357Security
1358 * Fix potential invalid memory read in the server, that allows a client to
1359 crash it remotely (found by Caj Larsson).
1360 * Fix potential invalid memory read in certificate parsing, that allows a
1361 client to crash the server remotely if client authentication is enabled
1362 (found using Codenomicon Defensics).
1363 * Add countermeasure against "Lucky 13 strikes back" cache-based attack,
1364 https://dl.acm.org/citation.cfm?id=2714625
1365
1366Bugfix
1367 * Fix bug in Via Padlock support (found by Nikos Mavrogiannopoulos).
1368 * Fix hardclock() (only used in the benchmarking program) with some
1369 versions of mingw64 (found by kxjhlele).
1370 * Fix warnings from mingw64 in timing.c (found by kxjklele).
1371 * Fix potential unintended sign extension in asn1_get_len() on 64-bit
1372 platforms (found with Coverity Scan).
1373
1374= Version 1.2.13 released 2015-02-16
1375Note: Although PolarSSL has been renamed to mbed TLS, no changes reflecting
1376 this will be made in the 1.2 branch at this point.
1377
1378Security
1379 * Fix remotely-triggerable uninitialised pointer dereference caused by
1380 crafted X.509 certificate (TLS server is not affected if it doesn't ask
1381 for a client certificate) (found using Codenomicon Defensics).
1382 * Fix remotely-triggerable memory leak caused by crafted X.509 certificates
1383 (TLS server is not affected if it doesn't ask for a client certificate)
1384 (found using Codenomicon Defensics).
1385 * Fix potential stack overflow while parsing crafted X.509 certificates
1386 (TLS server is not affected if it doesn't ask for a client certificate)
1387 found using Codenomicon Defensics).
1388 * Fix buffer overread of size 1 when parsing crafted X.509 certificates
1389 (TLS server is not affected if it doesn't ask for a client certificate).
1390
1391Bugfix
1392 * Fix potential undefined behaviour in Camellia.
1393 * Fix memory leaks in PKCS#5 and PKCS#12.
1394 * Stack buffer overflow if ctr_drbg_update() is called with too large
1395 add_len (found by Jean-Philippe Aumasson) (not triggerable remotely).
1396 * Fix bug in MPI/bignum on s390/s390x (reported by Dan Horák) (introduced
1397 in 1.2.12).
1398 * Fix unchecked return code in x509_crt_parse_path() on Windows (found by
1399 Peter Vaskovic).
1400 * Fix assembly selection for MIPS64 (thanks to James Cowgill).
1401 * ssl_get_verify_result() now works even if the handshake was aborted due
1402 to a failed verification (found by Fredrik Axelsson).
1403 * Skip writing and parsing signature_algorithm extension if none of the
1404 key exchanges enabled needs certificates. This fixes a possible interop
1405 issue with some servers when a zero-length extension was sent. (Reported
1406 by Peter Dettman.)
1407 * On a 0-length input, base64_encode() did not correctly set output length
1408 (found by Hendrik van den Boogaard).
1409
1410Changes
1411 * Blind RSA private operations even when POLARSSL_RSA_NO_CRT is defined.
1412 * Forbid repeated extensions in X.509 certificates.
1413 * Add compile-time option POLARSSL_X509_MAX_INTERMEDIATE_CA to limit the
1414 length of an X.509 verification chain (default = 8).
1415= Version 1.2.12 released 2014-10-24
1416
1417Security
1418 * Remotely-triggerable memory leak when parsing some X.509 certificates
1419 (server is not affected if it doesn't ask for a client certificate).
1420 (Found using Codenomicon Defensics.)
1421
1422Bugfix
1423 * Fix potential bad read in parsing ServerHello (found by Adrien
1424 Vialletelle).
1425 * ssl_close_notify() could send more than one message in some circumstances
1426 with non-blocking I/O.
1427 * x509_crt_parse() did not increase total_failed on PEM error
1428 * Fix compiler warnings on iOS (found by Sander Niemeijer).
1429 * Don't print uninitialised buffer in ssl_mail_client (found by Marc Abel).
1430 * Fix net_accept() regarding non-blocking sockets (found by Luca Pesce).
1431 * ssl_read() could return non-application data records on server while
1432 renegotation was pending, and on client when a HelloRequest was received.
1433 * Fix warnings from Clang's scan-build (contributed by Alfred Klomp).
1434
1435Changes
1436 * X.509 certificates with more than one AttributeTypeAndValue per
1437 RelativeDistinguishedName are not accepted any more.
1438 * ssl_read() now returns POLARSSL_ERR_NET_WANT_READ rather than
1439 POLARSSL_ERR_SSL_UNEXPECTED_MESSAGE on harmless alerts.
1440 * Accept spaces at end of line or end of buffer in base64_decode().
1441
1442= Version 1.2.11 released 2014-07-11
1443Features
1444 * Entropy module now supports seed writing and reading
1445
1446Changes
1447 * Introduced POLARSSL_HAVE_READDIR_R for systems without it
1448 * Improvements to the CMake build system, contributed by Julian Ospald.
1449 * Work around a bug of the version of Clang shipped by Apple with Mavericks
1450 that prevented bignum.c from compiling. (Reported by Rafael Baptista.)
1451 * Improvements to tests/Makefile, contributed by Oden Eriksson.
1452 * Use UTC time to check certificate validity.
1453 * Reject certificates with times not in UTC, per RFC 5280.
1454 * Migrate zeroizing of data to polarssl_zeroize() instead of memset()
1455 against unwanted compiler optimizations
1456
1457Security
1458 * Forbid change of server certificate during renegotiation to prevent
1459 "triple handshake" attack when authentication mode is optional (the
1460 attack was already impossible when authentication is required).
1461 * Check notBefore timestamp of certificates and CRLs from the future.
1462 * Forbid sequence number wrapping
1463 * Prevent potential NULL pointer dereference in ssl_read_record() (found by
1464 TrustInSoft)
1465 * Fix length checking for AEAD ciphersuites (found by Codenomicon).
1466 It was possible to crash the server (and client) using crafted messages
1467 when a GCM suite was chosen.
1468
1469Bugfix
1470 * Fixed X.509 hostname comparison (with non-regular characters)
1471 * SSL now gracefully handles missing RNG
1472 * crypt_and_hash app checks MAC before final decryption
1473 * Fixed x509_crt_parse_path() bug on Windows platforms
1474 * Added missing MPI_CHK() around some statements in mpi_div_mpi() (found by
1475 TrustInSoft)
1476 * Fixed potential overflow in certificate size verification in
1477 ssl_write_certificate() (found by TrustInSoft)
1478 * Fix ASM format in bn_mul.h
1479 * Potential memory leak in bignum_selftest()
1480 * Replaced expired test certificate
1481 * ssl_mail_client now terminates lines with CRLF, instead of LF
1482 * Fix bug in RSA PKCS#1 v1.5 "reversed" operations
1483 * Fixed testing with out-of-source builds using cmake
1484 * Fixed version-major intolerance in server
1485 * Fixed CMake symlinking on out-of-source builds
1486 * Bignum's MIPS-32 assembly was used on MIPS-64, causing chaos. (Found by
1487 Alex Wilson.)
1488 * ssl_init() was leaving a dirty pointer in ssl_context if malloc of
1489 out_ctr failed
1490 * ssl_handshake_init() was leaving dirty pointers in subcontexts if malloc
1491 of one of them failed
1492 * x509_get_current_time() uses localtime_r() to prevent thread issues
1493 * Some example server programs were not sending the close_notify alert.
1494 * Potential memory leak in mpi_exp_mod() when error occurs during
1495 calculation of RR.
1496 * Improve interoperability by not writing extension length in ClientHello
1497 when no extensions are present (found by Matthew Page)
1498 * rsa_check_pubkey() now allows an E up to N
1499 * On OpenBSD, use arc4random_buf() instead of rand() to prevent warnings
1500 * mpi_fill_random() was creating numbers larger than requested on
1501 big-endian platform when size was not an integer number of limbs
1502 * Fix detection of DragonflyBSD in net.c (found by Markus Pfeiffer)
1503 * Stricter check on SSL ClientHello internal sizes compared to actual packet
1504 size (found by TrustInSoft)
1505 * Fix preprocessor checks for bn_mul PPC asm (found by Barry K. Nathan).
1506 * Use \n\t rather than semicolons for bn_mul asm, since some assemblers
1507 interpret semicolons as comment delimiters (found by Barry K. Nathan).
1508 * Disable broken Sparc64 bn_mul assembly (found by Florian Obser).
1509 * Fix base64_decode() to return and check length correctly (in case of
1510 tight buffers)
1511
1512= Version 1.2.10 released 2013-10-07
1513Changes
1514 * Changed RSA blinding to a slower but thread-safe version
1515
1516Bugfix
1517 * Fixed memory leak in RSA as a result of introduction of blinding
1518 * Fixed ssl_pkcs11_decrypt() prototype
1519 * Fixed MSVC project files
1520
1521= Version 1.2.9 released 2013-10-01
1522Changes
1523 * x509_verify() now case insensitive for cn (RFC 6125 6.4)
1524
1525Bugfix
1526 * Fixed potential memory leak when failing to resume a session
1527 * Fixed potential file descriptor leaks (found by Remi Gacogne)
1528 * Minor fixes
1529
1530Security
1531 * Fixed potential heap buffer overflow on large hostname setting
1532 * Fixed potential negative value misinterpretation in load_file()
1533 * RSA blinding on CRT operations to counter timing attacks
1534 (found by Cyril Arnaud and Pierre-Alain Fouque)
1535
1536= Version 1.2.8 released 2013-06-19
1537Features
1538 * Parsing of PKCS#8 encrypted private key files
1539 * PKCS#12 PBE and derivation functions
1540 * Centralized module option values in config.h to allow user-defined
1541 settings without editing header files by using POLARSSL_CONFIG_OPTIONS
1542
1543Changes
1544 * HAVEGE random generator disabled by default
1545 * Internally split up x509parse_key() into a (PEM) handler function
1546 and specific DER parser functions for the PKCS#1 and unencrypted
1547 PKCS#8 private key formats
1548 * Added mechanism to provide alternative implementations for all
1549 symmetric cipher and hash algorithms (e.g. POLARSSL_AES_ALT in
1550 config.h)
1551 * PKCS#5 module added. Moved PBKDF2 functionality inside and deprecated
1552 old PBKDF2 module
1553
1554Bugfix
1555 * Secure renegotiation extension should only be sent in case client
1556 supports secure renegotiation
1557 * Fixed offset for cert_type list in ssl_parse_certificate_request()
1558 * Fixed const correctness issues that have no impact on the ABI
1559 * x509parse_crt() now better handles PEM error situations
1560 * ssl_parse_certificate() now calls x509parse_crt_der() directly
1561 instead of the x509parse_crt() wrapper that can also parse PEM
1562 certificates
1563 * x509parse_crtpath() is now reentrant and uses more portable stat()
1564 * Fixed bignum.c and bn_mul.h to support Thumb2 and LLVM compiler
1565 * Fixed values for 2-key Triple DES in cipher layer
1566 * ssl_write_certificate_request() can handle empty ca_chain
1567
1568Security
1569 * A possible DoS during the SSL Handshake, due to faulty parsing of
1570 PEM-encoded certificates has been fixed (found by Jack Lloyd)
1571
1572= Version 1.2.7 released 2013-04-13
1573Features
1574 * Ability to specify allowed ciphersuites based on the protocol version.
1575
1576Changes
1577 * Default Blowfish keysize is now 128-bits
1578 * Test suites made smaller to accommodate Raspberry Pi
1579
1580Bugfix
1581 * Fix for MPI assembly for ARM
1582 * GCM adapted to support sizes > 2^29
1583
1584= Version 1.2.6 released 2013-03-11
1585Bugfix
1586 * Fixed memory leak in ssl_free() and ssl_reset() for active session
1587 * Corrected GCM counter incrementation to use only 32-bits instead of
1588 128-bits (found by Yawning Angel)
1589 * Fixes for 64-bit compilation with MS Visual Studio
1590 * Fixed net_bind() for specified IP addresses on little endian systems
1591 * Fixed assembly code for ARM (Thumb and regular) for some compilers
1592
1593Changes
1594 * Internally split up rsa_pkcs1_encrypt(), rsa_pkcs1_decrypt(),
1595 rsa_pkcs1_sign() and rsa_pkcs1_verify() to separate PKCS#1 v1.5 and
1596 PKCS#1 v2.1 functions
1597 * Added support for custom labels when using rsa_rsaes_oaep_encrypt()
1598 or rsa_rsaes_oaep_decrypt()
1599 * Re-added handling for SSLv2 Client Hello when the define
1600 POLARSSL_SSL_SRV_SUPPORT_SSLV2_CLIENT_HELLO is set
1601 * The SSL session cache module (ssl_cache) now also retains peer_cert
1602 information (not the entire chain)
1603
1604Security
1605 * Removed further timing differences during SSL message decryption in
1606 ssl_decrypt_buf()
1607 * Removed timing differences due to bad padding from
1608 rsa_rsaes_pkcs1_v15_decrypt() and rsa_pkcs1_decrypt() for PKCS#1 v1.5
1609 operations
1610
1611= Version 1.2.5 released 2013-02-02
1612Changes
1613 * Allow enabling of dummy error_strerror() to support some use-cases
1614 * Debug messages about padding errors during SSL message decryption are
1615 disabled by default and can be enabled with POLARSSL_SSL_DEBUG_ALL
1616 * Sending of security-relevant alert messages that do not break
1617 interoperability can be switched on/off with the flag
1618 POLARSSL_SSL_ALL_ALERT_MESSAGES
1619
1620Security
1621 * Removed timing differences during SSL message decryption in
1622 ssl_decrypt_buf() due to badly formatted padding
1623
1624= Version 1.2.4 released 2013-01-25
1625Changes
1626 * More advanced SSL ciphersuite representation and moved to more dynamic
1627 SSL core
1628 * Added ssl_handshake_step() to allow single stepping the handshake process
1629
1630Bugfix
1631 * Memory leak when using RSA_PKCS_V21 operations fixed
1632 * Handle future version properly in ssl_write_certificate_request()
1633 * Correctly handle CertificateRequest message in client for <= TLS 1.1
1634 without DN list
1635
1636= Version 1.2.3 released 2012-11-26
1637Bugfix
1638 * Server not always sending correct CertificateRequest message
1639
1640= Version 1.2.2 released 2012-11-24
1641Changes
1642 * Added p_hw_data to ssl_context for context specific hardware acceleration
1643 data
1644 * During verify trust-CA is only checked for expiration and CRL presence
1645
1646Bugfixes
1647 * Fixed client authentication compatibility
1648 * Fixed dependency on POLARSSL_SHA4_C in SSL modules
1649
1650= Version 1.2.1 released 2012-11-20
1651Changes
1652 * Depth that the certificate verify callback receives is now numbered
1653 bottom-up (Peer cert depth is 0)
1654
1655Bugfixes
1656 * Fixes for MSVC6
1657 * Moved mpi_inv_mod() outside POLARSSL_GENPRIME
1658 * Allow R and A to point to same mpi in mpi_div_mpi (found by Manuel
1659 Pégourié-Gonnard)
1660 * Fixed possible segfault in mpi_shift_r() (found by Manuel
1661 Pégourié-Gonnard)
1662 * Added max length check for rsa_pkcs1_sign with PKCS#1 v2.1
1663
1664= Version 1.2.0 released 2012-10-31
1665Features
1666 * Added support for NULL cipher (POLARSSL_CIPHER_NULL_CIPHER) and weak
1667 ciphersuites (POLARSSL_ENABLE_WEAK_CIPHERSUITES). They are disabled by
1668 default!
1669 * Added support for wildcard certificates
1670 * Added support for multi-domain certificates through the X509 Subject
1671 Alternative Name extension
1672 * Added preliminary ASN.1 buffer writing support
1673 * Added preliminary X509 Certificate Request writing support
1674 * Added key_app_writer example application
1675 * Added cert_req example application
1676 * Added base Galois Counter Mode (GCM) for AES
1677 * Added TLS 1.2 support (RFC 5246)
1678 * Added GCM suites to TLS 1.2 (RFC 5288)
1679 * Added commandline error code convertor (util/strerror)
1680 * Added support for Hardware Acceleration hooking in SSL/TLS
1681 * Added OpenSSL / PolarSSL compatibility script (tests/compat.sh) and
1682 example application (programs/ssl/o_p_test) (requires OpenSSL)
1683 * Added X509 CA Path support
1684 * Added Thumb assembly optimizations
1685 * Added DEFLATE compression support as per RFC3749 (requires zlib)
1686 * Added blowfish algorithm (Generic and cipher layer)
1687 * Added PKCS#5 PBKDF2 key derivation function
1688 * Added Secure Renegotiation (RFC 5746)
1689 * Added predefined DHM groups from RFC 5114
1690 * Added simple SSL session cache implementation
1691 * Added ServerName extension parsing (SNI) at server side
1692 * Added option to add minimum accepted SSL/TLS protocol version
1693
1694Changes
1695 * Removed redundant POLARSSL_DEBUG_MSG define
1696 * AES code only check for Padlock once
1697 * Fixed const-correctness mpi_get_bit()
1698 * Documentation for mpi_lsb() and mpi_msb()
1699 * Moved out_msg to out_hdr + 32 to support hardware acceleration
1700 * Changed certificate verify behaviour to comply with RFC 6125 section 6.3
1701 to not match CN if subjectAltName extension is present (Closes ticket #56)
1702 * Cipher layer cipher_mode_t POLARSSL_MODE_CFB128 is renamed to
1703 POLARSSL_MODE_CFB, to also handle different block size CFB modes.
1704 * Removed handling for SSLv2 Client Hello (as per RFC 5246 recommendation)
1705 * Revamped session resumption handling
1706 * Generalized external private key implementation handling (like PKCS#11)
1707 in SSL/TLS
1708 * Revamped x509_verify() and the SSL f_vrfy callback implementations
1709 * Moved from unsigned long to fixed width uint32_t types throughout code
1710 * Renamed ciphersuites naming scheme to IANA reserved names
1711
1712Bugfix
1713 * Fixed handling error in mpi_cmp_mpi() on longer B values (found by
1714 Hui Dong)
1715 * Fixed potential heap corruption in x509_name allocation
1716 * Fixed single RSA test that failed on Big Endian systems (Closes ticket #54)
1717 * mpi_exp_mod() now correctly handles negative base numbers (Closes ticket
1718 #52)
1719 * Handle encryption with private key and decryption with public key as per
1720 RFC 2313
1721 * Handle empty certificate subject names
1722 * Prevent reading over buffer boundaries on X509 certificate parsing
1723 * mpi_add_abs() now correctly handles adding short numbers to long numbers
1724 with carry rollover (found by Ruslan Yushchenko)
1725 * Handle existence of OpenSSL Trust Extensions at end of X.509 DER blob
1726 * Fixed MPI assembly for SPARC64 platform
1727
1728Security
1729 * Fixed potential memory zeroization on miscrafted RSA key (found by Eloi
1730 Vanderbeken)
1731
1732= Version 1.1.8 released on 2013-10-01
1733Bugfix
1734 * Fixed potential memory leak when failing to resume a session
1735 * Fixed potential file descriptor leaks
1736
1737Security
1738 * Potential buffer-overflow for ssl_read_record() (independently found by
1739 both TrustInSoft and Paul Brodeur of Leviathan Security Group)
1740 * Potential negative value misinterpretation in load_file()
1741 * Potential heap buffer overflow on large hostname setting
1742
1743= Version 1.1.7 released on 2013-06-19
1744Changes
1745 * HAVEGE random generator disabled by default
1746
1747Bugfix
1748 * x509parse_crt() now better handles PEM error situations
1749 * ssl_parse_certificate() now calls x509parse_crt_der() directly
1750 instead of the x509parse_crt() wrapper that can also parse PEM
1751 certificates
1752 * Fixed values for 2-key Triple DES in cipher layer
1753 * ssl_write_certificate_request() can handle empty ca_chain
1754
1755Security
1756 * A possible DoS during the SSL Handshake, due to faulty parsing of
1757 PEM-encoded certificates has been fixed (found by Jack Lloyd)
1758
1759= Version 1.1.6 released on 2013-03-11
1760Bugfix
1761 * Fixed net_bind() for specified IP addresses on little endian systems
1762
1763Changes
1764 * Allow enabling of dummy error_strerror() to support some use-cases
1765 * Debug messages about padding errors during SSL message decryption are
1766 disabled by default and can be enabled with POLARSSL_SSL_DEBUG_ALL
1767
1768Security
1769 * Removed timing differences during SSL message decryption in
1770 ssl_decrypt_buf()
1771 * Removed timing differences due to bad padding from
1772 rsa_rsaes_pkcs1_v15_decrypt() and rsa_pkcs1_decrypt() for PKCS#1 v1.5
1773 operations
1774
1775= Version 1.1.5 released on 2013-01-16
1776Bugfix
1777 * Fixed MPI assembly for SPARC64 platform
1778 * Handle existence of OpenSSL Trust Extensions at end of X.509 DER blob
1779 * mpi_add_abs() now correctly handles adding short numbers to long numbers
1780 with carry rollover
1781 * Moved mpi_inv_mod() outside POLARSSL_GENPRIME
1782 * Prevent reading over buffer boundaries on X509 certificate parsing
1783 * mpi_exp_mod() now correctly handles negative base numbers (Closes ticket
1784 #52)
1785 * Fixed possible segfault in mpi_shift_r() (found by Manuel
1786 Pégourié-Gonnard)
1787 * Allow R and A to point to same mpi in mpi_div_mpi (found by Manuel
1788 Pégourié-Gonnard)
1789 * Added max length check for rsa_pkcs1_sign with PKCS#1 v2.1
1790 * Memory leak when using RSA_PKCS_V21 operations fixed
1791 * Handle encryption with private key and decryption with public key as per
1792 RFC 2313
1793 * Fixes for MSVC6
1794
1795Security
1796 * Fixed potential memory zeroization on miscrafted RSA key (found by Eloi
1797 Vanderbeken)
1798
1799= Version 1.1.4 released on 2012-05-31
1800Bugfix
1801 * Correctly handle empty SSL/TLS packets (Found by James Yonan)
1802 * Fixed potential heap corruption in x509_name allocation
1803 * Fixed single RSA test that failed on Big Endian systems (Closes ticket #54)
1804
1805= Version 1.1.3 released on 2012-04-29
1806Bugfix
1807 * Fixed random MPI generation to not generate more size than requested.
1808
1809= Version 1.1.2 released on 2012-04-26
1810Bugfix
1811 * Fixed handling error in mpi_cmp_mpi() on longer B values (found by
1812 Hui Dong)
1813
1814Security
1815 * Fixed potential memory corruption on miscrafted client messages (found by
1816 Frama-C team at CEA LIST)
1817 * Fixed generation of DHM parameters to correct length (found by Ruslan
1818 Yushchenko)
1819
1820= Version 1.1.1 released on 2012-01-23
1821Bugfix
1822 * Check for failed malloc() in ssl_set_hostname() and x509_get_entries()
1823 (Closes ticket #47, found by Hugo Leisink)
1824 * Fixed issues with Intel compiler on 64-bit systems (Closes ticket #50)
1825 * Fixed multiple compiler warnings for VS6 and armcc
1826 * Fixed bug in CTR_CRBG selftest
1827
1828= Version 1.1.0 released on 2011-12-22
1829Features
1830 * Added ssl_session_reset() to allow better multi-connection pools of
1831 SSL contexts without needing to set all non-connection-specific
1832 data and pointers again. Adapted ssl_server to use this functionality.
1833 * Added ssl_set_max_version() to allow clients to offer a lower maximum
1834 supported version to a server to help buggy server implementations.
1835 (Closes ticket #36)
1836 * Added cipher_get_cipher_mode() and cipher_get_cipher_operation()
1837 introspection functions (Closes ticket #40)
1838 * Added CTR_DRBG based on AES-256-CTR (NIST SP 800-90) random generator
1839 * Added a generic entropy accumulator that provides support for adding
1840 custom entropy sources and added some generic and platform dependent
1841 entropy sources
1842
1843Changes
1844 * Documentation for AES and Camellia in modes CTR and CFB128 clarified.
1845 * Fixed rsa_encrypt and rsa_decrypt examples to use public key for
1846 encryption and private key for decryption. (Closes ticket #34)
1847 * Inceased maximum size of ASN1 length reads to 32-bits.
1848 * Added an EXPLICIT tag number parameter to x509_get_ext()
1849 * Added a separate CRL entry extension parsing function
1850 * Separated the ASN.1 parsing code from the X.509 specific parsing code.
1851 So now there is a module that is controlled with POLARSSL_ASN1_PARSE_C.
1852 * Changed the defined key-length of DES ciphers in cipher.h to include the
1853 parity bits, to prevent mistakes in copying data. (Closes ticket #33)
1854 * Loads of minimal changes to better support WINCE as a build target
1855 (Credits go to Marco Lizza)
1856 * Added POLARSSL_MPI_WINDOW_SIZE definition to allow easier time to memory
1857 trade-off
1858 * Introduced POLARSSL_MPI_MAX_SIZE and POLARSSL_MPI_MAX_BITS for MPI size
1859 management (Closes ticket #44)
1860 * Changed the used random function pointer to more flexible format. Renamed
1861 havege_rand() to havege_random() to prevent mistakes. Lots of changes as
1862 a consequence in library code and programs
1863 * Moved all examples programs to use the new entropy and CTR_DRBG
1864 * Added permissive certificate parsing to x509parse_crt() and
1865 x509parse_crtfile(). With permissive parsing the parsing does not stop on
1866 encountering a parse-error. Beware that the meaning of return values has
1867 changed!
1868 * All error codes are now negative. Even on mermory failures and IO errors.
1869
1870Bugfix
1871 * Fixed faulty HMAC-MD2 implementation. Found by dibac. (Closes
1872 ticket #37)
1873 * Fixed a bug where the CRL parser expected an EXPLICIT ASN.1 tag
1874 before version numbers
1875 * Allowed X509 key usage parsing to accept 4 byte values instead of the
1876 standard 1 byte version sometimes used by Microsoft. (Closes ticket #38)
1877 * Fixed incorrect behaviour in case of RSASSA-PSS with a salt length
1878 smaller than the hash length. (Closes ticket #41)
1879 * If certificate serial is longer than 32 octets, serial number is now
1880 appended with '....' after first 28 octets
1881 * Improved build support for s390x and sparc64 in bignum.h
1882 * Fixed MS Visual C++ name clash with int64 in sha4.h
1883 * Corrected removal of leading "00:" in printing serial numbers in
1884 certificates and CRLs
1885
1886= Version 1.0.0 released on 2011-07-27
1887Features
1888 * Expanded cipher layer with support for CFB128 and CTR mode
1889 * Added rsa_encrypt and rsa_decrypt simple example programs.
1890
1891Changes
1892 * The generic cipher and message digest layer now have normal error
1893 codes instead of integers
1894
1895Bugfix
1896 * Undid faulty bug fix in ssl_write() when flushing old data (Ticket
1897 #18)
1898
1899= Version 0.99-pre5 released on 2011-05-26
1900Features
1901 * Added additional Cipher Block Modes to symmetric ciphers
1902 (AES CTR, Camellia CTR, XTEA CBC) including the option to
1903 enable and disable individual modes when needed
1904 * Functions requiring File System functions can now be disabled
1905 by undefining POLARSSL_FS_IO
1906 * A error_strerror function() has been added to translate between
1907 error codes and their description.
1908 * Added mpi_get_bit() and mpi_set_bit() individual bit setter/getter
1909 functions.
1910 * Added ssl_mail_client and ssl_fork_server as example programs.
1911
1912Changes
1913 * Major argument / variable rewrite. Introduced use of size_t
1914 instead of int for buffer lengths and loop variables for
1915 better unsigned / signed use. Renamed internal bigint types
1916 t_int and t_dbl to t_uint and t_udbl in the process
1917 * mpi_init() and mpi_free() now only accept a single MPI
1918 argument and do not accept variable argument lists anymore.
1919 * The error codes have been remapped and combining error codes
1920 is now done with a PLUS instead of an OR as error codes
1921 used are negative.
1922 * Changed behaviour of net_read(), ssl_fetch_input() and ssl_recv().
1923 net_recv() now returns 0 on EOF instead of
1924 POLARSSL_ERR_NET_CONN_RESET. ssl_fetch_input() returns
1925 POLARSSL_ERR_SSL_CONN_EOF on an EOF from its f_recv() function.
1926 ssl_read() returns 0 if a POLARSSL_ERR_SSL_CONN_EOF is received
1927 after the handshake.
1928 * Network functions now return POLARSSL_ERR_NET_WANT_READ or
1929 POLARSSL_ERR_NET_WANT_WRITE instead of the ambiguous
1930 POLARSSL_ERR_NET_TRY_AGAIN
1931
1932= Version 0.99-pre4 released on 2011-04-01
1933Features
1934 * Added support for PKCS#1 v2.1 encoding and thus support
1935 for the RSAES-OAEP and RSASSA-PSS operations.
1936 * Reading of Public Key files incorporated into default x509
1937 functionality as well.
1938 * Added mpi_fill_random() for centralized filling of big numbers
1939 with random data (Fixed ticket #10)
1940
1941Changes
1942 * Debug print of MPI now removes leading zero octets and
1943 displays actual bit size of the value.
1944 * x509parse_key() (and as a consequence x509parse_keyfile())
1945 does not zeroize memory in advance anymore. Use rsa_init()
1946 before parsing a key or keyfile!
1947
1948Bugfix
1949 * Debug output of MPI's now the same independent of underlying
1950 platform (32-bit / 64-bit) (Fixes ticket #19, found by Mads
1951 Kiilerich and Mihai Militaru)
1952 * Fixed bug in ssl_write() when flushing old data (Fixed ticket
1953 #18, found by Nikolay Epifanov)
1954 * Fixed proper handling of RSASSA-PSS verification with variable
1955 length salt lengths
1956
1957= Version 0.99-pre3 released on 2011-02-28
1958This release replaces version 0.99-pre2 which had possible copyright issues.
1959Features
1960 * Parsing PEM private keys encrypted with DES and AES
1961 are now supported as well (Fixes ticket #5)
1962 * Added crl_app program to allow easy reading and
1963 printing of X509 CRLs from file
1964
1965Changes
1966 * Parsing of PEM files moved to separate module (Fixes
1967 ticket #13). Also possible to remove PEM support for
1968 systems only using DER encoding
1969
1970Bugfixes
1971 * Corrected parsing of UTCTime dates before 1990 and
1972 after 1950
1973 * Support more exotic OID's when parsing certificates
1974 (found by Mads Kiilerich)
1975 * Support more exotic name representations when parsing
1976 certificates (found by Mads Kiilerich)
1977 * Replaced the expired test certificates
1978 * Do not bail out if no client certificate specified. Try
1979 to negotiate anonymous connection (Fixes ticket #12,
1980 found by Boris Krasnovskiy)
1981
1982Security fixes
1983 * Fixed a possible Man-in-the-Middle attack on the
1984 Diffie Hellman key exchange (thanks to Larry Highsmith,
1985 Subreption LLC)
1986
1987= Version 0.99-pre1 released on 2011-01-30
1988Features
1989Note: Most of these features have been donated by Fox-IT
1990 * Added Doxygen source code documentation parts
1991 * Added reading of DHM context from memory and file
1992 * Improved X509 certificate parsing to include extended
1993 certificate fields, including Key Usage
1994 * Improved certificate verification and verification
1995 against the available CRLs
1996 * Detection for DES weak keys and parity bits added
1997 * Improvements to support integration in other
1998 applications:
1999 + Added generic message digest and cipher wrapper
2000 + Improved information about current capabilities,
2001 status, objects and configuration
2002 + Added verification callback on certificate chain
2003 verification to allow external blacklisting
2004 + Additional example programs to show usage
2005 * Added support for PKCS#11 through the use of the
2006 libpkcs11-helper library
2007
2008Changes
2009 * x509parse_time_expired() checks time in addition to
2010 the existing date check
2011 * The ciphers member of ssl_context and the cipher member
2012 of ssl_session have been renamed to ciphersuites and
2013 ciphersuite respectively. This clarifies the difference
2014 with the generic cipher layer and is better naming
2015 altogether
2016
2017= Version 0.14.0 released on 2010-08-16
2018Features
2019 * Added support for SSL_EDH_RSA_AES_128_SHA and
2020 SSL_EDH_RSA_CAMELLIA_128_SHA ciphersuites
2021 * Added compile-time and run-time version information
2022 * Expanded ssl_client2 arguments for more flexibility
2023 * Added support for TLS v1.1
2024
2025Changes
2026 * Made Makefile cleaner
2027 * Removed dependency on rand() in rsa_pkcs1_encrypt().
2028 Now using random fuction provided to function and
2029 changed the prototype of rsa_pkcs1_encrypt(),
2030 rsa_init() and rsa_gen_key().
2031 * Some SSL defines were renamed in order to avoid
2032 future confusion
2033
2034Bug fixes
2035 * Fixed CMake out of source build for tests (found by
2036 kkert)
2037 * rsa_check_private() now supports PKCS1v2 keys as well
2038 * Fixed deadlock in rsa_pkcs1_encrypt() on failing random
2039 generator
2040
2041= Version 0.13.1 released on 2010-03-24
2042Bug fixes
2043 * Fixed Makefile in library that was mistakenly merged
2044 * Added missing const string fixes
2045
2046= Version 0.13.0 released on 2010-03-21
2047Features
2048 * Added option parsing for host and port selection to
2049 ssl_client2
2050 * Added support for GeneralizedTime in X509 parsing
2051 * Added cert_app program to allow easy reading and
2052 printing of X509 certificates from file or SSL
2053 connection.
2054
2055Changes
2056 * Added const correctness for main code base
2057 * X509 signature algorithm determination is now
2058 in a function to allow easy future expansion
2059 * Changed symmetric cipher functions to
2060 identical interface (returning int result values)
2061 * Changed ARC4 to use separate input/output buffer
2062 * Added reset function for HMAC context as speed-up
2063 for specific use-cases
2064
2065Bug fixes
2066 * Fixed bug resulting in failure to send the last
2067 certificate in the chain in ssl_write_certificate() and
2068 ssl_write_certificate_request() (found by fatbob)
2069 * Added small fixes for compiler warnings on a Mac
2070 (found by Frank de Brabander)
2071 * Fixed algorithmic bug in mpi_is_prime() (found by
2072 Smbat Tonoyan)
2073
2074= Version 0.12.1 released on 2009-10-04
2075Changes
2076 * Coverage test definitions now support 'depends_on'
2077 tagging system.
2078 * Tests requiring specific hashing algorithms now honor
2079 the defines.
2080
2081Bug fixes
2082 * Changed typo in #ifdef in x509parse.c (found
2083 by Eduardo)
2084
2085= Version 0.12.0 released on 2009-07-28
2086Features
2087 * Added CMake makefiles as alternative to regular Makefiles.
2088 * Added preliminary Code Coverage tests for AES, ARC4,
2089 Base64, MPI, SHA-family, MD-family, HMAC-SHA-family,
2090 Camellia, DES, 3-DES, RSA PKCS#1, XTEA, Diffie-Hellman
2091 and X509parse.
2092
2093Changes
2094 * Error codes are not (necessarily) negative. Keep
2095 this is mind when checking for errors.
2096 * RSA_RAW renamed to SIG_RSA_RAW for consistency.
2097 * Fixed typo in name of POLARSSL_ERR_RSA_OUTPUT_TOO_LARGE.
2098 * Changed interface for AES and Camellia setkey functions
2099 to indicate invalid key lengths.
2100
2101Bug fixes
2102 * Fixed include location of endian.h on FreeBSD (found by
2103 Gabriel)
2104 * Fixed include location of endian.h and name clash on
2105 Apples (found by Martin van Hensbergen)
2106 * Fixed HMAC-MD2 by modifying md2_starts(), so that the
2107 required HMAC ipad and opad variables are not cleared.
2108 (found by code coverage tests)
2109 * Prevented use of long long in bignum if
2110 POLARSSL_HAVE_LONGLONG not defined (found by Giles
2111 Bathgate).
2112 * Fixed incorrect handling of negative strings in
2113 mpi_read_string() (found by code coverage tests).
2114 * Fixed segfault on handling empty rsa_context in
2115 rsa_check_pubkey() and rsa_check_privkey() (found by
2116 code coverage tests).
2117 * Fixed incorrect handling of one single negative input
2118 value in mpi_add_abs() (found by code coverage tests).
2119 * Fixed incorrect handling of negative first input
2120 value in mpi_sub_abs() (found by code coverage tests).
2121 * Fixed incorrect handling of negative first input
2122 value in mpi_mod_mpi() and mpi_mod_int(). Resulting
2123 change also affects mpi_write_string() (found by code
2124 coverage tests).
2125 * Corrected is_prime() results for 0, 1 and 2 (found by
2126 code coverage tests).
2127 * Fixed Camellia and XTEA for 64-bit Windows systems.
2128
2129= Version 0.11.1 released on 2009-05-17
2130 * Fixed missing functionality for SHA-224, SHA-256, SHA384,
2131 SHA-512 in rsa_pkcs1_sign()
2132
2133= Version 0.11.0 released on 2009-05-03
2134 * Fixed a bug in mpi_gcd() so that it also works when both
2135 input numbers are even and added testcases to check
2136 (found by Pierre Habouzit).
2137 * Added support for SHA-224, SHA-256, SHA-384 and SHA-512
2138 one way hash functions with the PKCS#1 v1.5 signing and
2139 verification.
2140 * Fixed minor bug regarding mpi_gcd located within the
2141 POLARSSL_GENPRIME block.
2142 * Fixed minor memory leak in x509parse_crt() and added better
2143 handling of 'full' certificate chains (found by Mathias
2144 Olsson).
2145 * Centralized file opening and reading for x509 files into
2146 load_file()
2147 * Made definition of net_htons() endian-clean for big endian
2148 systems (Found by Gernot).
2149 * Undefining POLARSSL_HAVE_ASM now also handles prevents asm in
2150 padlock and timing code.
2151 * Fixed an off-by-one buffer allocation in ssl_set_hostname()
2152 responsible for crashes and unwanted behaviour.
2153 * Added support for Certificate Revocation List (CRL) parsing.
2154 * Added support for CRL revocation to x509parse_verify() and
2155 SSL/TLS code.
2156 * Fixed compatibility of XTEA and Camellia on a 64-bit system
2157 (found by Felix von Leitner).
2158
2159= Version 0.10.0 released on 2009-01-12
2160 * Migrated XySSL to PolarSSL
2161 * Added XTEA symmetric cipher
2162 * Added Camellia symmetric cipher
2163 * Added support for ciphersuites: SSL_RSA_CAMELLIA_128_SHA,
2164 SSL_RSA_CAMELLIA_256_SHA and SSL_EDH_RSA_CAMELLIA_256_SHA
2165 * Fixed dangerous bug that can cause a heap overflow in
2166 rsa_pkcs1_decrypt (found by Christophe Devine)
2167
2168================================================================
2169XySSL ChangeLog
2170
2171= Version 0.9 released on 2008-03-16
2172
2173 * Added support for ciphersuite: SSL_RSA_AES_128_SHA
2174 * Enabled support for large files by default in aescrypt2.c
2175 * Preliminary openssl wrapper contributed by David Barrett
2176 * Fixed a bug in ssl_write() that caused the same payload to
2177 be sent twice in non-blocking mode when send returns EAGAIN
2178 * Fixed ssl_parse_client_hello(): session id and challenge must
2179 not be swapped in the SSLv2 ClientHello (found by Greg Robson)
2180 * Added user-defined callback debug function (Krystian Kolodziej)
2181 * Before freeing a certificate, properly zero out all cert. data
2182 * Fixed the "mode" parameter so that encryption/decryption are
2183 not swapped on PadLock; also fixed compilation on older versions
2184 of gcc (bug reported by David Barrett)
2185 * Correctly handle the case in padlock_xcryptcbc() when input or
2186 ouput data is non-aligned by falling back to the software
2187 implementation, as VIA Nehemiah cannot handle non-aligned buffers
2188 * Fixed a memory leak in x509parse_crt() which was reported by Greg
2189 Robson-Garth; some x509write.c fixes by Pascal Vizeli, thanks to
2190 Matthew Page who reported several bugs
2191 * Fixed x509_get_ext() to accept some rare certificates which have
2192 an INTEGER instead of a BOOLEAN for BasicConstraints::cA.
2193 * Added support on the client side for the TLS "hostname" extension
2194 (patch contributed by David Patino)
2195 * Make x509parse_verify() return BADCERT_CN_MISMATCH when an empty
2196 string is passed as the CN (bug reported by spoofy)
2197 * Added an option to enable/disable the BN assembly code
2198 * Updated rsa_check_privkey() to verify that (D*E) = 1 % (P-1)*(Q-1)
2199 * Disabled obsolete hash functions by default (MD2, MD4); updated
2200 selftest and benchmark to not test ciphers that have been disabled
2201 * Updated x509parse_cert_info() to correctly display byte 0 of the
2202 serial number, setup correct server port in the ssl client example
2203 * Fixed a critical denial-of-service with X.509 cert. verification:
2204 peer may cause xyssl to loop indefinitely by sending a certificate
2205 for which the RSA signature check fails (bug reported by Benoit)
2206 * Added test vectors for: AES-CBC, AES-CFB, DES-CBC and 3DES-CBC,
2207 HMAC-MD5, HMAC-SHA1, HMAC-SHA-256, HMAC-SHA-384, and HMAC-SHA-512
2208 * Fixed HMAC-SHA-384 and HMAC-SHA-512 (thanks to Josh Sinykin)
2209 * Modified ssl_parse_client_key_exchange() to protect against
2210 Daniel Bleichenbacher attack on PKCS#1 v1.5 padding, as well
2211 as the Klima-Pokorny-Rosa extension of Bleichenbacher's attack
2212 * Updated rsa_gen_key() so that ctx->N is always nbits in size
2213 * Fixed assembly PPC compilation errors on Mac OS X, thanks to
2214 David Barrett and Dusan Semen
2215
2216= Version 0.8 released on 2007-10-20
2217
2218 * Modified the HMAC functions to handle keys larger
2219 than 64 bytes, thanks to Stephane Desneux and gary ng
2220 * Fixed ssl_read_record() to properly update the handshake
2221 message digests, which fixes IE6/IE7 client authentication
2222 * Cleaned up the XYSSL* #defines, suggested by Azriel Fasten
2223 * Fixed net_recv(), thanks to Lorenz Schori and Egon Kocjan
2224 * Added user-defined callbacks for handling I/O and sessions
2225 * Added lots of debugging output in the SSL/TLS functions
2226 * Added preliminary X.509 cert. writing by Pascal Vizeli
2227 * Added preliminary support for the VIA PadLock routines
2228 * Added AES-CFB mode of operation, contributed by chmike
2229 * Added an SSL/TLS stress testing program (ssl_test.c)
2230 * Updated the RSA PKCS#1 code to allow choosing between
2231 RSA_PUBLIC and RSA_PRIVATE, as suggested by David Barrett
2232 * Updated ssl_read() to skip 0-length records from OpenSSL
2233 * Fixed the make install target to comply with *BSD make
2234 * Fixed a bug in mpi_read_binary() on 64-bit platforms
2235 * mpi_is_prime() speedups, thanks to Kevin McLaughlin
2236 * Fixed a long standing memory leak in mpi_is_prime()
2237 * Replaced realloc with malloc in mpi_grow(), and set
2238 the sign of zero as positive in mpi_init() (reported
2239 by Jonathan M. McCune)
2240
2241= Version 0.7 released on 2007-07-07
2242
2243 * Added support for the MicroBlaze soft-core processor
2244 * Fixed a bug in ssl_tls.c which sometimes prevented SSL
2245 connections from being established with non-blocking I/O
2246 * Fixed a couple bugs in the VS6 and UNIX Makefiles
2247 * Fixed the "PIC register ebx clobbered in asm" bug
2248 * Added HMAC starts/update/finish support functions
2249 * Added the SHA-224, SHA-384 and SHA-512 hash functions
2250 * Fixed the net_set_*block routines, thanks to Andreas
2251 * Added a few demonstration programs: md5sum, sha1sum,
2252 dh_client, dh_server, rsa_genkey, rsa_sign, rsa_verify
2253 * Added new bignum import and export helper functions
2254 * Rewrote README.txt in program/ssl/ca to better explain
2255 how to create a test PKI
2256
2257= Version 0.6 released on 2007-04-01
2258
2259 * Ciphers used in SSL/TLS can now be disabled at compile
2260 time, to reduce the memory footprint on embedded systems
2261 * Added multiply assembly code for the TriCore and modified
2262 havege_struct for this processor, thanks to David Patiño
2263 * Added multiply assembly code for 64-bit PowerPCs,
2264 thanks to Peking University and the OSU Open Source Lab
2265 * Added experimental support of Quantum Cryptography
2266 * Added support for autoconf, contributed by Arnaud Cornet
2267 * Fixed "long long" compilation issues on IA-64 and PPC64
2268 * Fixed a bug introduced in xyssl-0.5/timing.c: hardclock
2269 was not being correctly defined on ARM and MIPS
2270
2271= Version 0.5 released on 2007-03-01
2272
2273 * Added multiply assembly code for SPARC and Alpha
2274 * Added (beta) support for non-blocking I/O operations
2275 * Implemented session resuming and client authentication
2276 * Fixed some portability issues on WinCE, MINIX 3, Plan9
2277 (thanks to Benjamin Newman), HP-UX, FreeBSD and Solaris
2278 * Improved the performance of the EDH key exchange
2279 * Fixed a bug that caused valid packets with a payload
2280 size of 16384 bytes to be rejected
2281
2282= Version 0.4 released on 2007-02-01
2283
2284 * Added support for Ephemeral Diffie-Hellman key exchange
2285 * Added multiply asm code for SSE2, ARM, PPC, MIPS and M68K
2286 * Various improvement to the modular exponentiation code
2287 * Rewrote the headers to generate the API docs with doxygen
2288 * Fixed a bug in ssl_encrypt_buf (incorrect padding was
2289 generated) and in ssl_parse_client_hello (max. client
2290 version was not properly set), thanks to Didier Rebeix
2291 * Fixed another bug in ssl_parse_client_hello: clients with
2292 cipherlists larger than 96 bytes were incorrectly rejected
2293 * Fixed a couple memory leak in x509_read.c
2294
2295= Version 0.3 released on 2007-01-01
2296
2297 * Added server-side SSLv3 and TLSv1.0 support
2298 * Multiple fixes to enhance the compatibility with g++,
2299 thanks to Xosé Antón Otero Ferreira
2300 * Fixed a bug in the CBC code, thanks to dowst; also,
2301 the bignum code is no longer dependent on long long
2302 * Updated rsa_pkcs1_sign to handle arbitrary large inputs
2303 * Updated timing.c for improved compatibility with i386
2304 and 486 processors, thanks to Arnaud Cornet
2305
2306= Version 0.2 released on 2006-12-01
2307
2308 * Updated timing.c to support ARM and MIPS arch
2309 * Updated the MPI code to support 8086 on MSVC 1.5
2310 * Added the copyright notice at the top of havege.h
2311 * Fixed a bug in sha2_hmac, thanks to newsoft/Wenfang Zhang
2312 * Fixed a bug reported by Adrian Rüegsegger in x509_read_key
2313 * Fixed a bug reported by Torsten Lauter in ssl_read_record
2314 * Fixed a bug in rsa_check_privkey that would wrongly cause
2315 valid RSA keys to be dismissed (thanks to oldwolf)
2316 * Fixed a bug in mpi_is_prime that caused some primes to fail
2317 the Miller-Rabin primality test
2318
2319 I'd also like to thank Younès Hafri for the CRUX linux port,
2320 Khalil Petit who added XySSL into pkgsrc and Arnaud Cornet
2321 who maintains the Debian package :-)
2322
2323= Version 0.1 released on 2006-11-01