MatrixSSL 3.1.2

Feature Updates

• Explicit API support for processing multi-record data buffers - The 3.1.1 API set did not include a documented mechanism for processing buffers in which multiple application data records are concatenated in a single ‘recv’ buffer. This is not an uncommon scenario and users are strongly encouraged to update to this latest MatrixSSL version and implement the new matrixSslProcessedData function in their applications. Details can be found in the updated API documentation included in this package.
• MatrixSSL version defines added - A version.h file has been added that includes defines for the MatrixSSL major, minor, and patch build version. The new header is included by matrixsslApi.h and defines the full version and the individual components. For example:

  #define MATRIXSSL_VERSION       “3.1.2-OPEN” 
  #define MATRIXSSL_VERSION_MAJOR	3 
  #define MATRIXSSL_VERSION_MINOR	1 
  #define MATRIXSSL_VERSION_PATCH	2
  #define MATRIXSSL_VERSION_CODE	“OPEN”

• The sslTest application includes a timing mode - The sslTest application can now be built to measure the connection speeds for clients and servers for the various cipher suites.
• Improvements to HTTP parsing in example application code - The server and client example applications now identify partial and multi-record HTTP records.

Public API Changes

• New matrixSslProcessedData prototype and return codes - To support the processing of multi-record data buffers, the matrixSslProcessedData function prototype and return codes have changed. The new function has two additional parameters that are used to return the next decoded record in the buffer. The return codes for this function have been expanded to inform the user how that second record should be handled.

  Please see the API documentation and code examples for detailed information.

Bug Fixes

• Fixed return codes where unsigned data types were assigned negative values - The functions psRsaDecryptPriv, psRsaDecryptPub, and matrixSslDecode are now consistent in their use of unsigned vs. signed data types.

MatrixSSL 3.1.1

Feature Updates

• Secure Renegotiations - Turn re-handshaking support back on, MatrixSSL users! Beginning in version 3.1.1 support for the recently published TLS Renegotiation Indication Extension (RFC 5746 ) is included. SSL/TLS renegotiations enable servers to fine tune the security parameters or access controls for individual clients without having to reconnect. MatrixSSL enabled clients and servers now support the "renegotiation_info" extension and the TLS_EMPTY_RENEGOTIATION_INFO_SCSV signaling cipher suite to prevent any possibility of the "plaintext injection attack" that was disclosed November 2009 and described in CVE-2009-3555.
• CLIENT_HELLO extension support - Support for adding extensions to CLIENT_HELLO messages is now included in the open source version of MatrixSSL. More information on hello extensions can be found in RFC 3546.
• Client cipher suites on re-handshakes - Clients will now resend the full list of supported cipher suites on server-initiated re-handshakes. In previous versions, upon receiving a HELLO_REQUEST from a connected server, the client would only supply the cipher suite that was currently negotiated in the CLIENT_HELLO.
• Makefile auto detects 32 and 64 bit platforms - The top level Makefile now detects whether 32 or 64 bit Linux or Mac OS X is running, and sets some defines appropriately to optimize performance for 64 bit platforms.
• New documents - Migration to 3.1 and OS Porting Guide

Public API Changes

• New matrixSslNewClientSession prototype - An additional parameter has been added to this routine to improve hello extension support. Clients can now register a callback that will be invoked during the SSL handshakes to parse any SERVER_HELLO extensions that might be sent by the server.
• USE_INT64 renamed to HAVE_NATIVE_INT64 - This define in coreConfig.h has been renamed for clarity.

Bug Fixes

• Changing Cipher Suites on Re-handshake - A handshaking failure was discovered during re-handshake testing in some cases where the underlying cipher suite was changing, resulting in an invalid SSL Alert and connection close. This has been fixed as part of the overall handshake protocol change.
• Default size for pstm_digit - The default 32-bit platform now explicitly sets the psmt_digit type as a 32-bit unsigned integer rather than an unsigned long. This fixes a compile issue witbh running with 32-bit math on a 64-bit platform.

MatrixSSL 3.1

Major Revision and Feature Updates

