source: mod_gnutls/CHANGELOG @ 19fbd4d

Last change on this file since 19fbd4d was add6b31, checked in by Fiona Klute <fiona.klute@…>, 16 months ago

Documentation for building coverage reports

  • Property mode set to 100644
File size: 15.6 KB
1** Version 0.11.0 (UNRELEASED)
3- Change default for GnuTLSOCSPCheckNonce to "off", and send OCSP
4  nonces only if it has been enabled. The reason for this change is
5  that in practice most public CAs do not support OCSP nonces, which
6  is permitted by both RFC 6960 and the CA/Browser Forum baseline
7  requirements (as of version 1.6.9). In this situation enforcing
8  correct nonces by default makes the automatic OCSP stapling support
9  mostly useless.
11- Add a test for correct nonce handling with "GnuTLSOCSPCheckNonce
12  on", thanks to Krista Karppinen for that and a rewrite of the OCSP
13  responder script in Python!
15- Support session resumption using session tickets for proxy
16  connections (TLS 1.3 connections only). Requires a suitable
17  GnuTLSCache configuration.
19- Disable session tickets by default. The GnuTLS built-in key rotation
20  for session tickets never actually changes the primary key, just
21  derives keys from it, so it does not provide forward secrecy in case
22  an attacker learns the primary key (by gaining access to server
23  RAM). A reload of the server is enough to generate a new key, so
24  consider enabling session tickets and reloading the server every few
25  hours, at least until a forward-secret rotation can be implemented.
27- Add ./configure option to disable building PDF documentation
29- Deprecate SRP and disable it by default.
31- Add support for building coverage reports using clang's source-based
32  code coverage.
34- Make ./configure check if both [::1] and are available,
35  disable either if not. This makes the build work out-of-the-box in
36  Docker containers, which by default use IPv4 only.
38** Version 0.10.0 (2020-02-03)
40- Added support for stapling multiple OCSP responses (TLS 1.3
41  only). mod_gnutls will staple for as many consecutive certificates
42  in the certificate chain as possible.
44- Added support for TLS 1.3 post-handshake authentication, used if TLS
45  client authentication is required only for some resources on the
46  server. Rehandshake (for older TLS versions) is not supported, the
47  existing but broken code has been removed.
49- The test infrastructure has been mostly rewritten in Python, note
50  the new dependencies (Python 3, Pyyaml). Tests can run multiple TLS
51  connections and HTTP(S) requests as well as custom hooks now, see
52  test/ for details.
54- Server certificates are checked for the must-staple TLS feature
55  extension, stapling must be enabled if it is present.
57- Compatibility fix for GnuTLS 3.6.11 in the test suite: Handle
58  peer certificate type in TLS session information strings.
60- The test system will automatically detect if it needs to load
61  critical modules (e.g. mod_logio) that are built-in with the Debian
62  packages. This makes the tests work on Fedora without modifications,
63  and likely on similar distributions too.
65- Tests can optionally run with Valgrind for the primary HTTPD
66  instance by running ./configure with --enable-valgrind-test, see
67  test/ for details.
69- Known issue: When using MSVA client certificate validation the
70  Valgrind tests indicate memory leaks from libcurl, which is used by
71  libmsv to send requests to the MSVA. For details see the bug report:
74** Version 0.9.1 (2019-11-29)
75- Fix possible segfault (NULL pointer dereference) on failed TLS
76  handshake. Calling ssl_var_lookup() after a failed handshake could
77  lead to GnuTLS session information functions being called on a NULL
78  session pointer, leading to segfault.
79- Remove URLs from expected error responses in the test suite. Apache
80  HTTPD removed request URLs from canned error messages to prevent
81  misleading text/links being displayed via crafted links
82  (CVE-2019-10092). Adjust the expected error responses in our tests
83  so they can pass again.
84- Test suite: Ignore "Content-Length" header of responses. Thanks to
85  Krista Karppinen!
86- Add a section about module dependencies on socache to the handbook
87- Restructure the manpage build and move it to section 5 (config
88  files)
89- Test suite: Restructure certificate directories
91** Version 0.9.0 (2019-01-23)
92- Security fix: Refuse to send or receive any data over a failed TLS
93  connection (commit 72b669eae8c45dda1850e8e5b30a97c918357b51). The
94  previous behavior could lead to requests on reverse proxy TLS
95  connections being sent in plain text, and might have allowed faking
96  requests in plain text.
97- Security fix: Reject HTTP requests if they try to access virtual
98  hosts that do not match their TLS connections (commit
99  de3fad3c12f53cdbf082ad675e4b10f521a02811). Additionally check if SNI
100  and Host header match. Thanks to Krista Karppinen for contributing
101  tests!
102- OCSP stapling is now enabled by default, if possible. OCSP responses
103  are updated regularly and stored in a cache separate from the
104  session cache. The OCSP cache uses mod_socache_shmcb by default
105  (if the module is loaded, no other configuration required).
106- Session tickets are now enabled by default if using GnuTLS 3.6.4 or
107  newer. GnuTLS 3.6.4 introduced automatic rotation for the used key,
108  and TLS 1.3 takes care of other reasons not to use tickets while
109  requiring them for session resumption. Note that there is currently
110  no mechanism to synchronize ticket keys across a cluster of servers.
111- The internal cache implementation has been replaced with
112  mod_socache. Users may need to update their GnuTLSCache settings and
113  load the appropriate socache modules.
114- ALPN (required for HTTP/2) now works correctly with different
115  "Protocols" directives between virtual hosts if building with GnuTLS
116  3.6.3 or newer. Older versions require identical "Protocols"
117  directives for overlapping virtual hosts. Thanks to Vincent Tamet
118  for the bug report!
119- ALPN is now supported for proxy connections, making HTTP/2 proxy
120  connections using mod_proxy_http2 possible.
121- GnuTLSPriorities is optional now and defaults to "NORMAL" if
122  missing. The same applies to GnuTLSProxyPriorities (if TLS proxy is
123  enabled).
124- The manual is now built as a manual page, too, if pandoc is
125  available.
126- OpenPGP support has been removed.
127- Don't require pem2openpgp for tests when building without MSVA
128  support.
130** Version 0.8.4 (2018-04-13)
131- Support Apache HTTPD 2.4.33 API for proxy TLS connections
132- Support TLS for HTTP/2 connections with mod_http2
133- Fix configuration of OCSP stapling callback
135** Version 0.8.3 (2017-10-20)
136- Use GnuTLS' default DH parameters by default
137- Handle long Server Name Indication data and gracefully ignore
138  unknown SNI types
139- Send SNI for proxy connections
140- Deprecate OpenPGP support like GnuTLS did (will be removed
141  completely in a future release)
142- Do not announce session ticket support for proxy connections
143- Minor documentation updates (SSL_CLIENT_I_DN, reference for SNI)
144- Test suite: Simplify handling of proxy backend servers and OCSP
145  responders
146- Test suite: stability/compatibility fixes
148** Version 0.8.2 (2017-01-08)
149- Test suite: Ensure CRLF line ends in HTTP headers
150- Test suite, gen_ocsp_index.c: Handle serial as fixed order byte array
152** Version 0.8.1 (2016-12-20)
153- Bugfix: Use APR_SIZE_T_FMT for portable apr_size_t formatting
155** Version 0.8.0 (2016-12-11)
156- New: Support for OCSP stapling
157- Bugfix: Access to DBM cache is locked using global mutex
158  "gnutls-cache"
159- Bugfix: GnuTLSSessionTickets is now disabled by default as described
160  in the handbook
161- Fixed memory leak while checking proxy backend certificate
162- Fixed memory leaks in post_config
163- Safely delete session ticket key (requires GnuTLS >= 3.4)
164- Improved error handling in post_config hook
165- Various handbook updates
166- Internal API documentation can be generated using Doxygen
167- Unused code has been removed (conditionals for GnuTLS 2.x and Apache
168  versions before 2.2, internal Lua bytecode structure last used in
169  2011).
170- Test suite: Fixed locking for access to the PGP keyring of the test
171  certificate authority
172- mod_gnutls can be built using Clang (unsupported)
174** Version 0.7.5 (2016-05-28)
175- Sunil Mohan Adapa reported retry loops during session shutdown in
176  cleanup_gnutls_session() due to gnutls_bye() incorrectly returning
177  GNUTLS_E_INTERRUPTED or GNUTLS_E_AGAIN. Setting the GnuTLS session
178  errno in mgs_transport_write() fixes the problem.
179- Import Daniel Kahn Gillmor's patches for GnuPG v2 support from the
180  Debian package.
181- Build system improvements that allow VPATH builds and get "make
182  distcheck" to work
184** Version 0.7.4 (2016-04-13)
185- Support SoftHSM 2 for PKCS #11 testing
186- Increase verbosity of test logs
188** Version 0.7.3 (2016-01-12)
189- Update test suite for compatibility with GnuTLS 3.4, which has
190  stricter key usage checks and priorities than 3.3.
191- Write non-HTML output to mod_status reports if AP_STATUS_SHORT is
192  set (mod_status sets it for requests with the "auto" parameter, e.g.
193  https://localhost/server-status?auto).
194- Register "ssl_is_https" function so the special mod_rewrite variable
195  %{HTTPS} works correctly with mod_gnutls. The new test case for this
196  requires Wget or curl. Fixes Debian bug #514005.
197- Test suite servers listen on IPv4 *and* IPv6 loopback addresses by
198  default (other addresses configurable), which should fix failures
199  due to localhost randomly resolving to either on some distributions.
200- Isolate tests using network namespaces, if possible. This avoids
201  port conflicts with other test cases (so they can run in parallel)
202  and host services.
203- Support for local Apache drop-in config files in the test suite
204  (e.g. to load additional modules needed on Fedora).
205- Try to use markdown to build HTML documentation if pandoc is not
206  available.
207- Disable use of flock if it is unavailable or does not support
208  timeouts (the latter caused the build to fail on Debian Hurd).
209- New test: Disable TLS 1.0 (regression test for Debian bug #754960).
211** Version 0.7.2 (2015-11-21)
212- Bugfix: Non-blocking reads in the input filter could lead to a busy
213  wait in the gnutls_io_input_read function, causing high load on
214  Keep-Alive connections waiting for data, until either more data
215  could be received or the connection was closed. The fix is to pass
216  EAGAIN/EINTR results up to the input filter so they can be handled
217  properly.
218- Close TLS session if the input filter receives EOF (mostly relevant
219  for proper termination of proxy connections).
220- Remove dependency on APR Memcache, which is replaced by the newer
221  version included in the APR Utility Library (libaprutil).
222- Remove dependency on bc. It was used for floating point arithmetic
223  in the test suite, the calculations have been changed to use
224  integers and pure bash code.
226** Version 0.7.1 (2015-10-18)
227- Improved handling of PKCS #11 modules: mod_gnutls now loads either
228  modules specified using GnuTLSP11Module, or the system defaults, but
229  not both. Thanks to Nikos Mavrogiannopoulos for the report and
230  initial patch!
231- Initialize variables to safe defaults during client certificate
232  verification. Certain error code paths did not set them, but they
233  should never be hit due to config validation. This adds another line
234  of defense.
235- Enable C99 support via autoconf
236- Test suite improvements. Most importantly, automake now handles
237  environment setup without any external make calls. Rules to build
238  the certificates are included from the old test makefile. Note that
239  the dependency on GNU make is not new (the test makefile always used
240  GNU make syntax), it just wasn't listed explicitly.
242** Version 0.7 (2015-07-12)
243- Security fix for TLS client authentication (CVE-2015-2091)
244- Bug fixes that enable support for reverse proxy operation
245- Various test suite improvements. Tests are configured through autoconf,
246  so the test suite now works for builds without Monkeysphere support.
247- Add support for TLS connections to back end servers when operating as a
248  reverse proxy (X.509 authentication only at the moment).
249- PKCS #11 support for server keys and certificates
250- Use strict compiler arguments by default (-Wall -Werror -Wextra)
251- Allow limiting the size of certificates exported as SSL_SERVER_CERT
252  and SSL_CLIENT_CERT through the GnuTLSExportCertificates directive
254** Version 0.6 (2014-02-17)
255- Generating DH Params instead of using static ones.
256- Now considering ServerAlias Directives.
257- Major Legacy Code Cleanup.
258- html and pdf and manual documentation generated from markdown sources
259- support monkeysphere validation agent (MSVA) client-certificate verification
260- wider test suite
261- GnuTLSExportCertificates off by default
263** Version 0.5.10 (2011-07-12)
264- Patched a bug responsible for excessive memory consumption by mod_gnutls.
265- Support for proxying from SSL to plain HTTP was added (ie. proxy termination).
267** Version 0.5.9 (2010-09-24)
268- GnuTLSCache none is now an allowed option.
269- Corrected behavior in Keep-Alive connections (do not
270  terminate the connection prematurely)
271- The GnuTLSCache variable now can be given the specific
272  option "gdbm" instead of "dbm". "dbm" will use the berkeley
273  db type of libapr while gdbm will force gdbm to be used.
274  sdbm is no longer being used due to serious limitations.
276** Version 0.5.8 (2010-08-18)
277- Session tickets are enabled by default.
278- Fixes some segmentation faults noticed in some
279  configurations.
281** Version 0.5.7 (2010-07-01)
282- Force usage of SDBM. For some reason the default in
283  my system had issues after reaching a limit of entries.
284  SDBM seems stable so force it.
285- Optimizations in session caching.
286- Added support for session tickets. This allows a
287  server to avoid using a session cache and still support
288  session resumption. This is at the cost of transporting
289  session data during handshake. New option
290  GnuTLSSessionTickets [on|off]
291- Depend on gnutls 2.10.0 to force support for safe
292  renegotiation.
294** Version 0.5.6 (2010-03-24)
295- Corrected issue with firefox and long POST data (by
296  handling EINTR and EAGAIN errors in read).
297- Added support for chained client certificates
298- Corrected more issues related to double frees
301** Version 0.5.5 (2009-06-13)
302- Removed limits on CA certificate loading. Reported by
303  Sander Marechal and Jack Bates.
304- Do not allow sending empty TLS packets even when instructed to.
305  This had the side effect of clients closing connection.
307** Version 0.5.4 (2009-01-04)
308- mod_gnutls.h: modified definition to extern to avoid compilation
309  errors in darwin.
310- Added patch to fix issue with mod_proxy. Investigation and patch by Alain
311  Knaff.
312- libgnutls detection uses pkg-config.
314** Version 0.5.3 (2008-10-16)
315- Corrected bug to allow having an OpenPGP-only web site.
316- Increased Max handshake tries due to interrupted system calls.
318** Version 0.5.2 (2008-06-29)
319- Depend on gnutls 2.4 which has openpgp support in main library.
321** Version 0.5.1 (2008-03-05)
322- Added --disable-srp configure option
323- Better check for memcache (patch by Guillaume Rousse)
324- Corrected possible memory leak in DBM support for resuming sessions.
326** Version 0.5.0-alpha (2008-01-24)
327- Added support for OpenPGP keys. The new directives are:
328  GnuTLSPGPKeyringFile, GnuTLSPGPCertificateFile, GnuTLSPGPKeyFile
330** Version 0.4.2 (2007-12-10)
331- Added support for sending a certificate chain.
332- Corrected bug which did not allow the TLS session cache to be used.
333- Do not allow resuming sessions on different servers.
335** Version 0.4.1 (2007-12-03)
336- Added support for subject alternative names in certificates.
337Only one per certificate is supported.
338- New enviroment variables: SSL_CLIENT_M_VERSION, SSL_CLIENT_S_SAN%,
340- The compatibility mode can now be enabled explicitely with the
341%COMPAT keyword at the GnuTLSPriorities string. It is no longer the default.
342- Check for GnuTLSPriorities directive. This corrects a segfault. Thanks
343to David Hrbáč.
344- Better handling of GnuTLSDHFile and GnuTLSRSAFile.
345- No longer default paths for RSA and DH parameter files.
Note: See TracBrowser for help on using the repository browser.