2017-12-14 06:19:16 -05:00
|
|
|
Version 2.1.0
|
|
|
|
=============
|
2017-09-03 08:35:27 -04:00
|
|
|
|
|
|
|
Notable changes
|
|
|
|
---------------
|
|
|
|
|
2017-11-25 09:12:08 -05:00
|
|
|
* Support for OpenSSL versions before 1.0.1 and LibreSSL versions before 2.5
|
|
|
|
is removed.
|
2017-09-03 08:35:27 -04:00
|
|
|
[[GitHub #86]](https://github.com/ruby/openssl/pull/86)
|
|
|
|
* OpenSSL::BN#negative?, #+@, and #-@ are added.
|
|
|
|
* OpenSSL::SSL::SSLSocket#connect raises a more informative exception when
|
|
|
|
certificate verification fails.
|
|
|
|
[[GitHub #99]](https://github.com/ruby/openssl/pull/99)
|
2017-11-25 09:12:08 -05:00
|
|
|
* OpenSSL::KDF module is newly added. In addition to PBKDF2-HMAC that has moved
|
|
|
|
from OpenSSL::PKCS5, scrypt and HKDF are supported.
|
2017-09-03 08:35:27 -04:00
|
|
|
[[GitHub #109]](https://github.com/ruby/openssl/pull/109)
|
2017-11-25 09:12:08 -05:00
|
|
|
[[GitHub #173]](https://github.com/ruby/openssl/pull/173)
|
|
|
|
* OpenSSL.fips_mode is added. We had the setter, but not the getter.
|
2017-09-03 08:35:27 -04:00
|
|
|
[[GitHub #125]](https://github.com/ruby/openssl/pull/125)
|
|
|
|
* OpenSSL::OCSP::Request#signed? is added.
|
|
|
|
* OpenSSL::ASN1 handles the indefinite length form better. OpenSSL::ASN1.decode
|
|
|
|
no longer wrongly treats the end-of-contents octets as part of the content.
|
|
|
|
OpenSSL::ASN1::ASN1Data#infinite_length is renamed to #indefinite_length.
|
|
|
|
[[GitHub #98]](https://github.com/ruby/openssl/pull/98)
|
|
|
|
* OpenSSL::X509::Name#add_entry now accepts two additional keyword arguments
|
|
|
|
'loc' and 'set'.
|
|
|
|
[[GitHub #94]](https://github.com/ruby/openssl/issues/94)
|
2017-11-25 09:12:08 -05:00
|
|
|
* OpenSSL::SSL::SSLContext#min_version= and #max_version= are added to replace
|
|
|
|
#ssl_version= that was built on top of the deprecated OpenSSL C API. Use of
|
|
|
|
that method and the constant OpenSSL::SSL::SSLContext::METHODS is now
|
|
|
|
deprecated.
|
2017-09-03 08:35:27 -04:00
|
|
|
[[GitHub #142]](https://github.com/ruby/openssl/pull/142)
|
|
|
|
* OpenSSL::X509::Name#to_utf8 is added.
|
|
|
|
[[GitHub #26]](https://github.com/ruby/openssl/issues/26)
|
|
|
|
[[GitHub #143]](https://github.com/ruby/openssl/pull/143)
|
2017-11-25 09:12:08 -05:00
|
|
|
* OpenSSL::X509::{Extension,Attribute,Certificate,CRL,Revoked,Request} can be
|
|
|
|
compared with == operator.
|
|
|
|
[[GitHub #161]](https://github.com/ruby/openssl/pull/161)
|
|
|
|
* TLS Fallback Signaling Cipher Suite Value (SCSV) support is added.
|
|
|
|
[[GitHub #165]](https://github.com/ruby/openssl/pull/165)
|
|
|
|
* Build failure with OpenSSL 1.1 built with no-deprecated is fixed.
|
|
|
|
[[GitHub #160]](https://github.com/ruby/openssl/pull/160)
|
|
|
|
* OpenSSL::Buffering#write accepts an arbitrary number of arguments.
|
|
|
|
[[Feature #9323]](https://bugs.ruby-lang.org/issues/9323)
|
|
|
|
[[GitHub #162]](https://github.com/ruby/openssl/pull/162)
|
|
|
|
* OpenSSL::PKey::RSA#sign_pss and #verify_pss are added. They perform RSA-PSS
|
|
|
|
signature and verification.
|
|
|
|
[[GitHub #75]](https://github.com/ruby/openssl/issues/75)
|
|
|
|
[[GitHub #76]](https://github.com/ruby/openssl/pull/76)
|
|
|
|
[[GitHub #169]](https://github.com/ruby/openssl/pull/169)
|
|
|
|
* OpenSSL::SSL::SSLContext#add_certificate is added.
|
|
|
|
[[GitHub #167]](https://github.com/ruby/openssl/pull/167)
|
2017-12-14 06:19:16 -05:00
|
|
|
* OpenSSL::PKey::EC::Point#to_octet_string is added.
|
|
|
|
OpenSSL::PKey::EC::Point.new can now take String as the second argument.
|
|
|
|
[[GitHub #177]](https://github.com/ruby/openssl/pull/177)
|
|
|
|
|
|
|
|
|
2018-05-12 03:33:53 -04:00
|
|
|
Version 2.0.8
|
|
|
|
=============
|
|
|
|
|
|
|
|
Bug fixes
|
|
|
|
---------
|
|
|
|
|
|
|
|
* OpenSSL::Cipher#pkcs5_keyivgen raises an error when a negative iteration
|
|
|
|
count is given.
|
|
|
|
[[GitHub #184]](https://github.com/ruby/openssl/pull/184)
|
|
|
|
* Fixed build with LibreSSL 2.7.
|
|
|
|
[[GitHub #192]](https://github.com/ruby/openssl/issues/192)
|
|
|
|
[[GitHub #193]](https://github.com/ruby/openssl/pull/193)
|
|
|
|
|
|
|
|
|
2017-12-14 06:19:16 -05:00
|
|
|
Version 2.0.7
|
|
|
|
=============
|
|
|
|
|
|
|
|
Bug fixes
|
|
|
|
---------
|
|
|
|
|
|
|
|
* OpenSSL::Cipher#auth_data= could segfault if called against a non-AEAD cipher.
|
|
|
|
[[Bug #14024]](https://bugs.ruby-lang.org/issues/14024)
|
|
|
|
* OpenSSL::X509::Certificate#public_key= (and similar methods) could segfault
|
|
|
|
when an instance of OpenSSL::PKey::PKey with no public key components is
|
|
|
|
passed.
|
|
|
|
[[Bug #14087]](https://bugs.ruby-lang.org/issues/14087)
|
|
|
|
[[GitHub #168]](https://github.com/ruby/openssl/pull/168)
|
2017-09-03 08:35:27 -04:00
|
|
|
|
|
|
|
|
2017-09-24 12:26:22 -04:00
|
|
|
Version 2.0.6
|
|
|
|
=============
|
|
|
|
|
|
|
|
Bug fixes
|
|
|
|
---------
|
|
|
|
|
|
|
|
* The session_remove_cb set to an OpenSSL::SSL::SSLContext is no longer called
|
|
|
|
during GC.
|
|
|
|
* A possible deadlock in OpenSSL::SSL::SSLSocket#sysread is fixed.
|
|
|
|
[[GitHub #139]](https://github.com/ruby/openssl/pull/139)
|
|
|
|
* OpenSSL::BN#hash could return an unnormalized fixnum value on Windows.
|
|
|
|
[[Bug #13877]](https://bugs.ruby-lang.org/issues/13877)
|
|
|
|
* OpenSSL::SSL::SSLSocket#sysread and #sysread_nonblock set the length of the
|
|
|
|
destination buffer String to 0 on error.
|
|
|
|
[[GitHub #153]](https://github.com/ruby/openssl/pull/153)
|
|
|
|
* Possible deadlock is fixed. This happened only when built with older versions
|
|
|
|
of OpenSSL (before 1.1.0) or LibreSSL.
|
|
|
|
[[GitHub #155]](https://github.com/ruby/openssl/pull/155)
|
|
|
|
|
|
|
|
|
2017-08-10 05:23:45 -04:00
|
|
|
Version 2.0.5
|
|
|
|
=============
|
|
|
|
|
|
|
|
Bug fixes
|
|
|
|
---------
|
|
|
|
|
|
|
|
* Reading a PEM/DER-encoded private key or certificate from an IO object did
|
|
|
|
not work properly on mswin platforms.
|
|
|
|
[[ruby/openssl#128]](https://github.com/ruby/openssl/issues/128)
|
|
|
|
* Broken length check in the PEM passphrase callback is fixed.
|
|
|
|
* It failed to compile when OpenSSL is configured without TLS 1.0 support.
|
|
|
|
|
|
|
|
|
2017-06-14 05:49:09 -04:00
|
|
|
Version 2.0.4
|
|
|
|
=============
|
|
|
|
|
|
|
|
Bug fixes
|
|
|
|
---------
|
|
|
|
|
|
|
|
* It now compiles with LibreSSL without renaming on Windows (mswin).
|
|
|
|
* A workaround for the error queue leak of X509_load_cert_crl_file() that
|
|
|
|
causes random errors is added.
|
|
|
|
[[Bug #11033]](https://bugs.ruby-lang.org/issues/11033)
|
|
|
|
|
|
|
|
|
|
|
|
Version 2.0.3
|
|
|
|
=============
|
|
|
|
|
|
|
|
Bug fixes
|
|
|
|
---------
|
|
|
|
|
|
|
|
* OpenSSL::ASN1::Constructive#each which was broken by 2.0.0 is fixed.
|
|
|
|
[[ruby/openssl#96]](https://github.com/ruby/openssl/pull/96)
|
|
|
|
* Fixed build with static OpenSSL libraries on Windows.
|
|
|
|
[[Bug #13080]](https://bugs.ruby-lang.org/issues/13080)
|
|
|
|
* OpenSSL::X509::Name#eql? which was broken by 2.0.0 is fixed.
|
|
|
|
|
|
|
|
|
|
|
|
Version 2.0.2
|
|
|
|
=============
|
|
|
|
|
|
|
|
Bug fixes
|
|
|
|
---------
|
|
|
|
|
|
|
|
* Fix build with early 0.9.8 series which did not have SSL_CTX_clear_options().
|
|
|
|
[ruby-core:78693]
|
|
|
|
|
|
|
|
|
|
|
|
Version 2.0.1
|
|
|
|
=============
|
|
|
|
|
|
|
|
Bug fixes
|
|
|
|
---------
|
|
|
|
|
|
|
|
* A GC issue around OpenSSL::BN is fixed.
|
|
|
|
[[ruby/openssl#87]](https://github.com/ruby/openssl/issues/87)
|
|
|
|
* OpenSSL::ASN1 now parses BER encoding of GeneralizedTime without seconds.
|
|
|
|
[[ruby/openssl#88]](https://github.com/ruby/openssl/pull/88)
|
|
|
|
|
|
|
|
|
2016-11-30 09:41:46 -05:00
|
|
|
Version 2.0.0
|
|
|
|
=============
|
|
|
|
|
|
|
|
This is the first release of openssl gem, formerly a standard library of Ruby,
|
|
|
|
ext/openssl. This is the successor of the version included in Ruby 2.3.
|
|
|
|
|
|
|
|
Compatibility notes
|
|
|
|
-------------------
|
|
|
|
|
|
|
|
* Support for OpenSSL version 0.9.6 and 0.9.7 is completely removed. openssl gem
|
|
|
|
still works with OpenSSL 0.9.8, but users are strongly encouraged to upgrade
|
|
|
|
to at least 1.0.1, as OpenSSL < 1.0.1 will not receive any security fixes from
|
|
|
|
the OpenSSL development team.
|
|
|
|
|
|
|
|
Supported platforms
|
|
|
|
-------------------
|
|
|
|
|
|
|
|
* OpenSSL 1.0.0, 1.0.1, 1.0.2, 1.1.0
|
|
|
|
* OpenSSL < 0.9.8 is no longer supported.
|
|
|
|
* LibreSSL 2.3, 2.4, 2.5
|
|
|
|
* Ruby 2.3, 2.4
|
|
|
|
|
|
|
|
Notable changes
|
|
|
|
---------------
|
|
|
|
|
2017-06-14 05:49:09 -04:00
|
|
|
* Add support for OpenSSL 1.1.0.
|
|
|
|
[[Feature #12324]](https://bugs.ruby-lang.org/issues/12324)
|
2016-11-30 09:41:46 -05:00
|
|
|
* Add support for LibreSSL
|
|
|
|
|
|
|
|
* OpenSSL::Cipher
|
|
|
|
|
|
|
|
- OpenSSL::Cipher#key= and #iv= reject too long inputs. They used to truncate
|
|
|
|
silently. [[Bug #12561]](https://bugs.ruby-lang.org/issues/12561)
|
|
|
|
|
|
|
|
- OpenSSL::Cipher#iv_len= is added. It allows changing IV (nonce) length if
|
|
|
|
using AEAD ciphers.
|
|
|
|
[[Bug #8667]](https://bugs.ruby-lang.org/issues/8667),
|
|
|
|
[[Bug #10420]](https://bugs.ruby-lang.org/issues/10420),
|
|
|
|
[[GH ruby/ruby#569]](https://github.com/ruby/ruby/pull/569),
|
|
|
|
[[GH ruby/openssl#58]](https://github.com/ruby/openssl/pull/58)
|
|
|
|
|
|
|
|
- OpenSSL::Cipher#auth_tag_len= is added. This sets the authentication tag
|
|
|
|
length to be generated by an AEAD cipher.
|
|
|
|
|
|
|
|
* OpenSSL::OCSP
|
|
|
|
|
|
|
|
- Accessor methods are added to OpenSSL::OCSP::CertificateId.
|
|
|
|
[[Feature #7181]](https://bugs.ruby-lang.org/issues/7181)
|
|
|
|
|
|
|
|
- OpenSSL::OCSP::Request and BasicResponse can be signed with non-SHA-1 hash
|
|
|
|
algorithm. [[Feature #11552]](https://bugs.ruby-lang.org/issues/11552)
|
|
|
|
|
|
|
|
- OpenSSL::OCSP::CertificateId and BasicResponse can be encoded into DER.
|
|
|
|
|
|
|
|
- A new class OpenSSL::OCSP::SingleResponse is added for convenience.
|
|
|
|
|
|
|
|
- OpenSSL::OCSP::BasicResponse#add_status accepts absolute times. They used to
|
|
|
|
accept only relative seconds from the current time.
|
|
|
|
|
|
|
|
* OpenSSL::PKey
|
|
|
|
|
|
|
|
- OpenSSL::PKey::EC follows the general PKey interface.
|
|
|
|
[[Bug #6567]](https://bugs.ruby-lang.org/issues/6567)
|
|
|
|
|
|
|
|
- OpenSSL::PKey.read raises OpenSSL::PKey::PKeyError instead of ArgumentError
|
|
|
|
for consistency with OpenSSL::PKey::{DH,DSA,RSA,EC}#new.
|
|
|
|
[[Bug #11774]](https://bugs.ruby-lang.org/issues/11774),
|
|
|
|
[[GH ruby/openssl#55]](https://github.com/ruby/openssl/pull/55)
|
|
|
|
|
|
|
|
- OpenSSL::PKey::EC::Group retrieved by OpenSSL::PKey::EC#group is no longer
|
|
|
|
linked with the EC key. Modifications to the EC::Group have no effect on the
|
|
|
|
key. [[GH ruby/openssl#71]](https://github.com/ruby/openssl/pull/71)
|
|
|
|
|
|
|
|
- OpenSSL::PKey::EC::Point#to_bn allows specifying the point conversion form
|
|
|
|
by the optional argument.
|
|
|
|
|
|
|
|
* OpenSSL::SSL
|
|
|
|
|
|
|
|
- OpenSSL::SSL::SSLSocket#tmp_key is added. A client can call it after the
|
|
|
|
connection is established to retrieve the ephemeral key.
|
|
|
|
[[GH ruby/ruby#1318]](https://github.com/ruby/ruby/pull/1318)
|
|
|
|
|
|
|
|
- The automatic ephemeral ECDH curve selection is enabled by default when
|
|
|
|
built with OpenSSL >= 1.0.2 or LibreSSL.
|
|
|
|
|
|
|
|
- OpenSSL::SSL::SSLContext#security_level= is added. You can set the "security
|
|
|
|
level" of the SSL context. This is effective only when built with OpenSSL
|
|
|
|
1.1.0.
|
|
|
|
|
|
|
|
- A new option 'verify_hostname' is added to OpenSSL::SSL::SSLContext. When it
|
|
|
|
is enabled, and the SNI hostname is also set, the hostname verification on
|
|
|
|
the server certificate is automatically performed. It is now enabled by
|
2017-11-25 09:12:08 -05:00
|
|
|
OpenSSL::SSL::SSLContext#set_params.
|
2016-11-30 09:41:46 -05:00
|
|
|
[[GH ruby/openssl#60]](https://github.com/ruby/openssl/pull/60)
|
|
|
|
|
|
|
|
Removals
|
|
|
|
--------
|
|
|
|
|
|
|
|
* OpenSSL::Engine
|
|
|
|
|
|
|
|
- OpenSSL::Engine.cleanup does nothing when built with OpenSSL 1.1.0.
|
|
|
|
|
|
|
|
* OpenSSL::SSL
|
|
|
|
|
|
|
|
- OpenSSL::PKey::DH::DEFAULT_512 is removed. Hence servers no longer use
|
|
|
|
512-bit DH group by default. It is considered too weak nowadays.
|
|
|
|
[[Bug #11968]](https://bugs.ruby-lang.org/issues/11968),
|
|
|
|
[[GH ruby/ruby#1196]](https://github.com/ruby/ruby/pull/1196)
|
|
|
|
|
|
|
|
- RC4 cipher suites are removed from OpenSSL::SSL::SSLContext::DEFAULT_PARAMS.
|
|
|
|
RC4 is now considered to be weak.
|
|
|
|
[[GH ruby/openssl#50]](https://github.com/ruby/openssl/pull/50)
|
|
|
|
|
|
|
|
Deprecations
|
|
|
|
------------
|
|
|
|
|
|
|
|
* OpenSSL::PKey
|
|
|
|
|
|
|
|
- OpenSSL::PKey::RSA#n=, #e=, #d=, #p=, #q=, #dmp1=, #dmq1=, #iqmp=,
|
|
|
|
OpenSSL::PKey::DSA#p=, #q=, #g=, #priv_key=, #pub_key=,
|
|
|
|
OpenSSL::PKey::DH#p=, #g=, #priv_key= and #pub_key= are deprecated. They are
|
|
|
|
disabled when built with OpenSSL 1.1.0, due to its API change. Instead,
|
|
|
|
OpenSSL::PKey::RSA#set_key, #set_factors, #set_crt_params,
|
|
|
|
OpenSSL::PKey::DSA#set_pqg, #set_key, OpenSSL::PKey::DH#set_pqg and #set_key
|
|
|
|
are added.
|
|
|
|
|
|
|
|
* OpenSSL::Random
|
|
|
|
|
|
|
|
- OpenSSL::Random.pseudo_bytes is deprecated, and not defined when built with
|
|
|
|
OpenSSL 1.1.0. Use OpenSSL::Random.random_bytes instead.
|
|
|
|
|
|
|
|
* OpenSSL::SSL
|
|
|
|
|
|
|
|
- OpenSSL::SSL::SSLContext#tmp_ecdh_callback is deprecated, as the underlying
|
|
|
|
API SSL_CTX_set_tmp_ecdh_callback() is removed in OpenSSL 1.1.0. It was
|
|
|
|
first added in Ruby 2.3.0. To specify the curve to be used in ephemeral
|
|
|
|
ECDH, use OpenSSL::SSL::SSLContext#ecdh_curves=. The automatic curve
|
|
|
|
selection is also now enabled by default when built with a capable OpenSSL.
|