Fuller authority key id support, partial support for private key usage extension
[openssl.git] / CHANGES
1
2  OpenSSL CHANGES
3  _______________
4
5
6  Changes between 0.9.1c and 0.9.2
7
8   *) Really fix the ASN1 IMPLICIT bug this time... Partial support for private
9      key usage extension and fuller support for authority key id.
10      [Steve Henson]
11
12   *) Add OAEP encryption for the OpenSSL crypto library. OAEP is the improved
13      padding method for RSA, which is recommended for new applications in PKCS
14      #1 v2.0 (RFC 2437, October 1998).
15      OAEP (Optimal Asymmetric Encryption Padding) has better theoretical
16      foundations than the ad-hoc padding used in PKCS #1 v1.5. It is secure
17      against Bleichbacher's attack on RSA.
18      [Ulf Moeller <ulf@fitug.de>, reformatted, corrected and integrated by
19       Ben Laurie]
20
21   *) Updates to the new SSL compression code
22      [Eric A. Young, (from changes to C2Net SSLeay, integrated by Mark Cox)]
23
24   *) Fix so that the version number in the master secret, when passed
25      via RSA, checks that if TLS was proposed, but we roll back to SSLv3
26      (because the server will not accept higher), that the version number
27      is 0x03,0x01, not 0x03,0x00
28      [Eric A. Young, (from changes to C2Net SSLeay, integrated by Mark Cox)]
29
30   *) Run extensive memory leak checks on SSL apps. Fixed *lots* of memory
31      leaks in ssl/ relating to new X509_get_pubkey() behaviour. Also fixes
32      in apps/ and an unrelated leak in crypto/dsa/dsa_vrf.c
33      [Steve Henson]
34
35   *) Support for RAW extensions where an arbitrary extension can be
36      created by including its DER encoding. See apps/openssl.cnf for
37      an example.
38      [Steve Henson]
39
40   *) Make sure latest Perl versions don't interpret some generated C array
41      code as Perl array code in the crypto/err/err_genc.pl script.
42      [Lars Weber <3weber@informatik.uni-hamburg.de>]
43
44   *) Modify ms/do_ms.bat to not generate assembly language makefiles since
45      not many people have the assembler. Various Win32 compilation fixes and
46      update to the INSTALL.W32 file with (hopefully) more accurate Win32
47      build instructions.
48      [Steve Henson]
49
50   *) Modify configure script 'Configure' to automatically create crypto/date.h
51      file under Win32 and also build pem.h from pem.org. New script
52      util/mkfiles.pl to create the MINFO file on environments that can't do a
53      'make files': perl util/mkfiles.pl >MINFO should work.
54      [Steve Henson]
55
56   *) Major rework of DES function declarations, in the pursuit of correctness
57      and purity. As a result, many evil casts evaporated, and some weirdness,
58      too. You may find this causes warnings in your code. Zapping your evil
59      casts will probably fix them. Mostly.
60      [Ben Laurie]
61
62   *) Fix for a typo in asn1.h. Bug fix to object creation script
63      obj_dat.pl. It considered a zero in an object definition to mean
64      "end of object": none of the objects in objects.h have any zeros
65      so it wasn't spotted.
66      [Steve Henson, reported by Erwann ABALEA <eabalea@certplus.com>]
67
68   *) Add support for Triple DES Cipher Block Chaining with Output Feedback
69      Masking (CBCM). In the absence of test vectors, the best I have been able
70      to do is check that the decrypt undoes the encrypt, so far. Send me test
71      vectors if you have them.
72      [Ben Laurie]
73
74   *) Correct caclulation of key length for export ciphers (too much space was
75      allocated for null ciphers). This has not been tested!
76      [Ben Laurie]
77
78   *) Modifications to the mkdef.pl for Win32 DEF file creation. The usage
79      message is now correct (it understands "crypto" and "ssl" on its
80      command line). There is also now an "update" option. This will update
81      the util/ssleay.num and util/libeay.num files with any new functions.
82      If you do a: 
83      perl util/mkdef.pl crypto ssl update
84      it will update them.
85      [Steve Henson]
86
87   *) Overhauled the Perl interface (perl/*):
88      - ported BN stuff to OpenSSL's different BN library
89      - made the perl/ source tree CVS-aware
90      - renamed the package from SSLeay to OpenSSL (the files still contain
91        their history because I've copied them in the repository)
92      - removed obsolete files (the test scripts will be replaced
93        by better Test::Harness variants in the future)
94      [Ralf S. Engelschall]
95
96   *) First cut for a very conservative source tree cleanup:
97      1. merge various obsolete readme texts into doc/ssleay.txt
98      where we collect the old documents and readme texts.
99      2. remove the first part of files where I'm already sure that we no
100      longer need them because of three reasons: either they are just temporary
101      files which were left by Eric or they are preserved original files where
102      I've verified that the diff is also available in the CVS via "cvs diff
103      -rSSLeay_0_8_1b" or they were renamed (as it was definitely the case for
104      the crypto/md/ stuff).
105      [Ralf S. Engelschall]
106
107   *) More extension code. Incomplete support for subject and issuer alt
108      name, issuer and authority key id. Change the i2v function parameters
109      and add an extra 'crl' parameter in the X509V3_CTX structure: guess
110      what that's for :-) Fix to ASN1 macro which messed up
111      IMPLICIT tag and add f_enum.c which adds a2i, i2a for ENUMERATED.
112      [Steve Henson]
113
114   *) Preliminary support for ENUMERATED type. This is largely copied from the
115      INTEGER code.
116      [Steve Henson]
117
118   *) Add new function, EVP_MD_CTX_copy() to replace frequent use of memcpy.
119      [Eric A. Young, (from changes to C2Net SSLeay, integrated by Mark Cox)]
120
121   *) Make sure `make rehash' target really finds the `openssl' program.
122      [Ralf S. Engelschall, Matthias Loepfe <Matthias.Loepfe@adnovum.ch>]
123
124   *) Squeeze another 7% of speed out of MD5 assembler, at least on a P2. I'd
125      like to hear about it if this slows down other processors.
126      [Ben Laurie]
127
128   *) Add CygWin32 platform information to Configure script.
129      [Alan Batie <batie@aahz.jf.intel.com>]
130
131   *) Fixed ms/32all.bat script: `no_asm' -> `no-asm'
132      [Rainer W. Gerling <gerling@mpg-gv.mpg.de>]
133   
134   *) New program nseq to manipulate netscape certificate sequences
135      [Steve Henson]
136
137   *) Modify crl2pkcs7 so it supports multiple -certfile arguments. Fix a
138      few typos.
139      [Steve Henson]
140
141   *) Fixes to BN code.  Previously the default was to define BN_RECURSION
142      but the BN code had some problems that would cause failures when
143      doing certificate verification and some other functions.
144      [Eric A. Young, (from changes to C2Net SSLeay, integrated by Mark Cox)]
145
146   *) Add ASN1 and PEM code to support netscape certificate sequences.
147      [Steve Henson]
148
149   *) Add ASN1 and PEM code to support netscape certificate sequences.
150      [Steve Henson]
151
152   *) Add several PKIX and private extended key usage OIDs.
153      [Steve Henson]
154
155   *) Modify the 'ca' program to handle the new extension code. Modify
156      openssl.cnf for new extension format, add comments.
157      [Steve Henson]
158
159   *) More X509 V3 changes. Fix typo in v3_bitstr.c. Add support to 'req'
160      and add a sample to openssl.cnf so req -x509 now adds appropriate
161      CA extensions.
162      [Steve Henson]
163
164   *) Continued X509 V3 changes. Add to other makefiles, integrate with the
165      error code, add initial support to X509_print() and x509 application.
166      [Steve Henson]
167
168   *) Takes a deep breath and start addding X509 V3 extension support code. Add
169      files in crypto/x509v3. Move original stuff to crypto/x509v3/old. All this
170      stuff is currently isolated and isn't even compiled yet.
171      [Steve Henson]
172
173   *) Continuing patches for GeneralizedTime. Fix up certificate and CRL
174      ASN1 to use ASN1_TIME and modify print routines to use ASN1_TIME_print.
175      Removed the versions check from X509 routines when loading extensions:
176      this allows certain broken certificates that don't set the version
177      properly to be processed.
178      [Steve Henson]
179
180   *) Deal with irritating shit to do with dependencies, in YAAHW (Yet Another
181      Ad Hoc Way) - Makefile.ssls now all contain local dependencies, which
182      can still be regenerated with "make depend".
183      [Ben Laurie]
184
185   *) Spelling mistake in C version of CAST-128.
186      [Ben Laurie, reported by Jeremy Hylton <jeremy@cnri.reston.va.us>]
187
188   *) Changes to the error generation code. The perl script err-code.pl 
189      now reads in the old error codes and retains the old numbers, only
190      adding new ones if necessary. It also only changes the .err files if new
191      codes are added. The makefiles have been modified to only insert errors
192      when needed (to avoid needlessly modifying header files). This is done
193      by only inserting errors if the .err file is newer than the auto generated
194      C file. To rebuild all the error codes from scratch (the old behaviour)
195      either modify crypto/Makefile.ssl to pass the -regen flag to err_code.pl
196      or delete all the .err files.
197      [Steve Henson]
198
199   *) CAST-128 was incorrectly implemented for short keys. The C version has
200      been fixed, but is untested. The assembler versions are also fixed, but
201      new assembler HAS NOT BEEN GENERATED FOR WIN32 - the Makefile needs fixing
202      to regenerate it if needed.
203      [Ben Laurie, reported (with fix for C version) by Jun-ichiro itojun
204       Hagino <itojun@kame.net>]
205
206   *) File was opened incorrectly in randfile.c.
207      [Ulf Möller <ulf@fitug.de>]
208
209   *) Beginning of support for GeneralizedTime. d2i, i2d, check and print
210      functions. Also ASN1_TIME suite which is a CHOICE of UTCTime or
211      GeneralizedTime. ASN1_TIME is the proper type used in certificates et
212      al: it's just almost always a UTCTime. Note this patch adds new error
213      codes so do a "make errors" if there are problems.
214      [Steve Henson]
215
216   *) Correct Linux 1 recognition in config.
217      [Ulf Möller <ulf@fitug.de>]
218
219   *) Remove pointless MD5 hash when using DSA keys in ca.
220      [Anonymous <nobody@replay.com>]
221
222   *) Generate an error if given an empty string as a cert directory. Also
223      generate an error if handed NULL (previously returned 0 to indicate an
224      error, but didn't set one).
225      [Ben Laurie, reported by Anonymous <nobody@replay.com>]
226
227   *) Add prototypes to SSL methods. Make SSL_write's buffer const, at last.
228      [Ben Laurie]
229
230   *) Fix the dummy function BN_ref_mod_exp() in rsaref.c to have the correct
231      parameters. This was causing a warning which killed off the Win32 compile.
232      [Steve Henson]
233
234   *) Remove C++ style comments from crypto/bn/bn_local.h.
235      [Neil Costigan <neil.costigan@celocom.com>]
236
237   *) The function OBJ_txt2nid was broken. It was supposed to return a nid
238      based on a text string, looking up short and long names and finally
239      "dot" format. The "dot" format stuff didn't work. Added new function
240      OBJ_txt2obj to do the same but return an ASN1_OBJECT and rewrote 
241      OBJ_txt2nid to use it. OBJ_txt2obj can also return objects even if the
242      OID is not part of the table.
243      [Steve Henson]
244
245   *) Add prototypes to X509 lookup/verify methods, fixing a bug in
246      X509_LOOKUP_by_alias().
247      [Ben Laurie]
248
249   *) Sort openssl functions by name.
250      [Ben Laurie]
251
252   *) Get the gendsa program working (hopefully) and add it to app list. Remove
253      encryption from sample DSA keys (in case anyone is interested the password
254      was "1234").
255      [Steve Henson]
256
257   *) Make _all_ *_free functions accept a NULL pointer.
258      [Frans Heymans <fheymans@isaserver.be>]
259
260   *) If a DH key is generated in s3_srvr.c, don't blow it by trying to use
261      NULL pointers.
262      [Anonymous <nobody@replay.com>]
263
264   *) s_server should send the CAfile as acceptable CAs, not its own cert.
265      [Bodo Moeller <3moeller@informatik.uni-hamburg.de>]
266
267   *) Don't blow it for numeric -newkey arguments to apps/req.
268      [Bodo Moeller <3moeller@informatik.uni-hamburg.de>]
269
270   *) Temp key "for export" tests were wrong in s3_srvr.c.
271      [Anonymous <nobody@replay.com>]
272
273   *) Add prototype for temp key callback functions
274      SSL_CTX_set_tmp_{rsa,dh}_callback().
275      [Ben Laurie]
276
277   *) Make DH_free() tolerate being passed a NULL pointer (like RSA_free() and
278      DSA_free()). Make X509_PUBKEY_set() check for errors in d2i_PublicKey().
279      [Steve Henson]
280
281   *) X509_name_add_entry() freed the wrong thing after an error.
282      [Arne Ansper <arne@ats.cyber.ee>]
283
284   *) rsa_eay.c would attempt to free a NULL context.
285      [Arne Ansper <arne@ats.cyber.ee>]
286
287   *) BIO_s_socket() had a broken should_retry() on Windoze.
288      [Arne Ansper <arne@ats.cyber.ee>]
289
290   *) BIO_f_buffer() didn't pass on BIO_CTRL_FLUSH.
291      [Arne Ansper <arne@ats.cyber.ee>]
292
293   *) Make sure the already existing X509_STORE->depth variable is initialized
294      in X509_STORE_new(), but document the fact that this variable is still
295      unused in the certificate verification process.
296      [Ralf S. Engelschall]
297
298   *) Fix the various library and apps files to free up pkeys obtained from
299      X509_PUBKEY_get() et al. Also allow x509.c to handle netscape extensions.
300      [Steve Henson]
301
302   *) Fix reference counting in X509_PUBKEY_get(). This makes
303      demos/maurice/example2.c work, amongst others, probably.
304      [Steve Henson and Ben Laurie]
305
306   *) First cut of a cleanup for apps/. First the `ssleay' program is now named
307      `openssl' and second, the shortcut symlinks for the `openssl <command>'
308      are no longer created. This way we have a single and consistent command
309      line interface `openssl <command>', similar to `cvs <command>'.
310      [Ralf S. Engelschall, Paul Sutton and Ben Laurie]
311
312   *) ca.c: move test for DSA keys inside #ifndef NO_DSA. Make pubkey
313      BIT STRING wrapper always have zero unused bits.
314      [Steve Henson]
315
316   *) Add CA.pl, perl version of CA.sh, add extended key usage OID.
317      [Steve Henson]
318
319   *) Make the top-level INSTALL documentation easier to understand.
320      [Paul Sutton]
321
322   *) Makefiles updated to exit if an error occurs in a sub-directory
323      make (including if user presses ^C) [Paul Sutton]
324
325   *) Make Montgomery context stuff explicit in RSA data structure.
326      [Ben Laurie]
327
328   *) Fix build order of pem and err to allow for generated pem.h.
329      [Ben Laurie]
330
331   *) Fix renumbering bug in X509_NAME_delete_entry().
332      [Ben Laurie]
333
334   *) Enhanced the err-ins.pl script so it makes the error library number 
335      global and can add a library name. This is needed for external ASN1 and
336      other error libraries.
337      [Steve Henson]
338
339   *) Fixed sk_insert which never worked properly.
340      [Steve Henson]
341
342   *) Fix ASN1 macros so they can handle indefinite length construted 
343      EXPLICIT tags. Some non standard certificates use these: they can now
344      be read in.
345      [Steve Henson]
346
347   *) Merged the various old/obsolete SSLeay documentation files (doc/xxx.doc)
348      into a single doc/ssleay.txt bundle. This way the information is still
349      preserved but no longer messes up this directory. Now it's new room for
350      the new set of documenation files.
351      [Ralf S. Engelschall]
352
353   *) SETs were incorrectly DER encoded. This was a major pain, because they
354      shared code with SEQUENCEs, which aren't coded the same. This means that
355      almost everything to do with SETs or SEQUENCEs has either changed name or
356      number of arguments.
357      [Ben Laurie, based on a partial fix by GP Jayan <gp@nsj.co.jp>]
358
359   *) Fix test data to work with the above.
360      [Ben Laurie]
361
362   *) Fix the RSA header declarations that hid a bug I fixed in 0.9.0b but
363      was already fixed by Eric for 0.9.1 it seems.
364      [Ben Laurie - pointed out by Ulf Möller <ulf@fitug.de>]
365
366   *) Autodetect FreeBSD3.
367      [Ben Laurie]
368
369   *) Fix various bugs in Configure. This affects the following platforms:
370      nextstep
371      ncr-scde
372      unixware-2.0
373      unixware-2.0-pentium
374      sco5-cc.
375      [Ben Laurie]
376
377   *) Eliminate generated files from CVS. Reorder tests to regenerate files
378      before they are needed.
379      [Ben Laurie]
380
381   *) Generate Makefile.ssl from Makefile.org (to keep CVS happy).
382      [Ben Laurie]
383
384  Changes between 0.9.1b and 0.9.1c
385
386   *) Added OPENSSL_VERSION_NUMBER to crypto/crypto.h and 
387      changed SSLeay to OpenSSL in version strings.
388      [Ralf S. Engelschall]
389   
390   *) Some fixups to the top-level documents.
391      [Paul Sutton]
392
393   *) Fixed the nasty bug where rsaref.h was not found under compile-time
394      because the symlink to include/ was missing.
395      [Ralf S. Engelschall]
396
397   *) Incorporated the popular no-RSA/DSA-only patches 
398      which allow to compile a RSA-free SSLeay.
399      [Andrew Cooke / Interrader Ldt., Ralf S. Engelschall]
400
401   *) Fixed nasty rehash problem under `make -f Makefile.ssl links'
402      when "ssleay" is still not found.
403      [Ralf S. Engelschall]
404
405   *) Added more platforms to Configure: Cray T3E, HPUX 11, 
406      [Ralf S. Engelschall, Beckmann <beckman@acl.lanl.gov>]
407
408   *) Updated the README file.
409      [Ralf S. Engelschall]
410
411   *) Added various .cvsignore files in the CVS repository subdirs
412      to make a "cvs update" really silent.
413      [Ralf S. Engelschall]
414
415   *) Recompiled the error-definition header files and added
416      missing symbols to the Win32 linker tables.
417      [Ralf S. Engelschall]
418
419   *) Cleaned up the top-level documents;
420      o new files: CHANGES and LICENSE
421      o merged VERSION, HISTORY* and README* files a CHANGES.SSLeay 
422      o merged COPYRIGHT into LICENSE
423      o removed obsolete TODO file
424      o renamed MICROSOFT to INSTALL.W32
425      [Ralf S. Engelschall]
426
427   *) Removed dummy files from the 0.9.1b source tree: 
428      crypto/asn1/x crypto/bio/cd crypto/bio/fg crypto/bio/grep crypto/bio/vi
429      crypto/bn/asm/......add.c crypto/bn/asm/a.out crypto/dsa/f crypto/md5/f
430      crypto/pem/gmon.out crypto/perlasm/f crypto/pkcs7/build crypto/rsa/f
431      crypto/sha/asm/f crypto/threads/f ms/zzz ssl/f ssl/f.mak test/f
432      util/f.mak util/pl/f util/pl/f.mak crypto/bf/bf_locl.old apps/f
433      [Ralf S. Engelschall]
434
435   *) Added various platform portability fixes.
436      [Mark J. Cox]
437
438   *) The Genesis of the OpenSSL rpject:
439      We start with the latest (unreleased) SSLeay version 0.9.1b which Eric A.
440      Young and Tim J. Hudson created while they were working for C2Net until
441      summer 1998.
442      [The OpenSSL Project]
443  
444  Changes between 0.9.0b and 0.9.1b
445
446   *) Updated a few CA certificates under certs/
447      [Eric A. Young]
448
449   *) Changed some BIGNUM api stuff.
450      [Eric A. Young]
451
452   *) Various platform ports: OpenBSD, Ultrix, IRIX 64bit, NetBSD, 
453      DGUX x86, Linux Alpha, etc.
454      [Eric A. Young]
455
456   *) New COMP library [crypto/comp/] for SSL Record Layer Compression: 
457      RLE (dummy implemented) and ZLIB (really implemented when ZLIB is
458      available).
459      [Eric A. Young]
460
461   *) Add -strparse option to asn1pars program which parses nested 
462      binary structures 
463      [Dr Stephen Henson <shenson@bigfoot.com>]
464
465   *) Added "oid_file" to ssleay.cnf for "ca" and "req" programs.
466      [Eric A. Young]
467
468   *) DSA fix for "ca" program.
469      [Eric A. Young]
470
471   *) Added "-genkey" option to "dsaparam" program.
472      [Eric A. Young]
473
474   *) Added RIPE MD160 (rmd160) message digest.
475      [Eric A. Young]
476
477   *) Added -a (all) option to "ssleay version" command.
478      [Eric A. Young]
479
480   *) Added PLATFORM define which is the id given to Configure.
481      [Eric A. Young]
482
483   *) Added MemCheck_XXXX functions to crypto/mem.c for memory checking.
484      [Eric A. Young]
485
486   *) Extended the ASN.1 parser routines.
487      [Eric A. Young]
488
489   *) Extended BIO routines to support REUSEADDR, seek, tell, etc.
490      [Eric A. Young]
491
492   *) Added a BN_CTX to the BN library.
493      [Eric A. Young]
494
495   *) Fixed the weak key values in DES library
496      [Eric A. Young]
497
498   *) Changed API in EVP library for cipher aliases.
499      [Eric A. Young]
500
501   *) Added support for RC2/64bit cipher.
502      [Eric A. Young]
503
504   *) Converted the lhash library to the crypto/mem.c functions.
505      [Eric A. Young]
506
507   *) Added more recognized ASN.1 object ids.
508      [Eric A. Young]
509
510   *) Added more RSA padding checks for SSL/TLS.
511      [Eric A. Young]
512
513   *) Added BIO proxy/filter functionality.
514      [Eric A. Young]
515
516   *) Added extra_certs to SSL_CTX which can be used
517      send extra CA certificates to the client in the CA cert chain sending
518      process. It can be configured with SSL_CTX_add_extra_chain_cert().
519      [Eric A. Young]
520
521   *) Now Fortezza is denied in the authentication phase because
522      this is key exchange mechanism is not supported by SSLeay at all.
523      [Eric A. Young]
524
525   *) Additional PKCS1 checks.
526      [Eric A. Young]
527
528   *) Support the string "TLSv1" for all TLS v1 ciphers.
529      [Eric A. Young]
530
531   *) Added function SSL_get_ex_data_X509_STORE_CTX_idx() which gives the
532      ex_data index of the SSL context in the X509_STORE_CTX ex_data.
533      [Eric A. Young]
534
535   *) Fixed a few memory leaks.
536      [Eric A. Young]
537
538   *) Fixed various code and comment typos.
539      [Eric A. Young]
540
541   *) A minor bug in ssl/s3_clnt.c where there would always be 4 0 
542      bytes sent in the client random.
543      [Edward Bishop <ebishop@spyglass.com>]
544