• Celebrating 8 years of MatrixSSL! - New 3.x version of Open Source matches Commercial versioning.
• TLS 1.0 Protocol Support - Beginning in MatrixSSL 3.1 the TLS 1.0 protocol and AES cipher are now available in open source releases.
• Improved API - It is now easier than ever to integrate SSL into your application. MatrixSSL has always provided SSL integration to applications at a data buffer level to guarantee support for any given transport mechanism. Previous versions, however, left the management of these data buffers in the hands of the integrator. The new MatrixSSL 3.1 API incorporates size-optimized buffer management so the user is left only with the task of determining when data needs to be read or written, while still maintaing a transport-neutral, zero buffer copy API.
• Faster and Smaller RSA Cryptography - The public key cryptography operations required for RSA mathematics are the primary contributors to high water memory and CPU resources during the SSL handshake. MatrixSSL 3.1 includes specific optimizations that have resulted in major improvements to both speed and memory usage during public cryptography. These substantial memory savings and performance improvements allow MatrixSSL to be used on an even larger number of embedded platforms. The entire SSL handshake, including network buffers can now be completed in as little as 10KB of RAM, with a post-handshake dynamic memory footprint of less than 3KB.
• File and Functional Reorganization - The MatrixSSL 3.1 source code package has been organized to better reflect the individual functional areas. The core and crypto modules are now clear building blocks on which MatrixSSL relies and each module has an API and Configuration header to manage optional features and functionality.
• New Supported Client and Server Applications - New client and server examples are now provided as a starting off point for customer integration or new application development. The client application is an example of a simple, blocking sockets API HTTPS client that prints the response to a HTTP GET request. The server example demonstrates a non-blocking HTTPS server that handles multiple connections and session timeouts. The MatrixSSL API usage for both applications is very similar, and should help clarify how to integrate MatrixSSL with other applications.
• New Test Application - A SSL/TLS protocol test application is now included in the package so that new ports of MatrixSSL can quickly be verified and functionally tested, even before integration with a sockets layer. The application creates virtual SSL connections within a single process using memory buffers as the transport layer. Each supported cipher suite and handshake mode are validated.
• Additional Project File Formats - Project files for the MatrixSSL library, example and test applications are now provided for Microsoft Visual Studio Express Edition, Apple Xcode and standard GNU make. Projects for the Eclipse IDE can be directly imported from GNU Makefile.

MatrixSSL 1.8.8

Protocol Security Updates

• A security exploit around SSL re-negotiation has been discovered. This is a protocol level flaw, and affects all SSL and TLS implementations. The protocol sitting above SSL may or may not be affected. For example, HTTPS with keep-alive support on authenticated connections IS affected. MatrixSSL disables re-negotiation for server side SSL in this release, protecting secure servers from attack. When using MatrixSSL for client connections, care should be taken to only connect to SSL servers that have re-negotiation disabled.
• More information: HTTPS/SSL Attack Vector Discovered

MatrixSSL 1.8.7

New Features

• Windows project files for library and example application builds are now based on the freely available Microsoft Visual Studio C++ 2008 Express Edition

• The USE_MULTITHREADING define in matrixConfig.h is now off by default so that POSIX platforms will not require pthreads by default.

• Fixed the size calculations for SSL_FULL conditions when encoding the FINISHED flight of handshake messages
• Additional checks and proper error handling for the following types of malformed X.509 certificates as tested by Orange Labs. These do not constitute a remote attack vector for the Open Source release.
  • Testing for Serial Number encodings that use bad length specifications
  • Testing for Distinguished Name extension encodings that use bad length specifications
  • Error handling for Subject Alternate Name extensions that use bad length specifications

MatrixSSL 1.8.6

New Features

• The matrixRsaParsePubKey routine has added support for X.509 SubjectPublicKeyInfo formatted keys
• Full parsing support of the subjectAltName extension in certificates

• Allowing clients to send multiple compression parameters in the CLIENT_HELLO message
• The matrixX509ReadCert routine supports additional PEM file header and footer formats

• Corrected filename misspelling in httpsReflector.c for loading example CAcertCln.der certificate

MatrixSSL 1.8.5

API changes

• Internal API change to accommodate MatrixSSH users.

• Ignore TLS extensions sent with SSL 3.0 ClientHello. Thunderbird sends these extensions if negotiating down from a TLS connection, even though they are meaningless.
• Enhanced the parsing of the Key Usage certificate extension.

• Assure file reads into memory are NULL terminated. This was an issue flagged by Valgrind that doesn't present a problem in practice.
• 2008 copyright update.

• MatrixSSL 1.8.4 was not a public release.

MatrixSSL 1.8.3

API changes

• ‘const’ qualifiers added to literal string parameters for matrixRsaReadPrivKey, matrixRsaReadKeys, matrixRsaReadKeysEx and matrixX509ReadPubKey.

• Additional error reporting in RSA public decryption routine.

• Improved the enforcement of maximum certificate chain length.
• Added the –fPIC compile option to default POSIX builds.
• Fixed one time memory leak on error conditional during certificate parsing.
• 2007 copyright update.

MatrixSSL 1.8.2

API additions

• None

• New "leaky bucket" algorithm for empty message denial-of-service countermeasure. Previously, the count of empty messages was continually being incremented by the MatrixSSL library regardless of any interleaving valid messages. This could potentially cause the connection to be closed if a peer was sending many blank SSL messages. The count will now decrement on valid messages. This change is most relevant to use-cases that involve an OpenSSL client communicating with a MatrixSSL server, as these clients tend to periodically send a blank record.

