]>
Commit | Line | Data |
---|---|---|
81a6c781 | 1 | |
f1c236f8 | 2 | OpenSSL CHANGES |
651d0aff RE |
3 | _______________ |
4 | ||
7d3ba88a | 5 | Changes between 1.0.2 and 1.1.0 [xx XXX xxxx] |
a27e81ee MC |
6 | |
7 | *) Version negotiation has been rewritten. In particular SSLv23_method(), | |
8 | SSLv23_client_method() and SSLv23_server_method() have been deprecated, | |
9 | and turned into macros which simply call the new preferred function names | |
10 | TLS_method(), TLS_client_method() and TLS_server_method(). All new code | |
11 | should use the new names instead. Also as part of this change the ssl23.h | |
12 | header file has been removed. | |
13 | [Matt Caswell] | |
14 | ||
c3d73470 MC |
15 | *) Support for Kerberos ciphersuites in TLS (RFC2712) has been removed. This |
16 | code and the associated standard is no longer considered fit-for-purpose. | |
17 | [Matt Caswell] | |
6668b6b8 | 18 | |
995101d6 RS |
19 | *) Added HTTP GET support to the ocsp command. |
20 | [Rich Salz] | |
21 | ||
c3d73470 MC |
22 | *) RAND_pseudo_bytes has been deprecated. Users should use RAND_bytes instead. |
23 | [Matt Caswell] | |
302d38e3 | 24 | |
6668b6b8 DSH |
25 | *) Added support for TLS extended master secret from |
26 | draft-ietf-tls-session-hash-03.txt. Thanks for Alfredo Pironti for an | |
27 | initial patch which was a great help during development. | |
28 | [Steve Henson] | |
29 | ||
78cc1f03 MC |
30 | *) All libssl internal structures have been removed from the public header |
31 | files, and the OPENSSL_NO_SSL_INTERN option has been removed (since it is | |
32 | now redundant). Users should not attempt to access internal structures | |
33 | directly. Instead they should use the provided API functions. | |
34 | [Matt Caswell] | |
785da0e6 | 35 | |
bd2bd374 MC |
36 | *) config has been changed so that by default OPENSSL_NO_DEPRECATED is used. |
37 | Access to deprecated functions can be re-enabled by running config with | |
38 | "enable-deprecated". In addition applications wishing to use deprecated | |
39 | functions must define OPENSSL_USE_DEPRECATED. Note that this new behaviour | |
40 | will, by default, disable some transitive includes that previously existed | |
41 | in the header files (e.g. ec.h will no longer, by default, include bn.h) | |
42 | [Matt Caswell] | |
43 | ||
0c1bd7f0 MC |
44 | *) Added support for OCB mode. OpenSSL has been granted a patent license |
45 | compatible with the OpenSSL license for use of OCB. Details are available | |
46 | at https://www.openssl.org/docs/misc/OCB-patent-grant-OpenSSL.pdf. Support | |
47 | for OCB can be removed by calling config with no-ocb. | |
bd2bd374 | 48 | [Matt Caswell] |
0c1bd7f0 | 49 | |
12478cc4 KR |
50 | *) SSLv2 support has been removed. It still supports receiving a SSLv2 |
51 | compatible client hello. | |
52 | [Kurt Roeckx] | |
53 | ||
c56a50b2 AY |
54 | *) Increased the minimal RSA keysize from 256 to 512 bits [Rich Salz], |
55 | done while fixing the error code for the key-too-small case. | |
56 | [Annie Yousar <a.yousar@informatik.hu-berlin.de>] | |
57 | ||
be739b0c RS |
58 | *) CA.sh has been removmed; use CA.pl instead. |
59 | [Rich Salz] | |
60 | ||
24956ca0 RS |
61 | *) Removed old DES API. |
62 | [Rich Salz] | |
63 | ||
59ff1ce0 | 64 | *) Remove various unsupported platforms: |
10bf4fc2 RS |
65 | Sony NEWS4 |
66 | BEOS and BEOS_R5 | |
67 | NeXT | |
68 | SUNOS | |
69 | MPE/iX | |
70 | Sinix/ReliantUNIX RM400 | |
71 | DGUX | |
72 | NCR | |
73 | Tandem | |
74 | Cray | |
75 | 16-bit platforms such as WIN16 | |
b317819b RS |
76 | [Rich Salz] |
77 | ||
10bf4fc2 RS |
78 | *) Clean up OPENSSL_NO_xxx #define's |
79 | Use setbuf() and remove OPENSSL_NO_SETVBUF_IONBF | |
68b00c23 | 80 | Rename OPENSSL_SYSNAME_xxx to OPENSSL_SYS_xxx |
10bf4fc2 RS |
81 | OPENSSL_NO_EC{DH,DSA} merged into OPENSSL_NO_EC |
82 | OPENSSL_NO_RIPEMD160, OPENSSL_NO_RIPEMD merged into OPENSSL_NO_RMD160 | |
83 | OPENSSL_NO_FP_API merged into OPENSSL_NO_STDIO | |
84 | Remove OPENSSL_NO_BIO OPENSSL_NO_BUFFER OPENSSL_NO_CHAIN_VERIFY | |
85 | OPENSSL_NO_EVP OPENSSL_NO_FIPS_ERR OPENSSL_NO_HASH_COMP | |
86 | OPENSSL_NO_LHASH OPENSSL_NO_OBJECT OPENSSL_NO_SPEED OPENSSL_NO_STACK | |
87 | OPENSSL_NO_X509 OPENSSL_NO_X509_VERIFY | |
68b00c23 | 88 | Remove MS_STATIC; it's a relic from platforms <32 bits. |
4b618848 RS |
89 | [Rich Salz] |
90 | ||
10bf4fc2 | 91 | *) Cleaned up dead code |
a2b18e65 RS |
92 | Remove all but one '#ifdef undef' which is to be looked at. |
93 | [Rich Salz] | |
94 | ||
0dfb9398 RS |
95 | *) Clean up calling of xxx_free routines. |
96 | Just like free(), fix most of the xxx_free routines to accept | |
97 | NULL. Remove the non-null checks from callers. Save much code. | |
98 | [Rich Salz] | |
99 | ||
5fc3a5fe BL |
100 | *) Experimental support for a new, fast, unbiased prime candidate generator, |
101 | bn_probable_prime_dh_coprime(). Not currently used by any prime generator. | |
102 | [Felix Laurie von Massenbach <felix@erbridge.co.uk>] | |
103 | ||
189ae368 MK |
104 | *) New output format NSS in the sess_id command line tool. This allows |
105 | exporting the session id and the master key in NSS keylog format. | |
106 | [Martin Kaiser <martin@kaiser.cx>] | |
107 | ||
8acb9538 | 108 | *) Harmonize version and its documentation. -f flag is used to display |
109 | compilation flags. | |
110 | [mancha <mancha1@zoho.com>] | |
111 | ||
e14f14d3 | 112 | *) Fix eckey_priv_encode so it immediately returns an error upon a failure |
113 | in i2d_ECPrivateKey. | |
114 | [mancha <mancha1@zoho.com>] | |
115 | ||
4ba5e63b BL |
116 | *) Fix some double frees. These are not thought to be exploitable. |
117 | [mancha <mancha1@zoho.com>] | |
118 | ||
731f4314 DSH |
119 | *) A missing bounds check in the handling of the TLS heartbeat extension |
120 | can be used to reveal up to 64k of memory to a connected client or | |
121 | server. | |
122 | ||
123 | Thanks for Neel Mehta of Google Security for discovering this bug and to | |
124 | Adam Langley <agl@chromium.org> and Bodo Moeller <bmoeller@acm.org> for | |
125 | preparing the fix (CVE-2014-0160) | |
126 | [Adam Langley, Bodo Moeller] | |
127 | ||
f9b6c0ba DSH |
128 | *) Fix for the attack described in the paper "Recovering OpenSSL |
129 | ECDSA Nonces Using the FLUSH+RELOAD Cache Side-channel Attack" | |
130 | by Yuval Yarom and Naomi Benger. Details can be obtained from: | |
131 | http://eprint.iacr.org/2014/140 | |
132 | ||
133 | Thanks to Yuval Yarom and Naomi Benger for discovering this | |
134 | flaw and to Yuval Yarom for supplying a fix (CVE-2014-0076) | |
135 | [Yuval Yarom and Naomi Benger] | |
136 | ||
a4339ea3 | 137 | *) Use algorithm specific chains in SSL_CTX_use_certificate_chain_file(): |
14e96192 | 138 | this fixes a limitation in previous versions of OpenSSL. |
a4339ea3 DSH |
139 | [Steve Henson] |
140 | ||
5e3ff62c DSH |
141 | *) Experimental encrypt-then-mac support. |
142 | ||
143 | Experimental support for encrypt then mac from | |
144 | draft-gutmann-tls-encrypt-then-mac-02.txt | |
a6e7d1c0 | 145 | |
5fdeb58c DSH |
146 | To enable it set the appropriate extension number (0x42 for the test |
147 | server) using e.g. -DTLSEXT_TYPE_encrypt_then_mac=0x42 | |
a6e7d1c0 | 148 | |
5e3ff62c DSH |
149 | For non-compliant peers (i.e. just about everything) this should have no |
150 | effect. | |
151 | ||
152 | WARNING: EXPERIMENTAL, SUBJECT TO CHANGE. | |
a6e7d1c0 | 153 | |
5e3ff62c DSH |
154 | [Steve Henson] |
155 | ||
97cf1f6c DSH |
156 | *) Add EVP support for key wrapping algorithms, to avoid problems with |
157 | existing code the flag EVP_CIPHER_CTX_WRAP_ALLOW has to be set in | |
158 | the EVP_CIPHER_CTX or an error is returned. Add AES and DES3 wrap | |
159 | algorithms and include tests cases. | |
160 | [Steve Henson] | |
161 | ||
5c84d2f5 DSH |
162 | *) Extend CMS code to support RSA-PSS signatures and RSA-OAEP for |
163 | enveloped data. | |
164 | [Steve Henson] | |
165 | ||
271fef0e DSH |
166 | *) Extended RSA OAEP support via EVP_PKEY API. Options to specify digest, |
167 | MGF1 digest and OAEP label. | |
168 | [Steve Henson] | |
169 | ||
fefc111a BL |
170 | *) Make openssl verify return errors. |
171 | [Chris Palmer <palmer@google.com> and Ben Laurie] | |
172 | ||
1c455bc0 DSH |
173 | *) New function ASN1_TIME_diff to calculate the difference between two |
174 | ASN1_TIME structures or one structure and the current time. | |
175 | [Steve Henson] | |
176 | ||
a98b8ce6 DSH |
177 | *) Update fips_test_suite to support multiple command line options. New |
178 | test to induce all self test errors in sequence and check expected | |
179 | failures. | |
180 | [Steve Henson] | |
181 | ||
f4324e51 DSH |
182 | *) Add FIPS_{rsa,dsa,ecdsa}_{sign,verify} functions which digest and |
183 | sign or verify all in one operation. | |
184 | [Steve Henson] | |
185 | ||
14e96192 | 186 | *) Add fips_algvs: a multicall fips utility incorporating all the algorithm |
3ec9dceb DSH |
187 | test programs and fips_test_suite. Includes functionality to parse |
188 | the minimal script output of fipsalgest.pl directly. | |
f4324e51 | 189 | [Steve Henson] |
3ec9dceb | 190 | |
5e4eb995 DSH |
191 | *) Add authorisation parameter to FIPS_module_mode_set(). |
192 | [Steve Henson] | |
193 | ||
2bfeb7dc DSH |
194 | *) Add FIPS selftest for ECDH algorithm using P-224 and B-233 curves. |
195 | [Steve Henson] | |
196 | ||
4420b3b1 | 197 | *) Use separate DRBG fields for internal and external flags. New function |
cb71870d DSH |
198 | FIPS_drbg_health_check() to perform on demand health checking. Add |
199 | generation tests to fips_test_suite with reduced health check interval to | |
4420b3b1 DSH |
200 | demonstrate periodic health checking. Add "nodh" option to |
201 | fips_test_suite to skip very slow DH test. | |
202 | [Steve Henson] | |
203 | ||
15094852 DSH |
204 | *) New function FIPS_get_cipherbynid() to lookup FIPS supported ciphers |
205 | based on NID. | |
206 | [Steve Henson] | |
207 | ||
a11f06b2 DSH |
208 | *) More extensive health check for DRBG checking many more failure modes. |
209 | New function FIPS_selftest_drbg_all() to handle every possible DRBG | |
210 | combination: call this in fips_test_suite. | |
211 | [Steve Henson] | |
212 | ||
7fdcb457 DSH |
213 | *) Add support for Dual EC DRBG from SP800-90. Update DRBG algorithm test |
214 | and POST to handle Dual EC cases. | |
215 | [Steve Henson] | |
216 | ||
f55f5f77 DSH |
217 | *) Add support for canonical generation of DSA parameter 'g'. See |
218 | FIPS 186-3 A.2.3. | |
219 | ||
7fdcb457 DSH |
220 | *) Add support for HMAC DRBG from SP800-90. Update DRBG algorithm test and |
221 | POST to handle HMAC cases. | |
20f12e63 DSH |
222 | [Steve Henson] |
223 | ||
01a9a759 | 224 | *) Add functions FIPS_module_version() and FIPS_module_version_text() |
3d7bf77f | 225 | to return numerical and string versions of the FIPS module number. |
01a9a759 DSH |
226 | [Steve Henson] |
227 | ||
c2fd5989 | 228 | *) Rename FIPS_mode_set and FIPS_mode to FIPS_module_mode_set and |
3d7bf77f | 229 | FIPS_module_mode. FIPS_mode and FIPS_mode_set will be implemented |
c2fd5989 DSH |
230 | outside the validated module in the FIPS capable OpenSSL. |
231 | [Steve Henson] | |
232 | ||
e0d1a2f8 | 233 | *) Minor change to DRBG entropy callback semantics. In some cases |
3d7bf77f | 234 | there is no multiple of the block length between min_len and |
e0d1a2f8 DSH |
235 | max_len. Allow the callback to return more than max_len bytes |
236 | of entropy but discard any extra: it is the callback's responsibility | |
237 | to ensure that the extra data discarded does not impact the | |
238 | requested amount of entropy. | |
239 | [Steve Henson] | |
240 | ||
cac4fb58 DSH |
241 | *) Add PRNG security strength checks to RSA, DSA and ECDSA using |
242 | information in FIPS186-3, SP800-57 and SP800-131A. | |
243 | [Steve Henson] | |
244 | ||
b5dd1787 DSH |
245 | *) CCM support via EVP. Interface is very similar to GCM case except we |
246 | must supply all data in one chunk (i.e. no update, final) and the | |
247 | message length must be supplied if AAD is used. Add algorithm test | |
248 | support. | |
23916810 DSH |
249 | [Steve Henson] |
250 | ||
ac892b7a DSH |
251 | *) Initial version of POST overhaul. Add POST callback to allow the status |
252 | of POST to be monitored and/or failures induced. Modify fips_test_suite | |
253 | to use callback. Always run all selftests even if one fails. | |
254 | [Steve Henson] | |
255 | ||
06b7e5a0 DSH |
256 | *) XTS support including algorithm test driver in the fips_gcmtest program. |
257 | Note: this does increase the maximum key length from 32 to 64 bytes but | |
258 | there should be no binary compatibility issues as existing applications | |
259 | will never use XTS mode. | |
32a2d8dd DSH |
260 | [Steve Henson] |
261 | ||
05e24c87 DSH |
262 | *) Extensive reorganisation of FIPS PRNG behaviour. Remove all dependencies |
263 | to OpenSSL RAND code and replace with a tiny FIPS RAND API which also | |
264 | performs algorithm blocking for unapproved PRNG types. Also do not | |
265 | set PRNG type in FIPS_mode_set(): leave this to the application. | |
266 | Add default OpenSSL DRBG handling: sets up FIPS PRNG and seeds with | |
d7a3ce98 | 267 | the standard OpenSSL PRNG: set additional data to a date time vector. |
05e24c87 DSH |
268 | [Steve Henson] |
269 | ||
cab0595c DSH |
270 | *) Rename old X9.31 PRNG functions of the form FIPS_rand* to FIPS_x931*. |
271 | This shouldn't present any incompatibility problems because applications | |
272 | shouldn't be using these directly and any that are will need to rethink | |
273 | anyway as the X9.31 PRNG is now deprecated by FIPS 140-2 | |
274 | [Steve Henson] | |
275 | ||
96ec46f7 DSH |
276 | *) Extensive self tests and health checking required by SP800-90 DRBG. |
277 | Remove strength parameter from FIPS_drbg_instantiate and always | |
278 | instantiate at maximum supported strength. | |
279 | [Steve Henson] | |
280 | ||
8857b380 DSH |
281 | *) Add ECDH code to fips module and fips_ecdhvs for primitives only testing. |
282 | [Steve Henson] | |
283 | ||
11e80de3 DSH |
284 | *) New algorithm test program fips_dhvs to handle DH primitives only testing. |
285 | [Steve Henson] | |
286 | ||
287 | *) New function DH_compute_key_padded() to compute a DH key and pad with | |
288 | leading zeroes if needed: this complies with SP800-56A et al. | |
289 | [Steve Henson] | |
290 | ||
591cbfae DSH |
291 | *) Initial implementation of SP800-90 DRBGs for Hash and CTR. Not used by |
292 | anything, incomplete, subject to change and largely untested at present. | |
293 | [Steve Henson] | |
294 | ||
eead69f5 DSH |
295 | *) Modify fipscanisteronly build option to only build the necessary object |
296 | files by filtering FIPS_EX_OBJ through a perl script in crypto/Makefile. | |
297 | [Steve Henson] | |
298 | ||
017bc57b DSH |
299 | *) Add experimental option FIPSSYMS to give all symbols in |
300 | fipscanister.o and FIPS or fips prefix. This will avoid | |
5d439d69 DSH |
301 | conflicts with future versions of OpenSSL. Add perl script |
302 | util/fipsas.pl to preprocess assembly language source files | |
303 | and rename any affected symbols. | |
017bc57b DSH |
304 | [Steve Henson] |
305 | ||
25c65429 DSH |
306 | *) Add selftest checks and algorithm block of non-fips algorithms in |
307 | FIPS mode. Remove DES2 from selftests. | |
308 | [Steve Henson] | |
309 | ||
fe26d066 DSH |
310 | *) Add ECDSA code to fips module. Add tiny fips_ecdsa_check to just |
311 | return internal method without any ENGINE dependencies. Add new | |
25c65429 | 312 | tiny fips sign and verify functions. |
fe26d066 DSH |
313 | [Steve Henson] |
314 | ||
b3310161 DSH |
315 | *) New build option no-ec2m to disable characteristic 2 code. |
316 | [Steve Henson] | |
317 | ||
30b56225 DSH |
318 | *) New build option "fipscanisteronly". This only builds fipscanister.o |
319 | and (currently) associated fips utilities. Uses the file Makefile.fips | |
320 | instead of Makefile.org as the prototype. | |
321 | [Steve Henson] | |
322 | ||
b3d8022e DSH |
323 | *) Add some FIPS mode restrictions to GCM. Add internal IV generator. |
324 | Update fips_gcmtest to use IV generator. | |
325 | [Steve Henson] | |
326 | ||
bdaa5415 DSH |
327 | *) Initial, experimental EVP support for AES-GCM. AAD can be input by |
328 | setting output buffer to NULL. The *Final function must be | |
329 | called although it will not retrieve any additional data. The tag | |
330 | can be set or retrieved with a ctrl. The IV length is by default 12 | |
331 | bytes (96 bits) but can be set to an alternative value. If the IV | |
332 | length exceeds the maximum IV length (currently 16 bytes) it cannot be | |
333 | set before the key. | |
334 | [Steve Henson] | |
335 | ||
3da0ca79 DSH |
336 | *) New flag in ciphers: EVP_CIPH_FLAG_CUSTOM_CIPHER. This means the |
337 | underlying do_cipher function handles all cipher semantics itself | |
338 | including padding and finalisation. This is useful if (for example) | |
339 | an ENGINE cipher handles block padding itself. The behaviour of | |
340 | do_cipher is subtly changed if this flag is set: the return value | |
341 | is the number of characters written to the output buffer (zero is | |
342 | no longer an error code) or a negative error code. Also if the | |
d45087c6 | 343 | input buffer is NULL and length 0 finalisation should be performed. |
3da0ca79 DSH |
344 | [Steve Henson] |
345 | ||
2b3936e8 DSH |
346 | *) If a candidate issuer certificate is already part of the constructed |
347 | path ignore it: new debug notification X509_V_ERR_PATH_LOOP for this case. | |
348 | [Steve Henson] | |
349 | ||
7c2d4fee BM |
350 | *) Improve forward-security support: add functions |
351 | ||
352 | void SSL_CTX_set_not_resumable_session_callback(SSL_CTX *ctx, int (*cb)(SSL *ssl, int is_forward_secure)) | |
353 | void SSL_set_not_resumable_session_callback(SSL *ssl, int (*cb)(SSL *ssl, int is_forward_secure)) | |
354 | ||
355 | for use by SSL/TLS servers; the callback function will be called whenever a | |
356 | new session is created, and gets to decide whether the session may be | |
357 | cached to make it resumable (return 0) or not (return 1). (As by the | |
358 | SSL/TLS protocol specifications, the session_id sent by the server will be | |
359 | empty to indicate that the session is not resumable; also, the server will | |
360 | not generate RFC 4507 (RFC 5077) session tickets.) | |
361 | ||
362 | A simple reasonable callback implementation is to return is_forward_secure. | |
363 | This parameter will be set to 1 or 0 depending on the ciphersuite selected | |
364 | by the SSL/TLS server library, indicating whether it can provide forward | |
365 | security. | |
366 |