[thirdparty/openssl.git] / CHANGES


 OpenSSL CHANGES
 _______________

 Changes between 0.9.8b and 0.9.9  [xx XXX xxxx]

  *) Tidy up PKCS#7 routines and add new functions to make it easier to
     create PKCS7 structures containing multiple signers. Update smime
     application to support multiple signers.
     [Steve Henson]

  *) New -macalg option to pkcs12 utility to allow setting of an alternative
     digest MAC.
     [Steve Henson]

  *) Initial support for PKCS#5 v2.0 PRFs other than default SHA1 HMAC.
     Reorganize PBE internals to lookup from a static table using NIDs,
     add support for HMAC PBE OID translation. Add a EVP_CIPHER ctrl:
     EVP_CTRL_PBE_PRF_NID this allows a cipher to specify an alternative
     PRF which will be automatically used with PBES2.
     [Steve Henson]

  *) Replace the algorithm specific calls to generate keys in "req" with the
     new API.
     [Steve Henson]

  *) Update PKCS#7 enveloped data routines to use new API. This is now
     supported by any public key method supporting the encrypt operation. A
     ctrl is added to allow the public key algorithm to examine or modify
     the PKCS#7 RecipientInfo structure if it needs to: for RSA this is
     a no op.
     [Steve Henson]

  *) Add a ctrl to asn1 method to allow a public key algorithm to express
     a default digest type to use. In most cases this will be SHA1 but some
     algorithms (such as GOST) need to specify an alternative digest. The
     return value indicates how strong the prefernce is 1 means optional and
     2 is mandatory (that is it is the only supported type). Modify
     ASN1_item_sign() to accept a NULL digest argument to indicate it should
     use the default md. Update openssl utilities to use the default digest
     type for signing if it is not explicitly indicated.
     [Steve Henson]

  *) Use OID cross reference table in ASN1_sign() and ASN1_verify(). New 
     EVP_MD flag EVP_MD_FLAG_PKEY_METHOD_SIGNATURE. This uses the relevant
     signing method from the key type. This effectively removes the link
     between digests and public key types.
     [Steve Henson]

  *) Add an OID cross reference table and utility functions. Its purpose is to
     translate between signature OIDs such as SHA1WithrsaEncryption and SHA1,
     rsaEncryption. This will allow some of the algorithm specific hackery
     needed to use the correct OID to be removed. 
     [Steve Henson]

  *) Remove algorithm specific dependencies when setting PKCS7_SIGNER_INFO
     structures for PKCS7_sign(). They are now set up by the relevant public
     key ASN1 method.
     [Steve Henson]

  *) Add provisional EC pkey method with support for ECDSA and ECDH.
     [Steve Henson]

  *) Add support for key derivation (agreement) in the API, DH method and
     pkeyutl.
     [Steve Henson]

  *) Add DSA pkey method and DH pkey methods, extend DH ASN1 method to support
     public and private key formats. As a side effect these add additional 
     command line functionality not previously available: DSA signatures can be
     generated and verified using pkeyutl and DH key support and generation in
     pkey, genpkey.
     [Steve Henson]

  *) BeOS support.
     [Oliver Tappe <zooey@hirschkaefer.de>]

  *) New make target "install_html_docs" installs HTML renditions of the
     manual pages.
     [Oliver Tappe <zooey@hirschkaefer.de>]

  *) New utility "genpkey" this is analagous to "genrsa" etc except it can
     generate keys for any algorithm. Extend and update EVP_PKEY_METHOD to
     support key and parameter generation and add initial key generation
     functionality for RSA.
     [Steve Henson]

  *) Add functions for main EVP_PKEY_method operations. The undocumented
     functions EVP_PKEY_{encrypt,decrypt} have been renamed to
     EVP_PKEY_{encrypt,decrypt}_old. 
     [Steve Henson]

  *) Initial definitions for EVP_PKEY_METHOD. This will be a high level public
     key API, doesn't do much yet.
     [Steve Henson]

  *) New function EVP_PKEY_asn1_get0_info() to retrieve information about
     public key algorithms. New option to openssl utility:
     "list-public-key-algorithms" to print out info.
     [Steve Henson]

  *) Implement the Supported Elliptic Curves Extension for
     ECC ciphersuites from draft-ietf-tls-ecc-12.txt.
     [Douglas Stebila]

  *) Don't free up OIDs in OBJ_cleanup() if they are in use by EVP_MD or
     EVP_CIPHER structures to avoid later problems in EVP_cleanup().
     [Steve Henson]

  *) New utilities pkey and pkeyparam. These are similar to algorithm specific
     utilities such as rsa, dsa, dsaparam etc except they process any key
     type.
     [Steve Henson]

  *) Transfer public key printing routines to EVP_PKEY_ASN1_METHOD. New 
     functions EVP_PKEY_print_public(), EVP_PKEY_print_private(),
     EVP_PKEY_print_param() to print public key data from an EVP_PKEY
     structure.
     [Steve Henson]

  *) Initial support for pluggable public key ASN1.
     De-spaghettify the public key ASN1 handling. Move public and private
     key ASN1 handling to a new EVP_PKEY_ASN1_METHOD structure. Relocate
     algorithm specific handling to a single module within the relevant
     algorithm directory. Add functions to allow (near) opaque processing
     of public and private key structures.
     [Steve Henson]

  *) Implement the Supported Point Formats Extension for
     ECC ciphersuites from draft-ietf-tls-ecc-12.txt.
     [Douglas Stebila]

  *) Add initial support for RFC 4279 PSK TLS ciphersuites. Add members
     for the psk identity [hint] and the psk callback functions to the
     SSL_SESSION, SSL and SSL_CTX structure.
     
     New ciphersuites:
         PSK-RC4-SHA, PSK-3DES-EDE-CBC-SHA, PSK-AES128-CBC-SHA,
         PSK-AES256-CBC-SHA
 
     New functions:
         SSL_CTX_use_psk_identity_hint
         SSL_get_psk_identity_hint
         SSL_get_psk_identity
         SSL_use_psk_identity_hint

     [Mika Kousa and Pasi Eronen of Nokia Corporation]

  *) Add RFC 3161 compliant time stamp request creation, response generation
     and response verification functionality.
