Summary

Implement version 1.3 of the Transport Layer Security (TLS) Protocol RFC 8446.

Non-Goals

It is not a goal to support version 1.3 of the Datagram Transport Layer Security (DTLS) Protocol. It is also not a goal to support every feature of TLS 1.3; see the Description section for more details on what will be implemented.

Motivation

TLS 1.3 is a major overhaul of the TLS protocol and provides significant security and performance improvements over previous versions. Several early implementations from other vendors are available already. We need to support TLS 1.3 to remain competitive and keep pace with the latest standard.

Description

TLS 1.3 is a new TLS version which supersedes and obsoletes previous versions of TLS including version 1.2 (RFC 5246). It also obsoletes or changes other TLS features such as the OCSP stapling extensions (RFC 6066, RFC 6961), and the session hash and extended master secret extension (RFC 7627).

The Java Secure Socket Extension (JSSE) in the JDK provides a framework and a Java implementation of the SSL, TLS, and DTLS protocols. Currently, the JSSE API and JDK implementation supports SSL 3.0, TLS 1.0, TLS 1.1, TLS 1.2, DTLS 1.0 and DTLS 1.2.

The primary goal of this JEP is a minimal interoperable and compatible TLS 1.3 implementation. A minimal implementation should support:

Protocol version negotiation

TLS 1.3 full handshake

TLS 1.3 session resumption

TLS 1.3 key and iv update

TLS 1.3 updated OCSP stapling

TLS 1.3 backward compatibility mode

TLS 1.3 required extensions and algorithms

RSASSA-PSS signature algorithms (8146293)

No new public APIs are required for the minimal implementation. The following new standard algorithm names are required:

TLS protocol version name: TLSv1.3

javax.net.ssl.SSLContext algorithm name: TLSv1.3

algorithm name: TLS cipher suite names for TLS 1.3: TLS_AES_128_GCM_SHA256 , TLS_AES_256_GCM_SHA384 .

Additionally, the KRB5 cipher suites will be removed from the JDK because they are no longer considered safe to use.

In parallel with this JEP, we will develop cryptographic algorithm support for the following optional TLS 1.3 features:

ChaCha20/Poly1305 cipher suites (8140466)

X25519/X448 elliptic curve algorithms (8171279)

edDSA signature algorithms (8166596)

These features may be included in this JEP if time permits; otherwise they will be targeted and integrated as separate features.

The following significant features will not be implemented as part of this JEP:

0-RTT data

Post-handshake authentication

Signed certificate timestamps (SCT): RFC 6962

TLS 1.3 is not directly compatible with previous versions. Although TLS 1.3 can be implemented with a backward-compatibility mode, there are several compatibility risks when using this mode:

TLS 1.3 uses a half-close policy, while TLS 1.2 and prior versions use a duplex-close policy. For applications that depend on the duplex-close policy, there may be compatibility issues when upgrading to TLS 1.3.

The signature_algorithms_cert extension requires that pre-defined signature algorithms are used for certificate authentication. In practice, however, an application may use non-supported signature algorithms.

The DSA signature algorithm is not supported in TLS 1.3. If a server is configured to only use DSA certificates, it cannot upgrade to TLS 1.3.

The supported cipher suites for TLS 1.3 are not the same as TLS 1.2 and prior versions. If an application hard-codes cipher suites which are no longer supported, it may not be able to use TLS 1.3 without modifying the application code.

To minimize compatibility risk, this TLS 1.3 implementation will implement and enable the backward-compatibility mode by default. An application can turn off the backward-compatibility mode, and turn TLS 1.3 on or off if desired.

Testing

Tests will be developed or enhanced to validate the following general requirements:

Verify that there is no compatibility impact for (D)TLS 1.2 and prior versions.

Verify that the implementation does not break backward compatibility in unexpected ways.

Verify that the implementation does not introduce any unexpected interoperability issues.

Verify that there is no significant performance impact.

Verify that the implementation, in both client and server modes, interoperate with other TLS 1.3 implementation.

Risks and Assumptions

A third party TLS 1.3 implementation that supports the RFC is required for interoperability testing.

Dependencies

TLS 1.3 requires support for the RSASSA-PSS signature algorithms (8146293).