• None

MatrixSSL 1.8.1

API additions

• None

• Cleaner POSIX cross platform compiles for newer versions of Linux.
• Build support for Intel Macs (tested on OS X 10.4 CoreDuo).

• Minor compile warnings fixed.
• Graceful handling when MAX_CHAIN_LEN limit is exceeded in certificate parsing.
• Added ASN.1 BMPSTRING format support to certificate parsing.
• Fixed matrixSslReadKeysMem so that private key parameter is optional.
• Fixed one time memory leak for client initialization issues that include non-parsable certificates.

MatrixSSL 1.8

API additions

• Addition of two new server APIs that allow the user to add a custom flag value to client sessions. Servers may now assign persistant custom data to connected sessions that can be later retrieved from a session that was established with a session resumption handshake. See the API documentation for matrixSslSetResumptionFlag and matrixSslGetResumptionFlag for more details.

• Ability to put multiple certificates in a single PEM file.
• The handshake will now fail on an un-authenticated cert if no user validation callback has been defined with matrixSslSetCertValidator. It is still encouraged that a callback be registered.
• Users can now reply to a closure alert with a closure alert of their own using matrixSslEncodeClosureAlert. Previously, the SSL_CLOSED flag prevented this. Now only error cases will prevent the closure alert from being created.

• Numerous compile warnings fixed. Especially in the area of unsigned char / char type mismatches.
• Added explicit ‘void’ types to empty parameter functions.
• Fixed a bad shift operation in cipherSuite.c (no functional change).
• Fixed possible memory leak of pre-master secret if deleteSession called on some corner failure cases.
• Fixed compile and link issues when USE_FILE_SYSTEM was turned off in matrixConfig.h.
• Fix for unknown X.509 certificate extension parsing in which the extensions did not provide explicit data lengths in the encoding.
• Fixed parse issue with an empty AuthorityKeyIdentifier certificate extension.
• Created new sample certificates with updated dates.

MatrixSSL 1.7.3

Bug fixes and optimizations

• Fixed issue with certificate extension parsing causing a cert with some unrecognized extensions to fail validation.
• Fixed requirement when USE_CLIENT_SIDE is enabled with ReadKeysMem - CA is no longer required.

MatrixSSL 1.7.1b

Bug fixes and optimizations

• Fixed packaging issue causing a build error on Windows and Linux. No functional change from 1.7.1

MatrixSSL 1.7.1

Bug fixes and optimizations

• Fixed certificate chain parsing bug where a valid certificate chain was marked as invalid under certain circumstances. The result of the fix is that more cert chain configurations are supported.
• Added support for cert validation when the server sends the Root CA cert in addition to the lower levels of the chain. Typically the Root CA cert is loaded into the client, and not sent by the server. We have encountered some deployments where the server does send the root CA as well, and now successfully validate this chain.
• Relaxed parsing of the CertificateSerialNumber field within AuthorityKeyIdentifier. Although officially defined as an ASN.1 INTEGER type, some certificate generators use a non-integer value. Parser now supports these technically incorrect datatypes.

MatrixSSL 1.7

Overall changes

• Explicit support for anonymous RSA handshaking
• New APIs to support anonymous handshaking and re-handshaking over existing connections with new key material

• Version updated from 1.2.5 to 1.7 to mirror commercial MatrixSSL versioning
• Directory and file reorganization

• Significantly accelerated RSA handshake speeds
• Additional parsing of X.509 certificate extensions

MatrixSSL 1.2.5

Overall changes

• No API changes from 1.2.4 release

• Updated expiration date in sample certificates

• Remove unnecessary link to -lcrypto on Linux
• Fix prevTicks compatibility on non-i386 Linux platforms

MatrixSSL 1.2.4

Overall changes

• No API changes from 1.2.2 release
• There was no public 1.2.3 release

• Client will reply with NULL cert message if client authentication is requested.

• Generate static libraries in addition to shared objects on Linux
• AMD64/Nacona x64 compile support on Linux
• Changed all instances of int types to int32 to be more explicit and to allow easy global redefinitions for porting
• Corrected the maximum message size limit to match the SSL specification
• Cert parse can handle duplicate distinguished name entries.
• ASN.1 parse fix for AlgorithmIdentifier missing the trailing NULL
• Checking certificate version before doing checking the 'ca' member of the basic constraint entry during certificate validation.
• Developers may notice some internal routines using a psPool_t parameter. These parameters allow deterministic memory support in the commercial version of MatrixSSL. They are unused in the GNU version of MatrixSSL.

MatrixSSL 1.2.2

Functional changes

• Added legacy certificate support

- for certificates without basic constraints
- MD2 support for older certificates (Because it is a less secure algorithm, it must be explicitly enabled).