Commit	Line	Data
81a6c781	1
f1c236f8	2	OpenSSL CHANGES
651d0aff RE	3	_______________
651d0aff RE	4
399a6f0b DSH	5	Changes between 0.9.8b and 0.9.9 [xx XXX xxxx]
399a6f0b DSH	6
a6e7fcd1 DSH	7	*) Tidy up PKCS#7 routines and add new functions to make it easier to
	8	create PKCS7 structures containing multiple signers. Update smime
	9	application to support multiple signers.
	10	[Steve Henson]
	11
121dd39f DSH	12	*) New -macalg option to pkcs12 utility to allow setting of an alternative
	13	digest MAC.
	14	[Steve Henson]
	15
856640b5	16	*) Initial support for PKCS#5 v2.0 PRFs other than default SHA1 HMAC.
b8f702a0	17	Reorganize PBE internals to lookup from a static table using NIDs,
6d3a1eac DSH	18	add support for HMAC PBE OID translation. Add a EVP_CIPHER ctrl:
	19	EVP_CTRL_PBE_PRF_NID this allows a cipher to specify an alternative
	20	PRF which will be automatically used with PBES2.
856640b5 DSH	21	[Steve Henson]
856640b5 DSH	22
34b3c72e	23	*) Replace the algorithm specific calls to generate keys in "req" with the
959e8dfe DSH	24	new API.
	25	[Steve Henson]
	26
399a6f0b DSH	27	*) Update PKCS#7 enveloped data routines to use new API. This is now
	28	supported by any public key method supporting the encrypt operation. A
	29	ctrl is added to allow the public key algorithm to examine or modify
	30	the PKCS#7 RecipientInfo structure if it needs to: for RSA this is
	31	a no op.
	32	[Steve Henson]
28e4fe34	33
03919683 DSH	34	*) Add a ctrl to asn1 method to allow a public key algorithm to express
	35	a default digest type to use. In most cases this will be SHA1 but some
	36	algorithms (such as GOST) need to specify an alternative digest. The
	37	return value indicates how strong the prefernce is 1 means optional and
	38	2 is mandatory (that is it is the only supported type). Modify
	39	ASN1_item_sign() to accept a NULL digest argument to indicate it should
	40	use the default md. Update openssl utilities to use the default digest
	41	type for signing if it is not explicitly indicated.
	42	[Steve Henson]
	43
ee1d9ec0 DSH	44	*) Use OID cross reference table in ASN1_sign() and ASN1_verify(). New
	45	EVP_MD flag EVP_MD_FLAG_PKEY_METHOD_SIGNATURE. This uses the relevant
	46	signing method from the key type. This effectively removes the link
	47	between digests and public key types.
	48	[Steve Henson]
	49
d2027098 DSH	50	*) Add an OID cross reference table and utility functions. Its purpose is to
	51	translate between signature OIDs such as SHA1WithrsaEncryption and SHA1,
	52	rsaEncryption. This will allow some of the algorithm specific hackery
	53	needed to use the correct OID to be removed.
	54	[Steve Henson]
	55
492a9e24 DSH	56	*) Remove algorithm specific dependencies when setting PKCS7_SIGNER_INFO
	57	structures for PKCS7_sign(). They are now set up by the relevant public
	58	key ASN1 method.
	59	[Steve Henson]
	60
