Source code
Revision control
Copy as Markdown
Other Tools
.. _mozilla_projects_nss_nss_3_21_release_notes:
NSS 3.21 release notes
======================
.. container::
2016-01-07, this page has been updated to include additional information about the release. The
sections "Security Fixes" and "Acknowledgements" have been added.
`Introduction <#introduction>`__
--------------------------------
.. container::
The NSS team has released Network Security Services (NSS) 3.21, which is a minor release.
`Distribution Information <#distribution_information>`__
--------------------------------------------------------
.. container::
The HG tag is NSS_3_21_RTM. NSS 3.21 requires NSPR 4.10.10 or newer.
NSS 3.21 source distributions are available on ftp.mozilla.org for secure HTTPS download:
- Source tarballs:
.. _security_fixes_in_nss_3.21:
`Security Fixes in NSS 3.21 <#security_fixes_in_nss_3.21>`__
------------------------------------------------------------
.. container::
MD5 Downgrade in TLS 1.2 Signatures.
.. _new_in_nss_3.21:
`New in NSS 3.21 <#new_in_nss_3.21>`__
--------------------------------------
.. _new_functionality:
`New Functionality <#new_functionality>`__
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.. container::
- ``certutil`` now supports a ``--rename`` option to change a nickname (`bug
- TLS extended master secret extension (`RFC
- New info functions added for use during mid-handshake callbacks (`bug
.. rubric:: New Functions
:name: new_functions
- *in nss.h*
- **NSS_OptionSet** - sets NSS global options
- **NSS_OptionGet** - gets the current value of NSS global options
- *in secmod.h*
- **SECMOD_CreateModuleEx** - Create a new SECMODModule structure from module name string,
module parameters string, NSS specific parameters string, and NSS configuration parameter
string. The module represented by the module structure is not loaded. The difference with
**SECMOD_CreateModule** is the new function handles NSS configuration parameter strings.
- *in ssl.h*
- **SSL_GetPreliminaryChannelInfo** - obtains information about a TLS channel prior to the
handshake being completed, for use with the callbacks that are invoked during the handshake
- **SSL_SignaturePrefSet** - configures the enabled signature and hash algorithms for TLS
- **SSL_SignaturePrefGet** - retrieves the currently configured signature and hash algorithms
- **SSL_SignatureMaxCount** - obtains the maximum number signature algorithms that can be
configured with **SSL_SignaturePrefSet**
- *in utilpars.h*
- **NSSUTIL_ArgParseModuleSpecEx** - takes a module spec and breaks it into shared library
string, module name string, module parameters string, NSS specific parameters string, and
NSS configuration parameter strings. The returned strings must be freed by the caller. The
difference with **NSS_ArgParseModuleSpec** is the new function handles NSS configuration
parameter strings.
- **NSSUTIL_MkModuleSpecEx** - take a shared library string, module name string, module
parameters string, NSS specific parameters string, and NSS configuration parameter string
and returns a module string which the caller must free when it is done. The difference with
**NSS_MkModuleSpec** is the new function handles NSS configuration parameter strings.
.. rubric:: New Types
:name: new_types
- *in pkcs11t.h*
- **CK_TLS12_MASTER_KEY_DERIVE_PARAMS{_PTR}** - parameters {or pointer} for
**CKM_TLS12_MASTER_KEY_DERIVE**
- **CK_TLS12_KEY_MAT_PARAMS{_PTR}** - parameters {or pointer} for
**CKM_TLS12_KEY_AND_MAC_DERIVE**
- **CK_TLS_KDF_PARAMS{_PTR}** - parameters {or pointer} for **CKM_TLS_KDF**
- **CK_TLS_MAC_PARAMS{_PTR}** - parameters {or pointer} for **CKM_TLS_MAC**
- *in sslt.h*
- **SSLHashType** - identifies a hash function
- **SSLSignatureAndHashAlg** - identifies a signature and hash function
- **SSLPreliminaryChannelInfo** - provides information about the session state prior to
handshake completion
.. rubric:: New Macros
:name: new_macros
- *in nss.h*
- **NSS_RSA_MIN_KEY_SIZE** - used with NSS_OptionSet and NSS_OptionGet to set or get the
minimum RSA key size
- **NSS_DH_MIN_KEY_SIZE** - used with NSS_OptionSet and NSS_OptionGet to set or get the
minimum DH key size
- **NSS_DSA_MIN_KEY_SIZE** - used with NSS_OptionSet and NSS_OptionGet to set or get the
minimum DSA key size
- *in pkcs11t.h*
- **CKM_TLS12_MASTER_KEY_DERIVE** - derives TLS 1.2 master secret
- **CKM_TLS12_KEY_AND_MAC_DERIVE** - derives TLS 1.2 traffic key and IV
- **CKM_TLS12_MASTER_KEY_DERIVE_DH** - derives TLS 1.2 master secret for DH (and ECDH) cipher
suites
- **CKM_TLS12_KEY_SAFE_DERIVE** and **CKM_TLS_KDF** are identifiers for additional PKCS#12
mechanisms for TLS 1.2 that are currently unused in NSS.
- **CKM_TLS_MAC** - computes TLS Finished MAC
- *in secoidt.h*
- **NSS_USE_ALG_IN_SSL_KX** - policy flag indicating that keys are used in TLS key exchange
- *in sslerr.h*
- **SSL_ERROR_RX_SHORT_DTLS_READ** - error code for failure to include a complete DTLS record
in a UDP packet
- **SSL_ERROR_NO_SUPPORTED_SIGNATURE_ALGORITHM** - error code for when no valid signature and
hash algorithm is available
- **SSL_ERROR_UNSUPPORTED_SIGNATURE_ALGORITHM** - error code for when an unsupported
signature and hash algorithm is configured
- **SSL_ERROR_MISSING_EXTENDED_MASTER_SECRET** - error code for when the extended master
secret is missing after having been negotiated
- **SSL_ERROR_UNEXPECTED_EXTENDED_MASTER_SECRET** - error code for receiving an extended
master secret when previously not negotiated
- *in sslt.h*
- **SSL_ENABLE_EXTENDED_MASTER_SECRET** - configuration to enable the TLS extended master
- **ssl_preinfo_version** - used with **SSLPreliminaryChannelInfo** to indicate that a TLS
version has been selected
- **ssl_preinfo_cipher_suite** - used with **SSLPreliminaryChannelInfo** to indicate that a
TLS cipher suite has been selected
- **ssl_preinfo_all** - used with **SSLPreliminaryChannelInfo** to indicate that all
preliminary information has been set
.. _notable_changes_in_nss_3.21:
`Notable Changes in NSS 3.21 <#notable_changes_in_nss_3.21>`__
--------------------------------------------------------------
.. container::
- NSS now builds with elliptic curve ciphers enabled by default (`bug
- NSS now builds with warnings as errors (`bug
- The following CA certificates were **Removed**
- CN = VeriSign Class 4 Public Primary Certification Authority - G3
- SHA1 Fingerprint: C8:EC:8C:87:92:69:CB:4B:AB:39:E9:8D:7E:57:67:F3:14:95:73:9D
- CN = UTN-USERFirst-Network Applications
- SHA1 Fingerprint: 5D:98:9C:DB:15:96:11:36:51:65:64:1B:56:0F:DB:EA:2A:C2:3E:F1
- CN = TC TrustCenter Universal CA III
- SHA1 Fingerprint: 96:56:CD:7B:57:96:98:95:D0:E1:41:46:68:06:FB:B8:C6:11:06:87
- CN = A-Trust-nQual-03
- SHA-1 Fingerprint: D3:C0:63:F2:19:ED:07:3E:34:AD:5D:75:0B:32:76:29:FF:D5:9A:F2
- CN = USERTrust Legacy Secure Server CA
- SHA-1 Fingerprint: 7C:2F:91:E2:BB:96:68:A9:C6:F6:BD:10:19:2C:6B:52:5A:1B:BA:48
- Friendly Name: Digital Signature Trust Co. Global CA 1
- SHA-1 Fingerprint: 81:96:8B:3A:EF:1C:DC:70:F5:FA:32:69:C2:92:A3:63:5B:D1:23:D3
- Friendly Name: Digital Signature Trust Co. Global CA 3
- SHA-1 Fingerprint: AB:48:F3:33:DB:04:AB:B9:C0:72:DA:5B:0C:C1:D0:57:F0:36:9B:46
- CN = UTN - DATACorp SGC
- SHA-1 Fingerprint: 58:11:9F:0E:12:82:87:EA:50:FD:D9:87:45:6F:4F:78:DC:FA:D6:D4
- O = TÜRKTRUST Bilgi İletişim ve Bilişim Güvenliği Hizmetleri A.Ş. (c) Kasım 2005
- SHA-1 Fingerprint: B4:35:D4:E1:11:9D:1C:66:90:A7:49:EB:B3:94:BD:63:7B:A7:82:B7
- The following CA certificate had the Websites **trust bit turned off**
- OU = Equifax Secure Certificate Authority
- SHA1 Fingerprint: D2:32:09:AD:23:D3:14:23:21:74:E4:0D:7F:9D:62:13:97:86:63:3A
- The following CA certificates were **Added**
- CN = Certification Authority of WoSign G2
- SHA1 Fingerprint: FB:ED:DC:90:65:B7:27:20:37:BC:55:0C:9C:56:DE:BB:F2:78:94:E1
- CN = CA WoSign ECC Root
- SHA1 Fingerprint: D2:7A:D2:BE:ED:94:C0:A1:3C:C7:25:21:EA:5D:71:BE:81:19:F3:2B
- CN = OISTE WISeKey Global Root GB CA
- SHA1 Fingerprint: 0F:F9:40:76:18:D3:D7:6A:4B:98:F0:A8:35:9E:0C:FD:27:AC:CC:ED
- The version number of the updated root CA list has been set to 2.6
.. _bugs_fixed_in_nss_3.21:
`Bugs fixed in NSS 3.21 <#bugs_fixed_in_nss_3.21>`__
----------------------------------------------------
.. container::
This Bugzilla query returns all the bugs fixed in NSS 3.21:
`Acknowledgements <#acknowledgements>`__
----------------------------------------
.. container::
The NSS development team would like to thank Karthikeyan Bhargavan from
`Compatibility <#compatibility>`__
----------------------------------
.. container::
NSS 3.21 shared libraries are backward compatible with all older NSS 3.x shared libraries. A
program linked with older NSS 3.x shared libraries will work with NSS 3.21 shared libraries
without recompiling or relinking. Furthermore, applications that restrict their use of NSS APIs
to the functions listed in NSS Public Functions will remain compatible with future versions of
the NSS shared libraries.
`Feedback <#feedback>`__
------------------------
.. container::
Bugs discovered should be reported by filing a bug report with