• Sanity check against invalid key lengths from certificate (potential DOS fix)
• Fixed 64 bit issue with mpi.c
• Fix potential leak in certificates with duplicate fields
• Allow application data parsing within re-handshake state

MatrixSSL 1.2.1

Bug fixes and optimizations

• Increased max SSL record length to 16K + 2K for Apache compatibility
• Validate outgoing record length in matrixSslEncode()
• Sanity check mac padding loop
• Validate all ASN.1 length fields in X.509 certificates

MatrixSSL 1.1.2

Bug fixes and optimizations

• Remove newline requirement for private key parsing
• Allow NULL certificate for matrixSslReadKeys()
• Cleaned up some spurious compiler warnings

MatrixSSL 1.1.1

Functional changes

• Enabled SSL_RSA_WITH_3DES_EDE_CBC_SHA by default. The footprint remains the same, since 3DES was already included with the USE_ENCRYPTED_PRIVATE_KEYS define. Note that this is the preferred cipher for many SSL clients, so by enabling this cipher, communications will default to a stronger, but slower cipher.

• Safer memory usage for RSA blinding function. Code was already safe for 1024 and 2048 bit keys, but this ensures the safety.


• Properly compare the time in the session cache to ensure the oldest unused session is replaced first. Previously the oldest session may not have been chosen, and a newer one replaced instead.


• Fixed a null-termination error in a static buffer that caused a crash on some platforms using encrypted private keys.


• Improved example code handling of return codes of sslRead(). Clarified that a 0 return code may indicate either a successful parse of a record with no application data, or an EOF. Previously both cases were treated as EOF, which fits the examples, but isn't as useful for other applications.

MatrixSSL 1.1

Enhancements

• Added session cache expiry code (defaults to 24 hours)
• Added optional support for RSA blinding (USE_RSA_BLINDING, off by default)
• Support for VxWorks
• Support for MacOS X
• Support for Microsoft Windows CE
• Support for platforms without native 64 bit integers (USE_INT64, on by default)

Changes

• Split matrixSsl.c into two additional files: sslDecode.c and sslEncode.c
• Updated matrixSslSetCertValidator() API and callback to support user supplied argument
• Added sigHash and sigHashLen parameters to sslCertInfo_t structure for public access to the certificate fingerprint
• General code formatting and cleanup
• Removed strtok() and va_args use for better portability

Fixes

• Support for (ignoring) TLS extensions in ClientHello
• Fixed bug in handling of static strings for matrixSslReadKeys()
• Fixed maximum 4 byte memory compare overrun in certificate parsing

MatrixSSL 1.0.2

This release fixes two issues; an error in parsing packed handshake records, and a corner case memory leak in the socket example code. Neither of these issues presents a security risk, but could affect interoperability and resource usage.

MatrixSSL 1.0.1

We've released a minor update to 1.0. Support has been added for validation of X.509 certificates with serial numbers using more than 32 bits, improving compatibility with more certificates. This change affects the public sslCertInfo_t structure serialNumber field type and adds a new element, serialNumberLen to the structure.

1.0 Release

We've posted our 1.0 release of MatrixSSL. Thank you to all the beta testers who sent us feedback and suggestions. We're sure the requirements will continue to be enhanced as additional products use MatrixSSL, but thanks to the open source community, this has been a strong 1.0 release.

Beta2 R2

We've released an updated Beta 2 package to fix an issue with the example certificate file included with the initial release. This certificate contained extensions that were not readable by Netscape 7 or Mozilla. We have regenerated the certificates and included them in the latest source download, with an update to asn1.c. These certificates are only for testing purposes and should not be used in an actual release.

MatrixSSL 1.0 Beta 2

We have just released a second beta version of MatrixSSL for download. Final release is just around the corner, but we wanted to get our client side SSL implementation some beta time.

Release Notes:

• RC4-MD5 and RC4-SHA are now enabled by default.
• httpClient and httpReflector must be "Set As StartUp Project" project in their respective VisualStudio solutions in order to run automatically in the debugger in Windows.
• Certificate validation currently checks only that the certificate was signed by the root CA, and that other internals are consistent. User level checks of the distinguished name will be added in final release.

Change Log:

• Added client side SSL support
• Added X.509 certificate parsing and basic validation
• Added httpClient example
• Added several new APIs for client side SSL
• Enhanced client and reflector example with support for pipelined requests
• Fixed length check in record parsing that could lead to a comparison beyond memory boundaries.
• Fixed SSL record version check that could allow invalid record versions to be sent. As only SSLv3 was supported, this did not cause a security concern.
• Added workaround for bug in Microsoft Internet Explorer, where negotiated version is sent in the encrypted premaster secret, rather than the requested version as per specification.
• Minor updates to cryptography code suggested by Tom St. Denis.

MatrixSSL 1.0 Beta

First general public release of MatrixSSL.