9ca7047d DSH	61	*) Add provisional EC pkey method with support for ECDSA and ECDH.
	62	[Steve Henson]
	63
ffb1ac67 DSH	64	*) Add support for key derivation (agreement) in the API, DH method and
	65	pkeyutl.
	66	[Steve Henson]
	67
3ba0885a DSH	68	*) Add DSA pkey method and DH pkey methods, extend DH ASN1 method to support
	69	public and private key formats. As a side effect these add additional
	70	command line functionality not previously available: DSA signatures can be
	71	generated and verified using pkeyutl and DH key support and generation in
	72	pkey, genpkey.
	73	[Steve Henson]
	74
4700aea9 UM	75	*) BeOS support.
	76	[Oliver Tappe <zooey@hirschkaefer.de>]
	77
	78	*) New make target "install_html_docs" installs HTML renditions of the
	79	manual pages.
	80	[Oliver Tappe <zooey@hirschkaefer.de>]
	81
f5cda4cb DSH	82	*) New utility "genpkey" this is analagous to "genrsa" etc except it can
	83	generate keys for any algorithm. Extend and update EVP_PKEY_METHOD to
	84	support key and parameter generation and add initial key generation
	85	functionality for RSA.
	86	[Steve Henson]
	87
f733a5ef DSH	88	*) Add functions for main EVP_PKEY_method operations. The undocumented
	89	functions EVP_PKEY_{encrypt,decrypt} have been renamed to
	90	EVP_PKEY_{encrypt,decrypt}_old.
	91	[Steve Henson]
	92
0b6f3c66 DSH	93	*) Initial definitions for EVP_PKEY_METHOD. This will be a high level public
	94	key API, doesn't do much yet.
	95	[Steve Henson]
	96
0b33dac3 DSH	97	*) New function EVP_PKEY_asn1_get0_info() to retrieve information about
	98	public key algorithms. New option to openssl utility:
	99	"list-public-key-algorithms" to print out info.
	100	[Steve Henson]
	101
33273721 BM	102	*) Implement the Supported Elliptic Curves Extension for
	103	ECC ciphersuites from draft-ietf-tls-ecc-12.txt.
	104	[Douglas Stebila]
	105
246e0931 DSH	106	*) Don't free up OIDs in OBJ_cleanup() if they are in use by EVP_MD or
	107	EVP_CIPHER structures to avoid later problems in EVP_cleanup().
	108	[Steve Henson]
	109
3e4585c8	110	*) New utilities pkey and pkeyparam. These are similar to algorithm specific
f5cda4cb	111	utilities such as rsa, dsa, dsaparam etc except they process any key
3e4585c8	112	type.
3e84b6e1 DSH	113	[Steve Henson]
3e84b6e1 DSH	114
35208f36 DSH	115	*) Transfer public key printing routines to EVP_PKEY_ASN1_METHOD. New
	116	functions EVP_PKEY_print_public(), EVP_PKEY_print_private(),
	117	EVP_PKEY_print_param() to print public key data from an EVP_PKEY
	118	structure.
	119	[Steve Henson]
	120
448be743 DSH	121	*) Initial support for pluggable public key ASN1.
	122	De-spaghettify the public key ASN1 handling. Move public and private
	123	key ASN1 handling to a new EVP_PKEY_ASN1_METHOD structure. Relocate
	124	algorithm specific handling to a single module within the relevant
	125	algorithm directory. Add functions to allow (near) opaque processing
	126	of public and private key structures.
	127	[Steve Henson]
	128
36ca4ba6 BM	129	*) Implement the Supported Point Formats Extension for
	130	ECC ciphersuites from draft-ietf-tls-ecc-12.txt.
	131	[Douglas Stebila]
	132
ddac1974 NL	133	*) Add initial support for RFC 4279 PSK TLS ciphersuites. Add members
	134	for the psk identity [hint] and the psk callback functions to the
	135	SSL_SESSION, SSL and SSL_CTX structure.
	136
	137	New ciphersuites:
	138	PSK-RC4-SHA, PSK-3DES-EDE-CBC-SHA, PSK-AES128-CBC-SHA,
	139	PSK-AES256-CBC-SHA
	140
	141	New functions:
	142	SSL_CTX_use_psk_identity_hint
	143	SSL_get_psk_identity_hint
	144	SSL_get_psk_identity
	145	SSL_use_psk_identity_hint
	146
	147	[Mika Kousa and Pasi Eronen of Nokia Corporation]
	148
c7235be6 UM	149	*) Add RFC 3161 compliant time stamp request creation, response generation
	150	and response verification functionality.
	151