Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8145252

JEP 332: Transport Layer Security (TLS) 1.3

    Details

    • Author:
      Xue-Lei Fan
    • JEP Type:
      Feature
    • Exposure:
      Open
    • Subcomponent:
    • Scope:
      SE
    • Discussion:
      security dash dev at openjdk dot java dot net
    • Effort:
      XL
    • Duration:
      XL
    • JEP Number:
      332

      Description

      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
      • 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).

        Attachments

          Issue Links

            Activity

              People

              • Assignee:
                xuelei Xue-Lei Fan
                Reporter:
                xuelei Xue-Lei Fan
                Owner:
                Xue-Lei Fan
                Reviewed By:
                Andrew Gross, Brian Goetz, Sean Mullan
                Endorsed By:
                Brian Goetz
              • Votes:
                0 Vote for this issue
                Watchers:
                10 Start watching this issue

                Dates

                • Created:
                  Updated:
                  Resolved: